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

package/dist/browser/serverOnly.d.ts

@@ -0,0 +1,15 @@
+import type { DataProvider } from "../types/DataProvider.js";
+import type { Logger } from "../types/Logger.js";
+import type { ResolvedSstDocsConfig } from "../types/SstDocsConfig.js";
+export declare function loadSstDocsConfig(_configPath?: string): Promise<ResolvedSstDocsConfig>;
+export declare function loadSstDocsConfigSync(_configPath?: string): ResolvedSstDocsConfig;
+export declare function loadSstDocsConfigFrom(_configDir: string): Promise<ResolvedSstDocsConfig>;
+export declare function loadSstDocsConfigFromSync(_configDir: string): ResolvedSstDocsConfig;
+export declare class fsDataProvider implements DataProvider {
+    readJson<T>(): Promise<T>;
+}
+export declare function resolveDataPath(): string;
+export declare function resolveAgainstProjectRoot(): string;
+export declare function pathExists(): Promise<boolean>;
+export declare const createLogger: (_scope: string) => Logger;
+//# sourceMappingURL=serverOnly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverOnly.d.ts","sourceRoot":"","sources":["../../src/browser/serverOnly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAQvE,wBAAsB,iBAAiB,CACrC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED,wBAAgB,qBAAqB,CACnC,WAAW,CAAC,EAAE,MAAM,GACnB,qBAAqB,CAEvB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAEvB;AAED,qBAAa,cAAe,YAAW,YAAY;IAC3C,QAAQ,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;CAGhC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAEnD;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MAE7C,CAAC"}

package/dist/browser/serverOnly.js

@@ -0,0 +1,33 @@
+function serverOnly(name) {
+    throw new Error(`"${name}" is only available in Node.js environments. Import from "@shadow-shard-tools/docs-core" on the server instead.`);
+}
+export async function loadSstDocsConfig(_configPath) {
+    serverOnly("loadSstDocsConfig");
+}
+export function loadSstDocsConfigSync(_configPath) {
+    serverOnly("loadSstDocsConfigSync");
+}
+export async function loadSstDocsConfigFrom(_configDir) {
+    serverOnly("loadSstDocsConfigFrom");
+}
+export function loadSstDocsConfigFromSync(_configDir) {
+    serverOnly("loadSstDocsConfigFromSync");
+}
+export class fsDataProvider {
+    async readJson() {
+        serverOnly("fsDataProvider.readJson");
+    }
+}
+export function resolveDataPath() {
+    serverOnly("resolveDataPath");
+}
+export function resolveAgainstProjectRoot() {
+    serverOnly("resolveAgainstProjectRoot");
+}
+export async function pathExists() {
+    serverOnly("pathExists");
+}
+export const createLogger = (_scope) => {
+    serverOnly("createLogger");
+};
+//# sourceMappingURL=serverOnly.js.map

package/dist/browser/serverOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverOnly.js","sourceRoot":"","sources":["../../src/browser/serverOnly.ts"],"names":[],"mappings":"AAIA,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,IAAI,KAAK,CACb,IAAI,IAAI,iHAAiH,CAC1H,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAoB;IAEpB,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAAoB;IAEpB,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAkB;IAElB,UAAU,CAAC,2BAA2B,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ;QACZ,UAAU,CAAC,yBAAyB,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,UAAU,CAAC,2BAA2B,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,UAAU,CAAC,YAAY,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAU,EAAE;IACrD,UAAU,CAAC,cAAc,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,38 @@
+export * from "./constants/index.js";
+export * from "./themes/index.js";
+export * from "./types/index.js";
+export { CODE_LANGUAGE_CONFIG, type SupportedLanguage, } from "./configs/codeLanguagesConfig.js";
+export { stylesConfig } from "./configs/stylesConfig.js";
+export { buildClientVisibleConfig, DEFAULT_CLIENT_CONFIG_GLOBAL, exposeClientConfig, readClientConfig, serializeClientConfigForBrowser, } from "./configs/clientConfig.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./configs/sstDocsConfig.shared.js";
+export { loadSstDocsConfig, loadSstDocsConfigFrom, loadSstDocsConfigSync, loadSstDocsConfigFromSync, } from "./browser/serverOnly.js";
+export { buildTree } from "./data/buildTree.js";
+export { loadAllCategories } from "./data/loadAllCategories.js";
+export { loadAllItems } from "./data/loadAllItems.js";
+export { loadVersionData } from "./data/loadVersionData.js";
+export { loadVersions } from "./data/loadVersions.js";
+export { httpDataProvider } from "./data/httpDataProvider.js";
+export { fsDataProvider } from "./browser/serverOnly.js";
+export { slugify } from "./utilities/string/slugify.js";
+export { sanitizeFilename } from "./utilities/string/sanitizeFilename.js";
+export { extractYouTubeId } from "./utilities/string/extractYouTubeId.js";
+export { withBasePath } from "./utilities/string/withBasePath.js";
+export { processListItems } from "./utilities/string/processListItems.js";
+export { normalizeBaseUrlPath } from "./utilities/string/normalizeBaseUrlPath.js";
+export { normalizeSystemPath } from "./utilities/string/normalizeSystemPath.js";
+export { getFileExtension } from "./utilities/file/getFileExtension.js";
+export { resolveDataPath } from "./browser/serverOnly.js";
+export { resolveAgainstProjectRoot } from "./browser/serverOnly.js";
+export { pathExists } from "./browser/serverOnly.js";
+export { createTimeout } from "./utilities/system/createTimeout.js";
+export { formatTime } from "./utilities/system/formatTime.js";
+export { createLogger } from "./browser/serverOnly.js";
+export { isMobileDevice } from "./utilities/validation/isMobileDevice.js";
+export { isValidColor } from "./utilities/validation/isValidColor.js";
+export { isValidImageUrl } from "./utilities/validation/isValidImageUrl.js";
+export { isValidYouTubeId } from "./utilities/validation/isValidYouTubeId.js";
+export { validateScale } from "./utilities/validation/validateScale.js";
+export { getResponsiveWidth } from "./utilities/dom/getResponsiveWidth.js";
+export { copyToClipboard } from "./utilities/dom/copyToClipboard.js";
+export { downloadTextFile } from "./utilities/dom/downloadTextFile.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/browser.js

@@ -0,0 +1,45 @@
+export * from "./constants/index.js";
+export * from "./themes/index.js";
+export * from "./types/index.js";
+// Configs
+export { CODE_LANGUAGE_CONFIG, } from "./configs/codeLanguagesConfig.js";
+export { stylesConfig } from "./configs/stylesConfig.js";
+export { buildClientVisibleConfig, DEFAULT_CLIENT_CONFIG_GLOBAL, exposeClientConfig, readClientConfig, serializeClientConfigForBrowser, } from "./configs/clientConfig.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./configs/sstDocsConfig.shared.js";
+export { loadSstDocsConfig, loadSstDocsConfigFrom, loadSstDocsConfigSync, loadSstDocsConfigFromSync, } from "./browser/serverOnly.js";
+// Data
+export { buildTree } from "./data/buildTree.js";
+export { loadAllCategories } from "./data/loadAllCategories.js";
+export { loadAllItems } from "./data/loadAllItems.js";
+export { loadVersionData } from "./data/loadVersionData.js";
+export { loadVersions } from "./data/loadVersions.js";
+export { httpDataProvider } from "./data/httpDataProvider.js";
+export { fsDataProvider } from "./browser/serverOnly.js";
+// Utilities (string)
+export { slugify } from "./utilities/string/slugify.js";
+export { sanitizeFilename } from "./utilities/string/sanitizeFilename.js";
+export { extractYouTubeId } from "./utilities/string/extractYouTubeId.js";
+export { withBasePath } from "./utilities/string/withBasePath.js";
+export { processListItems } from "./utilities/string/processListItems.js";
+export { normalizeBaseUrlPath } from "./utilities/string/normalizeBaseUrlPath.js";
+export { normalizeSystemPath } from "./utilities/string/normalizeSystemPath.js";
+// Utilities (file)
+export { getFileExtension } from "./utilities/file/getFileExtension.js";
+// Utilities (path + system)
+export { resolveDataPath } from "./browser/serverOnly.js";
+export { resolveAgainstProjectRoot } from "./browser/serverOnly.js";
+export { pathExists } from "./browser/serverOnly.js";
+export { createTimeout } from "./utilities/system/createTimeout.js";
+export { formatTime } from "./utilities/system/formatTime.js";
+export { createLogger } from "./browser/serverOnly.js";
+// Utilities (validation)
+export { isMobileDevice } from "./utilities/validation/isMobileDevice.js";
+export { isValidColor } from "./utilities/validation/isValidColor.js";
+export { isValidImageUrl } from "./utilities/validation/isValidImageUrl.js";
+export { isValidYouTubeId } from "./utilities/validation/isValidYouTubeId.js";
+export { validateScale } from "./utilities/validation/validateScale.js";
+// Utilities (dom)
+export { getResponsiveWidth } from "./utilities/dom/getResponsiveWidth.js";
+export { copyToClipboard } from "./utilities/dom/copyToClipboard.js";
+export { downloadTextFile } from "./utilities/dom/downloadTextFile.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,UAAU;AACV,OAAO,EACL,oBAAoB,GAErB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,4BAA4B;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/configs/clientConfig.d.ts

@@ -0,0 +1,18 @@
+import type { ClientVisibleSstDocsConfig } from "../types/ClientVisibleSstDocsConfig.js";
+import type { ResolvedSstDocsConfig } from "../types/SstDocsConfig.js";
+export declare const DEFAULT_CLIENT_CONFIG_GLOBAL = "__SST_DOCS_CONFIG__";
+type ClientConfigSource = ResolvedSstDocsConfig | ClientVisibleSstDocsConfig;
+export interface ClientConfigSerializationOptions {
+    globalName?: string;
+    pretty?: boolean;
+}
+export interface ExposeClientConfigOptions {
+    globalName?: string;
+    target?: Record<string, unknown>;
+}
+export declare function buildClientVisibleConfig(config: ResolvedSstDocsConfig): ClientVisibleSstDocsConfig;
+export declare function serializeClientConfigForBrowser(source: ClientConfigSource, options?: ClientConfigSerializationOptions): string;
+export declare function exposeClientConfig(source: ClientConfigSource, options?: ExposeClientConfigOptions): ClientVisibleSstDocsConfig;
+export declare function readClientConfig(globalName?: string): ClientVisibleSstDocsConfig;
+export {};
+//# sourceMappingURL=clientConfig.d.ts.map

package/dist/configs/clientConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientConfig.d.ts","sourceRoot":"","sources":["../../src/configs/clientConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE,KAAK,kBAAkB,GACnB,qBAAqB,GACrB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,GAC5B,0BAA0B,CAM5B;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,gCAAgC,GACzC,MAAM,CAKR;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,0BAA0B,CAe5B;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,SAA+B,GACxC,0BAA0B,CAkB5B"}

package/dist/configs/clientConfig.js

@@ -0,0 +1,58 @@
+export const DEFAULT_CLIENT_CONFIG_GLOBAL = "__SST_DOCS_CONFIG__";
+export function buildClientVisibleConfig(config) {
+    return {
+        PUBLIC_DATA_PATH: config.PUBLIC_DATA_PATH,
+        HEADER_BRANDING: config.HEADER_BRANDING,
+        HTML_GENERATOR_THEME: config.HTML_GENERATOR_SETTINGS?.THEME,
+    };
+}
+export function serializeClientConfigForBrowser(source, options) {
+    const payload = normalizeClientConfigSource(source);
+    const globalName = options?.globalName ?? DEFAULT_CLIENT_CONFIG_GLOBAL;
+    const spacing = options?.pretty ? 2 : undefined;
+    return `window.${globalName} = ${JSON.stringify(payload, null, spacing)};`;
+}
+export function exposeClientConfig(source, options) {
+    const payload = normalizeClientConfigSource(source);
+    const target = options?.target ??
+        globalThis;
+    if (!target) {
+        throw new Error("Unable to expose client config: no target global object was provided.");
+    }
+    const globalName = options?.globalName ?? DEFAULT_CLIENT_CONFIG_GLOBAL;
+    target[globalName] = payload;
+    return payload;
+}
+export function readClientConfig(globalName = DEFAULT_CLIENT_CONFIG_GLOBAL) {
+    if (hasCompileTimeClientConfig()) {
+        return __SST_DOCS_CONFIG__;
+    }
+    const globalObject = globalThis;
+    if (!globalObject) {
+        throw new Error("globalThis is not available in the current environment.");
+    }
+    const value = globalObject[globalName];
+    if (!isClientConfig(value)) {
+        throw new Error(`Client config "${globalName}" is missing or malformed on globalThis.`);
+    }
+    return value;
+}
+function normalizeClientConfigSource(source) {
+    if (isClientConfig(source)) {
+        return source;
+    }
+    return buildClientVisibleConfig(source);
+}
+function isClientConfig(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    return ("PUBLIC_DATA_PATH" in value &&
+        "HEADER_BRANDING" in value);
+}
+function hasCompileTimeClientConfig() {
+    // During browser builds Vite replaces __SST_DOCS_CONFIG__ with a JSON literal,
+    // so check for the identifier before touching globalThis at runtime.
+    return typeof __SST_DOCS_CONFIG__ !== "undefined";
+}
+//# sourceMappingURL=clientConfig.js.map

package/dist/configs/clientConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientConfig.js","sourceRoot":"","sources":["../../src/configs/clientConfig.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAgBlE,MAAM,UAAU,wBAAwB,CACtC,MAA6B;IAE7B,OAAO;QACL,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,oBAAoB,EAAE,MAAM,CAAC,uBAAuB,EAAE,KAAK;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAA0B,EAC1B,OAA0C;IAE1C,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,4BAA4B,CAAC;IACvE,MAAM,OAAO,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,OAAO,UAAU,UAAU,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAA0B,EAC1B,OAAmC;IAEnC,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GACV,OAAO,EAAE,MAAM;QACb,UAA8D,CAAC;IAEnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,4BAA4B,CAAC;IACvE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAU,GAAG,4BAA4B;IAEzC,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACjC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,YAAY,GAAG,UAAiD,CAAC;IACvE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,kBAAkB,UAAU,0CAA0C,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAClC,MAA0B;IAE1B,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CACrB,KAAc;IAEd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,kBAAkB,IAAI,KAAK;QAC3B,iBAAiB,IAAI,KAAK,CAC3B,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B;IACjC,+EAA+E;IAC/E,qEAAqE;IACrE,OAAO,OAAO,mBAAmB,KAAK,WAAW,CAAC;AACpD,CAAC"}

package/dist/configs/index.d.ts

@@ -1,4 +1,6 @@
 export { CODE_LANGUAGE_CONFIG, type SupportedLanguage, } from "./codeLanguagesConfig.js";
-export { stylesConfig } from "./stylesСonfig.js";
-export { loadSstDocsConfig, loadSstDocsConfigFrom, derivePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./sstDocsConfig.js";
+export { stylesConfig } from "./stylesConfig.js";
+export { loadSstDocsConfig, loadSstDocsConfigFrom, loadSstDocsConfigSync, loadSstDocsConfigFromSync, } from "./sstDocsConfig.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./sstDocsConfig.shared.js";
+export { buildClientVisibleConfig, DEFAULT_CLIENT_CONFIG_GLOBAL, exposeClientConfig, readClientConfig, serializeClientConfigForBrowser, } from "./clientConfig.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/dist/configs/index.js

@@ -1,4 +1,6 @@
 export { CODE_LANGUAGE_CONFIG, } from "./codeLanguagesConfig.js";
-export { stylesConfig } from "./stylesСonfig.js";
-export { loadSstDocsConfig, loadSstDocsConfigFrom, derivePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./sstDocsConfig.js";
+export { stylesConfig } from "./stylesConfig.js";
+export { loadSstDocsConfig, loadSstDocsConfigFrom, loadSstDocsConfigSync, loadSstDocsConfigFromSync, } from "./sstDocsConfig.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./sstDocsConfig.shared.js";
+export { buildClientVisibleConfig, DEFAULT_CLIENT_CONFIG_GLOBAL, exposeClientConfig, readClientConfig, serializeClientConfigForBrowser, } from "./clientConfig.js";
 //# sourceMappingURL=index.js.map

package/dist/configs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/dist/configs/sstDocsConfig.d.ts

@@ -1,9 +1,8 @@
 import type { ResolvedSstDocsConfig } from "../types/SstDocsConfig.js";
-export declare const SST_DOCS_CONFIG_FILENAME = "sst-docs.config.json";
-export declare class SstDocsConfigError extends Error {
-    constructor(message: string);
-}
+import { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME } from "./sstDocsConfig.shared.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, };
 export declare function loadSstDocsConfig(configPath?: string): Promise<ResolvedSstDocsConfig>;
-export declare function derivePublicDataPath(fsDataPath: string): string;
+export declare function loadSstDocsConfigSync(configPath?: string): ResolvedSstDocsConfig;
 export declare function loadSstDocsConfigFrom(configDir: string): Promise<ResolvedSstDocsConfig>;
+export declare function loadSstDocsConfigFromSync(configDir: string): ResolvedSstDocsConfig;
 //# sourceMappingURL=sstDocsConfig.d.ts.map

package/dist/configs/sstDocsConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sstDocsConfig.d.ts","sourceRoot":"","sources":["../../src/configs/sstDocsConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAKnC,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAID,wBAAsB,iBAAiB,CACrC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAahC;AAqCD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6B/D;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAGhC"}
+{"version":3,"file":"sstDocsConfig.d.ts","sourceRoot":"","sources":["../../src/configs/sstDocsConfig.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,2BAA2B,CAAC;AAG1F,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,CAAC;AAKF,wBAAsB,iBAAiB,CACrC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAMhC;AAED,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE,MAAM,GAClB,qBAAqB,CAMvB;AAqDD,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAGvB"}

package/dist/configs/sstDocsConfig.js

@@ -1,17 +1,22 @@
+import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import appRoot from "app-root-path";
+import { AVAILABLE_THEME_PRESET_NAMES, DEFAULT_THEME_PRESET, getThemePreset, isThemePresetName, } from "../themes/themeRegistry.js";
 import { normalizeSystemPath } from "../utilities/string/normalizeSystemPath.js";
-export const SST_DOCS_CONFIG_FILENAME = "sst-docs.config.json";
-export class SstDocsConfigError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "SstDocsConfigError";
-    }
-}
+import { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, } from "./sstDocsConfig.shared.js";
+export { derivePublicDataPath, resolvePublicDataPath, SstDocsConfigError, SST_DOCS_CONFIG_FILENAME, };
 const APP_ROOT = appRoot.path;
+const UTF8 = "utf-8";
 export async function loadSstDocsConfig(configPath) {
-    const { path: finalPath, contents } = await readConfigFile(configPath);
+    const { path: finalPath, contents } = await readConfigFromSearchPaths(getConfigSearchPaths(configPath), (candidate) => readFile(candidate, UTF8));
+    return parseConfigContents(contents, finalPath);
+}
+export function loadSstDocsConfigSync(configPath) {
+    const { path: finalPath, contents } = readConfigFromSearchPathsSync(getConfigSearchPaths(configPath), (candidate) => readFileSync(candidate, UTF8));
+    return parseConfigContents(contents, finalPath);
+}
+function parseConfigContents(contents, sourcePath) {
     let parsed;
     try {
         parsed = JSON.parse(contents);
@@ -19,7 +24,7 @@ export async function loadSstDocsConfig(configPath) {
     catch (error) {
         throw new SstDocsConfigError(`Failed to parse ${SST_DOCS_CONFIG_FILENAME}: ${error.message}`);
     }
-    return normalizeConfig(parsed, finalPath);
+    return normalizeConfig(parsed, sourcePath);
 }
 function normalizeConfig(value, sourcePath) {
     if (!value || typeof value !== "object") {
@@ -40,62 +45,72 @@ function normalizeConfig(value, sourcePath) {
         HTML_GENERATOR_SETTINGS: normalizeHtmlGeneratorSettings(raw.HTML_GENERATOR_SETTINGS, sourcePath),
     };
 }
-export function derivePublicDataPath(fsDataPath) {
-    const normalized = normalizeSystemPath(fsDataPath.trim());
-    let candidate = normalized;
-    // Strip leading relative markers like "./"
-    candidate = candidate.replace(/^\.\/*/, "/");
-    // Try to locate the /public segment and drop everything up to it.
-    const publicSegmentIndex = candidate.indexOf("/public");
-    if (publicSegmentIndex !== -1) {
-        candidate = candidate.slice(publicSegmentIndex + "/public".length);
-    }
-    else if (candidate.startsWith("public/")) {
-        candidate = candidate.slice("public".length);
-    }
-    if (candidate.length === 0 || candidate === "/") {
-        return "/";
-    }
-    if (!candidate.startsWith("/")) {
-        candidate = `/${candidate}`;
-    }
-    if (!candidate.endsWith("/")) {
-        candidate = `${candidate}/`;
-    }
-    return candidate;
-}
 export async function loadSstDocsConfigFrom(configDir) {
     const fullPath = resolve(configDir, SST_DOCS_CONFIG_FILENAME);
     return loadSstDocsConfig(fullPath);
 }
-async function readConfigFile(configPath) {
-    const searchPaths = [];
-    if (configPath) {
-        const explicit = resolve(APP_ROOT, configPath);
-        searchPaths.push(explicit);
-        if (!explicit.endsWith(".json")) {
-            searchPaths.push(resolve(explicit, SST_DOCS_CONFIG_FILENAME));
+export function loadSstDocsConfigFromSync(configDir) {
+    const fullPath = resolve(configDir, SST_DOCS_CONFIG_FILENAME);
+    return loadSstDocsConfigSync(fullPath);
+}
+async function readConfigFromSearchPaths(searchPaths, reader) {
+    const attempted = [];
+    for (const candidate of searchPaths) {
+        attempted.push(candidate);
+        try {
+            const contents = await reader(candidate);
+            return { path: candidate, contents };
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                continue;
+            }
+            throw wrapReadError(candidate, error);
         }
     }
-    else {
-        searchPaths.push(resolve(APP_ROOT, SST_DOCS_CONFIG_FILENAME));
-    }
+    throw missingConfigError(attempted);
+}
+function readConfigFromSearchPathsSync(searchPaths, reader) {
     const attempted = [];
     for (const candidate of searchPaths) {
         attempted.push(candidate);
         try {
-            const contents = await readFile(candidate, "utf-8");
+            const contents = reader(candidate);
             return { path: candidate, contents };
         }
         catch (error) {
-            const err = error;
-            if (err.code === "ENOENT" || err.code === "EISDIR") {
+            if (isMissingFileError(error)) {
                 continue;
             }
-            throw new SstDocsConfigError(`Failed to read ${SST_DOCS_CONFIG_FILENAME} at ${candidate}: ${err.message}`);
+            throw wrapReadError(candidate, error);
+        }
+    }
+    throw missingConfigError(attempted);
+}
+function getConfigSearchPaths(configPath) {
+    const searchPaths = [];
+    if (configPath) {
+        const explicit = resolve(APP_ROOT, configPath);
+        searchPaths.push(explicit);
+        if (!explicit.endsWith(".json")) {
+            searchPaths.push(resolve(explicit, SST_DOCS_CONFIG_FILENAME));
         }
     }
-    throw new SstDocsConfigError(`Unable to locate ${SST_DOCS_CONFIG_FILENAME}. Tried: ${attempted.join(", ")}`);
+    else {
+        searchPaths.push(resolve(APP_ROOT, SST_DOCS_CONFIG_FILENAME));
+    }
+    return searchPaths;
+}
+function isMissingFileError(error) {
+    const code = error?.code;
+    return code === "ENOENT" || code === "EISDIR";
+}
+function wrapReadError(candidate, error) {
+    const message = error?.message ?? String(error);
+    return new SstDocsConfigError(`Failed to read ${SST_DOCS_CONFIG_FILENAME} at ${candidate}: ${message}`);
+}
+function missingConfigError(attempted) {
+    return new SstDocsConfigError(`Unable to locate ${SST_DOCS_CONFIG_FILENAME}. Tried: ${attempted.join(", ")}`);
 }
 function normalizeHeaderBranding(value, sourcePath) {
     if (value === undefined) {
@@ -135,17 +150,92 @@ function normalizeHtmlGeneratorSettings(value, sourcePath) {
     if (outputDirectory.length === 0) {
         throw new SstDocsConfigError(`HTML_GENERATOR_SETTINGS.OUTPUT_DIRECTORY cannot be empty in ${sourcePath}`);
     }
-    if (!THEME || typeof THEME !== "object" || Array.isArray(THEME)) {
-        throw new SstDocsConfigError(`HTML_GENERATOR_SETTINGS.THEME must be an object in ${sourcePath}`);
+    if (THEME === undefined) {
+        throw new SstDocsConfigError(`HTML_GENERATOR_SETTINGS.THEME must be provided in ${sourcePath}`);
     }
     if (SEPARATE_BUILD_FOR_HTML_GENERATOR !== undefined &&
         typeof SEPARATE_BUILD_FOR_HTML_GENERATOR !== "boolean") {
         throw new SstDocsConfigError(`HTML_GENERATOR_SETTINGS.SEPARATE_BUILD_FOR_HTML_GENERATOR must be a boolean in ${sourcePath}`);
     }
+    const resolvedTheme = resolveThemeConfiguration(THEME, sourcePath);
     return {
         OUTPUT_DIRECTORY: outputDirectory,
-        THEME: THEME,
+        THEME: resolvedTheme,
         SEPARATE_BUILD_FOR_HTML_GENERATOR: SEPARATE_BUILD_FOR_HTML_GENERATOR ?? false,
     };
 }
+function resolveThemeConfiguration(value, sourcePath) {
+    if (typeof value === "string") {
+        return cloneThemeFromPreset(value, sourcePath, "HTML_GENERATOR_SETTINGS.THEME");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new SstDocsConfigError(`HTML_GENERATOR_SETTINGS.THEME must be a string or object in ${sourcePath}`);
+    }
+    const themeObject = value;
+    let baseThemeName = DEFAULT_THEME_PRESET;
+    if (themeObject.preset !== undefined) {
+        baseThemeName = ensureThemePresetName(themeObject.preset, sourcePath, "HTML_GENERATOR_SETTINGS.THEME.preset");
+    }
+    else if (themeObject.extend !== undefined) {
+        baseThemeName = ensureThemePresetName(themeObject.extend, sourcePath, "HTML_GENERATOR_SETTINGS.THEME.extend");
+    }
+    const overrides = { ...themeObject };
+    delete overrides.preset;
+    delete overrides.extend;
+    const baseTheme = cloneTheme(getThemePreset(baseThemeName));
+    return applyThemeOverrides(baseTheme, overrides, sourcePath);
+}
+function cloneThemeFromPreset(preset, sourcePath, propertyPath) {
+    const themeName = ensureThemePresetName(preset, sourcePath, propertyPath);
+    const presetTheme = getThemePreset(themeName);
+    return cloneTheme(presetTheme);
+}
+function ensureThemePresetName(raw, sourcePath, propertyPath) {
+    if (raw === undefined || raw === null) {
+        return DEFAULT_THEME_PRESET;
+    }
+    if (typeof raw !== "string") {
+        const options = AVAILABLE_THEME_PRESET_NAMES.join(", ");
+        throw new SstDocsConfigError(`${propertyPath} must be one of: ${options} in ${sourcePath}`);
+    }
+    const normalized = raw.trim().toLowerCase();
+    if (!isThemePresetName(normalized)) {
+        const options = AVAILABLE_THEME_PRESET_NAMES.join(", ");
+        throw new SstDocsConfigError(`Unknown ${propertyPath} "${raw}" in ${sourcePath}. Supported presets: ${options}`);
+    }
+    return normalized;
+}
+function applyThemeOverrides(theme, overrides, sourcePath) {
+    mergeThemeFragments(theme, overrides, sourcePath, "HTML_GENERATOR_SETTINGS.THEME");
+    return theme;
+}
+function mergeThemeFragments(target, overrides, sourcePath, path) {
+    const targetRecord = target;
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (!(key in targetRecord)) {
+            throw new SstDocsConfigError(`${path}.${key} is not a recognized theme field in ${sourcePath}`);
+        }
+        const current = targetRecord[key];
+        if (current &&
+            typeof current === "object" &&
+            !Array.isArray(current)) {
+            if (!value || typeof value !== "object" || Array.isArray(value)) {
+                throw new SstDocsConfigError(`${path}.${key} must be an object in ${sourcePath}`);
+            }
+            targetRecord[key] = { ...current };
+            mergeThemeFragments(targetRecord[key], value, sourcePath, `${path}.${key}`);
+            continue;
+        }
+        if (typeof value !== "string") {
+            throw new SstDocsConfigError(`${path}.${key} must be a string in ${sourcePath}`);
+        }
+        targetRecord[key] = value;
+    }
+}
+function cloneTheme(theme) {
+    return JSON.parse(JSON.stringify(theme));
+}
 //# sourceMappingURL=sstDocsConfig.js.map

package/dist/configs/sstDocsConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"sstDocsConfig.js","sourceRoot":"","sources":["../../src/configs/sstDocsConfig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sstDocsConfig.js","sourceRoot":"","sources":["../../src/configs/sstDocsConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AASpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,CAAC;AAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;AAC9B,MAAM,IAAI,GAAG,OAAO,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAmB;IAEnB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,yBAAyB,CACnE,oBAAoB,CAAC,UAAU,CAAC,EAChC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CACzC,CAAC;IACF,OAAO,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAmB;IAEnB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,6BAA6B,CACjE,oBAAoB,CAAC,UAAU,CAAC,EAChC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAC7C,CAAC;IACF,OAAO,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,UAAkB;IAElB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,wBAAwB,KAAM,KAAe,CAAC,OAAO,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CACtB,KAAc,EACd,UAAkB;IAElB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,UAAU,sBAAsB,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,KAAmC,CAAC;IAChD,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,UAAU,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAC1B,mCAAmC,UAAU,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,UAAU;QACxB,gBAAgB,EAAE,oBAAoB,CAAC,UAAU,CAAC;QAClD,eAAe,EAAE,uBAAuB,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC;QACzE,uBAAuB,EAAE,8BAA8B,CACrD,GAAG,CAAC,uBAAuB,EAC3B,UAAU,CACX;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB;IAEjB,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IAC9D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAAiB;IAEjB,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IAC9D,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,WAAqB,EACrB,MAA8C;IAE9C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,6BAA6B,CACpC,WAAqB,EACrB,MAAqC;IAErC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAmB;IAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,IAAI,GAAI,KAA2C,EAAE,IAAI,CAAC;IAChE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB,EAAE,KAAc;IACtD,MAAM,OAAO,GAAI,KAA2B,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,kBAAkB,CAC3B,kBAAkB,wBAAwB,OAAO,SAAS,KAAK,OAAO,EAAE,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAmB;IAC7C,OAAO,IAAI,kBAAkB,CAC3B,oBAAoB,wBAAwB,YAAY,SAAS,CAAC,IAAI,CACpE,IAAI,CACL,EAAE,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CAC1B,wCAAwC,UAAU,EAAE,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAgC,CAAC;IAExE,OAAO;QACL,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC;QAChE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC;QAChE,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,GAAW,EACX,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,GAAG,wBAAwB,UAAU,EAAE,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,8BAA8B,CACrC,KAAc,EACd,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,gDAAgD,UAAU,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,EACJ,gBAAgB,EAChB,KAAK,EACL,iCAAiC,GAClC,GAAG,KAAgC,CAAC;IAErC,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,gEAAgE,UAAU,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,kBAAkB,CAC1B,+DAA+D,UAAU,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD,UAAU,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,IACE,iCAAiC,KAAK,SAAS;QAC/C,OAAO,iCAAiC,KAAK,SAAS,EACtD,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,kFAAkF,UAAU,EAAE,CAC/F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAEnE,OAAO;QACL,gBAAgB,EAAE,eAAe;QACjC,KAAK,EAAE,aAAa;QACpB,iCAAiC,EAC9B,iCAAyD,IAAI,KAAK;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAc,EACd,UAAkB;IAElB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,oBAAoB,CACzB,KAAK,EACL,UAAU,EACV,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,+DAA+D,UAAU,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,KAAgC,CAAC;IAErD,IAAI,aAAa,GAAoB,oBAAoB,CAAC;IAC1D,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,aAAa,GAAG,qBAAqB,CACnC,WAAW,CAAC,MAAM,EAClB,UAAU,EACV,sCAAsC,CACvC,CAAC;IACJ,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,aAAa,GAAG,qBAAqB,CACnC,WAAW,CAAC,MAAM,EAClB,UAAU,EACV,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACrC,OAAO,SAAS,CAAC,MAAM,CAAC;IACxB,OAAO,SAAS,CAAC,MAAM,CAAC;IAExB,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5D,OAAO,mBAAmB,CACxB,SAAS,EACT,SAA2B,EAC3B,UAAU,CACX,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAgC,EAChC,UAAkB,EAClB,YAAoB;IAEpB,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAY,EACZ,UAAkB,EAClB,YAAoB;IAEpB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,IAAI,kBAAkB,CAC1B,GAAG,YAAY,oBAAoB,OAAO,OAAO,UAAU,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,IAAI,kBAAkB,CAC1B,WAAW,YAAY,KAAK,GAAG,QAAQ,UAAU,wBAAwB,OAAO,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAiB,EACjB,SAAyB,EACzB,UAAkB;IAElB,mBAAmB,CACjB,KAAK,EACL,SAAS,EACT,UAAU,EACV,+BAA+B,CAChC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAe,EACf,SAAkC,EAClC,UAAkB,EAClB,IAAY;IAEZ,MAAM,YAAY,GAAG,MAAiC,CAAC;IAEvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAC1B,GAAG,IAAI,IAAI,GAAG,uCAAuC,UAAU,EAAE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAElC,IACE,OAAO;YACP,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EACvB,CAAC;YACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,kBAAkB,CAC1B,GAAG,IAAI,IAAI,GAAG,yBAAyB,UAAU,EAAE,CACpD,CAAC;YACJ,CAAC;YAED,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,OAAmC,EAAE,CAAC;YAChE,mBAAmB,CACjB,YAAY,CAAC,GAAG,CAAC,EACjB,KAAgC,EAChC,UAAU,EACV,GAAG,IAAI,IAAI,GAAG,EAAE,CACjB,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,kBAAkB,CAC1B,GAAG,IAAI,IAAI,GAAG,wBAAwB,UAAU,EAAE,CACnD,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAe,CAAC;AACzD,CAAC"}

package/dist/configs/sstDocsConfig.shared.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedSstDocsConfig } from "../types/SstDocsConfig.js";
+export declare const SST_DOCS_CONFIG_FILENAME = "sst-docs.config.json";
+export declare class SstDocsConfigError extends Error {
+    constructor(message: string);
+}
+export declare function derivePublicDataPath(fsDataPath: string): string;
+export declare function resolvePublicDataPath(baseUrl: string | undefined, config: Pick<ResolvedSstDocsConfig, "PUBLIC_DATA_PATH"> | string): string;
+//# sourceMappingURL=sstDocsConfig.shared.d.ts.map

package/dist/configs/sstDocsConfig.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sstDocsConfig.shared.d.ts","sourceRoot":"","sources":["../../src/configs/sstDocsConfig.shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6B/D;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,GAAG,MAAM,GAC/D,MAAM,CAuBR"}