@shadow-shard-tools/docs-core 1.0.17 → 1.0.19

package/dist/data/buildTree.js

@@ -1,174 +1,129 @@
-export function buildTree(rawMap, allDocs) {
-    const errors = [];
-    const docLookup = new Map(allDocs.map((d) => [d.id, d]));
-    const usedDocIds = new Set();
-    // First pass: collect valid category ids.
-    const categoryIds = new Set();
-    for (const raw of Object.values(rawMap)) {
-        const id = typeof raw?.id === "string" ? raw.id.trim() : "";
-        if (id.length === 0) {
-            errors.push({
-                type: "invalidCategoryId",
-                message: "Encountered category with missing or invalid id.",
-            });
-            continue;
-        }
-        if (categoryIds.has(id)) {
-            errors.push({
-                type: "invalidCategoryId",
-                categoryId: id,
-                message: `Duplicate category id "${id}" encountered.`,
-            });
-            continue;
-        }
-        categoryIds.add(id);
+import { createLogger } from "../utilities/system/logger.js";
+function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger) {
+    if (visiting.has(raw.id)) {
+        const message = `Detected circular category reference at ${raw.id}.`;
+        diagnostics.push({
+            code: "circular-category",
+            level: "warn",
+            message,
+            context: { categoryId: raw.id },
+        });
+        logger.warn(message);
+        return null;
     }
-    // Second pass: prepare categories, docs, and adjacency once.
-    const prepared = new Map();
-    const referencedAsChild = new Map();
-    for (const raw of Object.values(rawMap)) {
-        const id = typeof raw?.id === "string" ? raw.id.trim() : "";
-        if (!categoryIds.has(id)) {
-            continue;
-        }
-        let docs;
-        if (raw.docs !== undefined && !Array.isArray(raw.docs)) {
-            errors.push({
-                type: "invalidDocsField",
-                categoryId: id,
-                message: `Category "${id}" has an invalid docs field (expected array).`,
-            });
-        }
-        else if (Array.isArray(raw.docs)) {
-            const collected = [];
-            for (const rawDocId of raw.docs) {
-                if (typeof rawDocId !== "string" || rawDocId.trim().length === 0) {
-                    errors.push({
-                        type: "invalidDocId",
-                        categoryId: id,
-                        docId: rawDocId,
-                        message: `Category "${id}" references an invalid doc id.`,
-                    });
-                    continue;
-                }
-                const docId = rawDocId.trim();
-                const doc = docLookup.get(docId);
-                if (!doc) {
-                    errors.push({
-                        type: "missingDoc",
-                        categoryId: id,
-                        docId,
-                        message: `Doc id "${docId}" referenced in category "${id}" was not found.`,
-                    });
-                    continue;
-                }
-                collected.push(doc);
-                usedDocIds.add(docId);
+    visiting.add(raw.id);
+    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) {
+                const message = `Invalid doc id in category ${raw.id}.`;
+                diagnostics.push({
+                    code: "invalid-doc-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, docId: rawId },
+                });
+                logger.warn(message);
+                return null;
             }
-            if (collected.length > 0) {
-                docs = collected;
+            const doc = docLookup.get(rawId);
+            if (!doc) {
+                const message = `Doc id ${rawId} referenced in category ${raw.id} not found.`;
+                diagnostics.push({
+                    code: "missing-doc-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, docId: rawId },
+                });
+                logger.warn(message);
+                return null;
             }
+            usedDocIds.add(rawId);
+            return doc;
+        })
+            .filter((doc) => doc !== null);
+        if (validDocs.length > 0) {
+            docs = validDocs;
         }
-        const childIds = [];
-        if (raw.children !== undefined && !Array.isArray(raw.children)) {
-            errors.push({
-                type: "invalidChildrenField",
-                categoryId: id,
-                message: `Category "${id}" has an invalid children field (expected array).`,
-            });
-        }
-        else if (Array.isArray(raw.children)) {
-            for (const rawChildId of raw.children) {
-                if (typeof rawChildId !== "string" ||
-                    rawChildId.trim().length === 0) {
-                    errors.push({
-                        type: "invalidChildId",
-                        categoryId: id,
-                        childId: rawChildId,
-                        message: `Category "${id}" references an invalid child category id.`,
-                    });
-                    continue;
-                }
-                const childId = rawChildId.trim();
-                if (!categoryIds.has(childId)) {
-                    errors.push({
-                        type: "missingCategory",
-                        categoryId: id,
-                        childId,
-                        message: `Child category "${childId}" referenced in "${id}" was not found.`,
-                    });
-                    continue;
-                }
-                childIds.push(childId);
-                referencedAsChild.set(childId, (referencedAsChild.get(childId) ?? 0) + 1);
-            }
-        }
-        prepared.set(id, { raw, docs, childIds });
     }
-    const allValidIds = Array.from(prepared.keys());
-    const rootIds = allValidIds.filter((id) => !referencedAsChild.has(id));
-    const rootsToUse = rootIds.length > 0 ? rootIds : allValidIds;
-    const state = new Map();
-    const built = new Map();
-    const buildNode = (id, stack) => {
-        const current = state.get(id) ?? "unvisited";
-        if (current === "visiting") {
-            const cyclePath = [...stack, id];
-            errors.push({
-                type: "cycle",
-                path: cyclePath,
-                message: `Detected circular category reference: ${cyclePath.join(" -> ")}`,
-            });
-            return null;
-        }
-        if (current === "visited") {
-            return built.get(id) ?? null;
-        }
-        const preparedCategory = prepared.get(id);
-        if (!preparedCategory) {
-            errors.push({
-                type: "missingCategory",
-                categoryId: id,
-                message: `Category "${id}" was referenced but not defined.`,
-            });
-            return null;
-        }
-        state.set(id, "visiting");
-        stack.push(id);
-        const children = [];
-        for (const childId of preparedCategory.childIds) {
-            const childNode = buildNode(childId, stack);
-            if (childNode) {
-                children.push(childNode);
+    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) {
+                const message = `Invalid child category id in ${raw.id}.`;
+                diagnostics.push({
+                    code: "invalid-child-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, childId: rawChildId },
+                });
+                logger.warn(message);
+                return null;
             }
+            const childRaw = rawMap[rawChildId];
+            if (!childRaw) {
+                const message = `Child category ${rawChildId} referenced in ${raw.id} not found.`;
+                diagnostics.push({
+                    code: "missing-child-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, childId: rawChildId },
+                });
+                logger.warn(message);
+                return null;
+            }
+            return convertCategory(childRaw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger);
+        })
+            .filter((child) => child !== null);
+        if (validChildren.length > 0) {
+            children = validChildren;
         }
-        const node = {
-            id: preparedCategory.raw.id,
-            title: preparedCategory.raw.title,
-            description: preparedCategory.raw.description,
-            content: preparedCategory.raw.content ?? [],
-        };
-        if (preparedCategory.docs && preparedCategory.docs.length > 0) {
-            node.docs = preparedCategory.docs;
-        }
-        if (children.length > 0) {
-            node.children = children;
-        }
-        built.set(id, node);
-        state.set(id, "visited");
-        stack.pop();
-        return node;
+    }
+    visiting.delete(raw.id);
+    included.add(raw.id);
+    return {
+        id: raw.id,
+        title: raw.title,
+        description: raw.description,
+        content: raw.content ?? [],
+        docs,
+        children,
     };
-    const tree = [];
-    for (const id of rootsToUse) {
-        if ((state.get(id) ?? "unvisited") === "visited") {
-            continue;
-        }
-        const node = buildNode(id, []);
-        if (node) {
-            tree.push(node);
+}
+export function buildTree(rawMap, allDocs, options) {
+    const docLookup = new Map(allDocs.map((d) => [d.id, d]));
+    const usedDocIds = new Set();
+    const includedIds = new Set();
+    const diagnostics = [];
+    const logger = options?.logger ?? createLogger("data:buildTree");
+    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);
+                }
+            });
         }
+    });
+    let rootCandidates = Object.values(rawMap).filter((category) => category &&
+        typeof category.id === "string" &&
+        category.id.length > 0 &&
+        !childCategoryIds.has(category.id));
+    if (rootCandidates.length === 0) {
+        rootCandidates = Object.values(rawMap).filter((category) => category && typeof category.id === "string" && category.id.length > 0);
     }
-    return { tree, usedDocIds, errors };
+    const tree = rootCandidates
+        .map((rootCategory) => {
+        if (includedIds.has(rootCategory.id))
+            return null;
+        return convertCategory(rootCategory, rawMap, docLookup, usedDocIds, includedIds, new Set(), diagnostics, logger);
+    })
+        .filter((category) => category !== null);
+    return { tree, usedDocIds, diagnostics };
 }
 //# sourceMappingURL=buildTree.js.map

package/dist/data/buildTree.js.map

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

package/dist/data/fsDataProvider.browser.d.ts

@@ -0,0 +1,6 @@
+import type { DataProvider } from "../types/DataProvider.js";
+export declare class FsDataProvider implements DataProvider {
+    readJson<T>(_absPath: string): Promise<T>;
+}
+export declare const fsDataProvider: typeof FsDataProvider;
+//# sourceMappingURL=fsDataProvider.browser.d.ts.map

package/dist/data/fsDataProvider.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsDataProvider.browser.d.ts","sourceRoot":"","sources":["../../src/data/fsDataProvider.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,qBAAa,cAAe,YAAW,YAAY;IAC3C,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAKhD;AAED,eAAO,MAAM,cAAc,uBAAiB,CAAC"}

package/dist/data/fsDataProvider.browser.js

@@ -0,0 +1,7 @@
+export class FsDataProvider {
+    async readJson(_absPath) {
+        throw new Error("FsDataProvider is only available in Node.js environments where the file system can be read.");
+    }
+}
+export const fsDataProvider = FsDataProvider;
+//# sourceMappingURL=fsDataProvider.browser.js.map

package/dist/data/fsDataProvider.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsDataProvider.browser.js","sourceRoot":"","sources":["../../src/data/fsDataProvider.browser.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ,CAAI,QAAgB;QAChC,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/dist/data/fsDataProvider.d.ts

@@ -1,5 +1,6 @@
 import type { DataProvider } from "../index.js";
-export declare class fsDataProvider implements DataProvider {
+export declare class FsDataProvider implements DataProvider {
     readJson<T>(absPath: string): Promise<T>;
 }
+export declare const fsDataProvider: typeof FsDataProvider;
 //# sourceMappingURL=fsDataProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fsDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,cAAe,YAAW,YAAY;IAC3C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAI/C"}
+{"version":3,"file":"fsDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,cAAe,YAAW,YAAY;IAC3C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAkB/C;AAED,eAAO,MAAM,cAAc,uBAAiB,CAAC"}

package/dist/data/fsDataProvider.js

@@ -1,8 +1,20 @@
 import { readFile } from "node:fs/promises";
-export class fsDataProvider {
+export class FsDataProvider {
     async readJson(absPath) {
-        const contents = await readFile(absPath, "utf8");
-        return JSON.parse(contents);
+        let contents;
+        try {
+            contents = await readFile(absPath, "utf8");
+        }
+        catch (error) {
+            throw new Error(`Failed to read JSON from ${absPath}: ${error.message}`);
+        }
+        try {
+            return JSON.parse(contents);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from ${absPath}: ${error.message}`);
+        }
     }
 }
+export const fsDataProvider = FsDataProvider;
 //# sourceMappingURL=fsDataProvider.js.map

package/dist/data/fsDataProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"fsDataProvider.js","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ,CAAI,OAAe;QAC/B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"fsDataProvider.js","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ,CAAI,OAAe;QAC/B,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,KAAM,KAAe,CAAC,OAAO,EAAE,CACnE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,KAAM,KAAe,CAAC,OAAO,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

package/dist/data/httpDataProvider.d.ts

@@ -1,5 +1,6 @@
 import type { DataProvider } from "../index.js";
-export declare class httpDataProvider implements DataProvider {
+export declare class HttpDataProvider implements DataProvider {
     readJson<T>(absUrl: string): Promise<T>;
 }
+export declare const httpDataProvider: typeof HttpDataProvider;
 //# sourceMappingURL=httpDataProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"httpDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,gBAAiB,YAAW,YAAY;IAC7C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ9C"}
+{"version":3,"file":"httpDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,gBAAiB,YAAW,YAAY;IAC7C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAwB9C;AAED,eAAO,MAAM,gBAAgB,yBAAmB,CAAC"}

package/dist/data/httpDataProvider.js

@@ -1,9 +1,22 @@
-export class httpDataProvider {
+export class HttpDataProvider {
     async readJson(absUrl) {
-        const res = await fetch(absUrl);
-        if (!res.ok)
+        let res;
+        try {
+            res = await fetch(absUrl);
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch ${absUrl}: ${error.message}`);
+        }
+        if (!res.ok) {
             throw new Error(`Failed to fetch ${absUrl}: ${res.status} ${res.statusText}`);
-        return res.json();
+        }
+        try {
+            return (await res.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from ${absUrl}: ${error.message}`);
+        }
     }
 }
+export const httpDataProvider = HttpDataProvider;
 //# sourceMappingURL=httpDataProvider.js.map

package/dist/data/httpDataProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"httpDataProvider.js","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,QAAQ,CAAI,MAAc;QAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,EAAE;YACT,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAC7D,CAAC;QACJ,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"httpDataProvider.js","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,QAAQ,CAAI,MAAc;QAC9B,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,KAAM,KAAe,CAAC,OAAO,EAAE,CACzD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAC7D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,KAAM,KAAe,CAAC,OAAO,EAAE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/data/index.browser.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,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/index.browser.js

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

package/dist/data/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../src/data/index.browser.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,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/index.d.ts

@@ -1,8 +1,9 @@
 export { buildTree } from "./buildTree.js";
 export { loadAllCategories } from "./loadAllCategories.js";
 export { loadAllItems } from "./loadAllItems.js";
-export { loadVersionData } from "./loadVersionData.js";
+export { loadVersionData, loadVersionDataFromHttp, } from "./loadVersionData.js";
+export { loadVersionDataFromFs } from "./loadVersionData.fs.js";
 export { loadVersions } from "./loadVersions.js";
-export { fsDataProvider } from "./fsDataProvider.js";
-export { httpDataProvider } from "./httpDataProvider.js";
+export { FsDataProvider, fsDataProvider } from "./fsDataProvider.js";
+export { HttpDataProvider, httpDataProvider } from "./httpDataProvider.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"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,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/index.js

@@ -1,8 +1,9 @@
 export { buildTree } from "./buildTree.js";
 export { loadAllCategories } from "./loadAllCategories.js";
 export { loadAllItems } from "./loadAllItems.js";
-export { loadVersionData } from "./loadVersionData.js";
+export { loadVersionData, loadVersionDataFromHttp, } from "./loadVersionData.js";
+export { loadVersionDataFromFs } from "./loadVersionData.fs.js";
 export { loadVersions } from "./loadVersions.js";
-export { fsDataProvider } from "./fsDataProvider.js";
-export { httpDataProvider } from "./httpDataProvider.js";
+export { FsDataProvider, fsDataProvider } from "./fsDataProvider.js";
+export { HttpDataProvider, httpDataProvider } from "./httpDataProvider.js";
 //# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -1 +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;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"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,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/data/loadAllCategories.d.ts

@@ -1,4 +1,13 @@
+import type { DataDiagnostic } from "../types/DataDiagnostic.js";
 import type { DataProvider } from "../types/DataProvider.js";
+import type { Logger } from "../types/Logger.js";
 import type { RawCategory } from "../types/RawCategory.js";
-export declare function loadAllCategories(provider: DataProvider, versionRootAbs: string, ids: string[]): Promise<Record<string, RawCategory>>;
+export interface LoadAllCategoriesResult {
+    categories: Record<string, RawCategory>;
+    diagnostics: DataDiagnostic[];
+}
+export interface LoadAllCategoriesOptions {
+    logger?: Logger;
+}
+export declare function loadAllCategories(provider: DataProvider, versionRootAbs: string, ids: string[], options?: LoadAllCategoriesOptions): Promise<LoadAllCategoriesResult>;
 //# sourceMappingURL=loadAllCategories.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"loadAllCategories.d.ts","sourceRoot":"","sources":["../../src/data/loadAllCategories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CA6BlC"}

package/dist/data/loadAllCategories.js

@@ -1,18 +1,28 @@
-export async function loadAllCategories(provider, versionRootAbs, ids) {
+import { createLogger } from "../utilities/system/logger.js";
+export async function loadAllCategories(provider, versionRootAbs, ids, options) {
+    const diagnostics = [];
+    const logger = options?.logger ?? createLogger("data:loadAllCategories");
     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 = {};
+    const categories = {};
     results.forEach((res, i) => {
         if (res.status === "fulfilled") {
-            map[res.value.id] = res.value.data;
+            categories[res.value.id] = res.value.data;
         }
         else {
-            console.warn(`Failed to load category ${ids[i]}:`, res.reason);
+            const message = `Failed to load category ${ids[i]}: ${res.reason.message ?? res.reason}`;
+            diagnostics.push({
+                code: "category-read-failed",
+                level: "warn",
+                message,
+                context: { id: ids[i] },
+            });
+            logger.warn(message);
         }
     });
-    return map;
+    return { categories, diagnostics };
 }
 //# sourceMappingURL=loadAllCategories.js.map

package/dist/data/loadAllCategories.js.map

@@ -1 +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"}
+{"version":3,"file":"loadAllCategories.js","sourceRoot":"","sources":["../../src/data/loadAllCategories.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAW7D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,cAAsB,EACtB,GAAa,EACb,OAAkC;IAElC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,CAAC,CAAC;IAEzE,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,UAAU,GAAgC,EAAE,CAAC;IACnD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,2BAA2B,GAAG,CAAC,CAAC,CAAC,KAAM,GAAG,CAAC,MAAgB,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACpG,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE,MAAM;gBACb,OAAO;gBACP,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE;aACxB,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC"}

package/dist/data/loadAllItems.d.ts

@@ -1,4 +1,13 @@
+import type { DataDiagnostic } from "../types/DataDiagnostic.js";
 import type { DataProvider } from "../types/DataProvider.js";
+import type { Logger } from "../types/Logger.js";
 import type { DocItem } from "../types/DocItem.js";
-export declare function loadAllItems(provider: DataProvider, versionRootAbs: string, ids: string[]): Promise<DocItem[]>;
+export interface LoadAllItemsResult {
+    items: DocItem[];
+    diagnostics: DataDiagnostic[];
+}
+export interface LoadAllItemsOptions {
+    logger?: Logger;
+}
+export declare function loadAllItems(provider: DataProvider, versionRootAbs: string, ids: string[], options?: LoadAllItemsOptions): Promise<LoadAllItemsResult>;
 //# sourceMappingURL=loadAllItems.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"loadAllItems.d.ts","sourceRoot":"","sources":["../../src/data/loadAllItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}