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

package/dist/cjs/data/buildTree.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTree = buildTree;
+const logger_js_1 = require("../utilities/system/logger.js");
+function convertCategory(raw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger) {
+    if (visiting.has(raw.id)) {
+        const message = `Detected circular category reference at ${raw.id}.`;
+        diagnostics.push({
+            code: "circular-category",
+            level: "warn",
+            message,
+            context: { categoryId: raw.id },
+        });
+        logger.warn(message);
+        return null;
+    }
+    visiting.add(raw.id);
+    let docs;
+    const docIds = Array.isArray(raw.docs) ? raw.docs : [];
+    if (docIds.length > 0) {
+        const validDocs = docIds
+            .map((rawId) => {
+            if (typeof rawId !== "string" || rawId.length === 0) {
+                const message = `Invalid doc id in category ${raw.id}.`;
+                diagnostics.push({
+                    code: "invalid-doc-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, docId: rawId },
+                });
+                logger.warn(message);
+                return null;
+            }
+            const doc = docLookup.get(rawId);
+            if (!doc) {
+                const message = `Doc id ${rawId} referenced in category ${raw.id} not found.`;
+                diagnostics.push({
+                    code: "missing-doc-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, docId: rawId },
+                });
+                logger.warn(message);
+                return null;
+            }
+            usedDocIds.add(rawId);
+            return doc;
+        })
+            .filter((doc) => doc !== null);
+        if (validDocs.length > 0) {
+            docs = validDocs;
+        }
+    }
+    let children;
+    const childIds = Array.isArray(raw.children) ? raw.children : [];
+    if (childIds.length > 0) {
+        const validChildren = childIds
+            .map((rawChildId) => {
+            if (typeof rawChildId !== "string" || rawChildId.length === 0) {
+                const message = `Invalid child category id in ${raw.id}.`;
+                diagnostics.push({
+                    code: "invalid-child-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, childId: rawChildId },
+                });
+                logger.warn(message);
+                return null;
+            }
+            const childRaw = rawMap[rawChildId];
+            if (!childRaw) {
+                const message = `Child category ${rawChildId} referenced in ${raw.id} not found.`;
+                diagnostics.push({
+                    code: "missing-child-ref",
+                    level: "warn",
+                    message,
+                    context: { categoryId: raw.id, childId: rawChildId },
+                });
+                logger.warn(message);
+                return null;
+            }
+            return convertCategory(childRaw, rawMap, docLookup, usedDocIds, included, visiting, diagnostics, logger);
+        })
+            .filter((child) => child !== null);
+        if (validChildren.length > 0) {
+            children = validChildren;
+        }
+    }
+    visiting.delete(raw.id);
+    included.add(raw.id);
+    return {
+        id: raw.id,
+        title: raw.title,
+        description: raw.description,
+        content: raw.content ?? [],
+        docs,
+        children,
+    };
+}
+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)) {
+            category.children.forEach((childId) => {
+                if (typeof childId === "string" && childId.length > 0) {
+                    childCategoryIds.add(childId);
+                }
+            });
+        }
+    });
+    let rootCandidates = Object.values(rawMap).filter((category) => category &&
+        typeof category.id === "string" &&
+        category.id.length > 0 &&
+        !childCategoryIds.has(category.id));
+    if (rootCandidates.length === 0) {
+        rootCandidates = Object.values(rawMap).filter((category) => category && typeof category.id === "string" && category.id.length > 0);
+    }
+    const tree = rootCandidates
+        .map((rootCategory) => {
+        if (includedIds.has(rootCategory.id))
+            return null;
+        return convertCategory(rootCategory, rawMap, docLookup, usedDocIds, includedIds, new Set(), diagnostics, logger);
+    })
+        .filter((category) => category !== null);
+    return { tree, usedDocIds, diagnostics };
+}

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/fsDataProvider.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fsDataProvider = exports.FsDataProvider = void 0;
+const promises_1 = require("node:fs/promises");
+class FsDataProvider {
+    async readJson(absPath) {
+        let contents;
+        try {
+            contents = await (0, promises_1.readFile)(absPath, "utf8");
+        }
+        catch (error) {
+            throw new Error(`Failed to read JSON from ${absPath}: ${error.message}`);
+        }
+        try {
+            return JSON.parse(contents);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from ${absPath}: ${error.message}`);
+        }
+    }
+}
+exports.FsDataProvider = FsDataProvider;
+exports.fsDataProvider = FsDataProvider;

package/dist/cjs/data/httpDataProvider.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpDataProvider = exports.HttpDataProvider = void 0;
+class HttpDataProvider {
+    async readJson(absUrl) {
+        let res;
+        try {
+            res = await fetch(absUrl);
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch ${absUrl}: ${error.message}`);
+        }
+        if (!res.ok) {
+            throw new Error(`Failed to fetch ${absUrl}: ${res.status} ${res.statusText}`);
+        }
+        try {
+            return (await res.json());
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from ${absUrl}: ${error.message}`);
+        }
+    }
+}
+exports.HttpDataProvider = HttpDataProvider;
+exports.httpDataProvider = HttpDataProvider;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpDataProvider = exports.HttpDataProvider = 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 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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpDataProvider = exports.HttpDataProvider = exports.fsDataProvider = exports.FsDataProvider = 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");
+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 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 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; } });
+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/loadAllCategories.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAllCategories = loadAllCategories;
+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 categories = {};
+    results.forEach((res, i) => {
+        if (res.status === "fulfilled") {
+            categories[res.value.id] = res.value.data;
+        }
+        else {
+            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 { categories, diagnostics };
+}

package/dist/cjs/data/loadAllItems.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAllItems = loadAllItems;
+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 items = [];
+    results.forEach((res, i) => {
+        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 { items, diagnostics };
+}

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

@@ -0,0 +1,29 @@
+"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 { versions, selectedVersion, diagnostics: versionDiagnostics, } = await (0, loadVersionData_js_1.selectVersion)(provider, root, options?.version, logger);
+    const versionRoot = (0, normalizeSystemPath_js_1.normalizeSystemPath)(node_path_1.default.resolve(root, selectedVersion));
+    const { items, tree, standaloneDocs, diagnostics: loadDiagnostics } = await (0, loadVersionData_js_1.loadVersionData)(provider, versionRoot, { logger });
+    diagnostics.push(...versionDiagnostics, ...loadDiagnostics);
+    return {
+        version: selectedVersion,
+        versions,
+        items,
+        tree,
+        standaloneDocs,
+        diagnostics,
+    };
+}

package/dist/cjs/data/loadVersionData.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadVersionData = loadVersionData;
+exports.loadVersionDataFromHttp = loadVersionDataFromHttp;
+exports.selectVersion = selectVersion;
+const logger_js_1 = require("../utilities/system/logger.js");
+const httpDataProvider_js_1 = require("./httpDataProvider.js");
+const buildTree_js_1 = require("./buildTree.js");
+const loadAllCategories_js_1 = require("./loadAllCategories.js");
+const loadAllItems_js_1 = require("./loadAllItems.js");
+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 [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, 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 { 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],
+    };
+}
+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 };
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+function joinUrl(base, child) {
+    return `${trimTrailingSlash(base)}/${child.replace(/^\/+/, "")}`;
+}

package/dist/cjs/data/loadVersions.js

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

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/index.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.js"), exports);
+__exportStar(require("./constants/index.js"), exports);
+__exportStar(require("./themes/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+__exportStar(require("./data/index.js"), exports);
+__exportStar(require("./utilities/index.js"), exports);

package/dist/cjs/themes/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+Object.defineProperty(exports, "AVAILABLE_THEME_PRESET_NAMES", { enumerable: true, get: function () { return themeRegistry_js_1.AVAILABLE_THEME_PRESET_NAMES; } });
+Object.defineProperty(exports, "DEFAULT_THEME_PRESET", { enumerable: true, get: function () { return themeRegistry_js_1.DEFAULT_THEME_PRESET; } });
+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/presets/default.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTheme = void 0;
+exports.defaultTheme = {
+    header: {
+        mobileNavigationToggle: "text-stone-500 hover:text-stone-700 dark:text-gray-500 dark:hover:text-gray-700",
+        mobileMenuToggle: "text-stone-500 hover:text-stone-700 dark:text-gray-500 dark:hover:text-gray-700",
+    },
+    category: {
+        empty: "text-gray-500 text-center",
+        cardBody: "rounded-xl text-left transition-colors bg-stone-200 border border-stone-400 hover:bg-stone-300 dark:bg-indigo-900/50 dark:border-indigo-800 dark:hover:bg-indigo-700/70",
+        cardHeaderText: "text-lg font-semibold mb-1 text-stone-700 dark:text-gray-50",
+        cardDescriptionText: "text-sm line-clamp-3 text-gray-600 dark:text-indigo-400",
+    },
+    navigation: {
+        row: "leading-tight focus:outline-none text-gray-900 dark:text-gray-50",
+        rowActive: "font-semibold transition-colors border-l-2 text-stone-700 bg-stone-200 border-stone-500 dark:text-gray-50 dark:bg-indigo-900/60 dark:border-white",
+        rowFocused: "ring-2 ring-stone-500 dark:ring-indigo-600",
+        rowHover: "transition-colors hover:text-stone-500 dark:hover:text-indigo-500",
+        hideOrShowHintsText: "text-stone-600 hover:underline focus:outline-none dark:text-indigo-500",
+    },
+    searchModal: {
+        resultBackground: "bg-stone-100 dark:bg-zinc-900",
+        resultEmptyInputText: "text-sm text-center text-gray-400",
+        resultNoResultText: "text-sm text-center text-gray-400",
+        header: "bg-white dark:bg-zinc-900 text-gray-800 dark:text-gray-400",
+        footer: "bg-white dark:bg-zinc-900",
+        borders: "border-gray-800 dark:border-gray-500",
+        item: "border-b border-stone-300 hover:bg-stone-300/70 dark:border-indigo-400/30 dark:hover:bg-indigo-900/80",
+        selectedItem: "border-b border-stone-300 bg-stone-300 hover:bg-stone-300/70 dark:border-indigo-400/30 dark:bg-indigo-900/60 dark:hover:bg-indigo-900/80",
+        itemHeaderText: "font-bold text-stone-600 dark:text-indigo-400",
+        itemFoundSectionText: "text-xs mt-1 line-clamp-2 text-gray-700 dark:text-gray-300",
+        itemTags: "bg-stone-400 rounded-full text-[11px] text-gray-50 mt-0.5 italic truncate dark:bg-indigo-400/40 dark:text-gray-100",
+    },
+    sections: {
+        siteBackground: "bg-stone-400 dark:bg-slate-950",
+        siteBorders: "border-x border-stone-600 dark:border-gray-700",
+        headerBackground: "bg-stone-50 shadow-sm border-b border-stone-400 dark:bg-zinc-900 dark:border-gray-700",
+        headerMobileBackground: "bg-stone-50 border-b border-stone-400 shadow-md dark:bg-zinc-900 dark:border-gray-700",
+        sidebarBackground: "bg-stone-50 border-r border-stone-400 dark:bg-zinc-900 dark:border-gray-700",
+        documentHeaderBackground: "bg-stone-200 border-b border-stone-400 dark:bg-indigo-900/60 dark:border-gray-700",
+        contentBackground: "bg-gray-100 dark:bg-zinc-900",
+    },
+    input: "text-sm text-stone-700 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500 dark:text-gray-400 dark:border-gray-600",
+    text: {
+        logoText: "text-xl font-semibold text-gray-900 dark:text-gray-50",
+        documentTitle: "text-2xl font-bold leading-tight text-stone-600 dark:text-gray-300",
+        breadcrumb: "text-sm text-stone-500 dark:text-gray-400",
+        titleLevel1: "text-3xl font-bold text-stone-600 mb-3 mt-8 first:mt-0 dark:text-indigo-400",
+        titleLevel2: "text-2xl font-semibold text-gray-800 mb-4 mt-8 first:mt-0 dark:text-gray-100",
+        titleLevel3: "text-xl font-medium text-gray-700 mb-3 mt-6 first:mt-0 dark:text-gray-200",
+        titleAnchor: "text-stone-400 hover:text-blue-500 dark:text-gray-400",
+        general: "text-base text-gray-700 mb-2 leading-relaxed dark:text-gray-300",
+        alternative: "text-sm text-center italic text-gray-400 mt-2",
+        list: "list-inside text-gray-700 mb-2 space-y-1 dark:text-gray-300",
+        math: "text-lg text-gray-800 dark:text-gray-200",
+    },
+    hints: {
+        text: "text-xs text-stone-500 dark:text-gray-400",
+        key: "text-xs text-stone-500 border border-stone-400 rounded dark:text-gray-400 dark:border-gray-600",
+    },
+    divider: {
+        border: "border-stone-400 dark:border-gray-500",
+        gradient: "from-transparent via-stone-400 to-transparent dark:via-gray-500",
+        text: "text-sm text-stone-400 dark:text-gray-500",
+    },
+    buttons: {
+        common: "font-bold rounded-md transition-colors text-stone-700 bg-stone-200 border border-stone-400 hover:bg-stone-300 dark:text-gray-100 dark:bg-indigo-900/50 dark:border-indigo-800 dark:hover:bg-indigo-700/70",
+        small: "text-xs font-semibold rounded-md transition-colors text-stone-700 bg-stone-200 border border-stone-400 hover:bg-stone-300 dark:text-gray-100 dark:bg-indigo-900 dark:border-indigo-600 dark:hover:bg-indigo-700/70",
+        tabSmall: "text-xs font-semibold rounded-md transition-colors text-stone-300 bg-stone-700 border border-stone-300 hover:bg-stone-500 dark:text-indigo-300 dark:bg-indigo-950 dark:border-indigo-600 dark:hover:bg-indigo-700/70",
+        tabSmallActive: "text-xs font-semibold rounded-md transition-colors text-stone-800 bg-lime-500 border border-lime-300 dark:text-gray-800 dark:bg-lime-500 dark:border-lime-300",
+    },
+    dropdown: {
+        container: "bg-white border border-stone-300 rounded-md shadow-lg dark:bg-slate-800 dark:border-indigo-600",
+        item: "text-left whitespace-nowrap transition-colors hover:bg-stone-200/50 dark:text-white dark:hover:bg-indigo-600/50",
+        itemActive: "border-l-2 text-stone-700 bg-stone-200 font-bold dark:bg-indigo-900/60",
+    },
+    messageBox: {
+        info: "bg-blue-100 text-blue-800 border-blue-300 dark:bg-blue-900/40 dark:text-blue-200 dark:border-blue-400/60",
+        warning: "bg-yellow-100 text-yellow-800 border-yellow-300 dark:bg-yellow-900/40 dark:text-yellow-200 dark:border-yellow-400/60",
+        error: "bg-red-100 text-red-800 border-red-300 dark:bg-red-900/40 dark:text-red-200 dark:border-red-400/60",
+        success: "bg-green-100 text-green-800 border-green-300 dark:bg-green-900/40 dark:text-green-200 dark:border-green-400/60",
+        neutral: "bg-stone-100 text-gray-700 border-gray-300 dark:bg-indigo-300/20 dark:text-gray-200 dark:border-gray-500",
+        quote: "bg-stone-300 border-l-4 border-stone-500 text-gray-700 italic dark:bg-indigo-900/50 dark:border-white dark:text-white",
+    },
+    table: {
+        cornerCell: "bg-stone-900/80 font-bold text-white text-lg dark:bg-indigo-900/50 dark:text-gray-200",
+        headers: "bg-stone-700/80 font-semibold text-white text-lg dark:bg-indigo-900/80 dark:text-gray-200",
+        rows: "bg-stone-50 text-gray-700 dark:bg-indigo-950/5 dark:text-gray-200",
+        border: "border-stone-400 dark:border-indigo-700",
+        empty: "text-gray-500 text-center",
+    },
+    code: {
+        header: "bg-stone-700/80 text-gray-200 border-b border-stone-300 dark:bg-indigo-900/80 dark:text-white dark:border-indigo-500",
+        language: "text-xs font-semibold text-stone-300 mt-1 text-right dark:text-indigo-300",
+        lines: "text-sm text-gray-500 border-r border-gray-300 dark:text-gray-500",
+        empty: "bg-gray-50 text-gray-500 text-center text-sm border",
+    },
+    audioPlayer: {
+        container: "bg-gray-300 dark:bg-indigo-900/50",
+        playButton: "bg-stone-700 hover:bg-stone-600 text-white transition-colors dark:bg-indigo-700 dark:hover:bg-indigo-600",
+        time: "text-gray-700 text-xs tabular-nums text-center dark:text-gray-400",
+        slider: "bg-transparent",
+        sliderThumb: "[&::-webkit-slider-thumb]:bg-stone-600 [&::-webkit-slider-thumb]:shadow-[0_0_0_3px_rgba(0,0,0,0.1)] [&::-moz-range-thumb]:bg-stone-600 [&::-moz-range-thumb]:border-none dark:[&::-webkit-slider-thumb]:bg-indigo-400 dark:[&::-webkit-slider-thumb]:shadow-[0_0_0_3px_rgba(37,99,235,0.35)] dark:[&::-moz-range-thumb]:bg-indigo-400",
+        sliderTrackColor: "rgba(99, 102, 241, 0.2)",
+        sliderFillColor: "rgba(129, 140, 248, 1)",
+    },
+    chart: {
+        legendLabelColor: "#334155",
+        tooltipBg: "#0f172a",
+        tooltipTitleColor: "#e2e8f0",
+        tooltipBodyColor: "#e5e7eb",
+        tooltipBorderColor: "#94a3b8",
+        axisTickColor: "#475569",
+        gridLineColor: "rgba(148, 163, 184, 0.3)",
+    },
+    graph: {
+        background: "#e5e7eb",
+        defaultCurve: "#2563eb",
+    },
+};

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