react-cheminfo 0.3.0 → 0.4.0

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"}

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

@@ -0,0 +1,45 @@
+/** How a legacy hash link is turned into the path it means. */
+export interface LegacyHashOptions {
+    /**
+     * Carry the query string of the address over to the path. The share
+     * configuration lives there, so an embed stays configured across the move.
+     * A query written inside the fragment itself always wins over it.
+     * @default true
+     */
+    keepSearch?: boolean;
+}
+/** How an address is read when adopting the path a legacy hash link meant. */
+export interface AdoptLegacyHashOptions extends LegacyHashOptions {
+    /**
+     * The path the site is mounted at, so a legacy link to a tool served under
+     * one is recognised as sitting on its root.
+     * @default ''
+     */
+    basePath?: string;
+}
+/**
+ * The path a link written before the site routed by path points at.
+ *
+ * Those links are in course pages, in bookmarks and inside other people's
+ * iframes, so they are answered rather than dropped. Only a fragment shaped
+ * like a path is one: an anchor such as `#results` names a place inside a page
+ * and comes back `null`.
+ * @param address - A full address, or the fragment on its own, e.g. `/#/tutorial/3`.
+ * @param options - Whether the query string is carried over.
+ * @returns The path form of the address, or `null` when it names no page.
+ */
+export declare function pathFromLegacyHash(address: string, options?: LegacyHashOptions): string | null;
+/**
+ * The address to put in the bar in place of a legacy hash link, before anything
+ * reads it.
+ *
+ * Called once at startup with `location.pathname + location.search +
+ * location.hash`, so nothing downstream has to know the site ever routed by the
+ * hash. Only a visitor sitting on the site's root is moved: a fragment on a
+ * real page is an anchor of that page, not an address of its own.
+ * @param address - The address the browser is on.
+ * @param options - Whether the query is carried over, and the site's mount path.
+ * @returns The address to replace it with, or `null` when there is nothing to adopt.
+ */
+export declare function adoptLegacyHashAddress(address: string, options?: AdoptLegacyHashOptions): string | null;
+//# sourceMappingURL=legacyHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacyHash.d.ts","sourceRoot":"","sources":["../../../src/router/core/legacyHash.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,IAAI,CAWf"}

package/lib/router/core/legacyHash.js

@@ -0,0 +1,50 @@
+import { splitAddress } from "./address.js";
+import { normalizeBasePath, stripBasePath } from "./basePath.js";
+/**
+ * The path a link written before the site routed by path points at.
+ *
+ * Those links are in course pages, in bookmarks and inside other people's
+ * iframes, so they are answered rather than dropped. Only a fragment shaped
+ * like a path is one: an anchor such as `#results` names a place inside a page
+ * and comes back `null`.
+ * @param address - A full address, or the fragment on its own, e.g. `/#/tutorial/3`.
+ * @param options - Whether the query string is carried over.
+ * @returns The path form of the address, or `null` when it names no page.
+ */
+export function pathFromLegacyHash(address, options = {}) {
+    const outer = splitAddress(address);
+    if (outer.fragment === '' || !outer.fragment.startsWith('/'))
+        return null;
+    const inner = splitAddress(outer.fragment);
+    if (inner.path === '/')
+        return null;
+    const keepSearch = options.keepSearch ?? true;
+    const search = inner.search || (keepSearch ? outer.search : '');
+    return search === '' ? inner.path : `${inner.path}?${search}`;
+}
+/**
+ * The address to put in the bar in place of a legacy hash link, before anything
+ * reads it.
+ *
+ * Called once at startup with `location.pathname + location.search +
+ * location.hash`, so nothing downstream has to know the site ever routed by the
+ * hash. Only a visitor sitting on the site's root is moved: a fragment on a
+ * real page is an anchor of that page, not an address of its own.
+ * @param address - The address the browser is on.
+ * @param options - Whether the query is carried over, and the site's mount path.
+ * @returns The address to replace it with, or `null` when there is nothing to adopt.
+ */
+export function adoptLegacyHashAddress(address, options = {}) {
+    const basePath = normalizeBasePath(options.basePath ?? '');
+    if (stripBasePath(basePath, splitAddress(address).path) !== '/')
+        return null;
+    const path = pathFromLegacyHash(address, options);
+    if (path === null)
+        return null;
+    if (basePath === '')
+        return path;
+    const { path: adopted, search } = splitAddress(path);
+    const mounted = `${basePath}${adopted}`;
+    return search === '' ? mounted : `${mounted}?${search}`;
+}
+//# sourceMappingURL=legacyHash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacyHash.js","sourceRoot":"","sources":["../../../src/router/core/legacyHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAuBjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1E,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,UAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAE7E,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;IACxC,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * The table of everything the site answers, read by the three things that must
+ * agree on it: the build, which writes one HTML file per entry and the sitemap
+ * listing them; the server or the entrypoint, which titles the page it hands
+ * out; and the running app, which retitles the tab after an in-app move.
+ *
+ * Pure and DOM-free, so the prerender script imports the same table under Node
+ * that the browser imports at run time. A page missing from it is a page a
+ * search engine only ever sees as the home page.
+ * @param options - The pages, in the order the site presents them.
+ * @returns The three lookups the build and the app share.
+ */
+export declare function createPageAddresses<Page extends PageWithPath>(options: PageAddressesOptions<Page>): PageAddresses<Page>;
+/** The one thing a page must carry: the address it is reachable at. */
+export interface PageWithPath {
+    /** Address from the site's own root, e.g. `/exercises`. */
+    path: string;
+}
+/** How a site's pages are turned into addresses. */
+export interface PageAddressesOptions<Page extends PageWithPath> {
+    /**
+     * Every page, deep addresses included. The first is the home page, and is
+     * what an address the site does not know opens.
+     */
+    pages: readonly Page[];
+    /**
+     * The path the site is served under: nothing on a host of its own, `/surge`
+     * as one tool among several on a shared one.
+     * @default ''
+     */
+    basePath?: string;
+}
+/** The lookups a site's pages answer. */
+export interface PageAddresses<Page extends PageWithPath> {
+    /** Every page, in the order given: what the sitemap lists and the build writes. */
+    everyPage: () => readonly Page[];
+    /**
+     * The address a page is indexed under, mount path included and query string
+     * dropped — a structure being edited and a share configuration are not pages.
+     */
+    canonicalPathOf: (page: Page) => string;
+    /**
+     * The page an address opens. An address below a page it does not list is that
+     * page — a link written before an exercise was renamed still opens, and is
+     * indexed as the exercises — and an address it knows nothing about is the
+     * home page.
+     */
+    pageAt: (address: string) => Page;
+}
+//# sourceMappingURL=pageAddresses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageAddresses.d.ts","sourceRoot":"","sources":["../../../src/router/core/pageAddresses.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,YAAY,EAC3D,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAClC,aAAa,CAAC,IAAI,CAAC,CAgCrB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,YAAY;IAC7D;;;OAGG;IACH,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,YAAY;IACtD,mFAAmF;IACnF,SAAS,EAAE,MAAM,SAAS,IAAI,EAAE,CAAC;IACjC;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IACxC;;;;;OAKG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC"}

package/lib/router/core/pageAddresses.js

@@ -0,0 +1,56 @@
+import { normalizePath, splitAddress } from "./address.js";
+import { joinBasePath, normalizeBasePath, stripBasePath } from "./basePath.js";
+/**
+ * The table of everything the site answers, read by the three things that must
+ * agree on it: the build, which writes one HTML file per entry and the sitemap
+ * listing them; the server or the entrypoint, which titles the page it hands
+ * out; and the running app, which retitles the tab after an in-app move.
+ *
+ * Pure and DOM-free, so the prerender script imports the same table under Node
+ * that the browser imports at run time. A page missing from it is a page a
+ * search engine only ever sees as the home page.
+ * @param options - The pages, in the order the site presents them.
+ * @returns The three lookups the build and the app share.
+ */
+export function createPageAddresses(options) {
+    const pages = options.pages;
+    const first = pages[0];
+    if (first === undefined) {
+        throw new Error('createPageAddresses needs at least one page');
+    }
+    const home = first;
+    const basePath = normalizeBasePath(options.basePath ?? '');
+    const byPath = new Map();
+    for (const page of pages) {
+        byPath.set(normalizePath(page.path), page);
+    }
+    function everyPage() {
+        return pages;
+    }
+    function canonicalPathOf(page) {
+        return joinBasePath(basePath, normalizePath(page.path));
+    }
+    function pageAt(address) {
+        const path = normalizePath(stripBasePath(basePath, splitAddress(address).path));
+        const exact = byPath.get(path);
+        if (exact !== undefined)
+            return exact;
+        return deepestPageUnder(pages, path) ?? home;
+    }
+    return { everyPage, canonicalPathOf, pageAt };
+}
+function deepestPageUnder(pages, path) {
+    let deepest;
+    let depth = 0;
+    for (const page of pages) {
+        const candidate = normalizePath(page.path);
+        if (candidate === '/' || candidate.length <= depth)
+            continue;
+        if (path.startsWith(`${candidate}/`)) {
+            deepest = page;
+            depth = candidate.length;
+        }
+    }
+    return deepest;
+}
+//# sourceMappingURL=pageAddresses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageAddresses.js","sourceRoot":"","sources":["../../../src/router/core/pageAddresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAS,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,eAAe,CAAC,IAAU;QACjC,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS,MAAM,CAAC,OAAe;QAC7B,MAAM,IAAI,GAAG,aAAa,CACxB,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CACpD,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,OAAO,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAyCD,SAAS,gBAAgB,CACvB,KAAsB,EACtB,IAAY;IAEZ,IAAI,OAAyB,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,IAAI,KAAK;YAAE,SAAS;QAC7D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,41 @@
+/** How a query string is read and written. */
+export interface QueryStringOptions {
+    /**
+     * Keep a `+` in a value as the character it is, rather than reading it as
+     * the space `URLSearchParams` decodes it to. A SMILES carries `+` for a
+     * charged atom, and `CC[N+](C)(C)C` handed out in a link has to survive.
+     * @default true
+     */
+    literalPlus?: boolean;
+    /**
+     * Write a parameter carrying nothing back as the bare key, so a hand-typed
+     * flag such as `?embed` survives the round trip. Left off, an empty value is
+     * dropped and an unconfigured link stays clean.
+     * @default false
+     */
+    keepEmptyValues?: boolean;
+}
+/**
+ * Read a query string.
+ *
+ * Forgiving by design, because the address is hand-editable and arrives from
+ * bookmarks, course pages and lecture slides: a repeated key keeps its last
+ * value, a key carrying nothing is kept as an empty value so a bare `?embed`
+ * reads as present, and an escape that does not decode is taken literally.
+ * @param search - The query string, with or without its leading `?`.
+ * @param options - How the values are decoded.
+ * @returns One entry per key, decoded.
+ */
+export declare function parseQueryString(search: string, options?: QueryStringOptions): Record<string, string>;
+/**
+ * Write a query string.
+ *
+ * A parameter left at nothing is dropped unless `keepEmptyValues` asks for it,
+ * and `undefined` or `null` removes a parameter outright, so a page can hand
+ * its whole state to this function and get back only what it actually carries.
+ * @param params - The parameters, in the order they should be written.
+ * @param options - How the values are encoded.
+ * @returns The query string, without its leading `?`, empty when nothing is carried.
+ */
+export declare function formatQueryString(params: Readonly<Record<string, string | undefined | null>>, options?: QueryStringOptions): string;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/router/core/query.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,EAC3D,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAYR"}