@design-edito/tools 0.5.2 → 0.5.4

package/components/index.d.ts

@@ -1,22 +1,22 @@
 export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/index.js'
-export * as disclaimer from './Disclaimer/index.js'
 export * as clippable from './Clippable/index.js'
 export * as drawer from './Drawer/index.js'
+export * as disclaimer from './Disclaimer/index.js'
 export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
-export * as iframe from './Iframe/index.js'
 export * as image from './Image/index.js'
-export * as input from './Input/index.js'
+export * as iframe from './Iframe/index.js'
 export * as intersectionObserver from './IntersectionObserver/index.js'
+export * as input from './Input/index.js'
 export * as jsonEditor from './JsonEditor/index.js'
 export * as listLoader from './ListLoader/index.js'
-export * as overlayer from './Overlayer/index.js'
 export * as paginator from './Paginator/index.js'
-export * as resizeObserver from './ResizeObserver/index.js'
+export * as overlayer from './Overlayer/index.js'
 export * as scrllgngn from './Scrllgngn/index.js'
-export * as scrollListener from './ScrollListener/index.js'
+export * as resizeObserver from './ResizeObserver/index.js'
 export * as select from './Select/index.js'
+export * as scrollListener from './ScrollListener/index.js'
 export * as sequencer from './Sequencer/index.js'
 export * as shadowRoot from './ShadowRoot/index.js'
 export * as subtitles from './Subtitles/index.js'

package/components/index.js

@@ -1,22 +1,22 @@
 export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/index.js'
-export * as disclaimer from './Disclaimer/index.js'
 export * as clippable from './Clippable/index.js'
 export * as drawer from './Drawer/index.js'
+export * as disclaimer from './Disclaimer/index.js'
 export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
-export * as iframe from './Iframe/index.js'
 export * as image from './Image/index.js'
-export * as input from './Input/index.js'
+export * as iframe from './Iframe/index.js'
 export * as intersectionObserver from './IntersectionObserver/index.js'
+export * as input from './Input/index.js'
 export * as jsonEditor from './JsonEditor/index.js'
 export * as listLoader from './ListLoader/index.js'
-export * as overlayer from './Overlayer/index.js'
 export * as paginator from './Paginator/index.js'
-export * as resizeObserver from './ResizeObserver/index.js'
+export * as overlayer from './Overlayer/index.js'
 export * as scrllgngn from './Scrllgngn/index.js'
-export * as scrollListener from './ScrollListener/index.js'
+export * as resizeObserver from './ResizeObserver/index.js'
 export * as select from './Select/index.js'
+export * as scrollListener from './ScrollListener/index.js'
 export * as sequencer from './Sequencer/index.js'
 export * as shadowRoot from './ShadowRoot/index.js'
 export * as subtitles from './Subtitles/index.js'

package/components/utils/index.d.ts

@@ -1 +1,23 @@
 export declare function mergeClassNames(...names: Array<string | null | undefined | Array<string | null | undefined>>): string;
+/**
+ * Calls `onChange` whenever `value` changes, and only then — never on mount.
+ *
+ * This is how a component reports one of its state items to its consumer:
+ * a bare `useEffect` on the value would also fire on the first render, telling
+ * the consumer something changed when nothing did.
+ *
+ * @template T - Type of the watched value.
+ * @param value - The value to watch.
+ * @param onChange - Called with the new value, once the change has happened.
+ * @param isEqual - Decides whether the value actually changed. Defaults to
+ * `Object.is`, which covers booleans, numbers and strings. Pass a custom
+ * comparison for values rebuilt on every render, such as an array or an object
+ * derived from state, whose identity always differs.
+ *
+ * @remarks
+ * `onChange` is deliberately left out of the effect's dependencies. A consumer
+ * passing an inline arrow creates a new function on every render, which would
+ * re-run the effect each time and defeat the guard. The handler is read when the
+ * effect fires, so it is never a stale one.
+ */
+export declare function useChangeDispatch<T>(value: T, onChange?: (value: T) => void, isEqual?: (a: T, b: T) => boolean): void;

package/components/utils/index.js

@@ -1,3 +1,4 @@
+import { useEffect, useRef } from 'react';
 export function mergeClassNames(...names) {
     return names.map(name => {
         if (typeof name !== 'string' && !Array.isArray(name))
@@ -10,3 +11,33 @@ export function mergeClassNames(...names) {
     }).filter((name) => typeof name === 'string')
         .join(' ');
 }
+/**
+ * Calls `onChange` whenever `value` changes, and only then — never on mount.
+ *
+ * This is how a component reports one of its state items to its consumer:
+ * a bare `useEffect` on the value would also fire on the first render, telling
+ * the consumer something changed when nothing did.
+ *
+ * @template T - Type of the watched value.
+ * @param value - The value to watch.
+ * @param onChange - Called with the new value, once the change has happened.
+ * @param isEqual - Decides whether the value actually changed. Defaults to
+ * `Object.is`, which covers booleans, numbers and strings. Pass a custom
+ * comparison for values rebuilt on every render, such as an array or an object
+ * derived from state, whose identity always differs.
+ *
+ * @remarks
+ * `onChange` is deliberately left out of the effect's dependencies. A consumer
+ * passing an inline arrow creates a new function on every render, which would
+ * re-run the effect each time and defeat the guard. The handler is read when the
+ * effect fires, so it is never a stale one.
+ */
+export function useChangeDispatch(value, onChange, isEqual = Object.is) {
+    const previousRef = useRef(value);
+    useEffect(() => {
+        if (isEqual(previousRef.current, value))
+            return;
+        previousRef.current = value;
+        onChange?.(value);
+    }, [value]);
+}

package/index.d.ts

@@ -1,3 +1,3 @@
 export * as components from './components/index.js'
-export * as node from './node/index.js'
 export * as agnostic from './agnostic/index.js'
+export * as node from './node/index.js'

package/index.js

@@ -1,3 +1,3 @@
 export * as components from './components/index.js'
-export * as node from './node/index.js'
 export * as agnostic from './agnostic/index.js'
+export * as node from './node/index.js'

package/node/@aws-s3/storage/directory/index.d.ts

@@ -1,4 +1,4 @@
-export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as moveDir from './move-dir/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-dir/index.js'

package/node/@aws-s3/storage/directory/index.js

@@ -1,4 +1,4 @@
-export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as moveDir from './move-dir/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-dir/index.js'

package/node/@aws-s3/storage/file/index.d.ts

@@ -1,6 +1,6 @@
 export * as copy from './copy/index.js'
-export * as exists from './exists/index.js'
 export * as download from './download/index.js'
+export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'

package/node/@aws-s3/storage/file/index.js

@@ -1,6 +1,6 @@
 export * as copy from './copy/index.js'
-export * as exists from './exists/index.js'
 export * as download from './download/index.js'
+export * as exists from './exists/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'

package/node/@aws-s3/storage/index.d.ts

@@ -1,2 +1,2 @@
-export * as directory from './directory/index.js'
 export * as file from './file/index.js'
+export * as directory from './directory/index.js'

package/node/@aws-s3/storage/index.js

@@ -1,2 +1,2 @@
-export * as directory from './directory/index.js'
 export * as file from './file/index.js'
+export * as directory from './directory/index.js'

package/node/@google-cloud/storage/directory/index.d.ts

@@ -1,4 +1,4 @@
-export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as moveDir from './move-dir/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-dir/index.js'

package/node/@google-cloud/storage/directory/index.js

@@ -1,4 +1,4 @@
-export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as moveDir from './move-dir/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-dir/index.js'

package/node/@google-cloud/storage/file/index.d.ts

@@ -6,7 +6,7 @@ export * as getMetadata from './get-metadata/index.js'
 export * as getPermissions from './get-permissions/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
-export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as stat from './stat/index.js'
-export * as updateMetadata from './update-metadata/index.js'
+export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as upload from './upload/index.js'
+export * as updateMetadata from './update-metadata/index.js'

package/node/@google-cloud/storage/file/index.js

@@ -6,7 +6,7 @@ export * as getMetadata from './get-metadata/index.js'
 export * as getPermissions from './get-permissions/index.js'
 export * as move from './move/index.js'
 export * as remove from './remove/index.js'
-export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as stat from './stat/index.js'
-export * as updateMetadata from './update-metadata/index.js'
+export * as revokeSignedUrls from './revoke-signed-urls/index.js'
 export * as upload from './upload/index.js'
+export * as updateMetadata from './update-metadata/index.js'

package/node/@google-cloud/storage/index.d.ts

@@ -1,3 +1,3 @@
-export * as directory from './directory/index.js'
 export * as bucket from './bucket/index.js'
+export * as directory from './directory/index.js'
 export * as file from './file/index.js'

package/node/@google-cloud/storage/index.js

@@ -1,3 +1,3 @@
-export * as directory from './directory/index.js'
 export * as bucket from './bucket/index.js'
+export * as directory from './directory/index.js'
 export * as file from './file/index.js'

package/node/cloud-storage/operations/index.d.ts

@@ -1,7 +1,7 @@
-export * as copyDir from './copy-dir/index.js'
 export * as copyFile from './copy-file/index.js'
-export * as downloadFile from './download-file/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as existsFile from './exists-file/index.js'
+export * as downloadFile from './download-file/index.js'
 export * as listDir from './list-dir/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as moveFile from './move-file/index.js'

package/node/cloud-storage/operations/index.js

@@ -1,7 +1,7 @@
-export * as copyDir from './copy-dir/index.js'
 export * as copyFile from './copy-file/index.js'
-export * as downloadFile from './download-file/index.js'
+export * as copyDir from './copy-dir/index.js'
 export * as existsFile from './exists-file/index.js'
+export * as downloadFile from './download-file/index.js'
 export * as listDir from './list-dir/index.js'
 export * as moveDir from './move-dir/index.js'
 export * as moveFile from './move-file/index.js'

package/node/ftps/file/index.d.ts

@@ -1,7 +1,7 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
-export * as exists from './exists/index.js'
 export * as move from './move/index.js'
-export * as remove from './remove/index.js'
+export * as exists from './exists/index.js'
 export * as stat from './stat/index.js'
+export * as remove from './remove/index.js'
 export * as upload from './upload/index.js'

package/node/ftps/file/index.js

@@ -1,7 +1,7 @@
 export * as copy from './copy/index.js'
 export * as download from './download/index.js'
-export * as exists from './exists/index.js'
 export * as move from './move/index.js'
-export * as remove from './remove/index.js'
+export * as exists from './exists/index.js'
 export * as stat from './stat/index.js'
+export * as remove from './remove/index.js'
 export * as upload from './upload/index.js'

package/node/images/index.d.ts

@@ -1,5 +1,5 @@
 export * as create from './create/index.js'
-export * as metadata from './metadata/index.js'
 export * as format from './format/index.js'
+export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

package/node/images/index.js

@@ -1,5 +1,5 @@
 export * as create from './create/index.js'
-export * as metadata from './metadata/index.js'
 export * as format from './format/index.js'
+export * as metadata from './metadata/index.js'
 export * as transform from './transform/index.js'
 export * as utils from './utils/index.js'

package/node/images/transform/operations/index.d.ts

@@ -1,6 +1,6 @@
 export * as blur from './blur/index.js'
-export * as extend from './extend/index.js'
 export * as brighten from './brighten/index.js'
+export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
 export * as flatten from './flatten/index.js'
 export * as flip from './flip/index.js'
@@ -9,7 +9,7 @@ export * as hue from './hue/index.js'
 export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as overlay from './overlay/index.js'
 export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
+export * as overlay from './overlay/index.js'
 export * as saturate from './saturate/index.js'

package/node/images/transform/operations/index.js

@@ -1,6 +1,6 @@
 export * as blur from './blur/index.js'
-export * as extend from './extend/index.js'
 export * as brighten from './brighten/index.js'
+export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
 export * as flatten from './flatten/index.js'
 export * as flip from './flip/index.js'
@@ -9,7 +9,7 @@ export * as hue from './hue/index.js'
 export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as overlay from './overlay/index.js'
 export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
+export * as overlay from './overlay/index.js'
 export * as saturate from './saturate/index.js'

package/node/index.d.ts

@@ -4,8 +4,8 @@ export * as express from './@express/index.js'
 export * as googleCloud from './@google-cloud/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'
-export * as ftps from './ftps/index.js'
 export * as files from './files/index.js'
+export * as ftps from './ftps/index.js'
 export * as images from './images/index.js'
 export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'

package/node/index.js

@@ -4,8 +4,8 @@ export * as express from './@express/index.js'
 export * as googleCloud from './@google-cloud/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'
-export * as ftps from './ftps/index.js'
 export * as files from './files/index.js'
+export * as ftps from './ftps/index.js'
 export * as images from './images/index.js'
 export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'

package/node/process/index.d.ts

@@ -1,3 +1,3 @@
 export * as onExit from './on-exit/index.js'
-export * as promptContinue from './prompt-continue/index.js'
 export * as spawner from './spawner/index.js'
+export * as promptContinue from './prompt-continue/index.js'

package/node/process/index.js

@@ -1,3 +1,3 @@
 export * as onExit from './on-exit/index.js'
-export * as promptContinue from './prompt-continue/index.js'
 export * as spawner from './spawner/index.js'
+export * as promptContinue from './prompt-continue/index.js'

package/node/sftp/file/index.d.ts

@@ -1,7 +1,7 @@
-export * as copy from './copy/index.js'
 export * as download from './download/index.js'
-export * as exists from './exists/index.js'
+export * as copy from './copy/index.js'
 export * as move from './move/index.js'
+export * as exists from './exists/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
 export * as upload from './upload/index.js'

package/node/sftp/file/index.js

@@ -1,7 +1,7 @@
-export * as copy from './copy/index.js'
 export * as download from './download/index.js'
-export * as exists from './exists/index.js'
+export * as copy from './copy/index.js'
 export * as move from './move/index.js'
+export * as exists from './exists/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
 export * as upload from './upload/index.js'

package/node/sftp/index.d.ts

@@ -1,2 +1,2 @@
-export * as directory from './directory/index.js'
 export * as file from './file/index.js'
+export * as directory from './directory/index.js'

package/node/sftp/index.js

@@ -1,2 +1,2 @@
-export * as directory from './directory/index.js'
 export * as file from './file/index.js'
+export * as directory from './directory/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",
@@ -1290,6 +1290,10 @@
     "./agnostic/time/dates/format-date/index.js": {
       "import": "./agnostic/time/dates/format-date/index.js"
     },
+    "./agnostic/time/dates/format-date/types.js": {
+      "import": "./agnostic/time/dates/format-date/types.js",
+      "types": "./agnostic/time/dates/format-date/types.d.ts"
+    },
     "./agnostic/time/dates/index.js": {
       "import": "./agnostic/time/dates/index.js"
     },
@@ -1308,6 +1312,17 @@
       "import": "./agnostic/time/duration/index.js",
       "types": "./agnostic/time/duration/index.d.ts"
     },
+    "./agnostic/time/duration/format-duration": {
+      "import": "./agnostic/time/duration/format-duration/index.js",
+      "types": "./agnostic/time/duration/format-duration/index.d.ts"
+    },
+    "./agnostic/time/duration/format-duration/index.js": {
+      "import": "./agnostic/time/duration/format-duration/index.js"
+    },
+    "./agnostic/time/duration/format-duration/types.js": {
+      "import": "./agnostic/time/duration/format-duration/types.js",
+      "types": "./agnostic/time/duration/format-duration/types.d.ts"
+    },
     "./agnostic/time/duration/index.js": {
       "import": "./agnostic/time/duration/index.js"
     },
@@ -1451,6 +1466,10 @@
     "./components/JsonEditor/index.js": {
       "import": "./components/JsonEditor/index.js"
     },
+    "./components/JsonEditor/types.js": {
+      "import": "./components/JsonEditor/types.js",
+      "types": "./components/JsonEditor/types.d.ts"
+    },
     "./components/ListLoader": {
       "import": "./components/ListLoader/index.js",
       "types": "./components/ListLoader/index.d.ts"
@@ -1521,10 +1540,6 @@
     "./components/Subtitles/index.js": {
       "import": "./components/Subtitles/index.js"
     },
-    "./components/Subtitles/types.js": {
-      "import": "./components/Subtitles/types.js",
-      "types": "./components/Subtitles/types.d.ts"
-    },
     "./components/Textarea": {
       "import": "./components/Textarea/index.js",
       "types": "./components/Textarea/index.d.ts"