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

package/dist/data/buildTree.d.ts

@@ -1,8 +1,16 @@
 import type { Category } from "../types/Category.js";
+import type { DataDiagnostic } from "../types/DataDiagnostic.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[]): {
+import type { Logger } from "../types/Logger.js";
+interface BuildTreeOptions {
+    logger?: Logger;
+}
+export interface BuildTreeResult {
     tree: Category[];
     usedDocIds: Set<string>;
-};
+    diagnostics: DataDiagnostic[];
+}
+export declare function buildTree(rawMap: Record<string, RawCategory>, allDocs: DocItem[], options?: BuildTreeOptions): BuildTreeResult;
+export {};
 //# sourceMappingURL=buildTree.d.ts.map

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

@@ -1 +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;AA2F3D,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,CA8C/C"}
+{"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,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AA8HD,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAkDjB"}

package/dist/data/buildTree.js

@@ -1,6 +1,14 @@
-function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting) {
+import { createLogger } from "../utilities/system/logger.js";
+function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger) {
     if (visiting.has(raw.id)) {
-        console.warn(`Detected circular category reference at ${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;
     }
     visiting.add(raw.id);
@@ -10,12 +18,26 @@ function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting)
         const validDocs = docIds
             .map((rawId) => {
             if (typeof rawId !== "string" || rawId.length === 0) {
-                console.warn(`Invalid doc id in category ${raw.id}:`, rawId);
+                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;
             }
             const doc = docLookup.get(rawId);
             if (!doc) {
-                console.warn(`Doc id ${rawId} referenced in category ${raw.id} not found.`);
+                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);
@@ -32,15 +54,29 @@ function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting)
         const validChildren = childIds
             .map((rawChildId) => {
             if (typeof rawChildId !== "string" || rawChildId.length === 0) {
-                console.warn(`Invalid child category id in ${raw.id}:`, rawChildId);
+                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) {
-                console.warn(`Child category ${rawChildId} referenced in ${raw.id} not found.`);
+                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);
+            return convertCategory(childRaw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger);
         })
             .filter((child) => child !== null);
         if (validChildren.length > 0) {
@@ -58,10 +94,12 @@ function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting)
         children,
     };
 }
-export function buildTree(rawMap, allDocs) {
+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)) {
@@ -83,9 +121,9 @@ export function buildTree(rawMap, allDocs) {
         .map((rootCategory) => {
         if (includedIds.has(rootCategory.id))
             return null;
-        return convertCategory(rootCategory, rawMap, docLookup, usedDocIds, includedIds, new Set());
+        return convertCategory(rootCategory, rawMap, docLookup, usedDocIds, includedIds, new Set(), diagnostics, logger);
     })
         .filter((category) => category !== null);
-    return { tree, usedDocIds };
+    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.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;CAkB/C;AAED,eAAO,MAAM,cAAc,uBAAiB,CAAC"}
+{"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.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,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"}
+{"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/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,7 +1,8 @@
 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, fsDataProvider } from "./fsDataProvider.js";
 export { HttpDataProvider, httpDataProvider } from "./httpDataProvider.js";

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,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,gBAAgB,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,7 +1,8 @@
 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, fsDataProvider } from "./fsDataProvider.js";
 export { HttpDataProvider, httpDataProvider } from "./httpDataProvider.js";

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,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,gBAAgB,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"}

package/dist/data/loadAllItems.js

@@ -1,12 +1,24 @@
-export async function loadAllItems(provider, versionRootAbs, ids) {
+import { createLogger } from "../utilities/system/logger.js";
+export async function loadAllItems(provider, versionRootAbs, ids, options) {
+    const diagnostics = [];
+    const logger = options?.logger ?? createLogger("data:loadAllItems");
     const results = await Promise.allSettled(ids.map((id) => provider.readJson(`${versionRootAbs}/items/${id}.json`)));
-    const list = [];
+    const items = [];
     results.forEach((res, i) => {
-        if (res.status === "fulfilled")
-            list.push(res.value);
-        else
-            console.warn(`Failed to load item ${ids[i]}:`, res.reason);
+        if (res.status === "fulfilled") {
+            items.push(res.value);
+        }
+        else {
+            const message = `Failed to load item ${ids[i]}: ${res.reason.message ?? res.reason}`;
+            diagnostics.push({
+                code: "item-read-failed",
+                level: "warn",
+                message,
+                context: { id: ids[i] },
+            });
+            logger.warn(message);
+        }
     });
-    return list;
+    return { items, diagnostics };
 }
 //# sourceMappingURL=loadAllItems.js.map

package/dist/data/loadAllItems.js.map

@@ -1 +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"}
+{"version":3,"file":"loadAllItems.js","sourceRoot":"","sources":["../../src/data/loadAllItems.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAW7D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,cAAsB,EACtB,GAAa,EACb,OAA6B;IAE7B,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAEpE,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,KAAK,GAAc,EAAE,CAAC;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,uBAAuB,GAAG,CAAC,CAAC,CAAC,KAAM,GAAG,CAAC,MAAgB,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAChG,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,kBAAkB;gBACxB,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;IACH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/dist/data/loadVersionData.d.ts

@@ -1,9 +1,30 @@
 import type { Category } from "../types/Category.js";
+import type { DataDiagnostic } from "../types/DataDiagnostic.js";
 import type { DataProvider } from "../types/DataProvider.js";
 import type { DocItem } from "../types/DocItem.js";
-export declare function loadVersionData(provider: DataProvider, versionRootAbs: string): Promise<{
+import type { Logger } from "../types/Logger.js";
+import type { Version } from "../types/Version.js";
+export interface LoadVersionDataOptions {
+    logger?: Logger;
+}
+export interface LoadVersionDataResult {
     items: DocItem[];
     tree: Category[];
     standaloneDocs: DocItem[];
+    diagnostics: DataDiagnostic[];
+}
+export interface LoadVersionDataFromProviderOptions extends LoadVersionDataOptions {
+    version?: string;
+}
+export interface LoadVersionDataFromProviderResult extends LoadVersionDataResult {
+    version: string;
+    versions: Version[];
+}
+export declare function loadVersionData(provider: DataProvider, versionRootAbs: string, options?: LoadVersionDataOptions): Promise<LoadVersionDataResult>;
+export declare function loadVersionDataFromHttp(baseUrl: string, options?: LoadVersionDataFromProviderOptions): Promise<LoadVersionDataFromProviderResult>;
+export declare function selectVersion(provider: DataProvider, root: string, requested: string | undefined, logger: Logger): Promise<{
+    versions: Version[];
+    selectedVersion: string;
+    diagnostics: DataDiagnostic[];
 }>;
 //# sourceMappingURL=loadVersionData.d.ts.map

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

@@ -1 +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"}
+{"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,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AASnD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kCAAmC,SAAQ,sBAAsB;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iCAAkC,SAAQ,qBAAqB;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA4BhC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kCAAkC,GAC3C,OAAO,CAAC,iCAAiC,CAAC,CA2B5C;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B,CAAC,CAkCD"}

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

@@ -0,0 +1,3 @@
+import type { LoadVersionDataFromProviderOptions, LoadVersionDataFromProviderResult } from "./loadVersionData.js";
+export declare function loadVersionDataFromFs(baseDir: string, options?: LoadVersionDataFromProviderOptions): Promise<LoadVersionDataFromProviderResult>;
+//# sourceMappingURL=loadVersionData.fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersionData.fs.d.ts","sourceRoot":"","sources":["../../src/data/loadVersionData.fs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kCAAkC,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AAQlH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kCAAkC,GAC3C,OAAO,CAAC,iCAAiC,CAAC,CA0B5C"}

package/dist/data/loadVersionData.fs.js

@@ -0,0 +1,24 @@
+import path from "node:path";
+import { normalizeSystemPath } from "../utilities/string/normalizeSystemPath.js";
+import { createLogger } from "../utilities/system/logger.js";
+import { FsDataProvider } from "./fsDataProvider.js";
+import { loadVersionData, selectVersion } from "./loadVersionData.js";
+export async function loadVersionDataFromFs(baseDir, options) {
+    const logger = options?.logger ?? createLogger("data:loadVersionDataFromFs");
+    const provider = new FsDataProvider();
+    const diagnostics = [];
+    const root = normalizeSystemPath(path.resolve(baseDir));
+    const { versions, selectedVersion, diagnostics: versionDiagnostics, } = await selectVersion(provider, root, options?.version, logger);
+    const versionRoot = normalizeSystemPath(path.resolve(root, selectedVersion));
+    const { items, tree, standaloneDocs, diagnostics: loadDiagnostics } = await loadVersionData(provider, versionRoot, { logger });
+    diagnostics.push(...versionDiagnostics, ...loadDiagnostics);
+    return {
+        version: selectedVersion,
+        versions,
+        items,
+        tree,
+        standaloneDocs,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=loadVersionData.fs.js.map

package/dist/data/loadVersionData.fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadVersionData.fs.js","sourceRoot":"","sources":["../../src/data/loadVersionData.fs.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,OAA4C;IAE5C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC,4BAA4B,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAExD,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,WAAW,EAAE,kBAAkB,GAChC,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAElE,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,GACjE,MAAM,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3D,WAAW,CAAC,IAAI,CAAC,GAAG,kBAAkB,EAAE,GAAG,eAAe,CAAC,CAAC;IAE5D,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,cAAc;QACd,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/data/loadVersionData.js

@@ -1,14 +1,74 @@
+import { createLogger } from "../utilities/system/logger.js";
+import { HttpDataProvider } from "./httpDataProvider.js";
 import { buildTree } from "./buildTree.js";
 import { loadAllCategories } from "./loadAllCategories.js";
 import { loadAllItems } from "./loadAllItems.js";
-export async function loadVersionData(provider, versionRootAbs) {
+import { loadVersions } from "./loadVersions.js";
+export async function loadVersionData(provider, versionRootAbs, options) {
+    const logger = options?.logger;
+    const diagnostics = [];
     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 [categoriesResult, itemsResult] = await Promise.all([
+        loadAllCategories(provider, versionRootAbs, index.categories, { logger }),
+        loadAllItems(provider, versionRootAbs, index.items, { logger }),
     ]);
-    const { tree, usedDocIds } = buildTree(rawCats, items);
-    const standaloneDocs = items.filter((d) => !usedDocIds.has(d.id));
-    return { items, tree, standaloneDocs };
+    const { tree, usedDocIds, diagnostics: treeDiagnostics } = buildTree(categoriesResult.categories, itemsResult.items, { logger });
+    const standaloneDocs = itemsResult.items.filter((d) => !usedDocIds.has(d.id));
+    diagnostics.push(...categoriesResult.diagnostics, ...itemsResult.diagnostics, ...treeDiagnostics);
+    return { items: itemsResult.items, tree, standaloneDocs, diagnostics };
+}
+export async function loadVersionDataFromHttp(baseUrl, options) {
+    const logger = options?.logger ?? createLogger("data:loadVersionDataFromHttp");
+    const provider = new HttpDataProvider();
+    const root = trimTrailingSlash(baseUrl);
+    const { versions, selectedVersion, diagnostics: versionDiagnostics, } = await selectVersion(provider, root, options?.version, logger);
+    const versionRoot = joinUrl(root, selectedVersion);
+    const { items, tree, standaloneDocs, diagnostics } = await loadVersionData(provider, versionRoot, { logger });
+    return {
+        version: selectedVersion,
+        versions,
+        items,
+        tree,
+        standaloneDocs,
+        diagnostics: [...versionDiagnostics, ...diagnostics],
+    };
+}
+export async function selectVersion(provider, root, requested, logger) {
+    const versions = await loadVersions(provider, root);
+    const diagnostics = [];
+    const fallback = "current";
+    if (versions.length === 0) {
+        const message = `No versions found under ${root}. Falling back to "${fallback}".`;
+        diagnostics.push({
+            code: "no-versions-found",
+            level: "warn",
+            message,
+            context: { root },
+        });
+        logger.warn(message);
+        return { versions, selectedVersion: requested ?? fallback, diagnostics };
+    }
+    if (requested) {
+        const match = versions.find((v) => v.version === requested);
+        if (!match) {
+            const message = `Requested version "${requested}" not found. Using first available: "${versions[0].version}".`;
+            diagnostics.push({
+                code: "version-not-found",
+                level: "warn",
+                message,
+                context: { requested, available: versions.map((v) => v.version) },
+            });
+            logger.warn(message);
+            return { versions, selectedVersion: versions[0].version, diagnostics };
+        }
+        return { versions, selectedVersion: requested, diagnostics };
+    }
+    return { versions, selectedVersion: versions[0].version, diagnostics };
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+function joinUrl(base, child) {
+    return `${trimTrailingSlash(base)}/${child.replace(/^\/+/, "")}`;
 }
 //# sourceMappingURL=loadVersionData.js.map

package/dist/data/loadVersionData.js.map

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

package/dist/index.browser.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC"}

package/dist/index.browser.js

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

package/dist/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC"}

package/dist/themes/index.d.ts

@@ -1,3 +1,4 @@
 export { defaultTheme } from "./presets/default.js";
 export { AVAILABLE_THEME_PRESET_NAMES, DEFAULT_THEME_PRESET, DOCS_CORE_THEME_PRESETS, getThemePreset, isThemePresetName, } from "./themeRegistry.js";
+export { isStyleTheme, parseStyleTheme, styleThemeSchema } from "./styleThemeSchema.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/themes/index.js

@@ -1,3 +1,4 @@
 export { defaultTheme } from "./presets/default.js";
 export { AVAILABLE_THEME_PRESET_NAMES, DEFAULT_THEME_PRESET, DOCS_CORE_THEME_PRESETS, getThemePreset, isThemePresetName, } from "./themeRegistry.js";
+export { isStyleTheme, parseStyleTheme, styleThemeSchema } from "./styleThemeSchema.js";
 //# sourceMappingURL=index.js.map