@design-edito/tools 0.4.20 → 0.4.21

package/agnostic/arrays/index.d.ts

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
 export * as isArrayOf from './is-array-of/index.js'
-export * as randomPick from './random-pick/index.js'
 export * as make from './make/index.js'
+export * as randomPick from './random-pick/index.js'
 export * as shuffle from './shuffle/index.js'

package/agnostic/arrays/index.js

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
 export * as isArrayOf from './is-array-of/index.js'
-export * as randomPick from './random-pick/index.js'
 export * as make from './make/index.js'
+export * as randomPick from './random-pick/index.js'
 export * as shuffle from './shuffle/index.js'

package/agnostic/colors/index.d.ts

@@ -1,6 +1,7 @@
-export * as contrast from './contrast/index.js'
 export * as channels from './channels/index.js'
+export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
+export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
 export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
@@ -9,4 +10,3 @@ export * as palette from './palette/index.js'
 export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as distance from './distance/index.js'

package/agnostic/colors/index.js

@@ -1,6 +1,7 @@
-export * as contrast from './contrast/index.js'
 export * as channels from './channels/index.js'
+export * as contrast from './contrast/index.js'
 export * as convert from './convert/index.js'
+export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
 export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
@@ -9,4 +10,3 @@ export * as palette from './palette/index.js'
 export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
 export * as typechecks from './typechecks/index.js'
-export * as distance from './distance/index.js'

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
+export * as bem from './bem/index.js'
 export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
-export * as isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as scale from './scale/index.js'
+export * as isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as stylesSet from './styles-set/index.js'
-export * as bem from './bem/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
+export * as bem from './bem/index.js'
 export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
-export * as isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as scale from './scale/index.js'
+export * as isValidCssClassName from './is-valid-css-class-name/index.js'
 export * as stylesSet from './styles-set/index.js'
-export * as bem from './bem/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts

@@ -1,52 +1,52 @@
 export * as add from './add/index.js'
-export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as equals from './equals/index.js'
+export * as addclass from './addclass/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
-export * as equals from './equals/index.js'
-export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
+export * as hjstringify from './hjstringify/index.js'
 export * as initialize from './initialize/index.js'
-export * as length from './length/index.js'
 export * as join from './join/index.js'
-export * as negate from './negate/index.js'
+export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as notrailing from './notrailing/index.js'
+export * as negate from './negate/index.js'
+export * as pickrandom from './pickrandom/index.js'
 export * as or from './or/index.js'
 export * as populate from './populate/index.js'
-export * as pickrandom from './pickrandom/index.js'
 export * as print from './print/index.js'
-export * as map from './map/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as push from './push/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
-export * as renameproperty from './renameproperty/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as replace from './replace/index.js'
-export * as set from './set/index.js'
-export * as setattribute from './setattribute/index.js'
+export * as renameproperty from './renameproperty/index.js'
 export * as select from './select/index.js'
-export * as sorton from './sorton/index.js'
+export * as set from './set/index.js'
+export * as replace from './replace/index.js'
 export * as setproperty from './setproperty/index.js'
-export * as spread from './spread/index.js'
+export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
+export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
 export * as toggleclass from './toggleclass/index.js'
-export * as toboolean from './toboolean/index.js'
+export * as setattribute from './setattribute/index.js'
+export * as tonull from './tonull/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
-export * as tonull from './tonull/index.js'
 export * as toref from './toref/index.js'
+export * as totext from './totext/index.js'
 export * as tostring from './tostring/index.js'
 export * as transformselected from './transformselected/index.js'
-export * as totext from './totext/index.js'
 export * as trim from './trim/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.js

@@ -1,52 +1,52 @@
 export * as add from './add/index.js'
-export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as equals from './equals/index.js'
+export * as addclass from './addclass/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
-export * as equals from './equals/index.js'
-export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
+export * as hjstringify from './hjstringify/index.js'
 export * as initialize from './initialize/index.js'
-export * as length from './length/index.js'
 export * as join from './join/index.js'
-export * as negate from './negate/index.js'
+export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as notrailing from './notrailing/index.js'
+export * as negate from './negate/index.js'
+export * as pickrandom from './pickrandom/index.js'
 export * as or from './or/index.js'
 export * as populate from './populate/index.js'
-export * as pickrandom from './pickrandom/index.js'
 export * as print from './print/index.js'
-export * as map from './map/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as push from './push/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
 export * as removeattribute from './removeattribute/index.js'
-export * as renameproperty from './renameproperty/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as replace from './replace/index.js'
-export * as set from './set/index.js'
-export * as setattribute from './setattribute/index.js'
+export * as renameproperty from './renameproperty/index.js'
 export * as select from './select/index.js'
-export * as sorton from './sorton/index.js'
+export * as set from './set/index.js'
+export * as replace from './replace/index.js'
 export * as setproperty from './setproperty/index.js'
-export * as spread from './spread/index.js'
+export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
+export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
 export * as toggleclass from './toggleclass/index.js'
-export * as toboolean from './toboolean/index.js'
+export * as setattribute from './setattribute/index.js'
+export * as tonull from './tonull/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
-export * as tonull from './tonull/index.js'
 export * as toref from './toref/index.js'
+export * as totext from './totext/index.js'
 export * as tostring from './tostring/index.js'
 export * as transformselected from './transformselected/index.js'
-export * as totext from './totext/index.js'
 export * as trim from './trim/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts

@@ -1,12 +1,12 @@
 export * as any from './any/index.js'
 export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
-export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
+export * as element from './element/index.js'
 export * as nodelist from './nodelist/index.js'
-export * as null from './null/index.js'
 export * as number from './number/index.js'
+export * as null from './null/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'
 export * as string from './string/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.js

@@ -1,12 +1,12 @@
 export * as any from './any/index.js'
 export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
-export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
+export * as element from './element/index.js'
 export * as nodelist from './nodelist/index.js'
-export * as null from './null/index.js'
 export * as number from './number/index.js'
+export * as null from './null/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'
 export * as string from './string/index.js'

package/agnostic/html/index.d.ts

@@ -1,10 +1,10 @@
 export * as deepSelect from './deep-select/index.js'
 export * as getNodeAncestors from './get-node-ancestors/index.js'
-export * as hyperJson from './hyper-json/index.js'
 export * as getPositionInsideParent from './get-position-inside-parent/index.js'
+export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
-export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
+export * as placeholders from './placeholders/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'

package/agnostic/html/index.js

@@ -1,10 +1,10 @@
 export * as deepSelect from './deep-select/index.js'
 export * as getNodeAncestors from './get-node-ancestors/index.js'
-export * as hyperJson from './hyper-json/index.js'
 export * as getPositionInsideParent from './get-position-inside-parent/index.js'
+export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
-export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
+export * as placeholders from './placeholders/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'

package/agnostic/index.d.ts

@@ -1,13 +1,13 @@
-export * as booleans from './booleans/index.js'
 export * as arrays from './arrays/index.js'
+export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
 export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
-export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as objects from './objects/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/index.js

@@ -1,13 +1,13 @@
-export * as booleans from './booleans/index.js'
 export * as arrays from './arrays/index.js'
+export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
 export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
-export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
+export * as objects from './objects/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
 export * as sanitization from './sanitization/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
-export * as cast from './cast/index.js'
 export * as assert from './assert/index.js'
+export * as cast from './cast/index.js'
 export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
 export * as dataSize from './data-size/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
-export * as logs from './logs/index.js'
 export * as isNullish from './is-nullish/index.js'
-export * as normalizeExtension from './normalize-extension/index.js'
+export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
+export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
-export * as cast from './cast/index.js'
 export * as assert from './assert/index.js'
+export * as cast from './cast/index.js'
 export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
 export * as dataSize from './data-size/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
-export * as logs from './logs/index.js'
 export * as isNullish from './is-nullish/index.js'
-export * as normalizeExtension from './normalize-extension/index.js'
+export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
+export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as interpolate from './interpolate/index.js'
 export * as round from './round/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as interpolate from './interpolate/index.js'
 export * as round from './round/index.js'

package/agnostic/sanitization/index.d.ts

@@ -1,4 +1,4 @@
 export * as fileName from './file-name/index.js'
-export * as path from './path/index.js'
 export * as html from './html/index.js'
+export * as path from './path/index.js'
 export * as userInput from './user-input/index.js'

package/agnostic/sanitization/index.js

@@ -1,4 +1,4 @@
 export * as fileName from './file-name/index.js'
-export * as path from './path/index.js'
 export * as html from './html/index.js'
+export * as path from './path/index.js'
 export * as userInput from './user-input/index.js'

package/agnostic/strings/index.d.ts

@@ -1,8 +1,8 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
-export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
-export * as trim from './trim/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
+export * as trim from './trim/index.js'

package/agnostic/strings/index.js

@@ -1,8 +1,8 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
-export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
-export * as trim from './trim/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
+export * as trim from './trim/index.js'

package/components/Button/index.d.ts

@@ -1,7 +1,27 @@
 import { type FunctionComponent, type ButtonHTMLAttributes, type ReactNode } from 'react';
 import type { WithClassName } from '../utils/types.js';
+/**
+ * Props for the {@link Button} component.
+ *
+ * Extends all native {@link ButtonHTMLAttributes} and {@link WithClassName}
+ * with optional label and error content.
+ *
+ * @property label - Content rendered as the button label.
+ * @property error - Content rendered to convey an error state associated with the button.
+ * @property className - Additional class name(s) applied to the root element.
+ */
 export type Props = ButtonHTMLAttributes<HTMLButtonElement> & WithClassName<{
     label?: ReactNode;
     error?: ReactNode;
 }>;
+/**
+ * Base button component.
+ *
+ * Renders a native `<button>` element with scoped class names applied.
+ * All standard button attributes are forwarded to the underlying element.
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A styled native button element.
+ */
 export declare const Button: FunctionComponent<Props>;

package/components/Button/index.js

@@ -3,6 +3,16 @@ import { clss } from '../../agnostic/css/clss/index.js';
 import { mergeClassNames } from '../utils/index.js';
 import { button as publicClassName } from '../public-classnames.js';
 import cssModule from './styles.module.css';
+/**
+ * Base button component.
+ *
+ * Renders a native `<button>` element with scoped class names applied.
+ * All standard button attributes are forwarded to the underlying element.
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A styled native button element.
+ */
 export const Button = ({ label, error, className, ...rest }) => {
     const c = clss(publicClassName, { cssModule });
     const rootClss = mergeClassNames(c(null), className);

package/components/Input/index.d.ts

@@ -1,7 +1,33 @@
 import { type FunctionComponent, type InputHTMLAttributes, type ReactNode } from 'react';
 import type { WithClassName } from '../utils/types.js';
+/**
+ * Props for the {@link Input} component.
+ *
+ * Extends all native {@link InputHTMLAttributes} and {@link WithClassName}
+ * with optional label and error content.
+ *
+ * @property label - Content rendered as an associated `<label>`. When omitted, no label is rendered.
+ * @property error - Content rendered as an error message below the input. When omitted, no error is rendered.
+ * @property className - Additional class name(s) applied to the root element.
+ */
 export type Props = InputHTMLAttributes<HTMLInputElement> & WithClassName<{
     label?: ReactNode;
     error?: ReactNode;
 }>;
+/**
+ * Input field component with optional label and error message.
+ *
+ * Renders a native `<input>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard input attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `input`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled input wrapper with optional error feedback.
+ */
 export declare const Input: FunctionComponent<Props>;

package/components/Input/index.js

@@ -6,6 +6,22 @@ import { randomHash } from '../../agnostic/random/uuid/index.js';
 import { input as publicClassName } from '../public-classnames.js';
 import { mergeClassNames } from '../utils/index.js';
 import cssModule from './styles.module.css';
+/**
+ * Input field component with optional label and error message.
+ *
+ * Renders a native `<input>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard input attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `input`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled input wrapper with optional error feedback.
+ */
 export const Input = ({ label, error, className, ...rest }) => {
     const [id] = useState(`_${randomHash(12)}`);
     const c = clss(publicClassName, { cssModule });

package/components/JsonEditor/index.d.ts

@@ -5,12 +5,51 @@ type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {
     [k: string]: JsonValue;
 };
+/**
+ * Props for the {@link JsonEditor} component.
+ *
+ * @property defaultValue - Initial JSON value rendered by the editor. Defaults to `null`.
+ * @property onChange - Called after any value change with the updated JSON value.
+ * @property onValidationError - Called when the updated value fails schema validation,
+ * with the list of Zod issues. Not called when no `schema` is provided.
+ * @property schema - Optional Zod schema used to validate the value after each change.
+ * When provided, validation runs after `onChange` is dispatched.
+ * @property className - Additional class name(s) applied to the root element.
+ */
 export type Props = WithClassName<{
     defaultValue?: JsonValue;
     onChange?: (val: JsonValue) => void;
     onValidationError?: (issues: core.$ZodIssue[]) => void;
     schema?: ZodType<JsonValue>;
 }>;
+/**
+ * Interactive JSON editor component.
+ *
+ * Renders a recursive value editor tree alongside a live JSON preview.
+ * Supports all JSON value types: strings, numbers, booleans, null, arrays,
+ * and records. Each node exposes a type selector and a type-appropriate input.
+ *
+ * When a `schema` is provided, the current value is validated against it after
+ * every change. Validation errors are reported through `onValidationError` and
+ * do not block editing.
+ *
+ * ### CSS elements
+ * - `value` — wraps each node in the editor tree; receives a type modifier
+ *   matching the current value type (`string`, `number`, `boolean`, `null`, `array`, `record`).
+ * - `type` — the type selector control.
+ * - `string`, `number`, `boolean`, `null` — primitive value inputs.
+ * - `record` — record entry list.
+ * - `array` — array entry list items.
+ * - `prop-name` — key input for record entries.
+ * - `create-prop` — button to append a new entry to a record or array.
+ * - `delete-prop` — button to remove an existing entry.
+ * - `lift-prop` — button to move an array entry up.
+ * - `drop-prop` — button to move an array entry down.
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A recursive JSON value editor with a live serialized preview.
+ */
 export declare const JsonEditor: FunctionComponent<Props>;
 export declare const ValueEditor: FunctionComponent<{
     defaultValue?: JsonValue;

package/components/JsonEditor/index.js

@@ -10,7 +10,36 @@ import { Textarea } from '../Textarea/index.js';
 import { mergeClassNames } from '../utils/index.js';
 import { jsonEditor as publicClassName } from '../public-classnames.js';
 import cssModule from './styles.module.css';
+/* Shared across all sub components */
 const c = clss(publicClassName, { cssModule });
+/**
+ * Interactive JSON editor component.
+ *
+ * Renders a recursive value editor tree alongside a live JSON preview.
+ * Supports all JSON value types: strings, numbers, booleans, null, arrays,
+ * and records. Each node exposes a type selector and a type-appropriate input.
+ *
+ * When a `schema` is provided, the current value is validated against it after
+ * every change. Validation errors are reported through `onValidationError` and
+ * do not block editing.
+ *
+ * ### CSS elements
+ * - `value` — wraps each node in the editor tree; receives a type modifier
+ *   matching the current value type (`string`, `number`, `boolean`, `null`, `array`, `record`).
+ * - `type` — the type selector control.
+ * - `string`, `number`, `boolean`, `null` — primitive value inputs.
+ * - `record` — record entry list.
+ * - `array` — array entry list items.
+ * - `prop-name` — key input for record entries.
+ * - `create-prop` — button to append a new entry to a record or array.
+ * - `delete-prop` — button to remove an existing entry.
+ * - `lift-prop` — button to move an array entry up.
+ * - `drop-prop` — button to move an array entry down.
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A recursive JSON value editor with a live serialized preview.
+ */
 export const JsonEditor = ({ defaultValue = null, onChange, onValidationError, schema, className }) => {
     const [value, setValue] = useState(defaultValue);
     const setValueAndDispatch = (val) => {
@@ -31,6 +60,11 @@ export const JsonEditor = ({ defaultValue = null, onChange, onValidationError, s
     const rootClss = mergeClassNames(c(null, {}), className);
     return _jsxs("div", { className: rootClss, children: [_jsx(ValueEditor, { defaultValue: defaultValue, onChange: val => setValueAndDispatch(val), path: [] }), _jsx("pre", { children: JSON.stringify(value, null, 2) })] });
 };
+/* * * * * * * * * * * * * * * * *
+ *
+ * Value
+ *
+ * * * * * * * * * * * * * * * * */
 export const ValueEditor = ({ defaultValue = {}, onChange, path = [] }) => {
     // State
     const [value, setValue] = useState(defaultValue);
@@ -71,12 +105,37 @@ export const ValueEditor = ({ defaultValue = {}, onChange, path = [] }) => {
     const pathStringDataAttr = (path ?? []).map(e => e.toString()).join('.');
     return _jsxs("span", { className: valueEditorClss, "data-path": pathStringDataAttr, children: [_jsxs(Select, { className: c('type'), onChange: handleTypeSelectChange, children: [_jsx("option", { value: 'string', selected: typeof value === 'string', children: "string" }), _jsx("option", { value: 'number', selected: typeof value === 'number', children: "number" }), _jsx("option", { value: 'boolean', selected: typeof value === 'boolean', children: "boolean" }), _jsx("option", { value: 'null', selected: value === null, children: "null" }), _jsx("option", { value: 'record', selected: isNonNullObject(value) && !Array.isArray(value), children: "record" }), _jsx("option", { value: 'array', selected: Array.isArray(value), children: "array" })] }), typeof value === 'string' && _jsx(StringEditor, { type: 'textarea', defaultValue: value, onChange: handleStringValueChange }), typeof value === 'number' && _jsx(NumberEditor, { defaultValue: value, onChange: handleNumberValueChange }), typeof value === 'boolean' && _jsx(BooleanEditor, { defaultValue: value, onChange: handleBooleanValueChange }), value === null && _jsx(NullEditor, { defaultValue: value }), isNonNullObject(value) && !Array.isArray(value) && _jsx(RecordEditor, { defaultValue: value, onChange: handleRecordValueChange, path: path }), Array.isArray(value) && _jsx(ArrayEditor, { defaultValue: value, onChange: handleArrayValueChange, path: path })] });
 };
+/* * * * * * * * * * * * * * * * *
+ *
+ * String
+ *
+ * * * * * * * * * * * * * * * * */
 const StringEditor = (props) => props.type === 'textarea'
     ? _jsx(Textarea, { className: c('string'), defaultValue: props.defaultValue ?? '', onChange: props.onChange })
     : _jsx(Input, { type: 'text', className: c('string'), defaultValue: props.defaultValue ?? '', onChange: props.onChange });
+/* * * * * * * * * * * * * * * * *
+ *
+ * Number
+ *
+ * * * * * * * * * * * * * * * * */
 const NumberEditor = (props) => _jsx(Input, { className: c('number'), type: 'number', defaultValue: props.defaultValue ?? 0, onChange: props.onChange });
+/* * * * * * * * * * * * * * * * *
+ *
+ * Boolean
+ *
+ * * * * * * * * * * * * * * * * */
 const BooleanEditor = (props) => _jsx(Input, { className: c('boolean'), type: 'checkbox', defaultChecked: props.defaultValue ?? false, onChange: props.onChange });
+/* * * * * * * * * * * * * * * * *
+ *
+ * Null
+ *
+ * * * * * * * * * * * * * * * * */
 const NullEditor = () => _jsx("span", { className: c('null'), children: "null" });
+/* * * * * * * * * * * * * * * * *
+ *
+ * Record
+ *
+ * * * * * * * * * * * * * * * * */
 const RecordEditor = ({ defaultValue = {}, onChange, path }) => {
     const [value, setValue] = useState(new Map(Object
         .entries(defaultValue)
@@ -124,6 +183,11 @@ const RecordEditor = ({ defaultValue = {}, onChange, path }) => {
     };
     return _jsxs("ul", { className: c('record'), children: [Array.from(value).map(([key, { id, val }]) => _jsxs("li", { "data-key": key, "data-path": [...(path ?? []), key].join('.'), children: [_jsx("button", { className: c('delete-prop'), onClick: () => handleDeleteProp(key), children: "x" }), _jsx("span", { className: c('prop-name'), children: _jsx(StringEditor, { type: 'input', defaultValue: key, onChange: handleRenameProp(key) }) }), _jsx(ValueEditor, { defaultValue: val, onChange: handleChangeProp(key), path: [...(path ?? []), key] })] }, id)), _jsx("button", { className: c('create-prop'), onClick: handleCreateProp, children: "+" })] });
 };
+/* * * * * * * * * * * * * * * * *
+ *
+ * Array
+ *
+ * * * * * * * * * * * * * * * * */
 const ArrayEditor = ({ defaultValue = [], onChange, path }) => {
     const [value, setValue] = useState(new Map(defaultValue.map(val => [randomHash(8), val])));
     const setValueAndDispatch = (newValue) => {

package/components/Select/index.d.ts

@@ -1,7 +1,34 @@
 import { type FunctionComponent, type SelectHTMLAttributes, type ReactNode, type PropsWithChildren } from 'react';
 import type { WithClassName } from '../utils/types.js';
+/**
+ * Props for the {@link Select} component.
+ *
+ * Extends all native {@link SelectHTMLAttributes} and {@link WithClassName}
+ * with optional label, error content, and option children.
+ *
+ * @property label - Content rendered as an associated `<label>`. When omitted, no label is rendered.
+ * @property error - Content rendered as an error message below the select. When omitted, no error is rendered.
+ * @property className - Additional class name(s) applied to the root element.
+ * @property children - `<option>` or `<optgroup>` elements rendered inside the select.
+ */
 export type Props = SelectHTMLAttributes<HTMLSelectElement> & PropsWithChildren<WithClassName<{
     label?: ReactNode;
     error?: ReactNode;
 }>>;
+/**
+ * Select field component with optional label and error message.
+ *
+ * Renders a native `<select>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard select attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `select`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled select wrapper with optional error feedback.
+ */
 export declare const Select: FunctionComponent<Props>;

package/components/Select/index.js

@@ -6,6 +6,22 @@ import { randomHash } from '../../agnostic/random/uuid/index.js';
 import { select as publicClassName } from '../public-classnames.js';
 import { mergeClassNames } from '../utils/index.js';
 import cssModule from './styles.module.css';
+/**
+ * Select field component with optional label and error message.
+ *
+ * Renders a native `<select>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard select attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `select`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled select wrapper with optional error feedback.
+ */
 export const Select = ({ label, error, className, children, ...rest }) => {
     const [id] = useState(`_${randomHash(12)}`);
     const c = clss(publicClassName, { cssModule });

package/components/Textarea/index.d.ts

@@ -1,7 +1,33 @@
 import { type FunctionComponent, type TextareaHTMLAttributes, type ReactNode } from 'react';
 import type { WithClassName } from '../utils/types.js';
+/**
+ * Props for the {@link Textarea} component.
+ *
+ * Extends all native {@link TextareaHTMLAttributes} and {@link WithClassName}
+ * with optional label and error content.
+ *
+ * @property label - Content rendered as an associated `<label>`. When omitted, no label is rendered.
+ * @property error - Content rendered as an error message below the textarea. When omitted, no error is rendered.
+ * @property className - Additional class name(s) applied to the root element.
+ */
 export type Props = TextareaHTMLAttributes<HTMLTextAreaElement> & WithClassName<{
     label?: ReactNode;
     error?: ReactNode;
 }>;
+/**
+ * Textarea field component with optional label and error message.
+ *
+ * Renders a native `<textarea>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard textarea attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `textarea`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled textarea wrapper with optional error feedback.
+ */
 export declare const Textarea: FunctionComponent<Props>;

package/components/Textarea/index.js

@@ -6,6 +6,22 @@ import { randomHash } from '../../agnostic/random/uuid/index.js';
 import { textarea as publicClassName } from '../public-classnames.js';
 import { mergeClassNames } from '../utils/index.js';
 import cssModule from './styles.module.css';
+/**
+ * Textarea field component with optional label and error message.
+ *
+ * Renders a native `<textarea>` element inside a wrapper, with a stable
+ * auto-generated `id` used to associate the label via `htmlFor`.
+ * All standard textarea attributes are forwarded to the underlying element.
+ *
+ * ### CSS elements
+ * - `label`
+ * - `textarea`
+ * - `error`
+ *
+ * @param props - Component properties.
+ * @see {@link Props}
+ * @returns A labelled textarea wrapper with optional error feedback.
+ */
 export const Textarea = ({ label, error, className, ...rest }) => {
     const [id] = useState(`_${randomHash(12)}`);
     const c = clss(publicClassName, { cssModule });

package/components/index.d.ts

@@ -1,8 +1,8 @@
 export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/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 drawer from './Drawer/index.js'
 export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
 export * as iframe from './Iframe/index.js'

package/components/index.js

@@ -1,8 +1,8 @@
 export * as beforeAfter from './BeforeAfter/index.js'
 export * as button from './Button/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 drawer from './Drawer/index.js'
 export * as eventListener from './EventListener/index.js'
 export * as gallery from './Gallery/index.js'
 export * as iframe from './Iframe/index.js'

package/index.d.ts

@@ -1,3 +1,3 @@
-export * as agnostic from './agnostic/index.js'
 export * as components from './components/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 agnostic from './agnostic/index.js'
 export * as components from './components/index.js'
+export * as agnostic from './agnostic/index.js'
 export * as node from './node/index.js'

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

@@ -8,5 +8,5 @@ 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 upload from './upload/index.js'
 export * as updateMetadata from './update-metadata/index.js'
+export * as upload from './upload/index.js'

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

@@ -8,5 +8,5 @@ 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 upload from './upload/index.js'
 export * as updateMetadata from './update-metadata/index.js'
+export * as upload from './upload/index.js'

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

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

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

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

package/node/ftps/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 list from './list/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/ftps/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 list from './list/index.js'
 export * as removeDir from './remove-dir/index.js'

package/node/images/index.d.ts

@@ -1,5 +1,5 @@
 export * as create from './create/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'
-export * as format from './format/index.js'

package/node/images/index.js

@@ -1,5 +1,5 @@
 export * as create from './create/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'
-export * as format from './format/index.js'

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

@@ -10,6 +10,6 @@ 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 rotate from './rotate/index.js'
-export * as saturate from './saturate/index.js'
 export * as resize from './resize/index.js'
+export * as saturate from './saturate/index.js'
+export * as rotate from './rotate/index.js'

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

@@ -10,6 +10,6 @@ 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 rotate from './rotate/index.js'
-export * as saturate from './saturate/index.js'
 export * as resize from './resize/index.js'
+export * as saturate from './saturate/index.js'
+export * as rotate from './rotate/index.js'

package/node/index.d.ts

@@ -7,5 +7,5 @@ export * as encryption from './encryption/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'
+export * as process from './process/index.js'

package/node/index.js

@@ -7,5 +7,5 @@ export * as encryption from './encryption/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'
+export * as process from './process/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.4.20",
+  "version": "0.4.21",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",