@shadow-shard-tools/docs-core 1.0.7 → 1.0.9

package/dist/constants/aligmentClasses.d.ts

@@ -0,0 +1,15 @@
+export declare const ALIGNMENT_CLASSES: {
+    readonly left: {
+        readonly text: "text-left";
+        readonly container: "mr-auto";
+    };
+    readonly center: {
+        readonly text: "text-center";
+        readonly container: "mx-auto";
+    };
+    readonly right: {
+        readonly text: "text-right";
+        readonly container: "ml-auto";
+    };
+};
+//# sourceMappingURL=aligmentClasses.d.ts.map

package/dist/constants/aligmentClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aligmentClasses.d.ts","sourceRoot":"","sources":["../../src/constants/aligmentClasses.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC"}

package/dist/constants/aligmentClasses.js

@@ -0,0 +1,15 @@
+export const ALIGNMENT_CLASSES = {
+    left: {
+        text: "text-left",
+        container: "mr-auto",
+    },
+    center: {
+        text: "text-center",
+        container: "mx-auto",
+    },
+    right: {
+        text: "text-right",
+        container: "ml-auto",
+    },
+};
+//# sourceMappingURL=aligmentClasses.js.map

package/dist/constants/aligmentClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aligmentClasses.js","sourceRoot":"","sources":["../../src/constants/aligmentClasses.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,SAAS;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,SAAS;KACrB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,SAAS;KACrB;CACO,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,3 @@
+export { ALIGNMENT_CLASSES } from "./aligmentClasses.js";
+export { SPACING_CLASSES } from "./spacingClasses.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,3 @@
+export { ALIGNMENT_CLASSES } from "./aligmentClasses.js";
+export { SPACING_CLASSES } from "./spacingClasses.js";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/constants/spacingClasses.d.ts

@@ -0,0 +1,7 @@
+export declare const SPACING_CLASSES: {
+    readonly none: "";
+    readonly small: "mb-4";
+    readonly medium: "mb-6";
+    readonly large: "mb-8";
+};
+//# sourceMappingURL=spacingClasses.d.ts.map

package/dist/constants/spacingClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacingClasses.d.ts","sourceRoot":"","sources":["../../src/constants/spacingClasses.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC"}

package/dist/constants/spacingClasses.js

@@ -0,0 +1,7 @@
+export const SPACING_CLASSES = {
+    none: "",
+    small: "mb-4",
+    medium: "mb-6",
+    large: "mb-8",
+};
+//# sourceMappingURL=spacingClasses.js.map

package/dist/constants/spacingClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacingClasses.js","sourceRoot":"","sources":["../../src/constants/spacingClasses.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,MAAM;CACL,CAAC"}

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;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"}
+{"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"}

package/dist/data/buildTree.js

@@ -1,59 +1,67 @@
-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;
+function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting) {
+    if (visiting.has(raw.id)) {
+        console.warn(`Detected circular category reference at ${raw.id}.`);
+        return null;
+    }
+    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) {
+                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;
             }
+            usedDocIds.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;
+    }
+    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 convertCategory(childRaw, rawMap, docLookup, usedDocIds, included, visiting);
+        })
+            .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,
-        };
+    }
+    visiting.delete(raw.id);
+    included.add(raw.id);
+    return {
+        id: raw.id,
+        title: raw.title,
+        description: raw.description,
+        content: raw.content ?? [],
+        docs,
+        children,
     };
+}
+export function buildTree(rawMap, allDocs) {
+    const docLookup = new Map(allDocs.map((d) => [d.id, d]));
+    const usedDocIds = new Set();
+    const includedIds = new Set();
     const childCategoryIds = new Set();
     Object.values(rawMap).forEach((category) => {
         if (Array.isArray(category?.children)) {
@@ -64,12 +72,20 @@ export function buildTree(rawMap, allDocs) {
             });
         }
     });
-    const tree = Object.values(rawMap)
-        .filter((category) => category &&
+    let rootCandidates = Object.values(rawMap).filter((category) => category &&
         typeof category.id === "string" &&
         category.id.length > 0 &&
-        !childCategoryIds.has(category.id))
-        .map(convert);
-    return { tree, usedDocIds: used };
+        !childCategoryIds.has(category.id));
+    if (rootCandidates.length === 0) {
+        rootCandidates = Object.values(rawMap).filter((category) => category && typeof category.id === "string" && category.id.length > 0);
+    }
+    const tree = rootCandidates
+        .map((rootCategory) => {
+        if (includedIds.has(rootCategory.id))
+            return null;
+        return convertCategory(rootCategory, rawMap, docLookup, usedDocIds, includedIds, new Set());
+    })
+        .filter((category) => category !== null);
+    return { tree, usedDocIds };
 }
 //# 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.d.ts

@@ -1,6 +1,5 @@
 import type { DataProvider } from "../index.js";
 export declare class FileSystemProvider implements DataProvider {
     readJson<T>(absPath: string): Promise<T>;
-    fileExists(absPath: string): Promise<boolean>;
 }
 //# 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":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,kBAAmB,YAAW,YAAY;IAC/C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CASpD"}
+{"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,kBAAmB,YAAW,YAAY;IAC/C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAI/C"}

package/dist/data/fsDataProvider.js

@@ -1,20 +1,8 @@
 import { readFile, access } from "node:fs/promises";
-import { constants } from "node:fs";
 export class FileSystemProvider {
     async readJson(absPath) {
         const contents = await readFile(absPath, "utf8");
         return JSON.parse(contents);
     }
-    async fileExists(absPath) {
-        try {
-            await access(absPath, constants.F_OK);
-            return true;
-        }
-        catch (err) {
-            if (err.code === "ENOENT")
-                return false;
-            throw err;
-        }
-    }
 }
 //# 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,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,OAAO,kBAAkB;IAC7B,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;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACnE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"fsDataProvider.js","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,OAAO,kBAAkB;IAC7B,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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./configs/index.js";
+export * from "./constants/index.js";
 export * from "./themes/index.js";
 export * from "./types/index.js";
 export * from "./data/index.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./configs/index.js";
+export * from "./constants/index.js";
 export * from "./themes/index.js";
 export * from "./types/index.js";
 export * from "./data/index.js";

package/dist/index.js.map

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

package/dist/types/Content.d.ts

@@ -14,7 +14,7 @@ import type { TextData } from "./TextData.js";
 import type { TitleData } from "./TitleData.js";
 import type { YoutubeData } from "./YoutubeData.js";
 export interface Content {
-    type?: "title" | "text" | "list" | "table" | "messageBox" | "divider" | "image" | "imageCompare" | "imageCarousel" | "imageGrid" | "audio" | "youtube" | "math" | "code" | "chart" | "graph";
+    type?: "title" | "text" | "list" | "table" | "messageBox" | "divider" | "image" | "imageCompare" | "imageCarousel" | "imageGrid" | "audio" | "youtube" | "math" | "code" | "chart";
     titleData?: TitleData;
     textData?: TextData;
     listData?: ListData;

package/dist/types/Content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Content.d.ts","sourceRoot":"","sources":["../../src/types/Content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EACD,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,SAAS,GACT,OAAO,GACP,cAAc,GACd,eAAe,GACf,WAAW,GACX,OAAO,GACP,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,CAAC;IAEZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB"}
+{"version":3,"file":"Content.d.ts","sourceRoot":"","sources":["../../src/types/Content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EACD,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,SAAS,GACT,OAAO,GACP,cAAc,GACd,eAAe,GACf,WAAW,GACX,OAAO,GACP,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,CAAC;IAEZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB"}

package/dist/types/DataProvider.d.ts

@@ -1,5 +1,4 @@
 export interface DataProvider {
     readJson<T>(absPath: string): Promise<T>;
-    fileExists?(absPath: string): Promise<boolean>;
 }
 //# sourceMappingURL=DataProvider.d.ts.map

package/dist/types/DataProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataProvider.d.ts","sourceRoot":"","sources":["../../src/types/DataProvider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,UAAU,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD"}
+{"version":3,"file":"DataProvider.d.ts","sourceRoot":"","sources":["../../src/types/DataProvider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1C"}

package/dist/types/HeaderBranding.d.ts

@@ -0,0 +1,6 @@
+export interface HeaderBranding {
+    logoSrc?: string;
+    logoAlt?: string;
+    logoText?: string;
+}
+//# sourceMappingURL=HeaderBranding.d.ts.map

package/dist/types/HeaderBranding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderBranding.d.ts","sourceRoot":"","sources":["../../src/types/HeaderBranding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/HeaderBranding.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HeaderBranding.js.map

package/dist/types/HeaderBranding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderBranding.js","sourceRoot":"","sources":["../../src/types/HeaderBranding.ts"],"names":[],"mappings":""}

package/dist/utilities/dom/copyToClipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copyToClipboard.d.ts","sourceRoot":"","sources":["../../../src/utilities/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAkBnE,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"copyToClipboard.d.ts","sourceRoot":"","sources":["../../../src/utilities/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAuCnE,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/utilities/dom/copyToClipboard.js

@@ -1,22 +1,37 @@
 export const copyToClipboard = async (text) => {
-    try {
-        await navigator.clipboard.writeText(text);
-        return true;
-    }
-    catch {
-        // Fallback for older browsers
-        const textarea = document.createElement("textarea");
-        textarea.value = text;
-        document.body.appendChild(textarea);
-        textarea.select();
+    const hasNavigatorClipboard = typeof navigator !== "undefined" &&
+        !!navigator.clipboard &&
+        typeof navigator.clipboard.writeText === "function";
+    if (hasNavigatorClipboard) {
         try {
-            const success = document.execCommand("copy");
-            return success;
+            await navigator.clipboard.writeText(text);
+            return true;
         }
-        finally {
-            document.body.removeChild(textarea);
+        catch {
+            // Intentionally fall through to the DOM-based fallback.
         }
     }
+    if (typeof document === "undefined" ||
+        typeof document.createElement !== "function" ||
+        typeof document.body === "undefined") {
+        return false;
+    }
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.setAttribute("readonly", "true");
+    textarea.style.position = "absolute";
+    textarea.style.left = "-9999px";
+    document.body.appendChild(textarea);
+    textarea.select();
+    try {
+        const success = typeof document.execCommand === "function"
+            ? document.execCommand("copy")
+            : false;
+        return success;
+    }
+    finally {
+        document.body.removeChild(textarea);
+    }
 };
 export default copyToClipboard;
 //# sourceMappingURL=copyToClipboard.js.map

package/dist/utilities/dom/copyToClipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyToClipboard.js","sourceRoot":"","sources":["../../../src/utilities/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACtE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"copyToClipboard.js","sourceRoot":"","sources":["../../../src/utilities/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACtE,MAAM,qBAAqB,GACzB,OAAO,SAAS,KAAK,WAAW;QAChC,CAAC,CAAC,SAAS,CAAC,SAAS;QACrB,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,KAAK,UAAU,CAAC;IAEtD,IAAI,qBAAqB,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;IAED,IACE,OAAO,QAAQ,KAAK,WAAW;QAC/B,OAAO,QAAQ,CAAC,aAAa,KAAK,UAAU;QAC5C,OAAO,QAAQ,CAAC,IAAI,KAAK,WAAW,EACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,WAAW,KAAK,UAAU;YACxD,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;YAC9B,CAAC,CAAC,KAAK,CAAC;QACV,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/utilities/index.d.ts

@@ -3,9 +3,12 @@ export { sanitizeFilename } from "./string/sanitizeFilename.js";
 export { extractYouTubeId } from "./string/extractYouTubeId.js";
 export { withBasePath } from "./string/withBasePath.js";
 export { processListItems } from "./string/processListItems.js";
+export { normalizeBaseUrlPath } from "./string/normalizeBaseUrlPath.js";
+export { normalizeSystemPath } from "./string/normalizeSystemPath.js";
 export { getFileExtension } from "./file/getFileExtension.js";
 export { resolveDataPath } from "./path/resolveDataPath.js";
 export { resolveAgainstProjectRoot } from "./path/resolveAgainstProjectRoot.js";
+export { pathExists } from "./path/pathExists.js";
 export { createTimeout } from "./system/createTimeout.js";
 export { formatTime } from "./system/formatTime.js";
 export { createLogger } from "./system/logger.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/utilities/index.js

@@ -4,11 +4,14 @@ export { sanitizeFilename } from "./string/sanitizeFilename.js";
 export { extractYouTubeId } from "./string/extractYouTubeId.js";
 export { withBasePath } from "./string/withBasePath.js";
 export { processListItems } from "./string/processListItems.js";
+export { normalizeBaseUrlPath } from "./string/normalizeBaseUrlPath.js";
+export { normalizeSystemPath } from "./string/normalizeSystemPath.js";
 // file
 export { getFileExtension } from "./file/getFileExtension.js";
 //path
 export { resolveDataPath } from "./path/resolveDataPath.js";
 export { resolveAgainstProjectRoot } from "./path/resolveAgainstProjectRoot.js";
+export { pathExists } from "./path/pathExists.js";
 // system
 export { createTimeout } from "./system/createTimeout.js";
 export { formatTime } from "./system/formatTime.js";

package/dist/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM;AACN,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM;AACN,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/utilities/path/pathExists.d.ts

@@ -0,0 +1,2 @@
+export declare function pathExists(pathLike: string): Promise<boolean>;
+//# sourceMappingURL=pathExists.d.ts.map

package/dist/utilities/path/pathExists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathExists.d.ts","sourceRoot":"","sources":["../../../src/utilities/path/pathExists.ts"],"names":[],"mappings":"AAGA,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnE"}

package/dist/utilities/path/pathExists.js

@@ -0,0 +1,14 @@
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+export async function pathExists(pathLike) {
+    try {
+        await access(pathLike, constants.F_OK);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=pathExists.js.map

package/dist/utilities/path/pathExists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathExists.js","sourceRoot":"","sources":["../../../src/utilities/path/pathExists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utilities/path/resolveDataPath.js

@@ -1,6 +1,6 @@
 import path from "node:path";
-import { normalizeDir } from "../string/normalizeDir.js";
 import { resolveAgainstProjectRoot } from "./resolveAgainstProjectRoot.js";
+import { normalizeSystemPath } from "../string/normalizeSystemPath.js";
 export function resolveDataPath(input) {
     const argv = process.argv.slice(2);
     const i = argv.indexOf("--fsDataPath");
@@ -8,6 +8,6 @@ export function resolveDataPath(input) {
     const fromEnv = process.env.FS_DATA_PATH;
     const candidate = input ?? fromCli ?? fromEnv ?? "./public/SST-Docs/data";
     const abs = resolveAgainstProjectRoot(String(candidate));
-    return normalizeDir(path.resolve(abs));
+    return normalizeSystemPath(path.resolve(abs));
 }
 //# sourceMappingURL=resolveDataPath.js.map

package/dist/utilities/path/resolveDataPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveDataPath.js","sourceRoot":"","sources":["../../../src/utilities/path/resolveDataPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,wBAAwB,CAAC;IAC1E,MAAM,GAAG,GAAG,yBAAyB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"resolveDataPath.js","sourceRoot":"","sources":["../../../src/utilities/path/resolveDataPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,wBAAwB,CAAC;IAC1E,MAAM,GAAG,GAAG,yBAAyB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/utilities/string/normalizeBaseUrlPath.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeBaseUrlPath(basePath: string | undefined): string;
+//# sourceMappingURL=normalizeBaseUrlPath.d.ts.map

package/dist/utilities/string/normalizeBaseUrlPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeBaseUrlPath.d.ts","sourceRoot":"","sources":["../../../src/utilities/string/normalizeBaseUrlPath.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,UAKhE"}

package/dist/utilities/string/normalizeBaseUrlPath.js

@@ -0,0 +1,9 @@
+export function normalizeBaseUrlPath(basePath) {
+    if (!basePath)
+        return "/";
+    if (basePath === "/")
+        return "/";
+    const trimmed = basePath.replace(/\/+$/, "");
+    return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+//# sourceMappingURL=normalizeBaseUrlPath.js.map

package/dist/utilities/string/normalizeBaseUrlPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeBaseUrlPath.js","sourceRoot":"","sources":["../../../src/utilities/string/normalizeBaseUrlPath.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,QAA4B;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/utilities/string/normalizeSystemPath.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeSystemPath(p: string): string;
+//# sourceMappingURL=normalizeSystemPath.d.ts.map

package/dist/utilities/string/normalizeSystemPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSystemPath.d.ts","sourceRoot":"","sources":["../../../src/utilities/string/normalizeSystemPath.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/utilities/string/normalizeSystemPath.js

@@ -0,0 +1,4 @@
+export function normalizeSystemPath(p) {
+    return p.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+//# sourceMappingURL=normalizeSystemPath.js.map

package/dist/utilities/string/normalizeSystemPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSystemPath.js","sourceRoot":"","sources":["../../../src/utilities/string/normalizeSystemPath.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/utilities/validation/isValidColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isValidColor.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/isValidColor.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAI5C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"isValidColor.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/isValidColor.ts"],"names":[],"mappings":"AA2KA,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAa5C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/utilities/validation/isValidColor.js

@@ -1,7 +1,179 @@
+const HEX_COLOR_REGEX = /^#(?:[0-9a-f]{3}){1,2}(?:[0-9a-f]{2})?$/i;
+const RGB_COLOR_REGEX = /^rgba?\(\s*(\d{1,3}%?)(\s*,\s*(\d{1,3}%?)){2}(\s*,\s*(0|0?\.\d+|1(\.0+)?))?\s*\)$/i;
+const HSL_COLOR_REGEX = /^hsla?\(\s*\d{1,3}(\.\d+)?(deg|grad|rad|turn)?\s*,\s*\d{1,3}%\s*,\s*\d{1,3}%(\s*,\s*(0|0?\.\d+|1(\.0+)?))?\s*\)$/i;
+const VAR_COLOR_REGEX = /^var\(--[^)]+\)$/i;
+const NAMED_COLORS = new Set([
+    "aliceblue",
+    "antiquewhite",
+    "aqua",
+    "aquamarine",
+    "azure",
+    "beige",
+    "bisque",
+    "black",
+    "blanchedalmond",
+    "blue",
+    "blueviolet",
+    "brown",
+    "burlywood",
+    "cadetblue",
+    "chartreuse",
+    "chocolate",
+    "coral",
+    "cornflowerblue",
+    "cornsilk",
+    "crimson",
+    "cyan",
+    "darkblue",
+    "darkcyan",
+    "darkgoldenrod",
+    "darkgray",
+    "darkgreen",
+    "darkgrey",
+    "darkkhaki",
+    "darkmagenta",
+    "darkolivegreen",
+    "darkorange",
+    "darkorchid",
+    "darkred",
+    "darksalmon",
+    "darkseagreen",
+    "darkslateblue",
+    "darkslategray",
+    "darkslategrey",
+    "darkturquoise",
+    "darkviolet",
+    "deeppink",
+    "deepskyblue",
+    "dimgray",
+    "dimgrey",
+    "dodgerblue",
+    "firebrick",
+    "floralwhite",
+    "forestgreen",
+    "fuchsia",
+    "gainsboro",
+    "ghostwhite",
+    "gold",
+    "goldenrod",
+    "gray",
+    "green",
+    "greenyellow",
+    "grey",
+    "honeydew",
+    "hotpink",
+    "indianred",
+    "indigo",
+    "ivory",
+    "khaki",
+    "lavender",
+    "lavenderblush",
+    "lawngreen",
+    "lemonchiffon",
+    "lightblue",
+    "lightcoral",
+    "lightcyan",
+    "lightgoldenrodyellow",
+    "lightgray",
+    "lightgreen",
+    "lightgrey",
+    "lightpink",
+    "lightsalmon",
+    "lightseagreen",
+    "lightskyblue",
+    "lightslategray",
+    "lightslategrey",
+    "lightsteelblue",
+    "lightyellow",
+    "lime",
+    "limegreen",
+    "linen",
+    "magenta",
+    "maroon",
+    "mediumaquamarine",
+    "mediumblue",
+    "mediumorchid",
+    "mediumpurple",
+    "mediumseagreen",
+    "mediumslateblue",
+    "mediumspringgreen",
+    "mediumturquoise",
+    "mediumvioletred",
+    "midnightblue",
+    "mintcream",
+    "mistyrose",
+    "moccasin",
+    "navajowhite",
+    "navy",
+    "oldlace",
+    "olive",
+    "olivedrab",
+    "orange",
+    "orangered",
+    "orchid",
+    "palegoldenrod",
+    "palegreen",
+    "paleturquoise",
+    "palevioletred",
+    "papayawhip",
+    "peachpuff",
+    "peru",
+    "pink",
+    "plum",
+    "powderblue",
+    "purple",
+    "rebeccapurple",
+    "red",
+    "rosybrown",
+    "royalblue",
+    "saddlebrown",
+    "salmon",
+    "sandybrown",
+    "seagreen",
+    "seashell",
+    "sienna",
+    "silver",
+    "skyblue",
+    "slateblue",
+    "slategray",
+    "slategrey",
+    "snow",
+    "springgreen",
+    "steelblue",
+    "tan",
+    "teal",
+    "thistle",
+    "tomato",
+    "turquoise",
+    "violet",
+    "wheat",
+    "white",
+    "whitesmoke",
+    "yellow",
+    "yellowgreen",
+]);
+const isSupportedInNode = (value) => {
+    const lower = value.toLowerCase();
+    return (HEX_COLOR_REGEX.test(value) ||
+        RGB_COLOR_REGEX.test(value) ||
+        HSL_COLOR_REGEX.test(value) ||
+        VAR_COLOR_REGEX.test(value) ||
+        lower === "transparent" ||
+        lower === "currentcolor" ||
+        NAMED_COLORS.has(lower));
+};
 export const isValidColor = (color) => {
-    const div = document.createElement("div");
-    div.style.color = color;
-    return div.style.color !== "";
+    if (typeof color !== "string")
+        return false;
+    const trimmed = color.trim();
+    if (trimmed.length === 0)
+        return false;
+    if (typeof document !== "undefined" && typeof document.createElement === "function") {
+        const div = document.createElement("div");
+        div.style.color = trimmed;
+        return div.style.color !== "";
+    }
+    return isSupportedInNode(trimmed);
 };
 export default isValidColor;
 //# sourceMappingURL=isValidColor.js.map

package/dist/utilities/validation/isValidColor.js.map

@@ -1 +1 @@
-{"version":3,"file":"isValidColor.js","sourceRoot":"","sources":["../../../src/utilities/validation/isValidColor.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAW,EAAE;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1C,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACxB,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"isValidColor.js","sourceRoot":"","sources":["../../../src/utilities/validation/isValidColor.ts"],"names":[],"mappings":"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"}

package/dist/utilities/validation/isValidImageUrl.d.ts

@@ -1,3 +1,3 @@
-export declare const isValidImageUrl: (url: string) => boolean;
+export declare const isValidImageUrl: (rawUrl: string) => boolean;
 export default isValidImageUrl;
 //# sourceMappingURL=isValidImageUrl.d.ts.map

package/dist/utilities/validation/isValidImageUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isValidImageUrl.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/isValidImageUrl.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,OAU7C,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"isValidImageUrl.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/isValidImageUrl.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,OAwBhD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/utilities/validation/isValidImageUrl.js

@@ -1,10 +1,32 @@
 import getFileExtension from "../file/getFileExtension.js";
-export const isValidImageUrl = (url) => {
+const VALID_EXTENSIONS = new Set([
+    "jpg",
+    "jpeg",
+    "png",
+    "gif",
+    "webp",
+    "svg",
+]);
+const ABSOLUTE_PROTOCOL_REGEX = /^[a-z][a-z0-9+\-.]*:/i;
+export const isValidImageUrl = (rawUrl) => {
+    if (typeof rawUrl !== "string")
+        return false;
+    const trimmed = rawUrl.trim();
+    if (trimmed.length === 0)
+        return false;
+    if (trimmed.startsWith("data:")) {
+        return true;
+    }
     try {
-        const urlObj = new URL(url);
-        const validExtensions = ["jpg", "jpeg", "png", "gif", "webp", "svg"];
+        // Accept relative paths by resolving them against a dummy origin.
+        const urlObj = ABSOLUTE_PROTOCOL_REGEX.test(trimmed)
+            ? new URL(trimmed)
+            : new URL(trimmed, "http://localhost");
+        if (urlObj.protocol === "data:") {
+            return true;
+        }
         const extension = getFileExtension(urlObj.pathname);
-        return validExtensions.includes(extension) || urlObj.protocol === "data:";
+        return VALID_EXTENSIONS.has(extension);
     }
     catch {
         return false;

package/dist/utilities/validation/isValidImageUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"isValidImageUrl.js","sourceRoot":"","sources":["../../../src/utilities/validation/isValidImageUrl.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAW,EAAE;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpD,OAAO,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"isValidImageUrl.js","sourceRoot":"","sources":["../../../src/utilities/validation/isValidImageUrl.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAE3D,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAW,EAAE;IACzD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,kEAAkE;QAClE,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC;YAClD,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC;YAClB,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAEzC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadow-shard-tools/docs-core",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Shared configs, types, and utilities for SST Docs modules and applications.",
   "license": "MIT",
   "type": "module",
@@ -65,8 +65,9 @@
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
     "rebuild": "npm run clean && npm run build",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run clean && npm run test && npm run build"
   },
   "repository": {
     "type": "git",
@@ -91,8 +92,10 @@
   },
   "devDependencies": {
     "@types/node": "^20.12.7",
+    "jsdom": "^27.1.0",
     "rimraf": "^5.0.5",
-    "typescript": "^5.4.5"
+    "typescript": "^5.4.5",
+    "vitest": "^4.0.7"
   },
   "typesVersions": {
     "*": {

package/dist/utilities/string/normalizeDir.d.ts

@@ -1,2 +0,0 @@
-export declare function normalizeDir(p: string): string;
-//# sourceMappingURL=normalizeDir.d.ts.map

package/dist/utilities/string/normalizeDir.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeDir.d.ts","sourceRoot":"","sources":["../../../src/utilities/string/normalizeDir.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/utilities/string/normalizeDir.js

@@ -1,4 +0,0 @@
-export function normalizeDir(p) {
-    return p.replace(/\\/g, "/").replace(/\/+$/, "");
-}
-//# sourceMappingURL=normalizeDir.js.map

package/dist/utilities/string/normalizeDir.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalizeDir.js","sourceRoot":"","sources":["../../../src/utilities/string/normalizeDir.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC"}