react-cheminfo 0.3.0 → 0.4.0

package/lib/structure/ui/StructurePlaceholder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The box a depiction leaves behind when there is no picture in it — nothing
+ * to draw, a notation that cannot be read, or the moment before the renderers
+ * have been downloaded.
+ *
+ * It is kept apart from the renderers on purpose: it pulls nothing in, so both
+ * sides of the `React.lazy` boundary in `Structure` can use it.
+ */
+import type { ReactElement, ReactNode } from 'react';
+/** Props of {@link StructurePlaceholder}. */
+export interface StructurePlaceholderProps {
+    /** Width of the box, in pixels: the width the picture would have had. */
+    width: number;
+    /** Height of the box, in pixels. */
+    height: number;
+    /**
+     * What is written in the middle of the box.
+     * @default undefined
+     */
+    children?: ReactNode;
+}
+/**
+ * A box the size of the picture that is not there, holding whatever the caller
+ * wants said instead.
+ * @param props - See {@link StructurePlaceholderProps}.
+ * @returns The placeholder.
+ */
+export declare function StructurePlaceholder(props: StructurePlaceholderProps): ReactElement;
+//# sourceMappingURL=StructurePlaceholder.d.ts.map

package/lib/structure/ui/StructurePlaceholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructurePlaceholder.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,YAAY,CAOd"}

package/lib/structure/ui/StructurePlaceholder.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * A box the size of the picture that is not there, holding whatever the caller
+ * wants said instead.
+ * @param props - See {@link StructurePlaceholderProps}.
+ * @returns The placeholder.
+ */
+export function StructurePlaceholder(props) {
+    const { width, height, children } = props;
+    return (_jsx("span", { style: { ...PLACEHOLDER_STYLE, width, height }, "aria-hidden": "true", children: children }));
+}
+const PLACEHOLDER_STYLE = {
+    display: 'inline-flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    color: '#8a96a3',
+    fontSize: '0.75rem',
+};
+//# sourceMappingURL=StructurePlaceholder.js.map

package/lib/structure/ui/StructurePlaceholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructurePlaceholder.js","sourceRoot":"","sources":["../../../src/structure/ui/StructurePlaceholder.tsx"],"names":[],"mappings":";AAwBA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC1C,OAAO,CACL,eAAM,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAc,MAAM,YACrE,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAkB;IACvC,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,QAAQ;IACxB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;CACpB,CAAC"}

package/lib/structure/ui/StructureSvg.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The react-ocl depiction of a structure whose notation has already been
+ * picked.
+ *
+ * `Structure` holds it behind `React.lazy`, and the barrel deliberately does
+ * not export it: this is the file that value-imports react-ocl, so
+ * anything able to reach it statically drags openchemlib into every bundle,
+ * including the ones that only ever wanted the Tools menu.
+ */
+import type { ReactElement, ReactNode } from 'react';
+import type { StructureSource } from '../core/structureSource.ts';
+/** Props of {@link StructureSvg}. */
+export interface StructureSvgProps {
+    /** The notation to draw, as `structureSource` picked it. */
+    source: StructureSource;
+    /** Width of the picture, in pixels. */
+    width: number;
+    /** Height of the picture, in pixels. */
+    height: number;
+    /** Crop the picture to the atoms rather than centring them in the box. */
+    autoCrop: boolean;
+    /** Blank space kept around the structure when it is cropped, in pixels. */
+    autoCropMargin: number;
+    /**
+     * Atoms to paint, which is how a substructure match is shown.
+     * @default undefined
+     */
+    atomHighlight?: number[];
+    /** The colour the highlighted atoms are painted. */
+    atomHighlightColor: string;
+    /**
+     * Bonds to paint.
+     * @default undefined
+     */
+    bondHighlight?: number[];
+    /** The colour the highlighted bonds are painted. */
+    bondHighlightColor: string;
+    /** Write the index of every atom next to it. */
+    showAtomNumber: boolean;
+    /** Write the index of every bond next to it. */
+    showBondNumber: boolean;
+    /** Write the reaction mapping number of every mapped atom. */
+    showMapping: boolean;
+    /**
+     * A caption drawn inside the picture, under the structure.
+     * @default undefined
+     */
+    label?: string;
+    /** What is shown in place of a structure react-ocl refuses to read. */
+    fallback: ReactNode;
+}
+/**
+ * Draw the picture with the renderer the notation calls for.
+ * @param props - See {@link StructureSvgProps}.
+ * @returns The svg, or the placeholder when the notation cannot be read.
+ */
+export declare function StructureSvg(props: StructureSvgProps): ReactElement;
+//# sourceMappingURL=StructureSvg.d.ts.map

package/lib/structure/ui/StructureSvg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureSvg.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAsBnE"}

package/lib/structure/ui/StructureSvg.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { IdcodeSvgRenderer, MolfileSvgRenderer, SmilesSvgRenderer, } from 'react-ocl';
+import { StructurePlaceholder } from "./StructurePlaceholder.js";
+/**
+ * Draw the picture with the renderer the notation calls for.
+ * @param props - See {@link StructureSvgProps}.
+ * @returns The svg, or the placeholder when the notation cannot be read.
+ */
+export function StructureSvg(props) {
+    const { source, fallback, ...rest } = props;
+    const ErrorComponent = useMemo(() => createFallbackRenderer(fallback), [fallback]);
+    const shared = { ...rest, ErrorComponent };
+    if (source.kind === 'idcode') {
+        return (_jsx(IdcodeSvgRenderer, { idcode: source.value, coordinates: source.coordinates, ...shared }));
+    }
+    if (source.kind === 'molfile') {
+        return _jsx(MolfileSvgRenderer, { molfile: source.value, ...shared });
+    }
+    return _jsx(SmilesSvgRenderer, { smiles: source.value, ...shared });
+}
+/**
+ * Build the renderer react-ocl falls back to, so a structure it refuses looks
+ * like one that was never supplied rather than like an error.
+ * @param fallback - What the caller wants shown instead of the structure.
+ * @returns The component react-ocl renders in place of the picture.
+ */
+function createFallbackRenderer(fallback) {
+    return function StructureFallback(props) {
+        return (_jsx(StructurePlaceholder, { width: props.width, height: props.height, children: fallback }));
+    };
+}
+//# sourceMappingURL=StructureSvg.js.map

package/lib/structure/ui/StructureSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureSvg.js","sourceRoot":"","sources":["../../../src/structure/ui/StructureSvg.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA4B,CAAC;AA2ClE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAE5C,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EACtC,CAAC,QAAQ,CAAC,CACX,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,CAAC;IAE3C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,CACL,KAAC,iBAAiB,IAChB,MAAM,EAAE,MAAM,CAAC,KAAK,EACpB,WAAW,EAAE,MAAM,CAAC,WAAW,KAC3B,MAAM,GACV,CACH,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAC,kBAAkB,IAAC,OAAO,EAAE,MAAM,CAAC,KAAK,KAAM,MAAM,GAAI,CAAC;IACnE,CAAC;IACD,OAAO,KAAC,iBAAiB,IAAC,MAAM,EAAE,MAAM,CAAC,KAAK,KAAM,MAAM,GAAI,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAC7B,QAAmB;IAEnB,OAAO,SAAS,iBAAiB,CAAC,KAA0B;QAC1D,OAAO,CACL,KAAC,oBAAoB,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,YAC3D,QAAQ,GACY,CACxB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/lib/structure/ui/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What a site imports to show or to draw a structure.
+ *
+ * **Nothing exported here may pull react-ocl or openchemlib in statically.**
+ * `StructureSvg` and `EditorCanvas` are deliberately absent: re-exporting
+ * either would make react-ocl reachable from this barrel, the `React.lazy`
+ * boundaries inside `Structure` and `StructureEditor` would be defeated, and
+ * `react-cheminfo/structure` would stop being importable at all when those
+ * optional peers are not installed — which is what a site wanting only the
+ * Tools menu does. Type-only re-exports are erased and so are safe.
+ */
+export type { StructureEditorChange, StructureEditorMode, } from './EditorCanvas.tsx';
+export type { StructureLabels, StructureProps } from './Structure.tsx';
+export { Structure } from './Structure.tsx';
+export type { StructureEditorProps } from './StructureEditor.tsx';
+export { StructureEditor } from './StructureEditor.tsx';
+export type { ToolbarFloorOptions } from './useToolbarFloor.ts';
+export { useToolbarFloor } from './useToolbarFloor.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/structure/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/structure/ui/index.js

@@ -0,0 +1,15 @@
+/**
+ * What a site imports to show or to draw a structure.
+ *
+ * **Nothing exported here may pull react-ocl or openchemlib in statically.**
+ * `StructureSvg` and `EditorCanvas` are deliberately absent: re-exporting
+ * either would make react-ocl reachable from this barrel, the `React.lazy`
+ * boundaries inside `Structure` and `StructureEditor` would be defeated, and
+ * `react-cheminfo/structure` would stop being importable at all when those
+ * optional peers are not installed — which is what a site wanting only the
+ * Tools menu does. Type-only re-exports are erased and so are safe.
+ */
+export { Structure } from "./Structure.js";
+export { StructureEditor } from "./StructureEditor.js";
+export { useToolbarFloor } from "./useToolbarFloor.js";
+//# sourceMappingURL=index.js.map

package/lib/structure/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structure/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/structure/ui/useToolbarFloor.d.ts

@@ -0,0 +1,26 @@
+import type { RefObject } from 'react';
+export interface ToolbarFloorOptions {
+    /**
+     * Smallest height of the drawing area, in pixels. Raised to whatever the
+     * toolbar needs, which is usually more.
+     * @default 320
+     */
+    minHeight?: number;
+    /**
+     * Bumped to look for the toolbar again, which a caller does after the editor
+     * has been remounted and the previous toolbar element has gone.
+     * @default 0
+     */
+    revision?: number;
+}
+/**
+ * Give an editor's container a minimum height that shows the whole toolbar.
+ *
+ * The height is measured rather than written down, so a different button count
+ * — a fragment editor, a reaction editor, a future release — keeps working
+ * instead of clipping its last buttons behind whatever follows the editor.
+ * @param options - The height the caller asked for, and when to look again.
+ * @returns The ref to put on the element wrapping the editor.
+ */
+export declare function useToolbarFloor(options?: ToolbarFloorOptions): RefObject<HTMLDivElement | null>;
+//# sourceMappingURL=useToolbarFloor.d.ts.map

package/lib/structure/ui/useToolbarFloor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarFloor.d.ts","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,mBAAwB,GAChC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAyClC"}

package/lib/structure/ui/useToolbarFloor.js

@@ -0,0 +1,70 @@
+import { useLayoutEffect, useRef } from 'react';
+import { toolbarFloorHeight } from "../core/toolbarFloor.js";
+/**
+ * Give an editor's container a minimum height that shows the whole toolbar.
+ *
+ * The height is measured rather than written down, so a different button count
+ * — a fragment editor, a reaction editor, a future release — keeps working
+ * instead of clipping its last buttons behind whatever follows the editor.
+ * @param options - The height the caller asked for, and when to look again.
+ * @returns The ref to put on the element wrapping the editor.
+ */
+export function useToolbarFloor(options = {}) {
+    const { minHeight = 320, revision = 0 } = options;
+    const containerRef = useRef(null);
+    useLayoutEffect(() => {
+        const container = containerRef.current;
+        if (container === null)
+            return;
+        let observer = null;
+        let frame = 0;
+        let attempts = 0;
+        // The editor builds itself asynchronously, so the toolbar is usually not
+        // there yet on the first look; watching for it is what keeps a slow first
+        // paint from leaving the container at its unmeasured height for good.
+        const attach = () => {
+            const toolbar = findToolbar(container);
+            if (toolbar === null) {
+                attempts++;
+                if (attempts > MAX_ATTEMPTS)
+                    return;
+                frame = globalThis.requestAnimationFrame(attach);
+                return;
+            }
+            observer = new ResizeObserver(() => {
+                // offsetHeight, because a dialog opens under a scaling transform and a
+                // measured rectangle would be that of the half drawn toolbar.
+                const floor = toolbarFloorHeight(toolbar.offsetHeight, minHeight);
+                container.style.minHeight = `${floor}px`;
+            });
+            observer.observe(toolbar);
+        };
+        attach();
+        return () => {
+            if (frame !== 0)
+                globalThis.cancelAnimationFrame(frame);
+            observer?.disconnect();
+        };
+    }, [minHeight, revision]);
+    return containerRef;
+}
+/** Roughly two seconds of frames, after which the editor is not coming. */
+const MAX_ATTEMPTS = 120;
+/**
+ * Find the toolbar canvas of the editor.
+ *
+ * The editor builds itself inside a shadow root and puts the toolbar there as
+ * a direct child, the drawing canvas being nested deeper.
+ * @param container - The element wrapping the editor.
+ * @returns The toolbar canvas, or null while the editor has not drawn one.
+ */
+function findToolbar(container) {
+    for (const element of container.querySelectorAll('*')) {
+        for (const child of element.shadowRoot?.children ?? []) {
+            if (child instanceof HTMLCanvasElement)
+                return child;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=useToolbarFloor.js.map

package/lib/structure/ui/useToolbarFloor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarFloor.js","sourceRoot":"","sources":["../../../src/structure/ui/useToolbarFloor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiB7D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA+B,EAAE;IAEjC,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAElD,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAE/B,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,GAAG,YAAY;oBAAE,OAAO;gBACpC,KAAK,GAAG,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE;gBACjC,uEAAuE;gBACvE,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBAClE,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,KAAK,IAAI,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QAET,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,CAAC;gBAAE,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACxD,QAAQ,EAAE,UAAU,EAAE,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,SAAsB;IACzC,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,YAAY,iBAAiB;gBAAE,OAAO,KAAK,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/structure.d.ts

@@ -0,0 +1,3 @@
+export * from './structure/core/index.ts';
+export * from './structure/ui/index.ts';
+//# sourceMappingURL=structure.d.ts.map

package/lib/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../src/structure.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/lib/structure.js

@@ -0,0 +1,3 @@
+export * from "./structure/core/index.js";
+export * from "./structure/ui/index.js";
+//# sourceMappingURL=structure.js.map

package/lib/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../src/structure.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/lib/ui.d.ts

@@ -1,4 +1,17 @@
+export * from './capsule/ui/index.ts';
+export * from './chrome/ui/index.ts';
 export * from './citation/ui/index.ts';
+export * from './clipboard/ui/index.ts';
+export * from './color/ui/index.ts';
+export * from './credits/ui/index.ts';
+export * from './delimited/ui/index.ts';
+export * from './disclosure/ui/index.ts';
 export * from './ecosystem/ui/index.ts';
+export * from './error/ui/index.ts';
+export * from './help/ui/index.ts';
+export * from './hooks/ui/index.ts';
+export * from './pedagogy/ui/index.ts';
+export * from './share/ui/index.ts';
 export * from './shared/ui/index.ts';
+export * from './state/ui/index.ts';
 //# sourceMappingURL=ui.d.ts.map

package/lib/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/lib/ui.js

@@ -1,4 +1,17 @@
+export * from "./capsule/ui/index.js";
+export * from "./chrome/ui/index.js";
 export * from "./citation/ui/index.js";
+export * from "./clipboard/ui/index.js";
+export * from "./color/ui/index.js";
+export * from "./credits/ui/index.js";
+export * from "./delimited/ui/index.js";
+export * from "./disclosure/ui/index.js";
 export * from "./ecosystem/ui/index.js";
+export * from "./error/ui/index.js";
+export * from "./help/ui/index.js";
+export * from "./hooks/ui/index.js";
+export * from "./pedagogy/ui/index.js";
+export * from "./share/ui/index.js";
 export * from "./shared/ui/index.js";
+export * from "./state/ui/index.js";
 //# sourceMappingURL=ui.js.map

package/lib/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/lib/worker/core/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Rejection of a request nobody is waiting for any more: its signal was
+ * aborted, or the channel it was posted on was terminated.
+ *
+ * It is the normal outcome of dragging a slider or clicking through a list, so
+ * a caller catches it and draws nothing rather than reporting a failure.
+ */
+export declare class CancelledRequestError extends Error {
+    name: string;
+}
+/** Rejection of a request that outlived its budget and was given up on. */
+export declare class RequestTimeoutError extends Error {
+    name: string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/worker/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/worker/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IACrC,IAAI,SAA2B;CACzC;AAED,2EAA2E;AAC3E,qBAAa,mBAAoB,SAAQ,KAAK;IACnC,IAAI,SAAyB;CACvC"}

package/lib/worker/core/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Rejection of a request nobody is waiting for any more: its signal was
+ * aborted, or the channel it was posted on was terminated.
+ *
+ * It is the normal outcome of dragging a slider or clicking through a list, so
+ * a caller catches it and draws nothing rather than reporting a failure.
+ */
+export class CancelledRequestError extends Error {
+    name = 'CancelledRequestError';
+}
+/** Rejection of a request that outlived its budget and was given up on. */
+export class RequestTimeoutError extends Error {
+    name = 'RequestTimeoutError';
+}
+//# sourceMappingURL=errors.js.map

package/lib/worker/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/worker/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,uBAAuB,CAAC;CACzC;AAED,2EAA2E;AAC3E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,qBAAqB,CAAC;CACvC"}

package/lib/worker/core/index.d.ts

@@ -0,0 +1,5 @@
+export { CancelledRequestError, RequestTimeoutError } from './errors.ts';
+export type { WorkerLike } from './messages.ts';
+export type { WorkerChannel, WorkerChannelOptions, WorkerRequestOptions, } from './workerChannel.ts';
+export { createWorkerChannel } from './workerChannel.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/worker/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/worker/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/worker/core/index.js

@@ -0,0 +1,3 @@
+export { CancelledRequestError, RequestTimeoutError } from "./errors.js";
+export { createWorkerChannel } from "./workerChannel.js";
+//# sourceMappingURL=index.js.map

package/lib/worker/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/worker/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/worker/core/messages.d.ts

@@ -0,0 +1,48 @@
+/** What a channel posts to its worker: one job, tagged with an identifier. */
+export interface WorkerRequestMessage<TRequest> {
+    /** Serial number of the request, which the answer must echo. */
+    id: number;
+    /** The job itself, exactly as the caller wrote it. */
+    request: TRequest;
+}
+/**
+ * What a worker posts back. An `Error` does not survive the boundary, so a
+ * failure travels as its message and becomes an `Error` again on this side.
+ */
+export type WorkerResponseMessage<TResponse> = {
+    id: number;
+    ok: true;
+    response: TResponse;
+} | {
+    id: number;
+    ok: false;
+    message: string;
+};
+/**
+ * As much of a `Worker` as a channel uses. A real `Worker` satisfies it, and so
+ * does anything else that speaks the same three calls — which is what lets the
+ * scheduling be unit-tested without a thread.
+ */
+export interface WorkerLike {
+    /** Send one message to the worker. */
+    postMessage(message: unknown): void;
+    /** Listen to what the worker answers, or to its failing outright. */
+    addEventListener(type: 'message' | 'error', listener: (event: WorkerEventLike) => void): void;
+    /** Stop the worker; whatever it was doing is lost. */
+    terminate(): void;
+}
+/** As much of a worker event as a channel reads. */
+export interface WorkerEventLike {
+    /**
+     * The message the worker posted, before anything checks it against the
+     * protocol. Absent on an error event.
+     * @default undefined
+     */
+    readonly data?: unknown;
+    /**
+     * What went wrong, on an error event. Absent on a message event.
+     * @default undefined
+     */
+    readonly message?: string;
+}
+//# sourceMappingURL=messages.d.ts.map

package/lib/worker/core/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/worker/core/messages.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB,CAAC,QAAQ;IAC5C,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,SAAS,IACvC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,qEAAqE;IACrE,gBAAgB,CACd,IAAI,EAAE,SAAS,GAAG,OAAO,EACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC,IAAI,CAAC;IACR,sDAAsD;IACtD,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/lib/worker/core/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/lib/worker/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/worker/core/messages.ts"],"names":[],"mappings":""}

package/lib/worker/core/workerChannel.d.ts

@@ -0,0 +1,69 @@
+import type { WorkerLike } from './messages.ts';
+/**
+ * Turn a worker into something a page can await.
+ *
+ * Several requests may be in flight at once; each one is tagged with an
+ * identifier the answer echoes, so replies are matched to callers whatever
+ * order they arrive in. A request that rejects — cancelled, timed out, or
+ * failed — drops out of the pending map at that moment, so a page that fires
+ * one job per keystroke never accumulates them.
+ *
+ * The worker is the caller's: the channel posts to it and terminates it when
+ * asked, but never creates one, which is what lets a site keep its own lazy
+ * construction and its own in-process fallback.
+ * @param worker - The worker to talk to, or anything that speaks its three calls.
+ * @param options - See {@link WorkerChannelOptions}.
+ * @returns The channel.
+ */
+export declare function createWorkerChannel<TRequest, TResponse>(worker: WorkerLike, options?: WorkerChannelOptions): WorkerChannel<TRequest, TResponse>;
+/** How a channel names itself and how long it waits. */
+export interface WorkerChannelOptions {
+    /**
+     * What the channel is called in the message of an error it raises, e.g.
+     * `conformers`.
+     * @default 'worker'
+     */
+    name?: string;
+    /**
+     * Milliseconds a request waits before it is given up on, when the call passes
+     * no budget of its own. A value that is not a positive finite number falls
+     * back to two minutes.
+     * @default 120000
+     */
+    defaultTimeoutMs?: number;
+}
+/** What one call may ask of the channel. */
+export interface WorkerRequestOptions {
+    /**
+     * Abort the call. Its promise then rejects with a
+     * {@link CancelledRequestError}; the worker itself is left alone, since a job
+     * already running cannot be interrupted from outside.
+     * @default undefined
+     */
+    signal?: AbortSignal;
+    /**
+     * Milliseconds this call alone waits, overriding the channel default —
+     * a calculation budget is often a user preference. A value that is not a
+     * positive finite number falls back to the channel default.
+     * @default the channel's defaultTimeoutMs
+     */
+    timeoutMs?: number;
+}
+/** A channel to one worker, over which several jobs may be in flight. */
+export interface WorkerChannel<TRequest, TResponse> {
+    /**
+     * Post one job and wait for the answer that carries its identifier.
+     * @param payload - The job.
+     * @param options - Per-call signal and budget.
+     * @returns What the worker answered.
+     */
+    request: (payload: TRequest, options?: WorkerRequestOptions) => Promise<TResponse>;
+    /** How many requests are still waiting for an answer. */
+    readonly pendingCount: number;
+    /**
+     * Terminate the worker, rejecting everything still waiting with a
+     * {@link CancelledRequestError}. The channel accepts no further request.
+     */
+    terminate: () => void;
+}
+//# sourceMappingURL=workerChannel.d.ts.map

package/lib/worker/core/workerChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerChannel.d.ts","sourceRoot":"","sources":["../../../src/worker/core/workerChannel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EACrD,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CA0GpC;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa,CAAC,QAAQ,EAAE,SAAS;IAChD;;;;;OAKG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB"}