forgebook 0.1.2 → 0.1.4

package/dist/src/toolbarLayout.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Where each control of the toolbar and the View menu sits for the person using a catalogue: whether it is pinned on
+ * the toolbar, whether it is hidden in the View menu, and one order both follow.
+ *
+ * @remarks
+ * Two levels, kept apart: the catalogue decides which controls exist (its switches, and Forgebook's own it did not turn
+ * off) and which start on the toolbar; the person decides where each one shows and in what order. Pinned and hidden
+ * are two choices, not one: a control can sit on the toolbar and take no row in the View menu, sit in both, sit in
+ * the View menu only, or show nowhere (its value still applies from the address; it only takes no room, and the
+ * menu's hidden list still reaches it). The arrangement is a convenience of the person's, kept in their browser
+ * (`useStored`), never in the address: a link shares the values, not how someone arranged their bar. A stored
+ * arrangement is resolved against the catalogue as it is now: a control it no longer has is dropped, a new one goes to
+ * the View menu, at the end. Pure.
+ *
+ * @module
+ */
+import type { CatalogueSettings, OwnControlId } from "./catalogue.ts";
+import type { ViewSwitch } from "./switches.ts";
+/** A control of the toolbar and the View menu: one of the catalogue's switches, or one of Forgebook's own. */
+export type ToolbarControl = {
+    /** A switch the catalogue declares. */
+    readonly kind: "switch";
+    /** The switch's id. */
+    readonly id: string;
+    /** The switch. */
+    readonly switch: ViewSwitch;
+} | {
+    /** One of Forgebook's own controls. */
+    readonly kind: "own";
+    /** The control's id. */
+    readonly id: OwnControlId;
+};
+/** A control and where it shows. */
+export type PlacedControl = {
+    /** The control. */
+    readonly control: ToolbarControl;
+    /** Whether it sits on the toolbar. */
+    readonly isPinned: boolean;
+    /** Whether it takes no row in the View menu (its hidden list still holds it). */
+    readonly isHidden: boolean;
+};
+/** A person's arrangement, as their browser keeps it: every control's id in their order, and the pinned and hidden. */
+export type ToolbarArrangement = {
+    /** The controls' ids, in the order the View menu lists them and the toolbar shows the pinned ones. */
+    readonly order: readonly string[];
+    /** The ids of the controls on the toolbar. */
+    readonly pinned: readonly string[];
+    /** The ids of the controls hidden in the View menu. */
+    readonly hidden: readonly string[];
+};
+/** The part of a catalogue's settings the arrangement reads. */
+type ArrangedCatalogue = Pick<CatalogueSettings, "switches" | "ownControls" | "toolbar">;
+/**
+ * Every control a catalogue shows, in its own order: its switches as it declares them, then Forgebook's own.
+ *
+ * @param catalogue - the catalogue's switches and controls.
+ */
+export declare const catalogueControls: (catalogue: Pick<CatalogueSettings, "switches" | "ownControls">) => ToolbarControl[];
+/**
+ * The controls as the catalogue places them before a person arranges anything: those it starts on the toolbar first,
+ * in its order and pinned, then the others, in their own order; none hidden.
+ *
+ * @param catalogue - the catalogue's switches, controls and starting toolbar.
+ */
+export declare const defaultControls: (catalogue: ArrangedCatalogue) => PlacedControl[];
+/**
+ * The controls placed by a person's arrangement, or by the catalogue when there is none: the arrangement's controls
+ * the catalogue still has, in its order, then the catalogue's new ones in the View menu.
+ *
+ * @param catalogue - the catalogue's switches, controls and starting toolbar.
+ * @param arrangement - the person's arrangement, when they made one.
+ */
+export declare const placedControls: (catalogue: ArrangedCatalogue, arrangement: ToolbarArrangement | undefined) => PlacedControl[];
+/**
+ * The arrangement that places the controls as they are.
+ *
+ * @param placed - the placed controls.
+ */
+export declare const arrangementOf: (placed: readonly PlacedControl[]) => ToolbarArrangement;
+/**
+ * The controls with one pinned on the toolbar or taken off it, keeping its position in the order.
+ *
+ * @param placed - the placed controls.
+ * @param id - the control's id.
+ * @param isPinned - whether it sits on the toolbar.
+ */
+export declare const withPinned: (placed: readonly PlacedControl[], id: string, isPinned: boolean) => PlacedControl[];
+/**
+ * The controls with one hidden in the View menu or shown there again, keeping its position in the order.
+ *
+ * @param placed - the placed controls.
+ * @param id - the control's id.
+ * @param isHidden - whether it takes no row in the View menu.
+ */
+export declare const withHidden: (placed: readonly PlacedControl[], id: string, isHidden: boolean) => PlacedControl[];
+/**
+ * The controls with one moved to a position among the View menu's rows (hidden ones left out); a hidden control
+ * keeps its position in the whole order, so showing it again brings it back where it was.
+ *
+ * @param placed - the placed controls.
+ * @param id - the moved control's id; a hidden one or an unknown one leaves the order as it is.
+ * @param index - its new position among the shown controls, clamped to them.
+ */
+export declare const withPosition: (placed: readonly PlacedControl[], id: string, index: number) => PlacedControl[];
+/**
+ * A stored arrangement read back, or none when the text holds none or not one this module wrote (an older format,
+ * an edit by hand): the catalogue's placing then applies.
+ *
+ * @param stored - the stored text, or none.
+ */
+export declare const readArrangement: (stored: string | null) => ToolbarArrangement | undefined;
+/**
+ * The text an arrangement is stored as; empty for none, so the catalogue's placing applies.
+ *
+ * @param arrangement - the arrangement, or none.
+ */
+export declare const arrangementText: (arrangement: ToolbarArrangement | undefined) => string;
+export {};
+//# sourceMappingURL=toolbarLayout.d.ts.map

package/dist/src/toolbarLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbarLayout.d.ts","sourceRoot":"","sources":["../../src/toolbarLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,8GAA8G;AAC9G,MAAM,MAAM,cAAc,GACtB;IACE,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,GACD;IACE,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEN,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,uHAAuH;AACvH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sGAAsG;IACtG,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,gEAAgE;AAChE,KAAK,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,aAAa,CAAC,KAC7D,cAAc,EAGhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,iBAAiB,KAAG,aAAa,EAS3E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,WAAW,iBAAiB,EAC5B,aAAa,kBAAkB,GAAG,SAAS,KAC1C,aAAa,EAkBf,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,aAAa,EAAE,KAAG,kBAI/D,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,SAAS,aAAa,EAAE,EAChC,IAAI,MAAM,EACV,UAAU,OAAO,KAChB,aAAa,EAAmF,CAAC;AAEpG;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,SAAS,aAAa,EAAE,EAChC,IAAI,MAAM,EACV,UAAU,OAAO,KAChB,aAAa,EAAmF,CAAC;AAEpG;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,SAAS,aAAa,EAAE,EAChC,IAAI,MAAM,EACV,OAAO,MAAM,KACZ,aAAa,EAef,CAAC;AAUF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,kBAAkB,GAAG,SAa5E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,aAAa,kBAAkB,GAAG,SAAS,KAAG,MAChB,CAAC"}

package/dist/src/toolbarLayout.js

@@ -0,0 +1,155 @@
+/**
+ * Where each control of the toolbar and the View menu sits for the person using a catalogue: whether it is pinned on
+ * the toolbar, whether it is hidden in the View menu, and one order both follow.
+ *
+ * @remarks
+ * Two levels, kept apart: the catalogue decides which controls exist (its switches, and Forgebook's own it did not turn
+ * off) and which start on the toolbar; the person decides where each one shows and in what order. Pinned and hidden
+ * are two choices, not one: a control can sit on the toolbar and take no row in the View menu, sit in both, sit in
+ * the View menu only, or show nowhere (its value still applies from the address; it only takes no room, and the
+ * menu's hidden list still reaches it). The arrangement is a convenience of the person's, kept in their browser
+ * (`useStored`), never in the address: a link shares the values, not how someone arranged their bar. A stored
+ * arrangement is resolved against the catalogue as it is now: a control it no longer has is dropped, a new one goes to
+ * the View menu, at the end. Pure.
+ *
+ * @module
+ */
+/**
+ * Every control a catalogue shows, in its own order: its switches as it declares them, then Forgebook's own.
+ *
+ * @param catalogue - the catalogue's switches and controls.
+ */
+export const catalogueControls = (catalogue) => [
+    ...catalogue.switches.map((each) => ({ kind: "switch", id: each.id, switch: each })),
+    ...catalogue.ownControls.map((id) => ({ kind: "own", id }))
+];
+/**
+ * The controls as the catalogue places them before a person arranges anything: those it starts on the toolbar first,
+ * in its order and pinned, then the others, in their own order; none hidden.
+ *
+ * @param catalogue - the catalogue's switches, controls and starting toolbar.
+ */
+export const defaultControls = (catalogue) => {
+    const controls = catalogueControls(catalogue);
+    const pinned = catalogue.toolbar.flatMap((id) => controls.filter((control) => control.id === id));
+    return [
+        ...pinned.map((control) => ({ control, isPinned: true, isHidden: false })),
+        ...controls
+            .filter((control) => !catalogue.toolbar.includes(control.id))
+            .map((control) => ({ control, isPinned: false, isHidden: false }))
+    ];
+};
+/**
+ * The controls placed by a person's arrangement, or by the catalogue when there is none: the arrangement's controls
+ * the catalogue still has, in its order, then the catalogue's new ones in the View menu.
+ *
+ * @param catalogue - the catalogue's switches, controls and starting toolbar.
+ * @param arrangement - the person's arrangement, when they made one.
+ */
+export const placedControls = (catalogue, arrangement) => {
+    if (arrangement === undefined)
+        return defaultControls(catalogue);
+    const controls = catalogueControls(catalogue);
+    const kept = arrangement.order.flatMap((id) => controls
+        .filter((control) => control.id === id)
+        .map((control) => ({
+        control,
+        isPinned: arrangement.pinned.includes(id),
+        isHidden: arrangement.hidden.includes(id)
+    })));
+    const added = controls
+        .filter((control) => !arrangement.order.includes(control.id))
+        .map((control) => ({ control, isPinned: false, isHidden: false }));
+    return [...kept, ...added];
+};
+/**
+ * The arrangement that places the controls as they are.
+ *
+ * @param placed - the placed controls.
+ */
+export const arrangementOf = (placed) => ({
+    order: placed.map((each) => each.control.id),
+    pinned: placed.filter((each) => each.isPinned).map((each) => each.control.id),
+    hidden: placed.filter((each) => each.isHidden).map((each) => each.control.id)
+});
+/**
+ * The controls with one pinned on the toolbar or taken off it, keeping its position in the order.
+ *
+ * @param placed - the placed controls.
+ * @param id - the control's id.
+ * @param isPinned - whether it sits on the toolbar.
+ */
+export const withPinned = (placed, id, isPinned) => placed.map((each) => (each.control.id === id ? { ...each, isPinned } : each));
+/**
+ * The controls with one hidden in the View menu or shown there again, keeping its position in the order.
+ *
+ * @param placed - the placed controls.
+ * @param id - the control's id.
+ * @param isHidden - whether it takes no row in the View menu.
+ */
+export const withHidden = (placed, id, isHidden) => placed.map((each) => (each.control.id === id ? { ...each, isHidden } : each));
+/**
+ * The controls with one moved to a position among the View menu's rows (hidden ones left out); a hidden control
+ * keeps its position in the whole order, so showing it again brings it back where it was.
+ *
+ * @param placed - the placed controls.
+ * @param id - the moved control's id; a hidden one or an unknown one leaves the order as it is.
+ * @param index - its new position among the shown controls, clamped to them.
+ */
+export const withPosition = (placed, id, index) => {
+    const shown = placed.filter((each) => !each.isHidden);
+    const moved = shown.find((each) => each.control.id === id);
+    if (moved === undefined)
+        return [...placed];
+    const others = shown.filter((each) => each !== moved);
+    const at = Math.min(Math.max(index, 0), others.length);
+    const reordered = [...others.slice(0, at), moved, ...others.slice(at)];
+    // the shown controls take the shown positions, in their new order; the hidden ones stay where they were
+    let next = 0;
+    return placed.map((each) => {
+        if (each.isHidden)
+            return each;
+        const taken = reordered[next] ?? each;
+        next += 1;
+        return taken;
+    });
+};
+/**
+ * The strings of a list read back, the rest left out.
+ *
+ * @param value - what the stored text holds there.
+ */
+const idsOf = (value) => Array.isArray(value) ? value.filter((id) => typeof id === "string") : [];
+/**
+ * A stored arrangement read back, or none when the text holds none or not one this module wrote (an older format,
+ * an edit by hand): the catalogue's placing then applies.
+ *
+ * @param stored - the stored text, or none.
+ */
+export const readArrangement = (stored) => {
+    if (stored === null || stored === "")
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(stored);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return undefined;
+    if (!("order" in parsed) || !Array.isArray(parsed.order))
+        return undefined;
+    if (!("pinned" in parsed) || !Array.isArray(parsed.pinned))
+        return undefined;
+    if (!("hidden" in parsed) || !Array.isArray(parsed.hidden))
+        return undefined;
+    return { order: idsOf(parsed.order), pinned: idsOf(parsed.pinned), hidden: idsOf(parsed.hidden) };
+};
+/**
+ * The text an arrangement is stored as; empty for none, so the catalogue's placing applies.
+ *
+ * @param arrangement - the arrangement, or none.
+ */
+export const arrangementText = (arrangement) => arrangement === undefined ? "" : JSON.stringify(arrangement);
+//# sourceMappingURL=toolbarLayout.js.map

package/dist/src/toolbarLayout.js.map

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

package/dist/src/usedIn.d.ts

@@ -0,0 +1,60 @@
+/**
+ * "Used in": for each component of a source, the other components whose stories use it, directly (their JSX renders
+ * it) or through another component that renders it; the shape the plugin's usage modules answer, read by the
+ * component page and the agents' answers.
+ *
+ * @remarks
+ * Each `?forgebook-files` group answers for its own files (`usage`, loaded only when asked): a source's groups are
+ * merged here. A component lists the stories of its own source only, never its own stories nor the components its meta
+ * names in `related`. Pure apart from the loaders it calls.
+ *
+ * @module
+ */
+import type { StorySource } from "@forgebook/story-format/source";
+/** A component whose stories use another. */
+export type UsingComponent = {
+    /** Its title (`Navigation/Tree`). */
+    readonly title: string;
+    /** Whether one of its stories renders the component itself, not only through another component. */
+    readonly isDirect: boolean;
+    /** The exports of its stories that use the component, in their file's order. */
+    readonly stories: readonly string[];
+};
+/** For each component of a group or a source, by title, the components that use it, direct ones first. */
+export type UsageIndex = Readonly<Record<string, readonly UsingComponent[]>>;
+/** How many using components a page shows before "and N more". */
+export declare const USED_IN_SHOWN = 12;
+/**
+ * Whether a usage module's answer is a usage index.
+ *
+ * @param value - what the module exports by default.
+ */
+export declare const isUsageIndex: (value: unknown) => value is UsageIndex;
+/**
+ * The using components in the order a page shows them: direct ones first, then by how many stories use the
+ * component, then by title.
+ *
+ * @param users - the using components.
+ */
+export declare const usersInOrder: (users: readonly UsingComponent[]) => UsingComponent[];
+/**
+ * Several groups' usage as one: a component's users from every group, in the page's order.
+ *
+ * @param indexes - the groups' usage.
+ */
+export declare const mergedUsage: (indexes: readonly UsageIndex[]) => UsageIndex;
+/**
+ * A source's usage: each group's usage module loaded and merged; an empty index when its groups have none (a
+ * catalogue that turned "Used in" off, a source built before it).
+ *
+ * @param source - the source.
+ * @returns the usage, or why a group's could not be read.
+ */
+export declare const sourceUsage: (source: StorySource) => Promise<UsageIndex | string>;
+/**
+ * A source's usage loader: the same function for the same source, its answer read once.
+ *
+ * @param source - the source.
+ */
+export declare const usageLoader: (source: StorySource) => (() => Promise<UsageIndex | string>);
+//# sourceMappingURL=usedIn.d.ts.map

package/dist/src/usedIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usedIn.d.ts","sourceRoot":"","sources":["../../src/usedIn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC,CAAC;AAE7E,kEAAkE;AAClE,eAAO,MAAM,aAAa,KAAK,CAAC;AAyBhC;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,UAGuC,CAAC;AAE/F;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,cAAc,EAAE,KAAG,cAAc,EAM3E,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,SAAS,UAAU,EAAE,KAAG,UAK5D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAU,QAAQ,WAAW,KAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAiBlF,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,KAAG,CAAC,MAAM,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAUpF,CAAC"}

package/dist/src/usedIn.js

@@ -0,0 +1,92 @@
+/** How many using components a page shows before "and N more". */
+export const USED_IN_SHOWN = 12;
+/**
+ * Whether a value is a list of strings.
+ *
+ * @param value - the value.
+ */
+const isStrings = (value) => Array.isArray(value) && value.every((each) => typeof each === "string");
+/**
+ * Whether a value is a using component.
+ *
+ * @param value - the value.
+ */
+const isUsingComponent = (value) => typeof value === "object" &&
+    value !== null &&
+    "title" in value &&
+    typeof value.title === "string" &&
+    "isDirect" in value &&
+    typeof value.isDirect === "boolean" &&
+    "stories" in value &&
+    isStrings(value.stories);
+/**
+ * Whether a usage module's answer is a usage index.
+ *
+ * @param value - what the module exports by default.
+ */
+export const isUsageIndex = (value) => typeof value === "object" &&
+    value !== null &&
+    Object.values(value).every((users) => Array.isArray(users) && users.every(isUsingComponent));
+/**
+ * The using components in the order a page shows them: direct ones first, then by how many stories use the
+ * component, then by title.
+ *
+ * @param users - the using components.
+ */
+export const usersInOrder = (users) => [...users].sort((first, second) => Number(second.isDirect) - Number(first.isDirect) ||
+    second.stories.length - first.stories.length ||
+    first.title.localeCompare(second.title));
+/**
+ * Several groups' usage as one: a component's users from every group, in the page's order.
+ *
+ * @param indexes - the groups' usage.
+ */
+export const mergedUsage = (indexes) => {
+    const merged = {};
+    for (const index of indexes)
+        for (const [title, users] of Object.entries(index))
+            merged[title] = [...(merged[title] ?? []), ...users];
+    return Object.fromEntries(Object.entries(merged).map(([title, users]) => [title, usersInOrder(users)]));
+};
+/**
+ * A source's usage: each group's usage module loaded and merged; an empty index when its groups have none (a
+ * catalogue that turned "Used in" off, a source built before it).
+ *
+ * @param source - the source.
+ * @returns the usage, or why a group's could not be read.
+ */
+export const sourceUsage = async (source) => {
+    const loaded = await Promise.all(source.files.flatMap((group) => (group.usage === undefined ? [] : [group.usage()])));
+    const indexes = [];
+    for (const answer of loaded) {
+        if (typeof answer === "object" &&
+            answer !== null &&
+            "error" in answer &&
+            typeof answer.error === "string")
+            return answer.error;
+        if (!isUsageIndex(answer))
+            return "A usage module answered something that is not a usage index";
+        indexes.push(answer);
+    }
+    return mergedUsage(indexes);
+};
+/** Each source's loader, made once, so a page asks for its usage once and its loader keeps one identity. */
+const LOADERS = new WeakMap();
+/**
+ * A source's usage loader: the same function for the same source, its answer read once.
+ *
+ * @param source - the source.
+ */
+export const usageLoader = (source) => {
+    const known = LOADERS.get(source);
+    if (known !== undefined)
+        return known;
+    let answer;
+    const load = () => {
+        answer ??= sourceUsage(source);
+        return answer;
+    };
+    LOADERS.set(source, load);
+    return load;
+};
+//# sourceMappingURL=usedIn.js.map

package/dist/src/usedIn.js.map

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

package/dist/src/viewState.d.ts

@@ -85,7 +85,7 @@ export declare const isComparing: (view: ViewState) => boolean;
 /** Every tool, in the bar's order. */
 export declare const MEASURE_TOOLS: readonly MeasureTool[];
 /** What the view reads of a catalogue: its switches and the lists its values are checked against. */
-export type ViewCatalogue = Pick<CatalogueSettings, "switches" | "widthRange" | "zooms" | "textSizes" | "backdrops" | "tabs">;
+export type ViewCatalogue = Pick<CatalogueSettings, "switches" | "widthRange" | "zooms" | "textSizes" | "backdrops" | "tabs" | "ownControls">;
 /**
  * A width kept in a catalogue's range, in whole pixels.
  *
@@ -126,19 +126,15 @@ export declare const defaultView: (catalogue: ViewCatalogue) => ViewState;
  */
 export declare const viewParams: (view: ViewState, switches: readonly ViewSwitch[]) => URLSearchParams;
 /**
- * Whether one of the View menu's settings is changed (a switch the toolbar does not show itself, the background,
- * the style sheets, the text size): the menu button then shows a dot, so a view is never left changed by mistake.
+ * Whether one of the given controls' values is changed (a switch, the background, the style sheets, the text size;
+ * the stage's width is not a view setting): the View menu's button shows a dot for the controls it holds, so a view
+ * is never left changed by mistake, even by a control the person hid.
  *
  * @param view - the view.
  * @param switches - the catalogue's switches.
+ * @param ids - the controls' ids.
  */
-export declare const hasViewChanges: (view: ViewState, switches: readonly ViewSwitch[]) => boolean;
-/**
- * Whether a switch sits in the View menu: every one but the colour scheme and the contrast, which the toolbar shows.
- *
- * @param each - the switch.
- */
-export declare const isMenuSwitch: (each: ViewSwitch) => boolean;
+export declare const hasViewChanges: (view: ViewState, switches: readonly ViewSwitch[], ids: readonly string[]) => boolean;
 /**
  * The address of a story's frame.
  *
@@ -191,4 +187,13 @@ export declare const codeGlobalsOf: (view: Pick<ViewState, "switches">, switches
  * @param search - the catalogue's query (`theme=dark&lang=it`), with or without `?`.
  */
 export declare const frameAddressOf: (frameUrl: string, id: string, search: string) => string;
+/**
+ * The address of a story's page in the catalogue from a catalogue's address query, for a tool that does not know the
+ * catalogue's switches: the story selected, the view kept as written.
+ *
+ * @param pageUrl - the catalogue's page (`http://localhost:5173/`).
+ * @param id - the story's id.
+ * @param search - the view's query (`theme=dark&lang=it`), with or without `?`.
+ */
+export declare const storyAddressOf: (pageUrl: string, id: string, search: string) => string;
 //# sourceMappingURL=viewState.d.ts.map

package/dist/src/viewState.d.ts.map

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

package/dist/src/viewState.js

@@ -90,7 +90,8 @@ const switchValuesOf = (params, switches) => Object.fromEntries(switches.map((ea
  * @param value - the parameter.
  * @param switches - the declared switches.
  */
-const compareAxesOf = (value, switches) => {
+const compareAxesOf = (value, catalogue) => {
+    const { switches, ownControls } = catalogue;
     if (value === null || value === "")
         return [];
     const scheme = switchWithRole(switches, "colorScheme");
@@ -101,7 +102,10 @@ const compareAxesOf = (value, switches) => {
         language: [switchWithRole(switches, "language")?.id]
     };
     const named = legacy[value] ?? value.split(",");
-    const known = [...switches.map((each) => each.id), ...OWN_COMPARE_AXES];
+    const known = [
+        ...switches.map((each) => each.id),
+        ...OWN_COMPARE_AXES.filter((axis) => ownControls.includes(axis))
+    ];
     return named.filter((axis) => axis !== undefined && known.includes(axis)).slice(0, 2);
 };
 /**
@@ -112,12 +116,14 @@ const compareAxesOf = (value, switches) => {
  */
 export const parseView = (search, catalogue) => {
     const params = new URLSearchParams(search);
+    // a control the catalogue turned off keeps its default, whatever the address says
+    const shown = (control) => catalogue.ownControls.includes(control) ? params.get(control) : null;
     return {
         switches: switchValuesOf(params, catalogue.switches),
-        backdrop: choice(params.get("backdrop"), catalogue.backdrops.map((backdrop) => backdrop.id), DEFAULT_VIEW.backdrop),
-        sheets: choice(params.get("sheets"), SHEETS_CHOICES, DEFAULT_VIEW.sheets),
-        text: choice(params.get("text"), catalogue.textSizes, DEFAULT_VIEW.text),
-        compare: compareAxesOf(params.get("compare"), catalogue.switches),
+        backdrop: choice(shown("backdrop"), catalogue.backdrops.map((backdrop) => backdrop.id), DEFAULT_VIEW.backdrop),
+        sheets: choice(shown("sheets"), SHEETS_CHOICES, DEFAULT_VIEW.sheets),
+        text: choice(shown("text"), catalogue.textSizes, DEFAULT_VIEW.text),
+        compare: compareAxesOf(params.get("compare"), catalogue),
         width: stageWidth(params.get("width"), catalogue.widthRange),
         height: stageHeight(params.get("height")),
         isPanelOpen: params.get("panel") !== "closed",
@@ -189,22 +195,18 @@ export const viewParams = (view, switches) => {
     return params;
 };
 /**
- * Whether one of the View menu's settings is changed (a switch the toolbar does not show itself, the background,
- * the style sheets, the text size): the menu button then shows a dot, so a view is never left changed by mistake.
+ * Whether one of the given controls' values is changed (a switch, the background, the style sheets, the text size;
+ * the stage's width is not a view setting): the View menu's button shows a dot for the controls it holds, so a view
+ * is never left changed by mistake, even by a control the person hid.
  *
  * @param view - the view.
  * @param switches - the catalogue's switches.
+ * @param ids - the controls' ids.
  */
-export const hasViewChanges = (view, switches) => switches.some((each) => isMenuSwitch(each) && !isDefault(view, each)) ||
-    view.backdrop !== DEFAULT_VIEW.backdrop ||
-    view.sheets !== DEFAULT_VIEW.sheets ||
-    view.text !== DEFAULT_VIEW.text;
-/**
- * Whether a switch sits in the View menu: every one but the colour scheme and the contrast, which the toolbar shows.
- *
- * @param each - the switch.
- */
-export const isMenuSwitch = (each) => each.role !== "colorScheme" && each.role !== "contrast";
+export const hasViewChanges = (view, switches, ids) => switches.some((each) => ids.includes(each.id) && !isDefault(view, each)) ||
+    (ids.includes("backdrop") && view.backdrop !== DEFAULT_VIEW.backdrop) ||
+    (ids.includes("sheets") && view.sheets !== DEFAULT_VIEW.sheets) ||
+    (ids.includes("text") && view.text !== DEFAULT_VIEW.text);
 /**
  * The address of a story's frame.
  *
@@ -300,4 +302,19 @@ export const frameAddressOf = (frameUrl, id, search) => {
     params.set("story", id);
     return `${frameUrl}?${params.toString()}`;
 };
+/**
+ * The address of a story's page in the catalogue from a catalogue's address query, for a tool that does not know the
+ * catalogue's switches: the story selected, the view kept as written.
+ *
+ * @param pageUrl - the catalogue's page (`http://localhost:5173/`).
+ * @param id - the story's id.
+ * @param search - the view's query (`theme=dark&lang=it`), with or without `?`.
+ */
+export const storyAddressOf = (pageUrl, id, search) => {
+    const params = new URLSearchParams(search);
+    params.delete("component");
+    params.delete("story");
+    params.set("story", id);
+    return `${pageUrl}?${params.toString()}`;
+};
 //# sourceMappingURL=viewState.js.map