@shadow-shard-tools/docs-core 1.0.0 → 1.0.3

package/dist/data/fsDataProvider.d.ts

@@ -0,0 +1,6 @@
+import type { DataProvider } from "../index.js";
+export declare class FileSystemProvider implements DataProvider {
+    readJson<T>(absPath: string): Promise<T>;
+    fileExists(absPath: string): Promise<boolean>;
+}
+//# sourceMappingURL=fsDataProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fsDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,kBAAmB,YAAW,YAAY;IAC/C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CASpD"}

package/dist/data/fsDataProvider.js

@@ -0,0 +1,20 @@
+import { readFile, access } from "node:fs/promises";
+import { constants } from "node:fs";
+export class FileSystemProvider {
+    async readJson(absPath) {
+        const contents = await readFile(absPath, "utf8");
+        return JSON.parse(contents);
+    }
+    async fileExists(absPath) {
+        try {
+            await access(absPath, constants.F_OK);
+            return true;
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return false;
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=fsDataProvider.js.map

package/dist/data/fsDataProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsDataProvider.js","sourceRoot":"","sources":["../../src/data/fsDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,QAAQ,CAAI,OAAe;QAC/B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACnE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/data/httpDataProvider.d.ts

@@ -0,0 +1,5 @@
+import type { DataProvider } from "../index.js";
+export declare class httpDataProvider implements DataProvider {
+    readJson<T>(absUrl: string): Promise<T>;
+}
+//# sourceMappingURL=httpDataProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"httpDataProvider.d.ts","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,gBAAiB,YAAW,YAAY;IAC7C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ9C"}

package/dist/data/httpDataProvider.js

@@ -0,0 +1,9 @@
+export class httpDataProvider {
+    async readJson(absUrl) {
+        const res = await fetch(absUrl);
+        if (!res.ok)
+            throw new Error(`Failed to fetch ${absUrl}: ${res.status} ${res.statusText}`);
+        return res.json();
+    }
+}
+//# sourceMappingURL=httpDataProvider.js.map

package/dist/data/httpDataProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpDataProvider.js","sourceRoot":"","sources":["../../src/data/httpDataProvider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,QAAQ,CAAI,MAAc;QAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,EAAE;YACT,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAC7D,CAAC;QACJ,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+export default copyToClipboard;
+//# sourceMappingURL=copyToClipboard.d.ts.map

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

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

package/dist/utilities/dom/copyToClipboard.js

@@ -0,0 +1,22 @@
+export const copyToClipboard = async (text) => {
+    try {
+        await navigator.clipboard.writeText(text);
+        return true;
+    }
+    catch {
+        // Fallback for older browsers
+        const textarea = document.createElement("textarea");
+        textarea.value = text;
+        document.body.appendChild(textarea);
+        textarea.select();
+        try {
+            const success = document.execCommand("copy");
+            return success;
+        }
+        finally {
+            document.body.removeChild(textarea);
+        }
+    }
+};
+export default copyToClipboard;
+//# sourceMappingURL=copyToClipboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copyToClipboard.js","sourceRoot":"","sources":["../../../src/utilities/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACtE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/utilities/dom/downloadTextFile.d.ts

@@ -0,0 +1,3 @@
+export declare const downloadTextFile: (content: string, filename: string, mimeType?: string) => void;
+export default downloadTextFile;
+//# sourceMappingURL=downloadTextFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloadTextFile.d.ts","sourceRoot":"","sources":["../../../src/utilities/dom/downloadTextFile.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,WAAU,MAAqB,KAC9B,IAkBF,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/utilities/dom/downloadTextFile.js

@@ -0,0 +1,20 @@
+import { sanitizeFilename } from "../string/sanitizeFilename.js";
+export const downloadTextFile = (content, filename, mimeType = "text/plain") => {
+    try {
+        const blob = new Blob([content], { type: mimeType });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = sanitizeFilename(filename);
+        link.style.display = "none";
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        setTimeout(() => URL.revokeObjectURL(url), 100);
+    }
+    catch (error) {
+        console.error("Failed to download file:", error);
+    }
+};
+export default downloadTextFile;
+//# sourceMappingURL=downloadTextFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloadTextFile.js","sourceRoot":"","sources":["../../../src/utilities/dom/downloadTextFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAe,EACf,QAAgB,EAChB,WAAmB,YAAY,EACzB,EAAE;IACR,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAE5B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/utilities/index.d.ts

@@ -2,16 +2,19 @@ export { slugify } from "./string/slugify.js";
 export { sanitizeFilename } from "./string/sanitizeFilename.js";
 export { extractYouTubeId } from "./string/extractYouTubeId.js";
 export { withBasePath } from "./string/withBasePath.js";
-export { copyToClipboard } from "./file/copyToClipboard.js";
-export { downloadTextFile } from "./file/downloadTextFile.js";
+export { processListItems } from "./string/processListItems.js";
 export { getFileExtension } from "./file/getFileExtension.js";
+export { resolveDataPath } from "./path/resolveDataPath.js";
+export { resolveAgainstProjectRoot } from "./path/resolveAgainstProjectRoot.js";
 export { createTimeout } from "./system/createTimeout.js";
 export { formatTime } from "./system/formatTime.js";
+export { createLogger } from "./system/logger.js";
 export { isMobileDevice } from "./validation/isMobileDevice.js";
 export { isValidColor } from "./validation/isValidColor.js";
 export { isValidImageUrl } from "./validation/isValidImageUrl.js";
 export { isValidYouTubeId } from "./validation/isValidYouTubeId.js";
 export { validateScale } from "./validation/validateScale.js";
 export { getResponsiveWidth } from "./dom/getResponsiveWidth.js";
-export { processListItems } from "./dom/processListItems.js";
+export { copyToClipboard } from "./dom/copyToClipboard.js";
+export { downloadTextFile } from "./dom/downloadTextFile.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utilities/index.js

@@ -3,13 +3,16 @@ export { slugify } from "./string/slugify.js";
 export { sanitizeFilename } from "./string/sanitizeFilename.js";
 export { extractYouTubeId } from "./string/extractYouTubeId.js";
 export { withBasePath } from "./string/withBasePath.js";
+export { processListItems } from "./string/processListItems.js";
 // file
-export { copyToClipboard } from "./file/copyToClipboard.js";
-export { downloadTextFile } from "./file/downloadTextFile.js";
 export { getFileExtension } from "./file/getFileExtension.js";
+//path
+export { resolveDataPath } from "./path/resolveDataPath.js";
+export { resolveAgainstProjectRoot } from "./path/resolveAgainstProjectRoot.js";
 // system
 export { createTimeout } from "./system/createTimeout.js";
 export { formatTime } from "./system/formatTime.js";
+export { createLogger } from "./system/logger.js";
 // validation
 export { isMobileDevice } from "./validation/isMobileDevice.js";
 export { isValidColor } from "./validation/isValidColor.js";
@@ -18,5 +21,6 @@ export { isValidYouTubeId } from "./validation/isValidYouTubeId.js";
 export { validateScale } from "./validation/validateScale.js";
 // dom
 export { getResponsiveWidth } from "./dom/getResponsiveWidth.js";
-export { processListItems } from "./dom/processListItems.js";
+export { copyToClipboard } from "./dom/copyToClipboard.js";
+export { downloadTextFile } from "./dom/downloadTextFile.js";
 //# sourceMappingURL=index.js.map

package/dist/utilities/index.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAgainstProjectRoot.d.ts","sourceRoot":"","sources":["../../../src/utilities/path/resolveAgainstProjectRoot.ts"],"names":[],"mappings":"AAGA,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAInE"}

package/dist/utilities/path/resolveAgainstProjectRoot.js

@@ -0,0 +1,8 @@
+import path from "node:path";
+import appRoot from "app-root-path";
+export function resolveAgainstProjectRoot(candidate) {
+    return path.isAbsolute(candidate)
+        ? candidate
+        : path.join(appRoot.path, candidate);
+}
+//# sourceMappingURL=resolveAgainstProjectRoot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAgainstProjectRoot.js","sourceRoot":"","sources":["../../../src/utilities/path/resolveAgainstProjectRoot.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDataPath.d.ts","sourceRoot":"","sources":["../../../src/utilities/path/resolveDataPath.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQtD"}

package/dist/utilities/path/resolveDataPath.js

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

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

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

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

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

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

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

package/dist/utilities/string/normalizeDir.js

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

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

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

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

@@ -0,0 +1,3 @@
+export declare const processListItems: (items?: string[]) => string[];
+export default processListItems;
+//# sourceMappingURL=processListItems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processListItems.d.ts","sourceRoot":"","sources":["../../../src/utilities/string/processListItems.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,KAAG,MAAM,EAIzD,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/utilities/string/processListItems.js

@@ -0,0 +1,7 @@
+export const processListItems = (items) => {
+    return (items ?? [])
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+};
+export default processListItems;
+//# sourceMappingURL=processListItems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processListItems.js","sourceRoot":"","sources":["../../../src/utilities/string/processListItems.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAgB,EAAY,EAAE;IAC7D,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/utilities/system/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare const createLogger: (scope: string) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utilities/system/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utilities/system/logger.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAKD,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAyB5C,CAAC"}

package/dist/utilities/system/logger.js

@@ -0,0 +1,37 @@
+import { stdout, stderr } from "node:process";
+const levelWeights = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+function format(scope, level, message) {
+    return `[${scope}] ${level.toUpperCase()}: ${message}`;
+}
+const defaultLevel = process.env.HTML_GENERATOR_LOG_LEVEL ?? "info";
+export const createLogger = (scope) => {
+    const minWeight = levelWeights[defaultLevel];
+    return {
+        debug(message) {
+            if (levelWeights.debug >= minWeight) {
+                stdout.write(`${format(scope, "debug", message)}\n`);
+            }
+        },
+        info(message) {
+            if (levelWeights.info >= minWeight) {
+                stdout.write(`${format(scope, "info", message)}\n`);
+            }
+        },
+        warn(message) {
+            if (levelWeights.warn >= minWeight) {
+                stderr.write(`${format(scope, "warn", message)}\n`);
+            }
+        },
+        error(message) {
+            if (levelWeights.error >= minWeight) {
+                stderr.write(`${format(scope, "error", message)}\n`);
+            }
+        },
+    };
+};
+//# sourceMappingURL=logger.js.map

package/dist/utilities/system/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utilities/system/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,YAAY,GAA6B;IAC7C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,SAAS,MAAM,CAAC,KAAa,EAAE,KAAe,EAAE,OAAe;IAC7D,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;AACzD,CAAC;AASD,MAAM,YAAY,GACf,OAAO,CAAC,GAAG,CAAC,wBAAiD,IAAI,MAAM,CAAC;AAE3E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK,CAAC,OAAe;YACnB,IAAI,YAAY,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAe;YAClB,IAAI,YAAY,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAe;YAClB,IAAI,YAAY,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,OAAe;YACnB,IAAI,YAAY,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadow-shard-tools/docs-core",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Shared configs, types, and utilities for SST Docs modules and applications.",
   "license": "MIT",
   "type": "module",
@@ -86,7 +86,9 @@
     "shared",
     "types"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "app-root-path": "^3.1.0"
+  },
   "devDependencies": {
     "@types/node": "^20.12.7",
     "rimraf": "^5.0.5",
@@ -94,16 +96,36 @@
   },
   "typesVersions": {
     "*": {
-      "configs": ["dist/configs/index.d.ts"],
-      "configs/*": ["dist/configs/*.d.ts"],
-      "data": ["dist/data/index.d.ts"],
-      "data/*": ["dist/data/*.d.ts"],
-      "themes": ["dist/themes/index.d.ts"],
-      "themes/*": ["dist/themes/*.d.ts"],
-      "types": ["dist/types/index.d.ts"],
-      "types/*": ["dist/types/*.d.ts"],
-      "utilities": ["dist/utilities/index.d.ts"],
-      "utilities/*": ["dist/utilities/*.d.ts"]
+      "configs": [
+        "dist/configs/index.d.ts"
+      ],
+      "configs/*": [
+        "dist/configs/*.d.ts"
+      ],
+      "data": [
+        "dist/data/index.d.ts"
+      ],
+      "data/*": [
+        "dist/data/*.d.ts"
+      ],
+      "themes": [
+        "dist/themes/index.d.ts"
+      ],
+      "themes/*": [
+        "dist/themes/*.d.ts"
+      ],
+      "types": [
+        "dist/types/index.d.ts"
+      ],
+      "types/*": [
+        "dist/types/*.d.ts"
+      ],
+      "utilities": [
+        "dist/utilities/index.d.ts"
+      ],
+      "utilities/*": [
+        "dist/utilities/*.d.ts"
+      ]
     }
   }
 }