@shadow-shard-tools/docs-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ShadowShardTools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# SST Docs Core
+Core runtime for the Shadow Shard Tools documentation stack. It gathers the shared themes, configuration objects, navigation helpers, typed content models, and browser-friendly utilities relied on by the site and generator projects.
+
+## Contents
+- `configs`: Tailwind-friendly theme wiring plus code-language metadata (`CODE_LANGUAGE_CONFIG`, `stylesConfig`).
+- `data`: File-system drivers for loading doc versions, category trees, and item payloads (`loadVersions`, `loadVersionData`, `buildTree`, etc.).
+- `themes`: Prebuilt light/dark `StyleTheme` definitions used by the Tailwind bridge.
+- `types`: Source-of-truth TypeScript contracts for doc content, theme structures, and provider interfaces.
+- `utilities`: DOM, validation, string, and file helpers that the site and exporters share (e.g. `slugify`, `withBasePath`, `isValidImageUrl`).
+
+## Usage
+```ts
+import {
+  darkTheme,
+  lightTheme,
+  stylesConfig,
+  loadVersions,
+  loadVersionData,
+  slugify,
+  type Content,
+  type Version,
+} from "@shadow-shard-tools/docs-core";
+
+// Or import a focused module:
+import { CODE_LANGUAGE_CONFIG } from "@shadow-shard-tools/docs-core/configs/index.js";
+```
+Everything ships as native ESM with TypeScript declarations in `dist/`. Install with `npm install @shadow-shard-tools/docs-core` (or link locally) and cherry-pick the helpers and contracts you need.
+
+## Development
+```bash
+npm install
+npm run build
+```
+`tsc` compiles everything under `src/` into `dist/` with source and declaration maps. Build before publishing or updating dependents so the published artifacts stay in sync.

package/dist/configs/code-languages-config.d.ts

@@ -0,0 +1,128 @@
+export declare const CODE_LANGUAGE_CONFIG: {
+    readonly javascript: {
+        readonly name: "JavaScript";
+        readonly ext: "js";
+    };
+    readonly typescript: {
+        readonly name: "TypeScript";
+        readonly ext: "ts";
+    };
+    readonly python: {
+        readonly name: "Python";
+        readonly ext: "py";
+    };
+    readonly java: {
+        readonly name: "Java";
+        readonly ext: "java";
+    };
+    readonly csharp: {
+        readonly name: "C#";
+        readonly ext: "cs";
+    };
+    readonly cpp: {
+        readonly name: "C++";
+        readonly ext: "cpp";
+    };
+    readonly c: {
+        readonly name: "C";
+        readonly ext: "c";
+    };
+    readonly php: {
+        readonly name: "PHP";
+        readonly ext: "php";
+    };
+    readonly ruby: {
+        readonly name: "Ruby";
+        readonly ext: "rb";
+    };
+    readonly go: {
+        readonly name: "Go";
+        readonly ext: "go";
+    };
+    readonly rust: {
+        readonly name: "Rust";
+        readonly ext: "rs";
+    };
+    readonly swift: {
+        readonly name: "Swift";
+        readonly ext: "swift";
+    };
+    readonly kotlin: {
+        readonly name: "Kotlin";
+        readonly ext: "kt";
+    };
+    readonly scala: {
+        readonly name: "Scala";
+        readonly ext: "scala";
+    };
+    readonly html: {
+        readonly name: "HTML";
+        readonly ext: "html";
+    };
+    readonly css: {
+        readonly name: "CSS";
+        readonly ext: "css";
+    };
+    readonly scss: {
+        readonly name: "SCSS";
+        readonly ext: "scss";
+    };
+    readonly sass: {
+        readonly name: "Sass";
+        readonly ext: "sass";
+    };
+    readonly less: {
+        readonly name: "Less";
+        readonly ext: "less";
+    };
+    readonly json: {
+        readonly name: "JSON";
+        readonly ext: "json";
+    };
+    readonly xml: {
+        readonly name: "XML";
+        readonly ext: "xml";
+    };
+    readonly yaml: {
+        readonly name: "YAML";
+        readonly ext: "yml";
+    };
+    readonly toml: {
+        readonly name: "TOML";
+        readonly ext: "toml";
+    };
+    readonly sql: {
+        readonly name: "SQL";
+        readonly ext: "sql";
+    };
+    readonly bash: {
+        readonly name: "Bash";
+        readonly ext: "sh";
+    };
+    readonly powershell: {
+        readonly name: "PowerShell";
+        readonly ext: "ps1";
+    };
+    readonly dockerfile: {
+        readonly name: "Dockerfile";
+        readonly ext: "dockerfile";
+    };
+    readonly markdown: {
+        readonly name: "Markdown";
+        readonly ext: "md";
+    };
+    readonly latex: {
+        readonly name: "LaTeX";
+        readonly ext: "tex";
+    };
+    readonly plaintext: {
+        readonly name: "Plain Text";
+        readonly ext: "txt";
+    };
+    readonly text: {
+        readonly name: "Text";
+        readonly ext: "txt";
+    };
+};
+export type SupportedLanguage = keyof typeof CODE_LANGUAGE_CONFIG;
+//# sourceMappingURL=code-languages-config.d.ts.map

package/dist/configs/code-languages-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-languages-config.d.ts","sourceRoot":"","sources":["../../src/configs/code-languages-config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC"}

package/dist/configs/code-languages-config.js

@@ -0,0 +1,34 @@
+export const CODE_LANGUAGE_CONFIG = {
+    javascript: { name: "JavaScript", ext: "js" },
+    typescript: { name: "TypeScript", ext: "ts" },
+    python: { name: "Python", ext: "py" },
+    java: { name: "Java", ext: "java" },
+    csharp: { name: "C#", ext: "cs" },
+    cpp: { name: "C++", ext: "cpp" },
+    c: { name: "C", ext: "c" },
+    php: { name: "PHP", ext: "php" },
+    ruby: { name: "Ruby", ext: "rb" },
+    go: { name: "Go", ext: "go" },
+    rust: { name: "Rust", ext: "rs" },
+    swift: { name: "Swift", ext: "swift" },
+    kotlin: { name: "Kotlin", ext: "kt" },
+    scala: { name: "Scala", ext: "scala" },
+    html: { name: "HTML", ext: "html" },
+    css: { name: "CSS", ext: "css" },
+    scss: { name: "SCSS", ext: "scss" },
+    sass: { name: "Sass", ext: "sass" },
+    less: { name: "Less", ext: "less" },
+    json: { name: "JSON", ext: "json" },
+    xml: { name: "XML", ext: "xml" },
+    yaml: { name: "YAML", ext: "yml" },
+    toml: { name: "TOML", ext: "toml" },
+    sql: { name: "SQL", ext: "sql" },
+    bash: { name: "Bash", ext: "sh" },
+    powershell: { name: "PowerShell", ext: "ps1" },
+    dockerfile: { name: "Dockerfile", ext: "dockerfile" },
+    markdown: { name: "Markdown", ext: "md" },
+    latex: { name: "LaTeX", ext: "tex" },
+    plaintext: { name: "Plain Text", ext: "txt" },
+    text: { name: "Text", ext: "txt" },
+};
+//# sourceMappingURL=code-languages-config.js.map

package/dist/configs/code-languages-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-languages-config.js","sourceRoot":"","sources":["../../src/configs/code-languages-config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE;IAC7C,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE;IAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE;IACrC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;IACjC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAChC,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAC1B,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;IACjC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;IAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;IACjC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;IACtC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE;IACrC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;IACtC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE;IAClC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IACnC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;IACjC,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE;IAC9C,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE;IACrD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE;IACzC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE;IACpC,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE;IAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE;CAC1B,CAAC"}

package/dist/configs/index.d.ts

@@ -0,0 +1,3 @@
+export { CODE_LANGUAGE_CONFIG, type SupportedLanguage, } from "./code-languages-config.js";
+export { stylesConfig } from "./styles-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/configs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/configs/index.js

@@ -0,0 +1,3 @@
+export { CODE_LANGUAGE_CONFIG, } from "./code-languages-config.js";
+export { stylesConfig } from "./styles-config.js";
+//# sourceMappingURL=index.js.map

package/dist/configs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/configs/styles-config.d.ts

@@ -0,0 +1,3 @@
+import type { StylesConfig } from "../index.js";
+export declare const stylesConfig: StylesConfig;
+//# sourceMappingURL=styles-config.d.ts.map

package/dist/configs/styles-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-config.d.ts","sourceRoot":"","sources":["../../src/configs/styles-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,eAAO,MAAM,YAAY,EAAE,YAK1B,CAAC"}

package/dist/configs/styles-config.js

@@ -0,0 +1,9 @@
+import { darkTheme } from "../themes/darkTheme.js";
+import { lightTheme } from "../themes/lightTheme.js";
+export const stylesConfig = {
+    themes: {
+        light: lightTheme,
+        dark: darkTheme,
+    },
+};
+//# sourceMappingURL=styles-config.js.map

package/dist/configs/styles-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-config.js","sourceRoot":"","sources":["../../src/configs/styles-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,MAAM,EAAE;QACN,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;KAChB;CACF,CAAC"}

package/dist/data/buildTree.d.ts

@@ -0,0 +1,8 @@
+import type { Category } from "../types/Category.js";
+import type { DocItem } from "../types/DocItem.js";
+import type { RawCategory } from "../types/RawCategory.js";
+export declare function buildTree(rawMap: Record<string, RawCategory>, allDocs: DocItem[]): {
+    tree: Category[];
+    usedDocIds: Set<string>;
+};
+//# sourceMappingURL=buildTree.d.ts.map

package/dist/data/buildTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTree.d.ts","sourceRoot":"","sources":["../../src/data/buildTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,OAAO,EAAE,OAAO,EAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CA8F/C"}

package/dist/data/buildTree.js

@@ -0,0 +1,75 @@
+export function buildTree(rawMap, allDocs) {
+    const docLookup = new Map(allDocs.map((d) => [d.id, d]));
+    const used = new Set();
+    const convert = (raw) => {
+        let docs;
+        const docIds = Array.isArray(raw.docs) ? raw.docs : [];
+        if (docIds.length > 0) {
+            const validDocs = docIds
+                .map((rawId) => {
+                if (typeof rawId !== "string" || rawId.length === 0) {
+                    console.warn(`Invalid doc id in category ${raw.id}:`, rawId);
+                    return null;
+                }
+                const doc = docLookup.get(rawId);
+                if (!doc) {
+                    console.warn(`Doc id ${rawId} referenced in category ${raw.id} not found.`);
+                    return null;
+                }
+                used.add(rawId);
+                return doc;
+            })
+                .filter((doc) => doc !== null);
+            if (validDocs.length > 0) {
+                docs = validDocs;
+            }
+        }
+        let children;
+        const childIds = Array.isArray(raw.children) ? raw.children : [];
+        if (childIds.length > 0) {
+            const validChildren = childIds
+                .map((rawChildId) => {
+                if (typeof rawChildId !== "string" || rawChildId.length === 0) {
+                    console.warn(`Invalid child category id in ${raw.id}:`, rawChildId);
+                    return null;
+                }
+                const childRaw = rawMap[rawChildId];
+                if (!childRaw) {
+                    console.warn(`Child category ${rawChildId} referenced in ${raw.id} not found.`);
+                    return null;
+                }
+                return convert(childRaw);
+            })
+                .filter((child) => child !== null);
+            if (validChildren.length > 0) {
+                children = validChildren;
+            }
+        }
+        return {
+            id: raw.id,
+            title: raw.title,
+            description: raw.description,
+            content: raw.content ?? [],
+            docs,
+            children,
+        };
+    };
+    const childCategoryIds = new Set();
+    Object.values(rawMap).forEach((category) => {
+        if (Array.isArray(category?.children)) {
+            category.children.forEach((childId) => {
+                if (typeof childId === "string" && childId.length > 0) {
+                    childCategoryIds.add(childId);
+                }
+            });
+        }
+    });
+    const tree = Object.values(rawMap)
+        .filter((category) => category &&
+        typeof category.id === "string" &&
+        category.id.length > 0 &&
+        !childCategoryIds.has(category.id))
+        .map(convert);
+    return { tree, usedDocIds: used };
+}
+//# sourceMappingURL=buildTree.js.map

package/dist/data/buildTree.js.map

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

package/dist/data/index.d.ts

@@ -0,0 +1,6 @@
+export { buildTree } from "./buildTree.js";
+export { loadAllCategories } from "./loadAllCategories.js";
+export { loadAllItems } from "./loadAllItems.js";
+export { loadVersionData } from "./loadVersionData.js";
+export { loadVersions } from "./loadVersions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,6 @@
+export { buildTree } from "./buildTree.js";
+export { loadAllCategories } from "./loadAllCategories.js";
+export { loadAllItems } from "./loadAllItems.js";
+export { loadVersionData } from "./loadVersionData.js";
+export { loadVersions } from "./loadVersions.js";
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/data/loadAllCategories.d.ts

@@ -0,0 +1,4 @@
+import type { DataProvider } from "../types/DataProvider.js";
+import type { RawCategory } from "../types/RawCategory.js";
+export declare function loadAllCategories(provider: DataProvider, versionRootAbs: string, ids: string[]): Promise<Record<string, RawCategory>>;
+//# sourceMappingURL=loadAllCategories.d.ts.map

package/dist/data/loadAllCategories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAllCategories.d.ts","sourceRoot":"","sources":["../../src/data/loadAllCategories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAkBtC"}

package/dist/data/loadAllCategories.js

@@ -0,0 +1,18 @@
+export async function loadAllCategories(provider, versionRootAbs, ids) {
+    const results = await Promise.allSettled(ids.map(async (id) => {
+        const p = `${versionRootAbs}/categories/${id}.json`;
+        const data = await provider.readJson(p);
+        return { id, data };
+    }));
+    const map = {};
+    results.forEach((res, i) => {
+        if (res.status === "fulfilled") {
+            map[res.value.id] = res.value.data;
+        }
+        else {
+            console.warn(`Failed to load category ${ids[i]}:`, res.reason);
+        }
+    });
+    return map;
+}
+//# sourceMappingURL=loadAllCategories.js.map

package/dist/data/loadAllCategories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAllCategories.js","sourceRoot":"","sources":["../../src/data/loadAllCategories.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,cAAsB,EACtB,GAAa;IAEb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,GAAG,cAAc,eAAe,EAAE,OAAO,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAc,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/data/loadAllItems.d.ts

@@ -0,0 +1,4 @@
+import type { DataProvider } from "../types/DataProvider.js";
+import type { DocItem } from "../types/DocItem.js";
+export declare function loadAllItems(provider: DataProvider, versionRootAbs: string, ids: string[]): Promise<DocItem[]>;
+//# sourceMappingURL=loadAllItems.d.ts.map

package/dist/data/loadAllItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAllItems.d.ts","sourceRoot":"","sources":["../../src/data/loadAllItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,OAAO,EAAE,CAAC,CAapB"}

package/dist/data/loadAllItems.js

@@ -0,0 +1,12 @@
+export async function loadAllItems(provider, versionRootAbs, ids) {
+    const results = await Promise.allSettled(ids.map((id) => provider.readJson(`${versionRootAbs}/items/${id}.json`)));
+    const list = [];
+    results.forEach((res, i) => {
+        if (res.status === "fulfilled")
+            list.push(res.value);
+        else
+            console.warn(`Failed to load item ${ids[i]}:`, res.reason);
+    });
+    return list;
+}
+//# sourceMappingURL=loadAllItems.js.map

package/dist/data/loadAllItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAllItems.js","sourceRoot":"","sources":["../../src/data/loadAllItems.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,cAAsB,EACtB,GAAa;IAEb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACb,QAAQ,CAAC,QAAQ,CAAU,GAAG,cAAc,UAAU,EAAE,OAAO,CAAC,CACjE,CACF,CAAC;IAEF,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;;YAChD,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/data/loadVersionData.d.ts

@@ -0,0 +1,9 @@
+import type { Category } from "../types/Category.js";
+import type { DataProvider } from "../types/DataProvider.js";
+import type { DocItem } from "../types/DocItem.js";
+export declare function loadVersionData(provider: DataProvider, versionRootAbs: string): Promise<{
+    items: DocItem[];
+    tree: Category[];
+    standaloneDocs: DocItem[];
+}>;
+//# sourceMappingURL=loadVersionData.d.ts.map

package/dist/data/loadVersionData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersionData.d.ts","sourceRoot":"","sources":["../../src/data/loadVersionData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,cAAc,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAa5E"}

package/dist/data/loadVersionData.js

@@ -0,0 +1,14 @@
+import { buildTree } from "./buildTree.js";
+import { loadAllCategories } from "./loadAllCategories.js";
+import { loadAllItems } from "./loadAllItems.js";
+export async function loadVersionData(provider, versionRootAbs) {
+    const index = await provider.readJson(`${versionRootAbs}/index.json`);
+    const [rawCats, items] = await Promise.all([
+        loadAllCategories(provider, versionRootAbs, index.categories),
+        loadAllItems(provider, versionRootAbs, index.items),
+    ]);
+    const { tree, usedDocIds } = buildTree(rawCats, items);
+    const standaloneDocs = items.filter((d) => !usedDocIds.has(d.id));
+    return { items, tree, standaloneDocs };
+}
+//# sourceMappingURL=loadVersionData.js.map

package/dist/data/loadVersionData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersionData.js","sourceRoot":"","sources":["../../src/data/loadVersionData.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAsB,EACtB,cAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CACnC,GAAG,cAAc,aAAa,CAC/B,CAAC;IAEF,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC;QAC7D,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC;KACpD,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;AACzC,CAAC"}

package/dist/data/loadVersions.d.ts

@@ -0,0 +1,4 @@
+import type { DataProvider } from "../types/DataProvider.js";
+import type { Version } from "../types/Version.js";
+export declare function loadVersions(provider: DataProvider, dataRootAbs: string): Promise<Version[]>;
+//# sourceMappingURL=loadVersions.d.ts.map

package/dist/data/loadVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersions.d.ts","sourceRoot":"","sources":["../../src/data/loadVersions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CAEpB"}

package/dist/data/loadVersions.js

@@ -0,0 +1,4 @@
+export async function loadVersions(provider, dataRootAbs) {
+    return provider.readJson(`${dataRootAbs}/versions.json`);
+}
+//# sourceMappingURL=loadVersions.js.map

package/dist/data/loadVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersions.js","sourceRoot":"","sources":["../../src/data/loadVersions.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,WAAmB;IAEnB,OAAO,QAAQ,CAAC,QAAQ,CAAY,GAAG,WAAW,gBAAgB,CAAC,CAAC;AACtE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./configs/index.js";
+export * from "./themes/index.js";
+export * from "./types/index.js";
+export * from "./data/index.js";
+export * from "./utilities/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./configs/index.js";
+export * from "./themes/index.js";
+export * from "./types/index.js";
+export * from "./data/index.js";
+export * from "./utilities/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/themes/darkTheme.d.ts

@@ -0,0 +1,3 @@
+import type { StyleTheme } from "../types/index.js";
+export declare const darkTheme: StyleTheme;
+//# sourceMappingURL=darkTheme.d.ts.map

package/dist/themes/darkTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"darkTheme.d.ts","sourceRoot":"","sources":["../../src/themes/darkTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,SAAS,EAAE,UAiIvB,CAAC"}