react-cheminfo 0.2.0 → 0.4.0

package/lib/pedagogy/ui/TutorialStepStrip.js

@@ -0,0 +1,98 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Tag, Tooltip } from '@blueprintjs/core';
+import { LEVEL_ORDER } from "./exerciseMeta.js";
+import { TUTORIAL_LEVEL_COLOURS } from "./tutorialLevels.js";
+/**
+ * The numbered steps of the tour, one coloured strip per level, plus a pager.
+ * @param props - The tour, the open step, and how to move.
+ * @returns The strips and the pager.
+ */
+export function TutorialStepStrip(props) {
+    const { steps, activeIndex, onSelect, levelLabels, pager = true, pagerHint, className, } = props;
+    const active = clampIndex(activeIndex, steps.length);
+    return (_jsxs("div", { className: className, style: ROOT_STYLE, children: [LEVEL_ORDER.map((level) => {
+                const positions = positionsOfLevel(steps, level);
+                if (positions.length === 0)
+                    return null;
+                return (_jsx(LevelStrip, { steps: steps, positions: positions, colours: TUTORIAL_LEVEL_COLOURS[level], label: levelLabels?.[level] ?? level, activeIndex: active, onSelect: onSelect }, level));
+            }), pager && (_jsxs("div", { style: PAGER_STYLE, children: [_jsx(Button, { size: "small", icon: "chevron-left", text: "Previous", disabled: active === 0, onClick: () => {
+                            onSelect(active - 1);
+                        } }), _jsx(Tag, { minimal: true, round: true, children: `Step ${active + 1} of ${steps.length}` }), _jsx(Button, { size: "small", endIcon: "chevron-right", text: "Next", intent: "primary", disabled: active >= steps.length - 1, onClick: () => {
+                            onSelect(active + 1);
+                        } }), pagerHint !== undefined && (_jsx("span", { style: HINT_STYLE, children: pagerHint }))] }))] }));
+}
+function LevelStrip(props) {
+    const { steps, positions, colours, label, activeIndex, onSelect } = props;
+    const buttons = [];
+    for (const position of positions) {
+        const step = steps[position];
+        const active = position === activeIndex;
+        buttons.push(_jsx(Tooltip, { content: step.title, hoverOpenDelay: HOVER_OPEN_DELAY, placement: "bottom", children: _jsx("button", { type: "button", "aria-label": `Step ${position + 1}: ${step.title}`, "aria-current": active ? 'step' : undefined, style: numberStyle(colours, active), onClick: () => {
+                    onSelect(position);
+                }, children: position + 1 }) }, step.id));
+    }
+    return (_jsxs("div", { style: { ...STRIP_STYLE, background: colours.background }, children: [_jsx("span", { style: LABEL_STYLE, children: label }), buttons] }));
+}
+function positionsOfLevel(steps, level) {
+    const positions = [];
+    for (let index = 0; index < steps.length; index++) {
+        if (steps[index]?.level === level)
+            positions.push(index);
+    }
+    return positions;
+}
+function clampIndex(index, total) {
+    if (!Number.isFinite(index) || index <= 0)
+        return 0;
+    return Math.min(Math.floor(index), Math.max(total - 1, 0));
+}
+/**
+ * The open step takes the darker shade of its own level, plus a border.
+ * @param colours - The two shades of the level the step belongs to.
+ * @param active - Whether this is the step on screen.
+ * @returns The style of one numbered button.
+ */
+function numberStyle(colours, active) {
+    return {
+        background: active ? colours.activeBackground : '#ffffff',
+        border: active ? '2px solid #1c2127' : '1px solid rgb(17 20 24 / 20%)',
+        borderRadius: 4,
+        color: '#1c2127',
+        cursor: 'pointer',
+        font: 'inherit',
+        fontSize: 12,
+        fontWeight: active ? 700 : 500,
+        lineHeight: 1,
+        minWidth: 26,
+        padding: active ? '5px 6px' : '6px 7px',
+    };
+}
+/** Long enough that the pointer can cross the strip without opening a title. */
+const HOVER_OPEN_DELAY = 150;
+const ROOT_STYLE = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 4,
+};
+const STRIP_STYLE = {
+    display: 'flex',
+    flexWrap: 'wrap',
+    alignItems: 'center',
+    gap: 4,
+    borderRadius: 4,
+    padding: '4px 6px',
+};
+const LABEL_STYLE = {
+    flex: '0 0 220px',
+    fontSize: 12,
+    fontWeight: 600,
+    color: '#1c2127',
+};
+const PAGER_STYLE = {
+    display: 'flex',
+    alignItems: 'center',
+    gap: 8,
+    paddingTop: 2,
+};
+const HINT_STYLE = { color: '#5b6875', fontSize: 11 };
+//# sourceMappingURL=TutorialStepStrip.js.map

package/lib/pedagogy/ui/TutorialStepStrip.js.map

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

package/lib/pedagogy/ui/exerciseMeta.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What a level and a status look like, in one place.
+ *
+ * A level means the same thing in the tutorial, in the exercise list and on the
+ * cheatsheet, so it is coloured from here rather than decided again per page.
+ */
+import type { IconName, Intent } from '@blueprintjs/core';
+import type { ExerciseLevel, ExerciseStatus } from '../core/types.ts';
+/** Green for a beginner, amber for an intermediate, red for an advanced one. */
+export declare const LEVEL_INTENT: Record<ExerciseLevel, Intent>;
+/** The three levels in teaching order, for a page listing all of them. */
+export declare const LEVEL_ORDER: readonly ExerciseLevel[];
+/** An empty circle, a warning sign, a tick: untouched, handed in, right. */
+export declare const STATUS_ICON: Record<ExerciseStatus, IconName>;
+/**
+ * Colour per status.
+ *
+ * `idle` is the one uncoloured value in the package: an exercise nobody has
+ * opened has nothing to report, and painting it would make a fresh list read as
+ * a list of mistakes. Every other value keeps its colour wherever it is shown,
+ * including on a tag that is switched off.
+ */
+export declare const STATUS_INTENT: Record<ExerciseStatus, Intent>;
+//# sourceMappingURL=exerciseMeta.d.ts.map

package/lib/pedagogy/ui/exerciseMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exerciseMeta.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/exerciseMeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtE,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAItD,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,SAAS,aAAa,EAI/C,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAIxD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIxD,CAAC"}

package/lib/pedagogy/ui/exerciseMeta.js

@@ -0,0 +1,38 @@
+/**
+ * What a level and a status look like, in one place.
+ *
+ * A level means the same thing in the tutorial, in the exercise list and on the
+ * cheatsheet, so it is coloured from here rather than decided again per page.
+ */
+/** Green for a beginner, amber for an intermediate, red for an advanced one. */
+export const LEVEL_INTENT = {
+    beginner: 'success',
+    intermediate: 'warning',
+    advanced: 'danger',
+};
+/** The three levels in teaching order, for a page listing all of them. */
+export const LEVEL_ORDER = [
+    'beginner',
+    'intermediate',
+    'advanced',
+];
+/** An empty circle, a warning sign, a tick: untouched, handed in, right. */
+export const STATUS_ICON = {
+    idle: 'circle',
+    attempted: 'warning-sign',
+    solved: 'tick-circle',
+};
+/**
+ * Colour per status.
+ *
+ * `idle` is the one uncoloured value in the package: an exercise nobody has
+ * opened has nothing to report, and painting it would make a fresh list read as
+ * a list of mistakes. Every other value keeps its colour wherever it is shown,
+ * including on a tag that is switched off.
+ */
+export const STATUS_INTENT = {
+    idle: 'none',
+    attempted: 'warning',
+    solved: 'success',
+};
+//# sourceMappingURL=exerciseMeta.js.map

package/lib/pedagogy/ui/exerciseMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exerciseMeta.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/exerciseMeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAkC;IACzD,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,UAAU;IACV,cAAc;IACd,UAAU;CACX,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;CAClB,CAAC"}

package/lib/pedagogy/ui/glossaryContext.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Where the terms a site defines are kept while the page is open.
+ *
+ * Prose is rendered deep inside a card, a callout or a tooltip, and threading
+ * the glossary down to each of those as a prop is what makes a site stop
+ * linking its jargon. It is read from the surrounding provider instead.
+ */
+import type { Glossary } from '../core/glossary.ts';
+/**
+ * The glossary the surrounding provider holds.
+ * @returns Every term the site defines, and no term at all when nothing wraps
+ * the tree — prose then renders its markers as plain words.
+ */
+export declare function useGlossary(): Glossary;
+/** Holder of the glossary, written by `GlossaryProvider` and read by prose. */
+export declare const GlossaryContext: import("react").Context<Glossary>;
+//# sourceMappingURL=glossaryContext.d.ts.map

package/lib/pedagogy/ui/glossaryContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossaryContext.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/glossaryContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,mCAA8B,CAAC"}

package/lib/pedagogy/ui/glossaryContext.js

@@ -0,0 +1,19 @@
+/**
+ * Where the terms a site defines are kept while the page is open.
+ *
+ * Prose is rendered deep inside a card, a callout or a tooltip, and threading
+ * the glossary down to each of those as a prop is what makes a site stop
+ * linking its jargon. It is read from the surrounding provider instead.
+ */
+import { createContext, useContext } from 'react';
+/**
+ * The glossary the surrounding provider holds.
+ * @returns Every term the site defines, and no term at all when nothing wraps
+ * the tree — prose then renders its markers as plain words.
+ */
+export function useGlossary() {
+    return useContext(GlossaryContext);
+}
+/** Holder of the glossary, written by `GlossaryProvider` and read by prose. */
+export const GlossaryContext = createContext({});
+//# sourceMappingURL=glossaryContext.js.map

package/lib/pedagogy/ui/glossaryContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossaryContext.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/glossaryContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIlD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAW,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,27 @@
+export type { ExerciseActionsProps } from './ExerciseActions.tsx';
+export { ExerciseActions } from './ExerciseActions.tsx';
+export type { ExerciseProgressHeaderProps } from './ExerciseProgressHeader.tsx';
+export { ExerciseProgressHeader } from './ExerciseProgressHeader.tsx';
+export type { ExerciseLevelTagProps, ExerciseStatusIconProps, } from './ExerciseTags.tsx';
+export { ExerciseLevelTag, ExerciseStatusIcon } from './ExerciseTags.tsx';
+export { LEVEL_INTENT, LEVEL_ORDER, STATUS_ICON } from './exerciseMeta.ts';
+export type { GlossaryProviderProps } from './GlossaryProvider.tsx';
+export { GlossaryProvider } from './GlossaryProvider.tsx';
+export type { GlossaryTextProps } from './GlossaryText.tsx';
+export { GlossaryText } from './GlossaryText.tsx';
+export { useGlossary } from './glossaryContext.ts';
+export type { HintLadderProps } from './HintLadder.tsx';
+export { HintLadder } from './HintLadder.tsx';
+export type { ReferenceGridProps } from './ReferenceGrid.tsx';
+export { ReferenceGrid } from './ReferenceGrid.tsx';
+export type { ReferenceRow, ReferenceSection, ReferenceSectionBlockProps, } from './ReferenceSectionBlock.tsx';
+export { ReferenceSectionBlock } from './ReferenceSectionBlock.tsx';
+export type { SyntaxTooltipContent, SyntaxTooltipExample, SyntaxTooltipProps, } from './SyntaxTooltip.tsx';
+export { SyntaxTooltip } from './SyntaxTooltip.tsx';
+export type { TestCaseListProps } from './TestCaseList.tsx';
+export { TestCaseList } from './TestCaseList.tsx';
+export type { TutorialStepStripProps } from './TutorialStepStrip.tsx';
+export { TutorialStepStrip } from './TutorialStepStrip.tsx';
+export type { TutorialLevelColours } from './tutorialLevels.ts';
+export { TUTORIAL_LEVEL_COLOURS } from './tutorialLevels.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/pedagogy/ui/index.js

@@ -0,0 +1,15 @@
+export { ExerciseActions } from "./ExerciseActions.js";
+export { ExerciseProgressHeader } from "./ExerciseProgressHeader.js";
+export { ExerciseLevelTag, ExerciseStatusIcon } from "./ExerciseTags.js";
+export { LEVEL_INTENT, LEVEL_ORDER, STATUS_ICON } from "./exerciseMeta.js";
+export { GlossaryProvider } from "./GlossaryProvider.js";
+export { GlossaryText } from "./GlossaryText.js";
+export { useGlossary } from "./glossaryContext.js";
+export { HintLadder } from "./HintLadder.js";
+export { ReferenceGrid } from "./ReferenceGrid.js";
+export { ReferenceSectionBlock } from "./ReferenceSectionBlock.js";
+export { SyntaxTooltip } from "./SyntaxTooltip.js";
+export { TestCaseList } from "./TestCaseList.js";
+export { TutorialStepStrip } from "./TutorialStepStrip.js";
+export { TUTORIAL_LEVEL_COLOURS } from "./tutorialLevels.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA8B,CAAC;AAKtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAoB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAMpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA6B,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/pedagogy/ui/tutorialLevels.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The two shades each level of the guided tour is painted in.
+ *
+ * Green, amber, pink — the same three the level tags use, in the pale weights a
+ * strip of buttons can sit on. They are shared so a student moving from one of
+ * our tools to the next reads the shape of the course the same way.
+ */
+import type { ExerciseLevel } from '../core/types.ts';
+/** How one level is painted. */
+export interface TutorialLevelColours {
+    /** Behind the whole strip. */
+    background: string;
+    /** Behind the step that is open, which is the darker of the two. */
+    activeBackground: string;
+}
+/** The palette of the three levels. */
+export declare const TUTORIAL_LEVEL_COLOURS: Record<ExerciseLevel, TutorialLevelColours>;
+//# sourceMappingURL=tutorialLevels.d.ts.map

package/lib/pedagogy/ui/tutorialLevels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tutorialLevels.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/tutorialLevels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,aAAa,EACb,oBAAoB,CAKrB,CAAC"}

package/lib/pedagogy/ui/tutorialLevels.js

@@ -0,0 +1,14 @@
+/**
+ * The two shades each level of the guided tour is painted in.
+ *
+ * Green, amber, pink — the same three the level tags use, in the pale weights a
+ * strip of buttons can sit on. They are shared so a student moving from one of
+ * our tools to the next reads the shape of the course the same way.
+ */
+/** The palette of the three levels. */
+export const TUTORIAL_LEVEL_COLOURS = {
+    beginner: { background: '#d1fae5', activeBackground: '#6ee7b7' },
+    intermediate: { background: '#fef3c7', activeBackground: '#fcd34d' },
+    advanced: { background: '#fce7f3', activeBackground: '#f9a8d4' },
+};
+//# sourceMappingURL=tutorialLevels.js.map

package/lib/pedagogy/ui/tutorialLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tutorialLevels.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/tutorialLevels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAG/B;IACF,QAAQ,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE;IAChE,YAAY,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE;IACpE,QAAQ,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE;CACjE,CAAC"}

package/lib/router/core/address.d.ts

@@ -0,0 +1,42 @@
+/** An address cut into the three parts a router reads separately. */
+export interface AddressParts {
+    /** Path of the address, `/` when it carries none. */
+    path: string;
+    /** Query string, without its leading `?`. */
+    search: string;
+    /** Fragment, without its leading `#`. */
+    fragment: string;
+}
+/**
+ * Cut an address into its path, its query and its fragment.
+ *
+ * The fragment is taken first, so a `?` inside it — an old hash link of the
+ * shape `#/tutorial/3?step=2` — stays part of the fragment rather than being
+ * read as the query of the page.
+ * @param address - A path, a full address, or a bare query string.
+ * @returns The three parts, each without its separator.
+ */
+export declare function splitAddress(address: string): AddressParts;
+/**
+ * The decoded, non-empty segments of a path.
+ * @param path - Path of an address, with or without its leading slash.
+ * @returns One entry per segment, `[]` for the root.
+ */
+export declare function splitPath(path: string): string[];
+/**
+ * A path in the one shape the lookups compare: a leading slash, no trailing
+ * one, its segments decoded, and neither query nor fragment.
+ * @param path - Path of an address.
+ * @returns The same address, normalized.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Decode one component of an address, tolerating an escape that is not one.
+ *
+ * `decodeURIComponent` throws on a lone `%`, and an address is hand-editable:
+ * the raw text is closer to what its author meant than an error page.
+ * @param value - Raw, percent-encoded text.
+ * @returns The decoded text, or the raw text when it does not decode.
+ */
+export declare function safeDecode(value: string): string;
+//# sourceMappingURL=address.d.ts.map

package/lib/router/core/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../src/router/core/address.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/lib/router/core/address.js

@@ -0,0 +1,64 @@
+/**
+ * Cut an address into its path, its query and its fragment.
+ *
+ * The fragment is taken first, so a `?` inside it — an old hash link of the
+ * shape `#/tutorial/3?step=2` — stays part of the fragment rather than being
+ * read as the query of the page.
+ * @param address - A path, a full address, or a bare query string.
+ * @returns The three parts, each without its separator.
+ */
+export function splitAddress(address) {
+    const hashIndex = address.indexOf('#');
+    const beforeHash = hashIndex === -1 ? address : address.slice(0, hashIndex);
+    const fragment = hashIndex === -1 ? '' : address.slice(hashIndex + 1);
+    const queryIndex = beforeHash.indexOf('?');
+    if (queryIndex === -1) {
+        return { path: beforeHash === '' ? '/' : beforeHash, search: '', fragment };
+    }
+    const path = beforeHash.slice(0, queryIndex);
+    return {
+        path: path === '' ? '/' : path,
+        search: beforeHash.slice(queryIndex + 1),
+        fragment,
+    };
+}
+/**
+ * The decoded, non-empty segments of a path.
+ * @param path - Path of an address, with or without its leading slash.
+ * @returns One entry per segment, `[]` for the root.
+ */
+export function splitPath(path) {
+    const segments = [];
+    for (const raw of path.split('/')) {
+        if (raw !== '')
+            segments.push(safeDecode(raw));
+    }
+    return segments;
+}
+/**
+ * A path in the one shape the lookups compare: a leading slash, no trailing
+ * one, its segments decoded, and neither query nor fragment.
+ * @param path - Path of an address.
+ * @returns The same address, normalized.
+ */
+export function normalizePath(path) {
+    const segments = splitPath(splitAddress(path).path);
+    return segments.length === 0 ? '/' : `/${segments.join('/')}`;
+}
+/**
+ * Decode one component of an address, tolerating an escape that is not one.
+ *
+ * `decodeURIComponent` throws on a lone `%`, and an address is hand-editable:
+ * the raw text is closer to what its author meant than an error page.
+ * @param value - Raw, percent-encoded text.
+ * @returns The decoded text, or the raw text when it does not decode.
+ */
+export function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=address.js.map

package/lib/router/core/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/router/core/address.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QAC9B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QACxC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,GAAG,KAAK,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/lib/router/core/basePath.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Where a site is mounted, read off the page rather than off the build.
+ *
+ * The build is mount-agnostic — vite is given a relative base, so the same
+ * `dist` serves `https://surge.cheminfo.org/` and
+ * `https://www.cheminfo.org/surge/`. What tells the two apart is the `<base>`
+ * the deployment stamps into the page it hands out, and `document.baseURI`
+ * resolves it against the address actually opened. So this answers correctly
+ * whether or not a slash closes the address, and on an address the SPA
+ * fallback answered.
+ * @returns The mount path, in the shape {@link normalizeBasePath} returns.
+ */
+export declare function readMountPath(): string;
+/**
+ * The path half of a site's address, as a mount path.
+ *
+ * A deployment names where it serves the site in full — origin and path in one
+ * value — because the origin is what the canonical link and the sitemap need.
+ * This is the other half of it.
+ * @param siteUrl - The absolute address the site is served at.
+ * @returns The mount path, in the shape {@link normalizeBasePath} returns.
+ */
+export declare function basePathOf(siteUrl: string): string;
+/**
+ * A mount path in the shape the other helpers assume: the empty string when the
+ * site owns the root of its host, `/surge` when it is one tool among several on
+ * a shared one.
+ * @param basePath - The mount path however it was written: `surge`, `/surge`, `/surge/`.
+ * @returns The normalized mount path, without a trailing slash.
+ */
+export declare function normalizeBasePath(basePath: string): string;
+/**
+ * Move one of the site's own addresses under the path it is mounted at.
+ * @param basePath - The mount path, in any of the shapes {@link normalizeBasePath} accepts.
+ * @param path - An address from the site's own root, e.g. `/exercises`.
+ * @returns The address the browser and the server see, e.g. `/surge/exercises`.
+ */
+export declare function joinBasePath(basePath: string, path: string): string;
+/**
+ * Read one of the site's own addresses back out of a browser path.
+ *
+ * A path that does not sit under the mount is handed back untouched, so a
+ * deployment served from somewhere else than the build was told still routes.
+ * @param basePath - The mount path, in any of the shapes {@link normalizeBasePath} accepts.
+ * @param pathname - The path the browser is on, e.g. `/surge/exercises`.
+ * @returns The address from the site's own root, `/` for the mount itself.
+ */
+export declare function stripBasePath(basePath: string, pathname: string): string;
+//# sourceMappingURL=basePath.d.ts.map

package/lib/router/core/basePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePath.d.ts","sourceRoot":"","sources":["../../../src/router/core/basePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQxE"}

package/lib/router/core/basePath.js

@@ -0,0 +1,78 @@
+/**
+ * Where a site is mounted, read off the page rather than off the build.
+ *
+ * The build is mount-agnostic — vite is given a relative base, so the same
+ * `dist` serves `https://surge.cheminfo.org/` and
+ * `https://www.cheminfo.org/surge/`. What tells the two apart is the `<base>`
+ * the deployment stamps into the page it hands out, and `document.baseURI`
+ * resolves it against the address actually opened. So this answers correctly
+ * whether or not a slash closes the address, and on an address the SPA
+ * fallback answered.
+ * @returns The mount path, in the shape {@link normalizeBasePath} returns.
+ */
+export function readMountPath() {
+    const baseUri = globalThis.document?.baseURI;
+    if (!baseUri)
+        return '';
+    return normalizeBasePath(new URL(baseUri).pathname);
+}
+/**
+ * The path half of a site's address, as a mount path.
+ *
+ * A deployment names where it serves the site in full — origin and path in one
+ * value — because the origin is what the canonical link and the sitemap need.
+ * This is the other half of it.
+ * @param siteUrl - The absolute address the site is served at.
+ * @returns The mount path, in the shape {@link normalizeBasePath} returns.
+ */
+export function basePathOf(siteUrl) {
+    return normalizeBasePath(new URL(siteUrl).pathname);
+}
+/**
+ * A mount path in the shape the other helpers assume: the empty string when the
+ * site owns the root of its host, `/surge` when it is one tool among several on
+ * a shared one.
+ * @param basePath - The mount path however it was written: `surge`, `/surge`, `/surge/`.
+ * @returns The normalized mount path, without a trailing slash.
+ */
+export function normalizeBasePath(basePath) {
+    const trimmed = basePath.trim();
+    if (trimmed === '' || trimmed === '/')
+        return '';
+    const opened = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    return opened.replace(/\/+$/, '');
+}
+/**
+ * Move one of the site's own addresses under the path it is mounted at.
+ * @param basePath - The mount path, in any of the shapes {@link normalizeBasePath} accepts.
+ * @param path - An address from the site's own root, e.g. `/exercises`.
+ * @returns The address the browser and the server see, e.g. `/surge/exercises`.
+ */
+export function joinBasePath(basePath, path) {
+    const base = normalizeBasePath(basePath);
+    const opened = path === '' || !path.startsWith('/') ? `/${path}` : path;
+    if (base === '')
+        return opened;
+    return opened === '/' ? `${base}/` : `${base}${opened}`;
+}
+/**
+ * Read one of the site's own addresses back out of a browser path.
+ *
+ * A path that does not sit under the mount is handed back untouched, so a
+ * deployment served from somewhere else than the build was told still routes.
+ * @param basePath - The mount path, in any of the shapes {@link normalizeBasePath} accepts.
+ * @param pathname - The path the browser is on, e.g. `/surge/exercises`.
+ * @returns The address from the site's own root, `/` for the mount itself.
+ */
+export function stripBasePath(basePath, pathname) {
+    const base = normalizeBasePath(basePath);
+    const path = pathname === '' ? '/' : pathname;
+    if (base === '')
+        return path;
+    if (path === base || path === `${base}/`)
+        return '/';
+    // `/surgeon` is not a page of a site mounted at `/surge`, so the mount only
+    // matches when what follows it is a path of its own.
+    return path.startsWith(`${base}/`) ? path.slice(base.length) : path;
+}
+//# sourceMappingURL=basePath.js.map

package/lib/router/core/basePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePath.js","sourceRoot":"","sources":["../../../src/router/core/basePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,iBAAiB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,iBAAiB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/B,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAgB;IAC9D,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9C,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACrD,4EAA4E;IAC5E,qDAAqD;IACrD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

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

@@ -0,0 +1,8 @@
+export { basePathOf, joinBasePath, normalizeBasePath, readMountPath, stripBasePath, } from './basePath.ts';
+export type { AdoptLegacyHashOptions, LegacyHashOptions, } from './legacyHash.ts';
+export { adoptLegacyHashAddress, pathFromLegacyHash } from './legacyHash.ts';
+export type { PageAddresses, PageAddressesOptions, PageWithPath, } from './pageAddresses.ts';
+export { createPageAddresses } from './pageAddresses.ts';
+export type { TabDefinition, TabRoute, TabRouteInput, TabRouter, TabRouterOptions, } from './tabRouter.ts';
+export { createTabRouter } from './tabRouter.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/router/core/index.js

@@ -0,0 +1,5 @@
+export { basePathOf, joinBasePath, normalizeBasePath, readMountPath, stripBasePath, } from "./basePath.js";
+export { adoptLegacyHashAddress, pathFromLegacyHash } from "./legacyHash.js";
+export { createPageAddresses } from "./pageAddresses.js";
+export { createTabRouter } from "./tabRouter.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}