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

package/dist/cjs/data/buildTree.js

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTree = buildTree;
-function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting) {
+const logger_js_1 = require("../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);
@@ -13,12 +21,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);
@@ -35,15 +57,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) {
@@ -61,10 +97,12 @@ function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting)
         children,
     };
 }
-function buildTree(rawMap, allDocs) {
+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 ?? (0, logger_js_1.createLogger)("data:buildTree");
     const childCategoryIds = new Set();
     Object.values(rawMap).forEach((category) => {
         if (Array.isArray(category?.children)) {
@@ -86,8 +124,8 @@ 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 };
 }

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fsDataProvider = exports.FsDataProvider = void 0;
+class FsDataProvider {
+    async readJson(_absPath) {
+        throw new Error("FsDataProvider is only available in Node.js environments where the file system can be read.");
+    }
+}
+exports.FsDataProvider = FsDataProvider;
+exports.fsDataProvider = FsDataProvider;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpDataProvider = exports.HttpDataProvider = exports.loadProducts = exports.loadVersions = exports.loadVersionDataFromHttp = exports.loadVersionData = exports.loadAllItems = exports.loadAllCategories = exports.buildTree = void 0;
+var buildTree_js_1 = require("./buildTree.js");
+Object.defineProperty(exports, "buildTree", { enumerable: true, get: function () { return buildTree_js_1.buildTree; } });
+var loadAllCategories_js_1 = require("./loadAllCategories.js");
+Object.defineProperty(exports, "loadAllCategories", { enumerable: true, get: function () { return loadAllCategories_js_1.loadAllCategories; } });
+var loadAllItems_js_1 = require("./loadAllItems.js");
+Object.defineProperty(exports, "loadAllItems", { enumerable: true, get: function () { return loadAllItems_js_1.loadAllItems; } });
+var loadVersionData_js_1 = require("./loadVersionData.js");
+Object.defineProperty(exports, "loadVersionData", { enumerable: true, get: function () { return loadVersionData_js_1.loadVersionData; } });
+Object.defineProperty(exports, "loadVersionDataFromHttp", { enumerable: true, get: function () { return loadVersionData_js_1.loadVersionDataFromHttp; } });
+var loadVersions_js_1 = require("./loadVersions.js");
+Object.defineProperty(exports, "loadVersions", { enumerable: true, get: function () { return loadVersions_js_1.loadVersions; } });
+var loadProducts_js_1 = require("./loadProducts.js");
+Object.defineProperty(exports, "loadProducts", { enumerable: true, get: function () { return loadProducts_js_1.loadProducts; } });
+var httpDataProvider_js_1 = require("./httpDataProvider.js");
+Object.defineProperty(exports, "HttpDataProvider", { enumerable: true, get: function () { return httpDataProvider_js_1.HttpDataProvider; } });
+Object.defineProperty(exports, "httpDataProvider", { enumerable: true, get: function () { return httpDataProvider_js_1.httpDataProvider; } });

package/dist/cjs/data/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.httpDataProvider = exports.HttpDataProvider = exports.fsDataProvider = exports.FsDataProvider = exports.loadVersions = exports.loadVersionData = exports.loadAllItems = exports.loadAllCategories = exports.buildTree = void 0;
+exports.httpDataProvider = exports.HttpDataProvider = exports.fsDataProvider = exports.FsDataProvider = exports.loadProducts = exports.loadVersions = exports.loadVersionDataFromFs = exports.loadVersionDataFromHttp = exports.loadVersionData = exports.loadAllItems = exports.loadAllCategories = exports.buildTree = void 0;
 var buildTree_js_1 = require("./buildTree.js");
 Object.defineProperty(exports, "buildTree", { enumerable: true, get: function () { return buildTree_js_1.buildTree; } });
 var loadAllCategories_js_1 = require("./loadAllCategories.js");
@@ -9,8 +9,13 @@ var loadAllItems_js_1 = require("./loadAllItems.js");
 Object.defineProperty(exports, "loadAllItems", { enumerable: true, get: function () { return loadAllItems_js_1.loadAllItems; } });
 var loadVersionData_js_1 = require("./loadVersionData.js");
 Object.defineProperty(exports, "loadVersionData", { enumerable: true, get: function () { return loadVersionData_js_1.loadVersionData; } });
+Object.defineProperty(exports, "loadVersionDataFromHttp", { enumerable: true, get: function () { return loadVersionData_js_1.loadVersionDataFromHttp; } });
+var loadVersionData_fs_js_1 = require("./loadVersionData.fs.js");
+Object.defineProperty(exports, "loadVersionDataFromFs", { enumerable: true, get: function () { return loadVersionData_fs_js_1.loadVersionDataFromFs; } });
 var loadVersions_js_1 = require("./loadVersions.js");
 Object.defineProperty(exports, "loadVersions", { enumerable: true, get: function () { return loadVersions_js_1.loadVersions; } });
+var loadProducts_js_1 = require("./loadProducts.js");
+Object.defineProperty(exports, "loadProducts", { enumerable: true, get: function () { return loadProducts_js_1.loadProducts; } });
 var fsDataProvider_js_1 = require("./fsDataProvider.js");
 Object.defineProperty(exports, "FsDataProvider", { enumerable: true, get: function () { return fsDataProvider_js_1.FsDataProvider; } });
 Object.defineProperty(exports, "fsDataProvider", { enumerable: true, get: function () { return fsDataProvider_js_1.fsDataProvider; } });

package/dist/cjs/data/loadAllCategories.js

@@ -1,20 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAllCategories = loadAllCategories;
-async function loadAllCategories(provider, versionRootAbs, ids) {
+const logger_js_1 = require("../utilities/system/logger.js");
+async function loadAllCategories(provider, versionRootAbs, ids, options) {
+    const diagnostics = [];
+    const logger = options?.logger ?? (0, logger_js_1.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 };
 }

package/dist/cjs/data/loadAllItems.js

@@ -1,14 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAllItems = loadAllItems;
-async function loadAllItems(provider, versionRootAbs, ids) {
+const logger_js_1 = require("../utilities/system/logger.js");
+async function loadAllItems(provider, versionRootAbs, ids, options) {
+    const diagnostics = [];
+    const logger = options?.logger ?? (0, logger_js_1.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 };
 }

package/dist/cjs/data/loadProducts.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProducts = loadProducts;
+async function loadProducts(provider, dataRootAbs) {
+    return provider.readJson(`${dataRootAbs}/products.json`);
+}

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadVersionDataFromFs = loadVersionDataFromFs;
+const node_path_1 = __importDefault(require("node:path"));
+const normalizeSystemPath_js_1 = require("../utilities/string/normalizeSystemPath.js");
+const logger_js_1 = require("../utilities/system/logger.js");
+const fsDataProvider_js_1 = require("./fsDataProvider.js");
+const loadVersionData_js_1 = require("./loadVersionData.js");
+async function loadVersionDataFromFs(baseDir, options) {
+    const logger = options?.logger ?? (0, logger_js_1.createLogger)("data:loadVersionDataFromFs");
+    const provider = new fsDataProvider_js_1.FsDataProvider();
+    const diagnostics = [];
+    const root = (0, normalizeSystemPath_js_1.normalizeSystemPath)(node_path_1.default.resolve(baseDir));
+    const { product, products, versionsRoot, versions, selectedVersion, diagnostics: selectionDiagnostics, } = await (0, loadVersionData_js_1.selectProductAndVersion)(provider, root, options, logger, (base, child) => (0, normalizeSystemPath_js_1.normalizeSystemPath)(node_path_1.default.resolve(base, child)));
+    const versionRoot = (0, normalizeSystemPath_js_1.normalizeSystemPath)(node_path_1.default.resolve(versionsRoot, selectedVersion));
+    const { items, tree, standaloneDocs, diagnostics: loadDiagnostics } = await (0, loadVersionData_js_1.loadVersionData)(provider, versionRoot, { logger });
+    diagnostics.push(...selectionDiagnostics, ...loadDiagnostics);
+    return {
+        version: selectedVersion,
+        versions,
+        product,
+        products,
+        items,
+        tree,
+        standaloneDocs,
+        diagnostics,
+    };
+}

package/dist/cjs/data/loadVersionData.js

@@ -1,16 +1,139 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadVersionData = loadVersionData;
+exports.loadVersionDataFromHttp = loadVersionDataFromHttp;
+exports.selectVersion = selectVersion;
+exports.selectProductAndVersion = selectProductAndVersion;
+const logger_js_1 = require("../utilities/system/logger.js");
+const httpDataProvider_js_1 = require("./httpDataProvider.js");
+const loadProducts_js_1 = require("./loadProducts.js");
 const buildTree_js_1 = require("./buildTree.js");
 const loadAllCategories_js_1 = require("./loadAllCategories.js");
 const loadAllItems_js_1 = require("./loadAllItems.js");
-async function loadVersionData(provider, versionRootAbs) {
+const loadVersions_js_1 = require("./loadVersions.js");
+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([
-        (0, loadAllCategories_js_1.loadAllCategories)(provider, versionRootAbs, index.categories),
-        (0, loadAllItems_js_1.loadAllItems)(provider, versionRootAbs, index.items),
+    const [categoriesResult, itemsResult] = await Promise.all([
+        (0, loadAllCategories_js_1.loadAllCategories)(provider, versionRootAbs, index.categories, { logger }),
+        (0, loadAllItems_js_1.loadAllItems)(provider, versionRootAbs, index.items, { logger }),
     ]);
-    const { tree, usedDocIds } = (0, buildTree_js_1.buildTree)(rawCats, items);
-    const standaloneDocs = items.filter((d) => !usedDocIds.has(d.id));
-    return { items, tree, standaloneDocs };
+    const { tree, usedDocIds, diagnostics: treeDiagnostics } = (0, buildTree_js_1.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 };
+}
+async function loadVersionDataFromHttp(baseUrl, options) {
+    const logger = options?.logger ?? (0, logger_js_1.createLogger)("data:loadVersionDataFromHttp");
+    const provider = new httpDataProvider_js_1.HttpDataProvider();
+    const root = trimTrailingSlash(baseUrl);
+    const { product, products, versionsRoot, versions, selectedVersion, diagnostics: selectionDiagnostics, } = await selectProductAndVersion(provider, root, options, logger, joinUrl);
+    const versionRoot = joinUrl(versionsRoot, selectedVersion);
+    const { items, tree, standaloneDocs, diagnostics } = await loadVersionData(provider, versionRoot, { logger });
+    return {
+        version: selectedVersion,
+        versions,
+        product,
+        products,
+        items,
+        tree,
+        standaloneDocs,
+        diagnostics: [...selectionDiagnostics, ...diagnostics],
+    };
+}
+async function selectVersion(provider, root, requested, logger) {
+    const versions = await (0, loadVersions_js_1.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 };
+}
+async function selectProductAndVersion(provider, root, options, logger, joinChild) {
+    const diagnostics = [];
+    const productVersioning = options?.productVersioning ?? false;
+    let versionsRoot = root;
+    let product;
+    let products;
+    if (productVersioning) {
+        const productSelection = await selectProduct(provider, root, options?.product, logger);
+        diagnostics.push(...productSelection.diagnostics);
+        products = productSelection.products;
+        product = productSelection.selectedProduct;
+        if (productSelection.selectedProduct) {
+            versionsRoot = joinChild(root, productSelection.selectedProduct);
+        }
+    }
+    const { versions, selectedVersion, diagnostics: versionDiagnostics, } = await selectVersion(provider, versionsRoot, options?.version, logger);
+    diagnostics.push(...versionDiagnostics);
+    return {
+        product,
+        products,
+        versionsRoot,
+        versions,
+        selectedVersion,
+        diagnostics,
+    };
+}
+async function selectProduct(provider, root, requested, logger) {
+    const diagnostics = [];
+    const products = await (0, loadProducts_js_1.loadProducts)(provider, root);
+    if (products.length === 0) {
+        const message = `No products found under ${root}.`;
+        diagnostics.push({
+            code: "no-products-found",
+            level: "warn",
+            message,
+            context: { root },
+        });
+        logger.warn(message);
+        return { products, selectedProduct: undefined, diagnostics };
+    }
+    if (requested) {
+        const match = products.find((p) => p.product === requested);
+        if (!match) {
+            const message = `Requested product "${requested}" not found. Using first available: "${products[0].product}".`;
+            diagnostics.push({
+                code: "product-not-found",
+                level: "warn",
+                message,
+                context: { requested, available: products.map((p) => p.product) },
+            });
+            logger.warn(message);
+            return { products, selectedProduct: products[0].product, diagnostics };
+        }
+        return { products, selectedProduct: requested, diagnostics };
+    }
+    return { products, selectedProduct: products[0].product, diagnostics };
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+function joinUrl(base, child) {
+    return `${trimTrailingSlash(base)}/${child.replace(/^\/+/, "")}`;
 }

package/dist/cjs/index.browser.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./configs/index.browser.js"), exports);
+__exportStar(require("./constants/index.js"), exports);
+__exportStar(require("./themes/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+__exportStar(require("./data/index.browser.js"), exports);
+__exportStar(require("./utilities/index.browser.js"), exports);

package/dist/cjs/themes/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isThemePresetName = exports.getThemePreset = exports.DOCS_CORE_THEME_PRESETS = exports.DEFAULT_THEME_PRESET = exports.AVAILABLE_THEME_PRESET_NAMES = exports.defaultTheme = void 0;
+exports.styleThemeSchema = exports.parseStyleTheme = exports.isStyleTheme = exports.isThemePresetName = exports.getThemePreset = exports.DOCS_CORE_THEME_PRESETS = exports.DEFAULT_THEME_PRESET = exports.AVAILABLE_THEME_PRESET_NAMES = exports.defaultTheme = void 0;
 var default_js_1 = require("./presets/default.js");
 Object.defineProperty(exports, "defaultTheme", { enumerable: true, get: function () { return default_js_1.defaultTheme; } });
 var themeRegistry_js_1 = require("./themeRegistry.js");
@@ -9,3 +9,7 @@ Object.defineProperty(exports, "DEFAULT_THEME_PRESET", { enumerable: true, get:
 Object.defineProperty(exports, "DOCS_CORE_THEME_PRESETS", { enumerable: true, get: function () { return themeRegistry_js_1.DOCS_CORE_THEME_PRESETS; } });
 Object.defineProperty(exports, "getThemePreset", { enumerable: true, get: function () { return themeRegistry_js_1.getThemePreset; } });
 Object.defineProperty(exports, "isThemePresetName", { enumerable: true, get: function () { return themeRegistry_js_1.isThemePresetName; } });
+var styleThemeSchema_js_1 = require("./styleThemeSchema.js");
+Object.defineProperty(exports, "isStyleTheme", { enumerable: true, get: function () { return styleThemeSchema_js_1.isStyleTheme; } });
+Object.defineProperty(exports, "parseStyleTheme", { enumerable: true, get: function () { return styleThemeSchema_js_1.parseStyleTheme; } });
+Object.defineProperty(exports, "styleThemeSchema", { enumerable: true, get: function () { return styleThemeSchema_js_1.styleThemeSchema; } });

package/dist/cjs/themes/styleThemeSchema.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.styleThemeSchema = void 0;
+exports.parseStyleTheme = parseStyleTheme;
+exports.isStyleTheme = isStyleTheme;
+const zod_1 = require("zod");
+const default_js_1 = require("./presets/default.js");
+function buildSchemaFromPreset(preset) {
+    const build = (value) => {
+        if (typeof value === "string") {
+            return zod_1.z.string();
+        }
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            const shape = {};
+            Object.entries(value).forEach(([key, child]) => {
+                shape[key] = build(child);
+            });
+            return zod_1.z.object(shape).strict();
+        }
+        throw new Error("Invalid style theme preset shape.");
+    };
+    return build(preset);
+}
+exports.styleThemeSchema = buildSchemaFromPreset(default_js_1.defaultTheme);
+function parseStyleTheme(theme) {
+    const result = exports.styleThemeSchema.safeParse(theme);
+    if (!result.success) {
+        throw new Error(`Invalid style theme provided. ${result.error.issues
+            .map((issue) => `${issue.path.join(".") || "theme"}: ${issue.message}`)
+            .join("; ")}`);
+    }
+    return result.data;
+}
+function isStyleTheme(theme) {
+    return exports.styleThemeSchema.safeParse(theme).success;
+}

package/dist/cjs/types/DataDiagnostic.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/Product.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/utilities/index.browser.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadTextFile = exports.copyToClipboard = exports.getResponsiveWidth = exports.validateScale = exports.isValidYouTubeId = exports.isValidImageUrl = exports.isValidColor = exports.isMobileDevice = exports.createLogger = exports.formatTime = exports.createTimeout = exports.pathExists = exports.resolveAgainstProjectRoot = exports.resolveDataPath = exports.getFileExtension = exports.normalizeSystemPath = exports.normalizeBaseUrlPath = exports.processListItems = exports.withBasePath = exports.extractYouTubeId = exports.sanitizeFilename = exports.slugify = void 0;
+// string
+var slugify_js_1 = require("./string/slugify.js");
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return slugify_js_1.slugify; } });
+var sanitizeFilename_js_1 = require("./string/sanitizeFilename.js");
+Object.defineProperty(exports, "sanitizeFilename", { enumerable: true, get: function () { return sanitizeFilename_js_1.sanitizeFilename; } });
+var extractYouTubeId_js_1 = require("./string/extractYouTubeId.js");
+Object.defineProperty(exports, "extractYouTubeId", { enumerable: true, get: function () { return extractYouTubeId_js_1.extractYouTubeId; } });
+var withBasePath_js_1 = require("./string/withBasePath.js");
+Object.defineProperty(exports, "withBasePath", { enumerable: true, get: function () { return withBasePath_js_1.withBasePath; } });
+var processListItems_js_1 = require("./string/processListItems.js");
+Object.defineProperty(exports, "processListItems", { enumerable: true, get: function () { return processListItems_js_1.processListItems; } });
+var normalizeBaseUrlPath_js_1 = require("./string/normalizeBaseUrlPath.js");
+Object.defineProperty(exports, "normalizeBaseUrlPath", { enumerable: true, get: function () { return normalizeBaseUrlPath_js_1.normalizeBaseUrlPath; } });
+var normalizeSystemPath_js_1 = require("./string/normalizeSystemPath.js");
+Object.defineProperty(exports, "normalizeSystemPath", { enumerable: true, get: function () { return normalizeSystemPath_js_1.normalizeSystemPath; } });
+// file
+var getFileExtension_js_1 = require("./file/getFileExtension.js");
+Object.defineProperty(exports, "getFileExtension", { enumerable: true, get: function () { return getFileExtension_js_1.getFileExtension; } });
+//path
+var resolveDataPath_browser_js_1 = require("./path/resolveDataPath.browser.js");
+Object.defineProperty(exports, "resolveDataPath", { enumerable: true, get: function () { return resolveDataPath_browser_js_1.resolveDataPath; } });
+var resolveAgainstProjectRoot_browser_js_1 = require("./path/resolveAgainstProjectRoot.browser.js");
+Object.defineProperty(exports, "resolveAgainstProjectRoot", { enumerable: true, get: function () { return resolveAgainstProjectRoot_browser_js_1.resolveAgainstProjectRoot; } });
+var pathExists_browser_js_1 = require("./path/pathExists.browser.js");
+Object.defineProperty(exports, "pathExists", { enumerable: true, get: function () { return pathExists_browser_js_1.pathExists; } });
+// system
+var createTimeout_js_1 = require("./system/createTimeout.js");
+Object.defineProperty(exports, "createTimeout", { enumerable: true, get: function () { return createTimeout_js_1.createTimeout; } });
+var formatTime_js_1 = require("./system/formatTime.js");
+Object.defineProperty(exports, "formatTime", { enumerable: true, get: function () { return formatTime_js_1.formatTime; } });
+var logger_browser_js_1 = require("./system/logger.browser.js");
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_browser_js_1.createLogger; } });
+// validation
+var isMobileDevice_js_1 = require("./validation/isMobileDevice.js");
+Object.defineProperty(exports, "isMobileDevice", { enumerable: true, get: function () { return isMobileDevice_js_1.isMobileDevice; } });
+var isValidColor_js_1 = require("./validation/isValidColor.js");
+Object.defineProperty(exports, "isValidColor", { enumerable: true, get: function () { return isValidColor_js_1.isValidColor; } });
+var isValidImageUrl_js_1 = require("./validation/isValidImageUrl.js");
+Object.defineProperty(exports, "isValidImageUrl", { enumerable: true, get: function () { return isValidImageUrl_js_1.isValidImageUrl; } });
+var isValidYouTubeId_js_1 = require("./validation/isValidYouTubeId.js");
+Object.defineProperty(exports, "isValidYouTubeId", { enumerable: true, get: function () { return isValidYouTubeId_js_1.isValidYouTubeId; } });
+var validateScale_js_1 = require("./validation/validateScale.js");
+Object.defineProperty(exports, "validateScale", { enumerable: true, get: function () { return validateScale_js_1.validateScale; } });
+// dom
+var getResponsiveWidth_js_1 = require("./dom/getResponsiveWidth.js");
+Object.defineProperty(exports, "getResponsiveWidth", { enumerable: true, get: function () { return getResponsiveWidth_js_1.getResponsiveWidth; } });
+var copyToClipboard_js_1 = require("./dom/copyToClipboard.js");
+Object.defineProperty(exports, "copyToClipboard", { enumerable: true, get: function () { return copyToClipboard_js_1.copyToClipboard; } });
+var downloadTextFile_js_1 = require("./dom/downloadTextFile.js");
+Object.defineProperty(exports, "downloadTextFile", { enumerable: true, get: function () { return downloadTextFile_js_1.downloadTextFile; } });

package/dist/cjs/utilities/path/pathExists.browser.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pathExists = pathExists;
+async function pathExists(_pathLike) {
+    throw new Error("pathExists is only available in a Node.js environment.");
+}

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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pathExists = pathExists;
-const promises_1 = require("node:fs/promises");
 const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
 async function pathExists(pathLike) {
     try {
         await (0, promises_1.access)(pathLike, node_fs_1.constants.F_OK);

package/dist/cjs/utilities/path/resolveAgainstProjectRoot.browser.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAgainstProjectRoot = resolveAgainstProjectRoot;
+function resolveAgainstProjectRoot(candidate) {
+    throw new Error(`resolveAgainstProjectRoot("${candidate}") is only available in Node.js where project roots can be resolved.`);
+}

package/dist/cjs/utilities/path/resolveDataPath.browser.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDataPath = resolveDataPath;
+function resolveDataPath(_input) {
+    throw new Error("resolveDataPath is only available in a Node.js environment.");
+}

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

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveDataPath = resolveDataPath;
 const node_path_1 = __importDefault(require("node:path"));
-const resolveAgainstProjectRoot_js_1 = require("./resolveAgainstProjectRoot.js");
 const normalizeSystemPath_js_1 = require("../string/normalizeSystemPath.js");
+const resolveAgainstProjectRoot_js_1 = require("./resolveAgainstProjectRoot.js");
 function resolveDataPath(input) {
     const argv = process.argv.slice(2);
     const i = argv.indexOf("--fsDataPath");