forgebook 0.0.0-stage → 0.1.2

package/dist/src/shell/strings.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Every text the catalogue's shell shows, in one place: the catalogue is a development tool in English, and keeping
+ * its words together keeps them consistent and ready for a translation.
+ *
+ * @remarks
+ * A catalogue may replace any plain text by its name (`strings: { props: "Controls", "tabs.props": "Controls" }` in
+ * its configuration): the shell applies the replacements once, before it draws (`configureStrings`), as a translation
+ * is set up, so every module keeps reading `STRINGS`. A text that takes values (`allStories(count)`) stays the shell's.
+ *
+ * @module
+ */
+import type { TextScale } from "../viewState.ts";
+/** The shell's texts, as Forgebook writes them; `configureStrings` replaces some before the shell draws. */
+declare const shellStrings: {
+    searchPlaceholder: string;
+    searchLabel: string;
+    componentsNav: string;
+    sidebarWidth: string;
+    hideSidebar: string;
+    showSidebar: string;
+    storiesNav: string;
+    allStories: (count: number) => string;
+    noMatch: string;
+    aliasPlace: (family: string) => string;
+    aliasHint: (place: string) => string;
+    alsoIn: (places: string) => string;
+    related: string;
+    view: string;
+    viewChanged: string;
+    backdrop: string;
+    backdropPlain: string;
+    sheets: string;
+    sheetChoices: {
+        full: string;
+        structure: string;
+        restyled: string;
+    };
+    text: string;
+    textScale: (scale: TextScale) => string;
+    resetView: string;
+    viewInAddress: string;
+    compare: string;
+    compareOff: string;
+    compareText: string;
+    compareSheets: string;
+    compareOf: (labels: readonly string[]) => string;
+    compareCell: (labels: readonly string[]) => string;
+    width: string;
+    widthFill: string;
+    widthPx: (width: number) => string;
+    copyStoryId: string;
+    clearSearch: string;
+    fromTexts: string;
+    backToText: string;
+    widthTyped: string;
+    widthAuto: string;
+    zoom: string;
+    zoomIn: string;
+    zoomOut: string;
+    zoomReset: string;
+    stageTools: string;
+    tools: {
+        outline: string;
+        grid: string;
+        measure: string;
+    };
+    widthHandle: string;
+    widthHandleHint: string;
+    heightHandle: string;
+    heightHandleHint: string;
+    widthFillNote: string;
+    panel: string;
+    panelHeight: string;
+    closePanel: string;
+    tabs: {
+        props: string;
+        events: string;
+        play: string;
+        parts: string;
+        code: string;
+        a11y: string;
+    };
+    playTitle: string;
+    playStatus: {
+        running: string;
+        passed: string;
+        failed: string;
+    };
+    playTime: (ms: number) => string;
+    playAgain: string;
+    playNoSteps: string;
+    fixedExamples: string;
+    allProps: string;
+    openFrame: string;
+    code: string;
+    codeFromArgs: string;
+    codeRender: string;
+    codeError: string;
+    copy: string;
+    copied: string;
+    matrix: string;
+    matrixNone: string;
+    matrixColumns: string;
+    a11y: string;
+    a11yCheck: string;
+    a11yRunning: string;
+    a11yPasses: string;
+    a11yCount: (count: number) => string;
+    a11yNone: string;
+    a11yError: string;
+    a11yNotInCompare: string;
+    replay: string;
+    clockLabel: string;
+    clockPause: string;
+    clockResume: string;
+    clockRestart: string;
+    clockSpeed: string;
+    clockRate: (rate: number) => string;
+    loadingStory: string;
+    apiReference: string;
+    apiProp: string;
+    apiEvent: string;
+    apiType: string;
+    apiSignature: string;
+    apiDefault: string;
+    apiWhat: string;
+    showCode: string;
+    hideCode: string;
+    openStory: string;
+    examples: string;
+    pageError: string;
+    storyLabel: string;
+    frameTitle: (component: string, story: string) => string;
+    home: string;
+    homeEmpty: string;
+    homeSummary: (components: number, sources: number) => string;
+    homeIntroError: string;
+    recentlyOpened: string;
+    componentsCount: (count: number) => string;
+    showAll: (count: number) => string;
+    showFewer: string;
+    unknownStory: (id: string) => string;
+    unknownComponent: (id: string) => string;
+    props: string;
+    propGroups: {
+        choice: string;
+        text: string;
+        toggle: string;
+    };
+    otherProps: string;
+    unset: string;
+    unsetDefault: (value: string) => string;
+    defaultIs: string;
+    pickColor: (prop: string) => string;
+    rangeValue: (prop: string) => string;
+    setByStory: string;
+    required: string;
+    resetArgs: string;
+    events: string;
+    calls: string;
+    noCalls: string;
+    clearCalls: string;
+    parts: string;
+    partCount: (count: number) => string;
+    partsList: string;
+    styleHooks: string;
+    testIds: string;
+    noProps: string;
+    docsLoading: string;
+    docsError: string;
+    indexProblems: string;
+};
+/** The shell's texts. */
+export type ShellStrings = typeof shellStrings;
+/** The shell's texts, as shown. */
+export declare const STRINGS: ShellStrings;
+/**
+ * Applies a catalogue's replacements to the shell's texts, once, before the shell draws.
+ *
+ * @param replacements - the new texts, by their path (`tabs.props`).
+ */
+export declare const configureStrings: (replacements: Readonly<Record<string, string>>) => void;
+export {};
+//# sourceMappingURL=strings.d.ts.map

package/dist/src/shell/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../src/shell/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/D,4GAA4G;AAE5G,QAAA,MAAM,YAAY;;;;;;;;wBAQI,MAAM,KAAG,MAAM;;yBAEd,MAAM,KAAG,MAAM;uBACjB,MAAM,KAAG,MAAM;qBACjB,MAAM,KAAG,MAAM;;;;;;;;;;;;;uBAYb,SAAS,KAAG,MAAM;;;;;;;wBAOjB,SAAS,MAAM,EAAE,KAAG,MAAM;0BACxB,SAAS,MAAM,EAAE,KAAG,MAAM;;;qBAG/B,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAmCjB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;uBAmBX,MAAM,KAAG,MAAM;;;;;;;;;;sBAUhB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;4BAeT,MAAM,SAAS,MAAM,KAAG,MAAM;;;8BAG5B,MAAM,WAAW,MAAM,KAAG,MAAM;;;6BAIjC,MAAM,KAAG,MAAM;qBACvB,MAAM,KAAG,MAAM;;uBAEb,MAAM,KAAG,MAAM;2BAEX,MAAM,KAAG,MAAM;;;;;;;;;0BAMhB,MAAM,KAAG,MAAM;;sBAEnB,MAAM,KAAG,MAAM;uBACd,MAAM,KAAG,MAAM;;;;;;;;;uBASf,MAAM,KAAG,MAAM;;;;;;;;CAQnC,CAAC;AAEF,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C,mCAAmC;AACnC,eAAO,MAAM,OAAO,EAAE,YAA2B,CAAC;AA6BlD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,cAAc,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,IAEjF,CAAC"}

package/dist/src/shell/strings.js

@@ -0,0 +1,188 @@
+/** The shell's texts, as Forgebook writes them; `configureStrings` replaces some before the shell draws. */
+// biome-ignore lint/nursery/useExplicitType: the texts' type is their own shape (`ShellStrings`); a written one would repeat every key
+const shellStrings = {
+    searchPlaceholder: "Search",
+    searchLabel: "Search components and stories",
+    componentsNav: "Components",
+    sidebarWidth: "Sidebar width",
+    hideSidebar: "Hide the sidebar",
+    showSidebar: "Show the sidebar",
+    storiesNav: "Stories",
+    allStories: (count) => `All ${count} stories`,
+    noMatch: "No component matches",
+    aliasPlace: (family) => `in ${family}`,
+    aliasHint: (place) => `Lives in ${place}: listed here too`,
+    alsoIn: (places) => `also listed in ${places}`,
+    related: "Related",
+    view: "View",
+    viewChanged: "A view setting is changed",
+    backdrop: "Background",
+    backdropPlain: "Plain",
+    sheets: "Styles",
+    sheetChoices: { full: "Full", structure: "Structure only", restyled: "Restyled" },
+    text: "Text",
+    textScale: (scale) => `${scale}%`,
+    resetView: "Reset to defaults",
+    viewInAddress: "Saved in the address",
+    compare: "Compare",
+    compareOff: "Off",
+    compareText: "Text sizes",
+    compareSheets: "Styles",
+    compareOf: (labels) => labels.join(" × "),
+    compareCell: (labels) => labels.join(" · "),
+    width: "Width",
+    widthFill: "Fill",
+    widthPx: (width) => `${width}`,
+    copyStoryId: "Copy the story's id",
+    clearSearch: "Clear the search",
+    fromTexts: "From the story's texts:",
+    backToText: "Back to the text",
+    widthTyped: "Width in px",
+    widthAuto: "auto",
+    zoom: "Zoom",
+    zoomIn: "Zoom in",
+    zoomOut: "Zoom out",
+    zoomReset: "Back to 100%",
+    stageTools: "Zoom and measuring tools",
+    tools: {
+        outline: "Outline every element",
+        grid: "8 px grid",
+        measure: "Measure the element under the pointer"
+    },
+    widthHandle: "Story width",
+    widthHandleHint: "Drag to resize the story; double-click for the whole stage",
+    heightHandle: "Story height",
+    heightHandleHint: "Drag to change the story's height; double-click for its own",
+    widthFillNote: "Fill: the story takes the whole stage",
+    panel: "Panel",
+    panelHeight: "Panel height",
+    closePanel: "Close the panel",
+    tabs: {
+        props: "Props",
+        events: "Events",
+        play: "Interactions",
+        parts: "Parts and styling",
+        code: "Code",
+        a11y: "Accessibility"
+    },
+    playTitle: "Play function",
+    playStatus: { running: "running", passed: "passed", failed: "failed" },
+    playTime: (ms) => `${ms} ms`,
+    playAgain: "Run again",
+    playNoSteps: "The play names no steps: wrap its parts in step(label, run) to see them here.",
+    fixedExamples: "This story draws fixed examples: its props are not set from here. Every prop, for reading:",
+    allProps: "Props",
+    openFrame: "Open in a new tab",
+    code: "Code",
+    codeFromArgs: "from the args",
+    codeRender: "the story's render",
+    codeError: "The story's code could not be read",
+    copy: "Copy",
+    copied: "Copied",
+    matrix: "Matrix",
+    matrixNone: "—",
+    matrixColumns: "Matrix columns",
+    a11y: "Accessibility",
+    a11yCheck: "Check the story",
+    a11yRunning: "Checking…",
+    a11yPasses: "passes",
+    a11yCount: (count) => `${count} ${count === 1 ? "problem" : "problems"}`,
+    a11yNone: "No WCAG 2.2 A or AA rule is broken in the story as it is now.",
+    a11yError: "The check could not run",
+    a11yNotInCompare: "One story at a time: leave Compare to check it",
+    replay: "Replay",
+    clockLabel: "Story clock",
+    clockPause: "Pause the clock",
+    clockResume: "Resume the clock",
+    clockRestart: "Restart",
+    clockSpeed: "Clock speed",
+    clockRate: (rate) => `×${rate}`,
+    loadingStory: "Loading the story…",
+    apiReference: "API reference",
+    apiProp: "Prop",
+    apiEvent: "Event",
+    apiType: "Type",
+    apiSignature: "Signature",
+    apiDefault: "Default",
+    apiWhat: "What it does",
+    showCode: "Show code",
+    hideCode: "Hide code",
+    openStory: "Open the story",
+    examples: "Examples",
+    pageError: "The component's page could not be read",
+    storyLabel: "Story",
+    frameTitle: (component, story) => `${component}: ${story}`,
+    home: "Home",
+    homeEmpty: "No stories yet: a source with story files shows its families here.",
+    homeSummary: (components, sources) => `${components} ${components === 1 ? "component" : "components"} in ${sources} ${sources === 1 ? "library" : "libraries"}.`,
+    homeIntroError: "The library's introduction could not be read",
+    recentlyOpened: "Recently opened",
+    componentsCount: (count) => `${count} ${count === 1 ? "component" : "components"}`,
+    showAll: (count) => `Show all ${count}`,
+    showFewer: "Show fewer",
+    unknownStory: (id) => `No story "${id}": it may have been renamed. Pick one in the sidebar.`,
+    unknownComponent: (id) => `No component "${id}": it may have been renamed. Pick one in the sidebar.`,
+    props: "Props",
+    propGroups: { choice: "Choices", text: "Text and numbers", toggle: "Toggles" },
+    otherProps: "Other props",
+    unset: "—",
+    unsetDefault: (value) => `— (${value})`,
+    defaultIs: "Default:",
+    pickColor: (prop) => `${prop}: pick a colour`,
+    rangeValue: (prop) => `${prop}: value`,
+    setByStory: "Set by the story",
+    required: "Required",
+    resetArgs: "Reset",
+    events: "Events",
+    calls: "Calls",
+    noCalls: "No call yet",
+    clearCalls: "Clear",
+    parts: "Parts and styling",
+    partCount: (count) => `${count} ${count === 1 ? "part" : "parts"}`,
+    partsList: "Parts",
+    styleHooks: "Styling attributes",
+    testIds: "Test ids",
+    noProps: "This page has no props",
+    docsLoading: "Reading the component…",
+    docsError: "The component could not be read",
+    indexProblems: "Some story files could not be placed"
+};
+/** The shell's texts, as shown. */
+export const STRINGS = shellStrings;
+/**
+ * Whether a value is a group of texts (`tabs`), whose members a path can name.
+ *
+ * @param value - a value among the texts.
+ */
+const isTextGroup = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * Replaces one text, by its path among the shell's texts (`props`, `tabs.props`): only a plain text, never a text
+ * that takes values, and nothing for a path that names none.
+ *
+ * @param texts - the texts, or a group of them.
+ * @param path - the text's name, then its name within each group.
+ * @param text - the new text.
+ */
+const replaceText = (texts, path, text) => {
+    const [name, ...rest] = path;
+    if (name === undefined)
+        return;
+    const current = texts[name];
+    if (rest.length === 0) {
+        if (typeof current === "string")
+            texts[name] = text;
+        return;
+    }
+    if (isTextGroup(current))
+        replaceText(current, rest, text);
+};
+/**
+ * Applies a catalogue's replacements to the shell's texts, once, before the shell draws.
+ *
+ * @param replacements - the new texts, by their path (`tabs.props`).
+ */
+export const configureStrings = (replacements) => {
+    for (const [path, text] of Object.entries(replacements))
+        replaceText(STRINGS, path.split("."), text);
+};
+//# sourceMappingURL=strings.js.map

package/dist/src/shell/strings.js.map

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

package/dist/src/shell/switchView.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A view's switches as the toolbar reads and sets them: a switch's value in a view, and a view with one switch set.
+ *
+ * @module
+ */
+import type { ViewSwitch } from "../switches.ts";
+import type { ViewState } from "../viewState.ts";
+/**
+ * A view with one switch set.
+ *
+ * @param view - the view.
+ * @param each - the switch.
+ * @param value - its new value.
+ */
+export declare const withSwitch: (view: ViewState, each: ViewSwitch, value: string) => ViewState;
+/**
+ * A switch's value in a view.
+ *
+ * @param view - the view.
+ * @param each - the switch.
+ */
+export declare const switchValueIn: (view: ViewState, each: ViewSwitch) => string;
+//# sourceMappingURL=switchView.d.ts.map

package/dist/src/shell/switchView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchView.d.ts","sourceRoot":"","sources":["../../../src/shell/switchView.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,SAAS,EAAE,MAAM,UAAU,EAAE,OAAO,MAAM,KAAG,SAG5E,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,EAAE,MAAM,UAAU,KAAG,MAC1B,CAAC"}

package/dist/src/shell/switchView.js

@@ -0,0 +1,19 @@
+/**
+ * A view with one switch set.
+ *
+ * @param view - the view.
+ * @param each - the switch.
+ * @param value - its new value.
+ */
+export const withSwitch = (view, each, value) => ({
+    ...view,
+    switches: { ...view.switches, [each.id]: value }
+});
+/**
+ * A switch's value in a view.
+ *
+ * @param view - the view.
+ * @param each - the switch.
+ */
+export const switchValueIn = (view, each) => view.switches[each.id] ?? each.default;
+//# sourceMappingURL=switchView.js.map

package/dist/src/shell/switchView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchView.js","sourceRoot":"","sources":["../../../src/shell/switchView.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAe,EAAE,IAAgB,EAAE,KAAa,EAAa,EAAE,CAAC,CAAC;IAC1F,GAAG,IAAI;IACP,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE;CACjD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAe,EAAE,IAAgB,EAAU,EAAE,CACzE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC"}

package/dist/src/shell/treeSearch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The sidebar's search: every word of the query must appear in a component's name, its title (family and group), its
+ * meta's search words or one of its stories' names and descriptions, in any order, so "button danger" or "inputs date"
+ * find what they mean, and "hstack" finds the row another library calls so.
+ *
+ * @remarks
+ * Case and accents are ignored. A component whose own name, title and search words hold every word is found whole; otherwise only
+ * the stories that hold the words the component lacks are kept. An alias entry is found by its name, the place
+ * it is listed in and the place it lives in, whole or not at all: its stories are picked on its page. Pure.
+ *
+ * @module
+ */
+import type { TreeComponent, TreeFamily } from "../storyTree.ts";
+/**
+ * The words of a query, folded; none for an empty query.
+ *
+ * @param query - what the user typed.
+ */
+export declare const searchWords: (query: string) => readonly string[];
+/**
+ * A component as the search finds it: whole when its name, title and search words hold every word, else only the stories that hold
+ * the rest; `undefined` when nothing matches.
+ *
+ * @param component - the component.
+ * @param words - the query's words (`searchWords`).
+ */
+export declare const foundComponent: (component: TreeComponent, words: readonly string[]) => TreeComponent | undefined;
+/**
+ * A family with only what the search finds: `undefined` when it finds nothing, the family as it is for no words.
+ *
+ * @param family - the family.
+ * @param words - the query's words (`searchWords`).
+ */
+export declare const foundFamily: (family: TreeFamily, words: readonly string[]) => TreeFamily | undefined;
+//# sourceMappingURL=treeSearch.d.ts.map

package/dist/src/shell/treeSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeSearch.d.ts","sourceRoot":"","sources":["../../../src/shell/treeSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAa,aAAa,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AAalG;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,SAAS,MAAM,EAGzB,CAAC;AASnC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,WAAW,aAAa,EACxB,OAAO,SAAS,MAAM,EAAE,KACvB,aAAa,GAAG,SAQlB,CAAC;AAcF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,UAAU,EAAE,OAAO,SAAS,MAAM,EAAE,KAAG,UAAU,GAAG,SAavF,CAAC"}

package/dist/src/shell/treeSearch.js

@@ -0,0 +1,60 @@
+/**
+ * A text as the search compares it: lower case, without accents.
+ *
+ * @param text - any text.
+ */
+const folded = (text) => text
+    .normalize("NFD")
+    .replace(/\p{Diacritic}/gu, "")
+    .toLowerCase();
+/**
+ * The words of a query, folded; none for an empty query.
+ *
+ * @param query - what the user typed.
+ */
+export const searchWords = (query) => folded(query)
+    .split(/\s+/)
+    .filter((word) => word !== "");
+/** Whether every word appears in the text. */
+const holdsEvery = (text, words) => words.every((word) => text.includes(word));
+/** The text a story is found by. */
+const storyText = (story) => folded(`${story.name} ${story.description ?? ""}`);
+/**
+ * A component as the search finds it: whole when its name, title and search words hold every word, else only the stories that hold
+ * the rest; `undefined` when nothing matches.
+ *
+ * @param component - the component.
+ * @param words - the query's words (`searchWords`).
+ */
+export const foundComponent = (component, words) => {
+    const own = folded(`${component.name} ${component.title.replaceAll("/", " ")} ${component.keywords.join(" ")}`);
+    if (holdsEvery(own, words))
+        return component;
+    const rest = words.filter((word) => !own.includes(word));
+    const stories = component.stories.filter((story) => holdsEvery(storyText(story), rest));
+    return stories.length === 0 ? undefined : { ...component, stories };
+};
+/** Whether an alias entry holds every word in its name, the place it is listed in or the place it lives in. */
+const isAliasFound = (alias, family, group, words) => holdsEvery(folded(`${alias.name} ${family.name} ${group.name ?? ""} ${alias.title.replaceAll("/", " ")}`), words);
+/**
+ * A family with only what the search finds: `undefined` when it finds nothing, the family as it is for no words.
+ *
+ * @param family - the family.
+ * @param words - the query's words (`searchWords`).
+ */
+export const foundFamily = (family, words) => {
+    if (words.length === 0)
+        return family;
+    const groups = family.groups
+        .map((group) => ({
+        ...group,
+        components: group.components.flatMap((component) => {
+            const found = foundComponent(component, words);
+            return found === undefined ? [] : [found];
+        }),
+        aliases: group.aliases.filter((alias) => isAliasFound(alias, family, group, words))
+    }))
+        .filter((group) => group.components.length > 0 || group.aliases.length > 0);
+    return groups.length === 0 ? undefined : { ...family, groups };
+};
+//# sourceMappingURL=treeSearch.js.map

package/dist/src/shell/treeSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeSearch.js","sourceRoot":"","sources":["../../../src/shell/treeSearch.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CACtC,IAAI;KACD,SAAS,CAAC,KAAK,CAAC;KAChB,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;KAC9B,WAAW,EAAE,CAAC;AAEnB;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAqB,EAAE,CAC9D,MAAM,CAAC,KAAK,CAAC;KACV,KAAK,CAAC,KAAK,CAAC;KACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AAEnC,8CAA8C;AAC9C,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAwB,EAAW,EAAE,CACrE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAE7C,oCAAoC;AACpC,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAU,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;AAEnG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAwB,EACxB,KAAwB,EACG,EAAE;IAC7B,MAAM,GAAG,GAAG,MAAM,CAChB,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC5F,CAAC;IACF,IAAI,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACxF,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC;AACtE,CAAC,CAAC;AAEF,+GAA+G;AAC/G,MAAM,YAAY,GAAG,CACnB,KAAgB,EAChB,MAAkB,EAClB,KAAgB,EAChB,KAAwB,EACf,EAAE,CACX,UAAU,CACR,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAC9F,KAAK,CACN,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,KAAwB,EAA0B,EAAE;IAClG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;SACzB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,KAAK;QACR,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YACjD,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;KACpF,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC,CAAC"}

package/dist/src/shell/useComponentDocs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The props panel's data for a story file: loaded from the source's `docs` when the component changes.
+ *
+ * @module
+ */
+import { type ComponentDocs } from "../componentDocs.ts";
+import { type Loaded } from "./useLoaded.ts";
+/** The panel's data: loading, a component, no component (a page), or why it failed. */
+export type DocsState = Loaded<ComponentDocs>;
+/**
+ * The docs of a story file's component.
+ *
+ * @param load - the source's loader for the file; `undefined` when it has none.
+ */
+export declare const useComponentDocs: (load: (() => Promise<unknown>) | undefined) => DocsState;
+//# sourceMappingURL=useComponentDocs.d.ts.map

package/dist/src/shell/useComponentDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentDocs.d.ts","sourceRoot":"","sources":["../../../src/shell/useComponentDocs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,gBAAgB,CAAC;AAExD,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAa9C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,KAAG,SAClD,CAAC"}

package/dist/src/shell/useComponentDocs.js

@@ -0,0 +1,25 @@
+/**
+ * The props panel's data for a story file: loaded from the source's `docs` when the component changes.
+ *
+ * @module
+ */
+import { isComponentDocs } from "../componentDocs.js";
+import { useLoaded } from "./useLoaded.js";
+/** What the plugin answered, as a state. */
+const docsState = (value) => {
+    if (isComponentDocs(value))
+        return { status: "ready", value };
+    if (typeof value === "object" && value !== null && "error" in value && typeof value.error === "string") {
+        return { status: "error", message: value.error };
+    }
+    if (typeof value === "object" && value !== null && "name" in value && value.name === null)
+        return { status: "none" };
+    return { status: "error", message: "The component's docs have an unexpected shape" };
+};
+/**
+ * The docs of a story file's component.
+ *
+ * @param load - the source's loader for the file; `undefined` when it has none.
+ */
+export const useComponentDocs = (load) => useLoaded(load, docsState);
+//# sourceMappingURL=useComponentDocs.js.map

package/dist/src/shell/useComponentDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentDocs.js","sourceRoot":"","sources":["../../../src/shell/useComponentDocs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAsB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKxD,4CAA4C;AAC5C,MAAM,SAAS,GAAG,CAAC,KAAc,EAAa,EAAE;IAC9C,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QACvF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;AACvF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAA0C,EAAa,EAAE,CACxF,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC"}

package/dist/src/shell/useCopy.d.ts

@@ -0,0 +1,10 @@
+/** What the hook gives a button. */
+export type Copy = {
+    /** Whether the text was copied a moment ago. */
+    readonly isCopied: boolean;
+    /** Copies a text to the clipboard. */
+    readonly copy: (text: string) => void;
+};
+/** Copies texts, remembering the last copy for a moment. */
+export declare const useCopy: () => Copy;
+//# sourceMappingURL=useCopy.d.ts.map

package/dist/src/shell/useCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopy.d.ts","sourceRoot":"","sources":["../../../src/shell/useCopy.ts"],"names":[],"mappings":"AAUA,oCAAoC;AACpC,MAAM,MAAM,IAAI,GAAG;IACjB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,OAAO,QAAO,IAY1B,CAAC"}

package/dist/src/shell/useCopy.js

@@ -0,0 +1,23 @@
+/**
+ * A button that copies a text: whether it just did, so the button can say "Copied" for a moment.
+ *
+ * @module
+ */
+import { useCallback, useEffect, useRef, useState } from "react";
+/** How long "Copied" shows on the button, in ms. */
+const COPIED_FOR = 1500;
+/** Copies texts, remembering the last copy for a moment. */
+export const useCopy = () => {
+    const [isCopied, setIsCopied] = useState(false);
+    const timer = useRef(undefined);
+    useEffect(() => () => window.clearTimeout(timer.current), []);
+    const copy = useCallback((text) => {
+        void navigator.clipboard.writeText(text).then(() => {
+            setIsCopied(true);
+            window.clearTimeout(timer.current);
+            timer.current = window.setTimeout(() => setIsCopied(false), COPIED_FOR);
+        });
+    }, []);
+    return { isCopied, copy };
+};
+//# sourceMappingURL=useCopy.js.map

package/dist/src/shell/useCopy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopy.js","sourceRoot":"","sources":["../../../src/shell/useCopy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,oDAAoD;AACpD,MAAM,UAAU,GAAG,IAAI,CAAC;AAUxB,4DAA4D;AAC5D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAS,EAAE;IAChC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAqB,SAAS,CAAC,CAAC;IACpD,SAAS,CAAC,GAAG,EAAE,CAAC,GAAS,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,IAAY,EAAQ,EAAE;QAC9C,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACjD,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC,CAAC"}