react-cheminfo 0.3.0 → 0.4.0

package/lib/share/core/escape.js

@@ -0,0 +1,22 @@
+/**
+ * Escape a value written into HTML text, so a formula, a title or an address
+ * a link carries cannot close the element it sits in.
+ * @param value - The untrusted value.
+ * @returns The value with `&`, `<` and `>` replaced by their entities.
+ */
+export function escapeText(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+}
+/**
+ * Escape a value written into a double-quoted HTML attribute, so an address
+ * carrying an ampersand or a quote cannot break out of it.
+ * @param value - The untrusted value.
+ * @returns The value with `&`, `<`, `>` and `"` replaced by their entities.
+ */
+export function escapeAttribute(value) {
+    return escapeText(value).replaceAll('"', '&quot;');
+}
+//# sourceMappingURL=escape.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/share/core/escape.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,9 @@
+export type { ShareConfig } from './config.ts';
+export { EMBED_PARAM, HIDE_PARAM, applyShareConfig, isHidden, isShareConfigured, parseShareConfig, suggestedShareConfig, } from './config.ts';
+export { escapeAttribute, escapeText } from './escape.ts';
+export type { BooleanParamOptions, IntegerParamOptions, ShareParamCodec, StringParamOptions, } from './params.ts';
+export { booleanParam, enumParam, integerParam, stringParam, } from './params.ts';
+export type { EmbedCodeOptions, ShareUrlOptions } from './url.ts';
+export { buildEmbedCode, buildShareUrl } from './url.ts';
+export type { HideablePart, ShareParamCodecs, ShareParamValues, ShareVocabulary, } from './vocabulary.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/share/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/lib/share/core/index.js

@@ -0,0 +1,5 @@
+export { EMBED_PARAM, HIDE_PARAM, applyShareConfig, isHidden, isShareConfigured, parseShareConfig, suggestedShareConfig, } from "./config.js";
+export { escapeAttribute, escapeText } from "./escape.js";
+export { booleanParam, enumParam, integerParam, stringParam, } from "./params.js";
+export { buildEmbedCode, buildShareUrl } from "./url.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/share/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO1D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,93 @@
+/**
+ * Reads one of a tool's own parameters out of a link and writes it back.
+ *
+ * `parse` is handed the raw value, or `null` when the link does not carry the
+ * key at all, and always answers: anything absent or malformed falls back to
+ * the default. `serialize` answers `null` for a value that is already the
+ * default, which deletes the key rather than writing it, so an unconfigured
+ * link stays a plain link.
+ */
+export interface ShareParamCodec<Value> {
+    /**
+     * Read the value a link carries.
+     * @param raw - The raw parameter, `null` when the link omits it.
+     * @returns The value, or the default when it is absent or malformed.
+     */
+    parse(raw: string | null): Value;
+    /**
+     * Write the value into a link.
+     * @param value - The value to write.
+     * @returns The raw parameter, or `null` to delete the key.
+     */
+    serialize(value: Value): string | null;
+}
+/** What {@link booleanParam} is configured with. */
+export interface BooleanParamOptions {
+    /**
+     * The value an absent parameter reads as, and the one deleted rather than
+     * written.
+     * @default false
+     */
+    default?: boolean;
+}
+/**
+ * A flag a link switches on by naming it. `?flag`, `?flag=` and `?flag=1` all
+ * read as on, because these addresses are retyped by hand out of a course
+ * page; only `0` and `false` read as off.
+ * @param options - The value the flag takes when the link says nothing.
+ * @returns The codec.
+ */
+export declare function booleanParam(options?: BooleanParamOptions): ShareParamCodec<boolean>;
+/** What {@link integerParam} is configured with. */
+export interface IntegerParamOptions<Fallback extends number | null> {
+    /** The smallest value a link may ask for. */
+    min: number;
+    /** The largest value a link may ask for, so a link cannot hang the page. */
+    max: number;
+    /**
+     * The value an absent or malformed parameter falls back to, and the one
+     * deleted rather than written. `null` means the tool has no value of its own
+     * until a link names one.
+     */
+    default: Fallback;
+}
+/**
+ * A whole number a link carries, rounded and clamped to the range the tool can
+ * actually serve. A value outside the range is brought back inside it rather
+ * than rejected: a link written when the maximum was higher must still open.
+ * @param options - The range and the default.
+ * @returns The codec.
+ */
+export declare function integerParam<Fallback extends number | null>(options: IntegerParamOptions<Fallback>): ShareParamCodec<number | Fallback>;
+/** What {@link stringParam} is configured with. */
+export interface StringParamOptions {
+    /**
+     * The value an absent parameter reads as, and the one deleted rather than
+     * written.
+     * @default ''
+     */
+    default?: string;
+    /**
+     * The longest value accepted; anything beyond it is cut, so a link cannot
+     * hand the tool a megabyte of text.
+     * @default undefined
+     */
+    maxLength?: number;
+}
+/**
+ * A free-text parameter, taken as written. The value is not trimmed: a
+ * leading space can be part of what the tool is showing.
+ * @param options - The default and the length limit.
+ * @returns The codec.
+ */
+export declare function stringParam(options?: StringParamOptions): ShareParamCodec<string>;
+/**
+ * One of a fixed set of names — a difficulty, a display mode, a format.
+ * A name the tool does not know falls back rather than throwing, so a link
+ * written before the set changed still opens.
+ * @param values - Every name the tool understands.
+ * @param fallback - The name an absent or unknown parameter reads as.
+ * @returns The codec.
+ */
+export declare function enumParam<Value extends string>(values: readonly Value[], fallback: Value): ShareParamCodec<Value>;
+//# sourceMappingURL=params.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/share/core/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IACjC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,eAAe,CAAC,OAAO,CAAC,CAa1B;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,MAAM,GAAG,IAAI;IACjE,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,MAAM,GAAG,IAAI,EACzD,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACrC,eAAe,CAAC,MAAM,GAAG,QAAQ,CAAC,CAgBpC;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,eAAe,CAAC,MAAM,CAAC,CAYzB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAC5C,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,QAAQ,EAAE,KAAK,GACd,eAAe,CAAC,KAAK,CAAC,CAkBxB"}

package/lib/share/core/params.js

@@ -0,0 +1,111 @@
+/**
+ * A flag a link switches on by naming it. `?flag`, `?flag=` and `?flag=1` all
+ * read as on, because these addresses are retyped by hand out of a course
+ * page; only `0` and `false` read as off.
+ * @param options - The value the flag takes when the link says nothing.
+ * @returns The codec.
+ */
+export function booleanParam(options = {}) {
+    const { default: fallback = false } = options;
+    return {
+        parse(raw) {
+            if (raw === null)
+                return fallback;
+            const text = raw.trim().toLowerCase();
+            return text !== '0' && text !== 'false';
+        },
+        serialize(value) {
+            if (value === fallback)
+                return null;
+            return value ? '1' : '0';
+        },
+    };
+}
+/**
+ * A whole number a link carries, rounded and clamped to the range the tool can
+ * actually serve. A value outside the range is brought back inside it rather
+ * than rejected: a link written when the maximum was higher must still open.
+ * @param options - The range and the default.
+ * @returns The codec.
+ */
+export function integerParam(options) {
+    const { min, max, default: fallback } = options;
+    return {
+        parse(raw) {
+            if (raw === null)
+                return fallback;
+            const text = raw.trim();
+            if (text === '')
+                return fallback;
+            const parsed = Number(text);
+            if (Number.isNaN(parsed))
+                return fallback;
+            return clamp(parsed, min, max);
+        },
+        serialize(value) {
+            if (typeof value !== 'number' || value === fallback)
+                return null;
+            return String(clamp(value, min, max));
+        },
+    };
+}
+/**
+ * A free-text parameter, taken as written. The value is not trimmed: a
+ * leading space can be part of what the tool is showing.
+ * @param options - The default and the length limit.
+ * @returns The codec.
+ */
+export function stringParam(options = {}) {
+    const { default: fallback = '', maxLength } = options;
+    return {
+        parse(raw) {
+            if (raw === null)
+                return fallback;
+            return cut(raw, maxLength);
+        },
+        serialize(value) {
+            const text = cut(value, maxLength);
+            return text === fallback ? null : text;
+        },
+    };
+}
+/**
+ * One of a fixed set of names — a difficulty, a display mode, a format.
+ * A name the tool does not know falls back rather than throwing, so a link
+ * written before the set changed still opens.
+ * @param values - Every name the tool understands.
+ * @param fallback - The name an absent or unknown parameter reads as.
+ * @returns The codec.
+ */
+export function enumParam(values, fallback) {
+    return {
+        parse(raw) {
+            if (raw === null)
+                return fallback;
+            const text = raw.trim();
+            for (const value of values) {
+                if (value === text)
+                    return value;
+            }
+            return fallback;
+        },
+        serialize(value) {
+            if (value === fallback)
+                return null;
+            for (const candidate of values) {
+                if (candidate === value)
+                    return value;
+            }
+            return null;
+        },
+    };
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, Math.round(value)));
+}
+function cut(value, maxLength) {
+    if (maxLength === undefined || value.length <= maxLength)
+        return value;
+    return value.slice(0, maxLength);
+}
+//# sourceMappingURL=params.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/share/core/params.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+/** One `key=value` pair of a query string, already decoded. */
+export type QueryEntry = readonly [key: string, value: string];
+/**
+ * Read a query string into its pairs, in the order it wrote them.
+ *
+ * A `+` is a plus, not a space: a link carries structures such as
+ * `CC[N+](C)(C)C`, and the form-urlencoded reading of `+` would turn one into
+ * a different molecule without anything failing. A malformed escape is kept as
+ * written rather than throwing, so a link somebody retyped still opens.
+ * @param search - The query string, with or without its leading `?`, and without a fragment.
+ * @returns The pairs, decoded.
+ */
+export declare function parseQuery(search: string): QueryEntry[];
+/**
+ * Write pairs back into a query string, keeping the two characters a reader
+ * of these links cares about legible: a comma stays a comma rather than
+ * `%2C`, and a plus stays a plus rather than `%2B`. Both parse back
+ * identically through {@link parseQuery}.
+ * @param entries - The pairs to write, in the order they should appear.
+ * @returns The query string, without its leading `?`.
+ */
+export declare function serializeQuery(entries: readonly QueryEntry[]): string;
+/**
+ * The first value each key carries, which is what a link means when it names
+ * the same parameter twice.
+ * @param entries - The pairs of a query string.
+ * @returns One value per key.
+ */
+export declare function firstValues(entries: readonly QueryEntry[]): ReadonlyMap<string, string>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAYvD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7B"}

package/lib/share/core/query.js

@@ -0,0 +1,68 @@
+/**
+ * Read a query string into its pairs, in the order it wrote them.
+ *
+ * A `+` is a plus, not a space: a link carries structures such as
+ * `CC[N+](C)(C)C`, and the form-urlencoded reading of `+` would turn one into
+ * a different molecule without anything failing. A malformed escape is kept as
+ * written rather than throwing, so a link somebody retyped still opens.
+ * @param search - The query string, with or without its leading `?`, and without a fragment.
+ * @returns The pairs, decoded.
+ */
+export function parseQuery(search) {
+    const text = search.startsWith('?') ? search.slice(1) : search;
+    const entries = [];
+    if (text === '')
+        return entries;
+    for (const chunk of text.split('&')) {
+        if (chunk === '')
+            continue;
+        const separator = chunk.indexOf('=');
+        const key = separator === -1 ? chunk : chunk.slice(0, separator);
+        const value = separator === -1 ? '' : chunk.slice(separator + 1);
+        entries.push([decodeComponent(key), decodeComponent(value)]);
+    }
+    return entries;
+}
+/**
+ * Write pairs back into a query string, keeping the two characters a reader
+ * of these links cares about legible: a comma stays a comma rather than
+ * `%2C`, and a plus stays a plus rather than `%2B`. Both parse back
+ * identically through {@link parseQuery}.
+ * @param entries - The pairs to write, in the order they should appear.
+ * @returns The query string, without its leading `?`.
+ */
+export function serializeQuery(entries) {
+    const chunks = [];
+    for (const [key, value] of entries) {
+        chunks.push(`${encodeComponent(key)}=${encodeComponent(value)}`);
+    }
+    return chunks.join('&');
+}
+/**
+ * The first value each key carries, which is what a link means when it names
+ * the same parameter twice.
+ * @param entries - The pairs of a query string.
+ * @returns One value per key.
+ */
+export function firstValues(entries) {
+    const values = new Map();
+    for (const [key, value] of entries) {
+        if (!values.has(key))
+            values.set(key, value);
+    }
+    return values;
+}
+function decodeComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+function encodeComponent(value) {
+    return encodeURIComponent(value)
+        .replaceAll('%2C', ',')
+        .replaceAll('%2B', '+');
+}
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,OAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,kBAAkB,CAAC,KAAK,CAAC;SAC7B,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC;SACtB,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,57 @@
+import type { ShareConfig } from './config.ts';
+import type { ShareParamCodecs, ShareVocabulary } from './vocabulary.ts';
+/** What {@link buildShareUrl} needs to write a link. */
+export interface ShareUrlOptions<Codecs extends ShareParamCodecs = Record<string, never>> {
+    /**
+     * Where the page is served from — origin and path. Anything from the first
+     * `?` or `#` is dropped, so the current address can be handed over as it is.
+     */
+    base: string;
+    /**
+     * The address as it stands, so the tool's own inputs travel with the link.
+     * @default ''
+     */
+    search?: string;
+    /** The configuration the link carries. */
+    config: ShareConfig<Codecs>;
+    /** What this site's links can say. */
+    vocabulary: ShareVocabulary<Codecs>;
+}
+/**
+ * The absolute link the share dialog hands out: the page, the tool's own
+ * inputs, and the configuration written over whatever the address carried.
+ * @param options - Where the page is, what it is showing, and how it is configured.
+ * @returns An absolute URL.
+ */
+export declare function buildShareUrl<Codecs extends ShareParamCodecs = Record<string, never>>(options: ShareUrlOptions<Codecs>): string;
+/** What {@link buildEmbedCode} needs to write the snippet. */
+export interface EmbedCodeOptions {
+    /** The link the frame loads. */
+    url: string;
+    /** What a screen reader announces the frame as; a frame without one is unreadable. */
+    title: string;
+    /**
+     * Height of the frame, in pixels.
+     * @default 700
+     */
+    height?: number;
+    /**
+     * Width of the frame; a number is taken as pixels.
+     * @default '100%'
+     */
+    width?: number | string;
+    /**
+     * The CSS border the frame is drawn with.
+     * @default '1px solid #ddd'
+     */
+    border?: string;
+}
+/**
+ * The snippet to paste into a course page: one iframe loading the shared link.
+ * Every value is escaped, so an address carrying an ampersand or a title
+ * carrying a quote cannot break out of its attribute.
+ * @param options - The link, its accessible name and the frame's dimensions.
+ * @returns One line of HTML.
+ */
+export declare function buildEmbedCode(options: EmbedCodeOptions): string;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/share/core/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzE,wDAAwD;AACxD,MAAM,WAAW,eAAe,CAC9B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,sCAAsC;IACtC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACvD,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,CAK1C;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAiBhE"}

package/lib/share/core/url.js

@@ -0,0 +1,49 @@
+import { applyShareConfig } from "./config.js";
+import { escapeAttribute } from "./escape.js";
+/**
+ * The absolute link the share dialog hands out: the page, the tool's own
+ * inputs, and the configuration written over whatever the address carried.
+ * @param options - Where the page is, what it is showing, and how it is configured.
+ * @returns An absolute URL.
+ */
+export function buildShareUrl(options) {
+    const { base, search = '', config, vocabulary } = options;
+    const query = applyShareConfig(search, config, vocabulary);
+    const address = trimAddress(base);
+    return query === '' ? address : `${address}?${query}`;
+}
+/**
+ * The snippet to paste into a course page: one iframe loading the shared link.
+ * Every value is escaped, so an address carrying an ampersand or a title
+ * carrying a quote cannot break out of its attribute.
+ * @param options - The link, its accessible name and the frame's dimensions.
+ * @returns One line of HTML.
+ */
+export function buildEmbedCode(options) {
+    const { url, title, height = DEFAULT_HEIGHT, width = '100%', border = '1px solid #ddd', } = options;
+    const style = `border: ${border}; border-radius: 8px`;
+    return [
+        `<iframe src="${escapeAttribute(url)}"`,
+        `title="${escapeAttribute(title)}"`,
+        `width="${escapeAttribute(formatWidth(width))}"`,
+        `height="${formatHeight(height)}"`,
+        `style="${escapeAttribute(style)}"`,
+        'loading="lazy"></iframe>',
+    ].join(' ');
+}
+const DEFAULT_HEIGHT = 700;
+function trimAddress(base) {
+    const cut = base.search(/[#?]/);
+    return cut === -1 ? base : base.slice(0, cut);
+}
+function formatWidth(width) {
+    if (typeof width !== 'number')
+        return width;
+    return String(Math.max(1, Math.round(width)));
+}
+function formatHeight(height) {
+    if (!Number.isFinite(height))
+        return String(DEFAULT_HEIGHT);
+    return String(Math.max(1, Math.round(height)));
+}
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/share/core/url.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAuB9C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAE3B,OAAgC;IAChC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC1D,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC;AACxD,CAAC;AAyBD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,EACJ,GAAG,EACH,KAAK,EACL,MAAM,GAAG,cAAc,EACvB,KAAK,GAAG,MAAM,EACd,MAAM,GAAG,gBAAgB,GAC1B,GAAG,OAAO,CAAC;IACZ,MAAM,KAAK,GAAG,WAAW,MAAM,sBAAsB,CAAC;IACtD,OAAO;QACL,gBAAgB,eAAe,CAAC,GAAG,CAAC,GAAG;QACvC,UAAU,eAAe,CAAC,KAAK,CAAC,GAAG;QACnC,UAAU,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG;QAChD,WAAW,YAAY,CAAC,MAAM,CAAC,GAAG;QAClC,UAAU,eAAe,CAAC,KAAK,CAAC,GAAG;QACnC,0BAA0B;KAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,KAAsB;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,51 @@
+import type { ShareParamCodec } from './params.ts';
+/**
+ * A part of a page a shared link can switch off through `?hide=`.
+ *
+ * The label is written positively — the dialog shows a ticked box for a part
+ * that stays visible — and the description says what switching it off does,
+ * for the person building the link rather than for the visitor.
+ */
+export interface HideablePart {
+    /** The name this part takes in `?hide=`, in lowerCamelCase. */
+    key: string;
+    /** How the part is named in the dialog. */
+    label: string;
+    /** What hiding it does. */
+    description: string;
+    /**
+     * Whether the dialog starts with this part already switched off, because it
+     * is noise inside somebody else's page.
+     * @default false
+     */
+    hiddenByDefault?: boolean;
+}
+/**
+ * The codecs of a tool's own parameters, keyed by the name each takes in the
+ * query string.
+ */
+export type ShareParamCodecs = Readonly<Record<string, ShareParamCodec<unknown>>>;
+/** The value each codec of a set reads and writes. */
+export type ShareParamValues<Codecs extends ShareParamCodecs> = {
+    [Key in keyof Codecs]: Codecs[Key] extends ShareParamCodec<infer Value> ? Value : never;
+};
+/**
+ * Everything one site's links can say: the parts they can switch off, and the
+ * typed parameters they carry beyond `embed` and `hide`.
+ *
+ * This is the only place that knows those names. A key it does not list is a
+ * tool input, left alone by every function here.
+ */
+export interface ShareVocabulary<Codecs extends ShareParamCodecs = Record<string, never>> {
+    /**
+     * The hideable parts, in the order `?hide=` and the dialog list them, so one
+     * selection always produces one link.
+     */
+    parts: readonly HideablePart[];
+    /**
+     * The tool's own parameters — a series length, a zoom, a seed.
+     * @default {}
+     */
+    params?: Codecs;
+}
+//# sourceMappingURL=vocabulary.d.ts.map

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

@@ -0,0 +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;CAC3B;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"}

package/lib/share/core/vocabulary.js

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

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

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

package/lib/share/ui/HiddenPartsProvider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface HiddenPartsProviderProps {
+    /**
+     * The parts the link switches off — the `hidden` of the parsed
+     * configuration.
+     * @default [] — nothing is switched off
+     */
+    hidden?: readonly string[];
+    /** The page, and everything in it that may ask what is hidden. */
+    children: ReactNode;
+}
+/**
+ * Put the configuration of the current link where every part of the page can
+ * read it, so nothing has to be threaded through props.
+ * @param props - The parts the link switches off, and the page.
+ * @returns The page, under the configuration.
+ */
+export declare function HiddenPartsProvider(props: HiddenPartsProviderProps): ReactElement;
+//# sourceMappingURL=HiddenPartsProvider.d.ts.map

package/lib/share/ui/HiddenPartsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HiddenPartsProvider.d.ts","sourceRoot":"","sources":["../../../src/share/ui/HiddenPartsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKrD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CASd"}

package/lib/share/ui/HiddenPartsProvider.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { HiddenPartsContext } from "./hiddenParts.js";
+/**
+ * Put the configuration of the current link where every part of the page can
+ * read it, so nothing has to be threaded through props.
+ * @param props - The parts the link switches off, and the page.
+ * @returns The page, under the configuration.
+ */
+export function HiddenPartsProvider(props) {
+    const { hidden, children } = props;
+    const parts = useMemo(() => new Set(hidden), [hidden]);
+    return (_jsx(HiddenPartsContext.Provider, { value: parts, children: children }));
+}
+//# sourceMappingURL=HiddenPartsProvider.js.map

package/lib/share/ui/HiddenPartsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HiddenPartsProvider.js","sourceRoot":"","sources":["../../../src/share/ui/HiddenPartsProvider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAatD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA+B;IAE/B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACtC,QAAQ,GACmB,CAC/B,CAAC;AACJ,CAAC"}

package/lib/share/ui/PagePart.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react';
+export interface PagePartProps {
+    /** The name this region takes in `?hide=`. */
+    part: string;
+    /** What the region draws. */
+    children: ReactNode;
+}
+/**
+ * A region of the page a shared link may leave out.
+ *
+ * A switched-off part is dropped from the tree rather than hidden with CSS: an
+ * embedded figure must not mount a 3D canvas, or run a search, for a panel
+ * nobody will see.
+ * @param props - Which region this is, and what it draws.
+ * @returns The children, or nothing.
+ */
+export declare function PagePart(props: PagePartProps): ReactNode;
+//# sourceMappingURL=PagePart.d.ts.map

package/lib/share/ui/PagePart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagePart.d.ts","sourceRoot":"","sources":["../../../src/share/ui/PagePart.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAKxD"}

package/lib/share/ui/PagePart.js

@@ -0,0 +1,16 @@
+import { useIsHidden } from "./hiddenParts.js";
+/**
+ * A region of the page a shared link may leave out.
+ *
+ * A switched-off part is dropped from the tree rather than hidden with CSS: an
+ * embedded figure must not mount a 3D canvas, or run a search, for a panel
+ * nobody will see.
+ * @param props - Which region this is, and what it draws.
+ * @returns The children, or nothing.
+ */
+export function PagePart(props) {
+    const { part, children } = props;
+    const isHidden = useIsHidden();
+    return isHidden(part) ? null : children;
+}
+//# sourceMappingURL=PagePart.js.map

package/lib/share/ui/PagePart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagePart.js","sourceRoot":"","sources":["../../../src/share/ui/PagePart.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC"}