react-cheminfo 0.64.1 → 0.65.0

package/lib/share/core/keySetParam.js

@@ -0,0 +1,60 @@
+/**
+ * A set of keys a link switches on — the layers a figure draws,
+ * `?flags=breakdown,working` — written comma separated, in the order the keys
+ * are listed, so one selection always produces one link.
+ *
+ * A key the tool does not list is dropped rather than refused, so a link
+ * written before a key was renamed still opens; the word for nothing, `none`
+ * by default, reads as the empty set, and an absent or empty parameter as the
+ * default.
+ * @param keys - Every key the tool understands, in the order links write them.
+ * @param options - The word for nothing, and the default set.
+ * @returns The codec.
+ */
+export function keySetParam(keys, options = {}) {
+    const none = options.none ?? 'none';
+    const fallback = options.default === undefined || options.default === null
+        ? null
+        : orderKeys(new Set(options.default), keys);
+    const omitted = options.omitted === undefined
+        ? fallback
+        : orderKeys(new Set(options.omitted), keys);
+    const omittedText = omitted === null ? null : writeKeys(omitted, keys);
+    return {
+        parse(raw) {
+            if (raw === null || raw.trim() === '')
+                return fallback;
+            if (raw.trim() === none)
+                return new Set();
+            const asked = new Set();
+            for (const name of raw.split(','))
+                asked.add(name.trim());
+            return orderKeys(asked, keys);
+        },
+        serialize(value) {
+            if (value === null)
+                return null;
+            const text = writeKeys(value, keys);
+            if (text === omittedText)
+                return null;
+            return text === '' ? none : text;
+        },
+    };
+}
+function orderKeys(asked, keys) {
+    const ordered = new Set();
+    for (const key of keys) {
+        if (asked.has(key))
+            ordered.add(key);
+    }
+    return ordered;
+}
+function writeKeys(value, keys) {
+    const on = [];
+    for (const key of keys) {
+        if (value.has(key))
+            on.push(key);
+    }
+    return on.join(',');
+}
+//# sourceMappingURL=keySetParam.js.map

package/lib/share/core/keySetParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keySetParam.js","sourceRoot":"","sources":["../../../src/share/core/keySetParam.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,IAAoB,EACpB,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IACpC,MAAM,QAAQ,GACZ,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QACvD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,CAAS,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,CAAS,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvE,OAAO;QACL,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,QAAQ,CAAC;YACvD,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,IAAI,GAAG,EAAO,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,SAAS,CAAC,KAAK;YACb,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAChC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YACtC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,KAA0B,EAC1B,IAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAO,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAChB,KAAuB,EACvB,IAAoB;IAEpB,MAAM,EAAE,GAAa,EAAE,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/lib/share/core/vocabulary.d.ts

@@ -55,5 +55,13 @@ export interface ShareVocabulary<Codecs extends ShareParamCodecs = Record<string
      * @default {}
      */
     params?: Codecs;
+    /**
+     * The `?hide=` keys older links dropped the chrome with, before the site
+     * spoke `?embed` — `header`, `menu`. A link naming one still opens framed,
+     * because course pages built then must keep opening bare; the key is no part
+     * of the page, so it is never offered and never written back.
+     * @default []
+     */
+    legacyEmbedParts?: readonly string[];
 }
 //# sourceMappingURL=vocabulary.d.ts.map

package/lib/share/core/vocabulary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../src/share/core/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CACrC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CACzC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,gBAAgB,IAAI;KAC7D,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,eAAe,CAAC,MAAM,KAAK,CAAC,GACnE,KAAK,GACL,KAAK;CACV,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvD;;;OAGG;IACH,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../src/share/core/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CACrC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CACzC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,gBAAgB,IAAI;KAC7D,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,eAAe,CAAC,MAAM,KAAK,CAAC,GACnE,KAAK,GACL,KAAK;CACV,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvD;;;OAGG;IACH,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC"}

package/lib/shell/ui/ShareControl.d.ts

@@ -0,0 +1,75 @@
+import type { ReactElement } from 'react';
+import type { SiteId } from '../../ecosystem/core/sites.ts';
+import type { ShareParamCodecs } from '../../share/core/index.ts';
+import type { ShareButtonVariant } from '../../share/ui/ShareButton.tsx';
+import type { ShareDialogProps } from '../../share/ui/ShareDialog.tsx';
+/** What {@link ShareControl} needs: the dialog's props, and the button's. */
+export interface ShareControlProps<Codecs extends ShareParamCodecs = Record<string, never>> extends Omit<ShareDialogProps<Codecs>, 'isOpen' | 'onClose' | 'search' | 'frameTitle'> {
+    /**
+     * The site the page belongs to, which names the frame `<host> — <title>`.
+     * @default undefined — the frame is named by the title alone
+     */
+    siteId?: SiteId;
+    /**
+     * What a screen reader announces the frame as.
+     * @default `<host> — <title>` with a `siteId`, the title without one
+     */
+    frameTitle?: string;
+    /**
+     * The address as it stands, so the tool's inputs travel with the link. A
+     * function is called only while the dialog is open, so a value that is costly
+     * to write — a pinned preference, a list of molecules — is written when a
+     * link is asked for and not on every render of the header.
+     * @default the query string of the page
+     */
+    search?: string | (() => string | undefined);
+    /**
+     * Whether the button keeps only its icon, in a bar that has run out of room.
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * Text of the button.
+     * @default the chrome's own word for it, in the language of the page
+     */
+    buttonLabel?: string;
+    /**
+     * What the pointer is told over the button.
+     * @default the chrome's own line, in the language of the page
+     */
+    buttonTitle?: string;
+    /**
+     * A plain bar entry, or a Blueprint button for a toolbar made of them.
+     * @default 'nav-link'
+     */
+    variant?: ShareButtonVariant;
+    /**
+     * Whether the dialog is open, for a page that has to know — to compute what
+     * the dialog shows only while it is. Pass it with `onOpenChange`.
+     * @default undefined — the control keeps the state itself
+     */
+    open?: boolean;
+    /**
+     * Called when the dialog opens or closes.
+     * @default undefined
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Called as the button is pressed, before the dialog opens — to write the
+     * page's state into the address the link is read from.
+     * @default undefined
+     */
+    onOpen?: () => void;
+}
+/**
+ * The Share entry of a header and the dialog it opens: the page handed out as a
+ * link, or as the iframe that frames it in somebody else's site.
+ *
+ * It is what a header's `share` prop takes, so the entry lands after Contact on
+ * every site. Everything the dialog can be told is passed straight through; the
+ * control adds the open state, and the frame's name read off the site.
+ * @param props - The dialog's props, and how the button is dressed.
+ * @returns The button, and the dialog while it is open.
+ */
+export declare function ShareControl<Codecs extends ShareParamCodecs = Record<string, never>>(props: ShareControlProps<Codecs>): ReactElement;
+//# sourceMappingURL=ShareControl.d.ts.map

package/lib/shell/ui/ShareControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareControl.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/ShareControl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB,CAChC,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CACvD,SAAQ,IAAI,CACZ,gBAAgB,CAAC,MAAM,CAAC,EACxB,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAC/C;IACC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACvD,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,YAAY,CAuDhD"}

package/lib/shell/ui/ShareControl.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { siteById } from "../../ecosystem/core/lookup.js";
+import { useChromeT } from "../../i18n/ui/useT.js";
+import { ShareButton } from "../../share/ui/ShareButton.js";
+import { ShareDialog } from "../../share/ui/ShareDialog.js";
+/**
+ * The Share entry of a header and the dialog it opens: the page handed out as a
+ * link, or as the iframe that frames it in somebody else's site.
+ *
+ * It is what a header's `share` prop takes, so the entry lands after Contact on
+ * every site. Everything the dialog can be told is passed straight through; the
+ * control adds the open state, and the frame's name read off the site.
+ * @param props - The dialog's props, and how the button is dressed.
+ * @returns The button, and the dialog while it is open.
+ */
+export function ShareControl(props) {
+    const { siteId, frameTitle, search, compact = false, buttonLabel, buttonTitle, variant, open, onOpenChange, onOpen, title, ...dialog } = props;
+    const t = useChromeT();
+    const [ownOpen, setOwnOpen] = useState(false);
+    const isOpen = open ?? ownOpen;
+    function setOpen(next) {
+        if (open === undefined)
+            setOwnOpen(next);
+        onOpenChange?.(next);
+    }
+    const host = siteId === undefined ? undefined : siteById(siteId).host;
+    const named = frameTitle ??
+        (host === undefined ? title : t('share.frameTitle', { site: host, title }));
+    return (_jsxs(_Fragment, { children: [_jsx(ShareButton, { compact: compact, label: buttonLabel, title: buttonTitle, variant: variant, onClick: () => {
+                    onOpen?.();
+                    setOpen(true);
+                } }), _jsx(ShareDialog, { ...dialog, title: title, frameTitle: named, search: isOpen && typeof search === 'function' ? search() : searchText(search), isOpen: isOpen, onClose: () => {
+                    setOpen(false);
+                } })] }));
+}
+function searchText(search) {
+    return typeof search === 'string' ? search : undefined;
+}
+//# sourceMappingURL=ShareControl.js.map

package/lib/shell/ui/ShareControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareControl.js","sourceRoot":"","sources":["../../../src/shell/ui/ShareControl.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAAgC,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAAgC,CAAC;AAkE7D;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAE1B,KAAgC;IAChC,MAAM,EACJ,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,GAAG,KAAK,EACf,WAAW,EACX,WAAW,EACX,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,GAAG,MAAM,EACV,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC;IAE/B,SAAS,OAAO,CAAC,IAAa;QAC5B,IAAI,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACzC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IACtE,MAAM,KAAK,GACT,UAAU;QACV,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAE9E,OAAO,CACL,8BACE,KAAC,WAAW,IACV,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,EAAE,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,GACD,EACF,KAAC,WAAW,OACN,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,KAAK,EACjB,MAAM,EACJ,MAAM,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAExE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EAAE;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC,GACD,IACD,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,MAAuD;IAEvD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/lib/shell/ui/ShellFrame.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The body of `SiteShell`, once the route has been read: the theme, the bar,
+ * the page and the footer.
+ */
+import type { ReactElement } from 'react';
+import type { ShareParamCodecs } from '../../share/core/index.ts';
+import type { SiteShellProps } from './SiteShell.tsx';
+/**
+ * Draw the shell.
+ * @param props - The shell's props, the route already read.
+ * @returns The page in its chrome.
+ */
+export declare function ShellFrame<Codecs extends ShareParamCodecs, Tab extends string>(props: SiteShellProps<Codecs, Tab>): ReactElement;
+//# sourceMappingURL=ShellFrame.d.ts.map

package/lib/shell/ui/ShellFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellFrame.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/ShellFrame.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,OAAO,CAAC;AAWrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,gBAAgB,EAAE,GAAG,SAAS,MAAM,EAC5E,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,GACjC,YAAY,CA0Fd"}

package/lib/shell/ui/ShellFrame.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { isValidElement } from 'react';
+import { AboutPage } from "../../about/ui/AboutPage.js";
+import { AboutButton } from "../../chrome/ui/AboutButton.js";
+import { SiteFooter } from "../../chrome/ui/SiteFooter.js";
+import { SiteHeader } from "../../chrome/ui/SiteHeader.js";
+import { useCompactHeader } from "../../chrome/ui/useCompactHeader.js";
+import { CiteButton } from "../../citation/ui/CiteButton.js";
+import { EcosystemButton } from "../../ecosystem/ui/EcosystemButton.js";
+import { SiteTheme } from "../../ecosystem/ui/SiteTheme.js";
+import { HiddenPartsProvider } from "../../share/ui/HiddenPartsProvider.js";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+import { ShareControl } from "./ShareControl.js";
+/**
+ * Draw the shell.
+ * @param props - The shell's props, the route already read.
+ * @returns The page in its chrome.
+ */
+export function ShellFrame(props) {
+    const { siteId, site, mark, markSize, nav, activeId, homeHref, onHome, renderNavItem, navPart = 'tabs', width = 'page', embedded = false, hidden, about = false, contact, belowHeader, mainClassName, mainTestId, footer = {}, account, children, } = props;
+    const compact = useCompactHeader();
+    const footerSiteId = footer === false ? undefined : (footer.siteId ?? siteId);
+    const aboutOnShow = about !== false && about.active === true;
+    const page = (_jsxs(_Fragment, { children: [siteId === undefined ? (_jsx(SiteTheme, { site: site })) : (_jsx(SiteTheme, { siteId: siteId })), _jsxs("div", { className: "site-shell", children: [_jsx(SiteHeader, { siteId: siteId, site: site, mark: mark, markSize: markSize, embedded: embedded, width: width, nav: hidden?.includes(navPart) ? [] : nav, activeId: aboutOnShow ? (about.id ?? 'about') : activeId, homeHref: homeHref, onHome: onHome, renderNavItem: renderNavItem, contact: contact, actions: _jsx(ShellActions, { ...props, compact: compact }), share: _jsx(ShellShare, { ...props, compact: compact }), account: account }), embedded ? null : belowHeader, _jsx("main", { className: joinClassNames('site-shell__main', width === 'full' ? 'site-shell__main--full' : undefined, embedded ? 'site-shell__main--embedded' : undefined, mainClassName), "data-testid": mainTestId, children: aboutOnShow
+                            ? (about.page ?? _jsx(AboutPage, { content: about.content }))
+                            : children })] }), footer === false || footerSiteId === undefined ? null : (_jsxs(SiteFooter, { siteId: footerSiteId, embedded: embedded, width: width, heading: footer.heading, layout: footer.layout, children: [footer.note === undefined ? null : (_jsx("p", { className: "app-footer__note", children: footer.note })), footer.children] }))] }));
+    return hidden === undefined ? (page) : (_jsx(HiddenPartsProvider, { hidden: hidden, children: page }));
+}
+function ShellActions(props) {
+    const { siteId, about = false, cite, ecosystem = true, actionsAfterAbout, actionsAfterCite, actions, language, compact, } = props;
+    const works = cite ?? (about === false ? [] : (about.content.cite ?? []));
+    return (_jsxs(_Fragment, { children: [about === false ? null : (_jsx(AboutButton, { id: about.id, href: about.href ?? '/about', active: about.active, onSelect: about.onSelect, label: about.label, title: about.title })), fill(actionsAfterAbout, compact), works === false || works.length === 0 ? null : (_jsx(CiteButton, { works: works, compact: compact })), fill(actionsAfterCite, compact), ecosystem ? (_jsx(EcosystemButton, { currentSiteId: siteId, compact: compact })) : null, fill(actions, compact), fill(language, compact)] }));
+}
+function ShellShare(props) {
+    const { share, siteId, compact } = props;
+    if (share === undefined)
+        return null;
+    if (isValidElement(share))
+        return share;
+    return _jsx(ShareControl, { siteId: siteId, compact: compact, ...share });
+}
+function fill(slot, compact) {
+    return typeof slot === 'function' ? slot(compact) : slot;
+}
+//# sourceMappingURL=ShellFrame.js.map

package/lib/shell/ui/ShellFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellFrame.js","sourceRoot":"","sources":["../../../src/shell/ui/ShellFrame.tsx"],"names":[],"mappings":"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"}

package/lib/shell/ui/SiteShell.d.ts

@@ -0,0 +1,251 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { AboutContent } from '../../about/core/about.ts';
+import type { NavItem } from '../../chrome/ui/navItem.ts';
+import type { CitedWork } from '../../citation/core/works.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
+import type { TabRouter } from '../../router/core/tabRouter.ts';
+import type { ShareParamCodecs } from '../../share/core/index.ts';
+import type { ShareControlProps } from './ShareControl.tsx';
+/**
+ * A slot of the bar: an element, or a function handed whether the bar has run
+ * out of room, so a site's own entries fold with the shared ones.
+ */
+export type ShellSlot = ReactNode | ((compact: boolean) => ReactNode);
+/** The site's About: the record, and where it is served. */
+export interface ShellAbout {
+    /** What the site says about itself; its works also feed the Cite button. */
+    content: AboutContent;
+    /**
+     * The About address.
+     * @default the router's address of the About tab, or `/about` without one
+     */
+    href?: string;
+    /**
+     * Whether the About is the page on show, in which case it is what the main
+     * area draws.
+     * @default whether the router's tab is the About tab, `false` without one
+     */
+    active?: boolean;
+    /**
+     * What the site does when the entry is picked, for a page that routes in
+     * place.
+     * @default a move to the About tab with a router, the plain link without
+     */
+    onSelect?: () => void;
+    /**
+     * What the active entry is named by.
+     * @default 'about'
+     */
+    id?: string;
+    /**
+     * What the entry reads.
+     * @default the chrome's own word for it
+     */
+    label?: string;
+    /**
+     * What the pointer is told.
+     * @default the chrome's own sentence
+     */
+    title?: string;
+    /**
+     * The page itself, for a site whose About carries more than its record — a
+     * section of its own, a sign-in, a mark.
+     * @default `<AboutPage content={content} />`
+     */
+    page?: ReactNode;
+}
+/** The strip under the page. */
+export interface ShellFooter {
+    /**
+     * The site the footer sits on, for a shell given a `site` record rather
+     * than a `siteId`.
+     * @default the shell's `siteId`, and no footer without one
+     */
+    siteId?: SiteId;
+    /**
+     * What introduces the family.
+     * @default undefined
+     */
+    heading?: string;
+    /**
+     * How much of each sibling is written.
+     * @default 'grid'
+     */
+    layout?: 'grid' | 'row';
+    /**
+     * One line under the family, set as the footer's note.
+     * @default undefined
+     */
+    note?: ReactNode;
+    /**
+     * Anything else under the family.
+     * @default undefined
+     */
+    children?: ReactNode;
+}
+/** What {@link SiteShell} needs. */
+export interface SiteShellProps<Codecs extends ShareParamCodecs = Record<string, never>, Tab extends string = string> {
+    /**
+     * The site, named. One of `site` and `siteId` is required.
+     * @default undefined
+     */
+    siteId?: SiteId;
+    /**
+     * The site, passed rather than named, for one outside the family's registry.
+     * @default undefined
+     */
+    site?: SiteRecord;
+    /**
+     * The site's own mark, for a site the shared glyphs do not hold.
+     * @default the family's mark for the site
+     */
+    mark?: ReactNode;
+    /**
+     * Edge of the mark, in pixels.
+     * @default 28
+     */
+    markSize?: number;
+    /**
+     * The site's router. With it the shell follows the address itself: the
+     * page on show is the tab it names, and the About tab is served as the About
+     * page.
+     * @default undefined — the page says which entry is active
+     */
+    router?: TabRouter<Tab>;
+    /**
+     * The tab the About is served at.
+     * @default 'about'
+     */
+    aboutTab?: Tab;
+    /** The pages, in the order the bar lists them; About is not one of them. */
+    nav: readonly NavItem[];
+    /**
+     * Which of the pages is on show.
+     * @default the router's tab, or none without a router
+     */
+    activeId?: string;
+    /**
+     * Where the brand leads.
+     * @default '/'
+     */
+    homeHref?: string;
+    /**
+     * What the site does when the brand is picked.
+     * @default undefined
+     */
+    onHome?: () => void;
+    /**
+     * Draws one page the site's own way.
+     * @default undefined
+     */
+    renderNavItem?: (item: NavItem, isActive: boolean) => ReactNode;
+    /**
+     * The part a link hides the pages with; the bar then lists none.
+     * @default 'tabs'
+     */
+    navPart?: string;
+    /**
+     * How wide the bar, the page and the footer run, all three alike.
+     * @default 'page'
+     */
+    width?: 'page' | 'full';
+    /**
+     * Whether the page is framed in another site: no bar, no footer, and the
+     * frame as the margin.
+     * @default false
+     */
+    embedded?: boolean;
+    /**
+     * The parts the link switches off, provided to every `PagePart` below.
+     * @default undefined — no provider; the page brings its own
+     */
+    hidden?: readonly string[];
+    /**
+     * The About entry and page; `false` leaves both out.
+     * @default false
+     */
+    about?: ShellAbout | false;
+    /**
+     * The works the Cite button offers; `false` leaves it out.
+     * @default the About's works, and no button when it has none
+     */
+    cite?: readonly CitedWork[] | false;
+    /**
+     * Whether the Tools menu of the family is in the bar.
+     * @default true
+     */
+    ecosystem?: boolean;
+    /**
+     * Entries between About and Cite — an API link, a version.
+     * @default undefined
+     */
+    actionsAfterAbout?: ShellSlot;
+    /**
+     * Entries between Cite and Tools — a feedback form, a specification.
+     * @default undefined
+     */
+    actionsAfterCite?: ShellSlot;
+    /**
+     * Entries after Tools — a unit picker, an admin action.
+     * @default undefined
+     */
+    actions?: ShellSlot;
+    /**
+     * The language switcher, after the site's own entries.
+     * @default undefined
+     */
+    language?: ShellSlot;
+    /**
+     * Who is signed in, at the right end.
+     * @default undefined
+     */
+    account?: ReactNode;
+    /**
+     * The Share entry: what `ShareControl` is given, the shell passing it the
+     * site and the compact state, or a control of the site's own.
+     * @default undefined — no Share entry
+     */
+    share?: ShareControlProps<Codecs> | ReactElement;
+    /**
+     * The contact form of the Contact entry, or `false` to leave it out.
+     * @default the family's form
+     */
+    contact?: string | false;
+    /**
+     * What sits between the bar and the page — a tagline, a banner — dropped
+     * with the bar when the page is framed.
+     * @default undefined
+     */
+    belowHeader?: ReactNode;
+    /**
+     * Classes the main area carries beside the shell's own.
+     * @default undefined
+     */
+    mainClassName?: string;
+    /**
+     * `data-testid` of the main area.
+     * @default undefined
+     */
+    mainTestId?: string;
+    /**
+     * The strip under the page, or `false` for none on this page.
+     * @default the family's links alone
+     */
+    footer?: ShellFooter | false;
+    /** The page the address names. */
+    children: ReactNode;
+}
+/**
+ * The chrome every site of the family carries, around its page: the theme,
+ * the bar with About · Cite · Tools · Contact · Share at its right, the page,
+ * and the footer linking every sibling. A framed page gets the page alone.
+ *
+ * Everything the bar holds is the shared components, in the family's order; a
+ * site fills the slots between them and never re-orders them. With a router,
+ * the shell also follows the address: it marks the tab on show and serves the
+ * About tab as the shared About page.
+ * @param props - See {@link SiteShellProps}.
+ * @returns The page in its chrome.
+ */
+export declare function SiteShell<Codecs extends ShareParamCodecs = Record<string, never>, Tab extends string = string>(props: SiteShellProps<Codecs, Tab>): ReactElement;
+//# sourceMappingURL=SiteShell.d.ts.map

package/lib/shell/ui/SiteShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SiteShell.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/SiteShell.tsx"],"names":[],"mappings":"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"}

package/lib/shell/ui/SiteShell.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { writeRoute } from "../../router/core/history.js";
+import { useTabRoute } from "../../router/ui/useTabRoute.js";
+import { ShellFrame } from "./ShellFrame.js";
+/**
+ * The chrome every site of the family carries, around its page: the theme,
+ * the bar with About · Cite · Tools · Contact · Share at its right, the page,
+ * and the footer linking every sibling. A framed page gets the page alone.
+ *
+ * Everything the bar holds is the shared components, in the family's order; a
+ * site fills the slots between them and never re-orders them. With a router,
+ * the shell also follows the address: it marks the tab on show and serves the
+ * About tab as the shared About page.
+ * @param props - See {@link SiteShellProps}.
+ * @returns The page in its chrome.
+ */
+export function SiteShell(props) {
+    const { router } = props;
+    if (router === undefined)
+        return _jsx(ShellFrame, { ...props });
+    return _jsx(RoutedShell, { ...props, router: router });
+}
+function RoutedShell(props) {
+    const { router, aboutTab = 'about', about, activeId } = props;
+    const route = useTabRoute(router);
+    const routedAbout = about === undefined || about === false
+        ? false
+        : {
+            ...about,
+            href: about.href ?? router.format({ tab: aboutTab }),
+            active: about.active ?? route.tab === aboutTab,
+            onSelect: about.onSelect ??
+                (() => {
+                    writeRoute(router, { tab: aboutTab });
+                }),
+        };
+    return (_jsx(ShellFrame, { ...props, about: routedAbout, activeId: activeId ?? route.tab }));
+}
+//# sourceMappingURL=SiteShell.js.map

package/lib/shell/ui/SiteShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SiteShell.js","sourceRoot":"","sources":["../../../src/shell/ui/SiteShell.tsx"],"names":[],"mappings":";AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AA8O9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAGvB,KAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAC,UAAU,OAAK,KAAK,GAAI,CAAC;IAC3D,OAAO,KAAC,WAAW,OAAK,KAAK,EAAE,MAAM,EAAE,MAAM,GAAI,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAClB,KAA+D;IAE/D,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACrE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,WAAW,GACf,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;QACpC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACE,GAAG,KAAK;YACR,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;YACpD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;YAC9C,QAAQ,EACN,KAAK,CAAC,QAAQ;gBACd,CAAC,GAAG,EAAE;oBACJ,UAAU,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACxC,CAAC,CAAC;SACL,CAAC;IACR,OAAO,CACL,KAAC,UAAU,OACL,KAAK,EACT,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC,GAAG,GAC/B,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export type { ShareControlProps } from './ShareControl.tsx';
+export { ShareControl } from './ShareControl.tsx';
+export type { ShellAbout, ShellFooter, ShellSlot, SiteShellProps, } from './SiteShell.tsx';
+export { SiteShell } from './SiteShell.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/shell/ui/index.js

@@ -0,0 +1,3 @@
+export { ShareControl } from "./ShareControl.js";
+export { SiteShell } from "./SiteShell.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shell/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAOlD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC"}

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

@@ -1,3 +1,4 @@
+export type { LegacyStorageKey } from './legacyEntries.ts';
 export type { BucketRead, PersistBucketOptions, PersistedBucket, } from './persistBucket.ts';
 export { persistBucket } from './persistBucket.ts';
 export type { PersistSignalBucketOptions, SignalEffect, } from './persistSignalBucket.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,0BAA0B,EAC1B,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,0BAA0B,EAC1B,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/core/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}