npmpackage.info

Gathering detailed insights and metrics for @cutting/use-get-parent-size

@cutting/use-get-parent-size - 2.4.0 | npmpackage.info

@cutting/use-get-parent-size

2.4.0

JavaScript

139.47 kB

2.5

Installations

npm install @cutting/use-get-parent-size

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Node Version

18.20.8

NPM Version

10.8.2 Pull Requests

Open

2

Total

1,030

Closed

62

Merged

966

Issues

Open

0

Total

9

Closed

9

Releases

477

@cutting/use-get-parent-size@2.4.0

Updated on Apr 02, 2025

@cutting/use-shortcuts@4.49.0

Updated on Apr 02, 2025

@cutting/use-mathjax@4.53.0

Updated on Apr 02, 2025

@cutting/component-library@5.45.0

Updated on Apr 02, 2025

@cutting/svg@4.57.0

Updated on Apr 02, 2025

@cutting/react-hook-form-components@0.8.0

Updated on Apr 02, 2025

View All 477 releases

Languages

JavaScript

TypeScript

CSS

HTML

MDX

Shell

Dockerfile

Arc

JavaScript (68.75%)

TypeScript (25.83%)

CSS (3.42%)

HTML (1.3%)

MDX (0.46%)

Shell (0.13%)

Dockerfile (0.09%)

Arc (0.01%)

Developer

dagda1

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

35 Stars

2,515 Commits

2 Forks

2 Watchers

14 Branches

2 Contributors

Updated on May 04, 2025

Maintainers

View All 2 Contributors

Package Meta Information

Latest Version

2.4.0

Package Id

@cutting/use-get-parent-size@2.4.0

Unpacked Size

139.47 kB

Size

41.26 kB

File Count

NPM Version

10.8.2

Node Version

18.20.8

Published on

Apr 02, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

@cutting/use-get-parent-size - Get resize events of an observed DOM element's height, width etc. from a resize-observer.

install

1pnpm add @cutting/use-get-parent-size
2
3# or
4
5npm install @cutting/use-get-parent-size

useParentSize

A React hook that allows you to use a ResizeObserver to measure an element's size.

usage

1const { width, height } = useParentSize(ref, options);

useParentSize takes a react ref object and an optional options object.

Returns the contentRect of the observed element:

1interface DOMRectReadOnly {
2  readonly bottom: number;
3  readonly height: number;
4  readonly left: number;
5  readonly right: number;
6  readonly top: number;
7  readonly width: number;
8  readonly x: number;
9  readonly y: number;
10  toJSON(): any;
11}

Options

1export interface UseParentSizeOptions {
2  debounceDelay: number;
3  initialValues: Partial<ResizeObserverContentRect>;
4  transformFunc?: (
5    entry: Partial<ResizeObserverContentRect>
6  ) => Partial<ResizeObserverContentRect>;
7  maxDifference?: number;
8  transformFunc?: ({ width, height }: Dimensions) => Dimensions;
9  callback?(entry: ResizeObserverContentRect): void;
10}

debounceDelay - default 500ms. an optional number that will throttle the speed at which reize events are raised to the calling code.
initialValues - initially, the ref will be null and no width or height values can be returned until it is mounted. The initialValues option can return a specific width and height value until the ref actually references a valid DOM node. e.g. const { width, height } = useParentSize(ref, { width: 100, height: 50});

Default is an empty DomRect:

1{
2 bottom: undefined,
3 height: undefined,
4 left: undefined,
5 width: undefined,
6 right: undefined,
7 top: undefined,
8 x: undefined,
9 y: undefined,
10};

transformFunc optional function to transform the results, e.g. to halve the size of the parent
```
1transformFunc: ({ width, height }) => ({
2  width: width / 2,
3  height: height / 2,
4});
```
Default is identity, (x) => x
maxDifference (default 10) - useParentSize stores the current DomRect values in memory and if a resize event occurrs, these values are checked against the new DomRect values after the resize. If the difference between the two values is greater than the maxDifference option then clients are notified.
callback a function can be provided that is executed on each resize.

Usage

Used to properly resize an svg

1import { useRef } from 'react';
2import type { UseParentSizeOptions } from '@cutting/use-get-parent-size';
3
4export function ResponsiveSVG({
5  children
6}): JSX.Element => {
7  const ref = useRef<HTMLDivElement>(null);
8  const { width, height } = useParentSize(ref, options);
9  const aspect = width / height;
10
11  const adjustedHeight = Math.ceil(width / aspect);
12
13  return (
14    <div ref={ref}>
15      <svg
16        viewBox={`${origin.x} ${origin.y} ${width} ${adjustedHeight}`}
17      >
18        {children}
19      </svg>
20    </div>
21  );
22};

Used with callback only

1const Pipeline = () => {
2  const controller = useVisualizationController();
3  const containerRef = useRef<HTMLDivElement>(null);
4
5  useParentSize(containerRef, {
6    callback: () => {
7      controller.getGraph().fit(70);
8    },
9    debounceDelay: 500,
10  });

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

1

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:78: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:90: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-deploy.yml:97: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/build-deploy.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tmate.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/tmate.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/tmate.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/tmate.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/validate.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/validate.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/validate.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/validate.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/validate.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/validate.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/validate.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/validate.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/version.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/version.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/version.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/version.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/version.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/version.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/dagda1/cuttingedge/version.yml/main?enable=pin
Warn: containerImage not pinned by hash: apps/website/Dockerfile:2: pin your Docker image by updating node:18.12.0 to node:18.12.0@sha256:cef9966b19672effeafcf1a67b8add742c3e46ca7dd5532efff60820526c2e95
Warn: containerImage not pinned by hash: apps/website/nginx/Dockerfile:1: pin your Docker image by updating nginx:1.26 to nginx:1.26@sha256:41b194461e4bae16f9b25d68b0976ed4735b89ca625c89aad88e1c1c3b7e8860
Warn: npmCommand not pinned by hash: apps/website/Dockerfile:44
Info: 0 out of 10 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 10 third-party GitHubAction dependencies pinned
Info: 0 out of 2 containerImage dependencies pinned
Info: 0 out of 1 npmCommand dependencies pinned

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.5

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@cutting/use-get-parent-size

Installations

Developer Guide

Yes

ESM

18.20.8

10.8.2

Pull Requests

2

1,030

62

966

Issues

0

9

9

Releases

Languages

Developer

dagda1

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

@cutting/use-get-parent-size - Get resize events of an observed DOM element's height, width etc. from a resize-observer.

install

useParentSize

usage

Options

Usage

Used to properly resize an svg

Used with callback only

10

10

1

0

0

0

0

0

0

0

0

0

2.5

/10