@stego-labs/shared 1.0.1 → 1.0.3

package/dist/contracts/cli/operations.d.ts

@@ -1,2 +1,2 @@
-export type CliOperation = "init" | "list-projects" | "new-project" | "new" | "validate" | "build" | "check-stage" | "lint" | "export" | "spine.read" | "spine.new-category" | "spine.new" | "metadata.read" | "metadata.apply" | "comments.read" | "comments.add" | "comments.reply" | "comments.set-status" | "comments.delete" | "comments.clear-resolved" | "comments.sync-anchors";
+export type CliOperation = "init" | "list-projects" | "new-project" | "new" | "validate" | "build" | "check-stage" | "lint" | "export" | "content.read" | "metadata.read" | "metadata.apply" | "comments.read" | "comments.add" | "comments.reply" | "comments.set-status" | "comments.delete" | "comments.clear-resolved" | "comments.sync-anchors";
 //# sourceMappingURL=operations.d.ts.map

package/dist/contracts/cli/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/operations.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,aAAa,GACb,KAAK,GACL,UAAU,GACV,OAAO,GACP,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,oBAAoB,GACpB,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,CAAC"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/contracts/cli/operations.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,aAAa,GACb,KAAK,GACL,UAAU,GACV,OAAO,GACP,aAAa,GACb,MAAM,GACN,QAAQ,GACR,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,CAAC"}

package/dist/domain/content/index.d.ts

@@ -0,0 +1,36 @@
+import { type FrontmatterRecord } from "../frontmatter/index.ts";
+export type LeafFormat = "markdown" | "plaintext";
+export type LeafHeadingTarget = {
+    text: string;
+    anchor: string;
+    line: number;
+};
+export type BranchMetadata = {
+    label?: string;
+};
+export type ParsedBranchDocument = {
+    metadata: BranchMetadata;
+    body: string;
+};
+export declare const BRANCH_FILENAME = "_branch.md";
+export declare const LEAF_ID_PATTERN: RegExp;
+export declare function isValidLeafId(value: string): boolean;
+export declare function inferLeafFormat(filePath: string): LeafFormat;
+export declare function isBranchFile(filePath: string): boolean;
+export declare function isSupportedLeafContentFile(filePath: string): boolean;
+export declare function buildBranchKey(contentRoot: string, dirPath: string): string;
+export declare function buildBranchName(dirPath: string): string;
+export declare function buildBranchParentKey(key: string): string | undefined;
+export declare function buildBranchLabel(name: string, metadataLabel?: string): string;
+export declare function parseBranchDocument(raw: string, filePath?: string): ParsedBranchDocument;
+export declare function validateBranchFrontmatter(frontmatter: FrontmatterRecord, filePath?: string): BranchMetadata;
+export declare function slugifyLeafHeading(value: string): string;
+export declare function buildLeafRootAnchor(leafId: string): string;
+export declare function buildLeafHeadingAnchor(leafId: string, slug: string): string;
+export declare function collectLeafHeadingTargets(body: string, leafId: string): LeafHeadingTarget[];
+export declare function injectLeafHeadingAnchors(body: string, leafId: string): string;
+export declare function findLeafHeadingTarget(headings: LeafHeadingTarget[], headingText: string): {
+    target?: LeafHeadingTarget;
+    ambiguous?: boolean;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/content/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,eAAe,QAAwC,CAAC;AAErE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAM5D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASpE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASpE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAkB,GAAG,oBAAoB,CAcjG;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,SAAkB,GACzB,cAAc,CAgBhB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA+B3F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAyB7E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,WAAW,EAAE,MAAM,GAClB;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAUrD"}

package/dist/domain/content/index.js

@@ -0,0 +1,166 @@
+import path from "node:path";
+import { parseMarkdownDocument } from "../frontmatter/index.js";
+export const BRANCH_FILENAME = "_branch.md";
+export const LEAF_ID_PATTERN = /^[A-Z][A-Z0-9]*-[A-Z0-9][A-Z0-9-]*$/;
+export function isValidLeafId(value) {
+    return LEAF_ID_PATTERN.test(value.trim());
+}
+export function inferLeafFormat(filePath) {
+    const normalized = filePath.toLowerCase();
+    if (normalized.endsWith(".md") || normalized.endsWith(".markdown")) {
+        return "markdown";
+    }
+    return "plaintext";
+}
+export function isBranchFile(filePath) {
+    return path.basename(filePath).toLowerCase() === BRANCH_FILENAME;
+}
+export function isSupportedLeafContentFile(filePath) {
+    const normalized = filePath.toLowerCase();
+    if (isBranchFile(normalized)) {
+        return false;
+    }
+    return normalized.endsWith(".md")
+        || normalized.endsWith(".markdown")
+        || normalized.endsWith(".txt")
+        || normalized.endsWith(".text");
+}
+export function buildBranchKey(contentRoot, dirPath) {
+    const relative = path.relative(path.resolve(contentRoot), path.resolve(dirPath));
+    if (!relative || relative === ".") {
+        return "";
+    }
+    return relative.split(path.sep).join("/");
+}
+export function buildBranchName(dirPath) {
+    return path.basename(path.resolve(dirPath));
+}
+export function buildBranchParentKey(key) {
+    if (!key) {
+        return undefined;
+    }
+    const slashIndex = key.lastIndexOf("/");
+    if (slashIndex === -1) {
+        return "";
+    }
+    return key.slice(0, slashIndex);
+}
+export function buildBranchLabel(name, metadataLabel) {
+    const explicit = metadataLabel?.trim();
+    if (explicit) {
+        return explicit;
+    }
+    return toTitleCase(name);
+}
+export function parseBranchDocument(raw, filePath = BRANCH_FILENAME) {
+    let parsed;
+    try {
+        parsed = parseMarkdownDocument(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Branch file '${filePath}' has invalid frontmatter: ${message}`);
+    }
+    const metadata = validateBranchFrontmatter(parsed.frontmatter, filePath);
+    return {
+        metadata,
+        body: parsed.body.trim()
+    };
+}
+export function validateBranchFrontmatter(frontmatter, filePath = BRANCH_FILENAME) {
+    const allowedKeys = new Set(["label"]);
+    for (const key of Object.keys(frontmatter)) {
+        if (!allowedKeys.has(key)) {
+            throw new Error(`Branch file '${filePath}' has unsupported frontmatter key '${key}'. Only 'label' is allowed.`);
+        }
+    }
+    const rawLabel = frontmatter.label;
+    if (rawLabel == null) {
+        return {};
+    }
+    if (typeof rawLabel !== "string" || rawLabel.trim().length === 0) {
+        throw new Error(`Branch file '${filePath}' must define 'label' as a non-empty string.`);
+    }
+    return { label: rawLabel.trim() };
+}
+export function slugifyLeafHeading(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .trim()
+        .replace(/\s+/g, "-");
+}
+export function buildLeafRootAnchor(leafId) {
+    return leafId;
+}
+export function buildLeafHeadingAnchor(leafId, slug) {
+    return `${leafId}--${slug}`;
+}
+export function collectLeafHeadingTargets(body, leafId) {
+    const lines = body.split(/\r?\n/);
+    const counts = new Map();
+    const headings = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const match = lines[index].match(/^#{1,6}\s+(.+?)\s*(?:\{#([^}]+)\})?\s*$/);
+        if (!match) {
+            continue;
+        }
+        const text = match[1].trim();
+        const explicitAnchor = match[2]?.trim();
+        const slugBase = explicitAnchor || slugifyLeafHeading(text);
+        if (!slugBase) {
+            continue;
+        }
+        const seen = counts.get(slugBase) || 0;
+        const occurrence = seen + 1;
+        counts.set(slugBase, occurrence);
+        const slug = occurrence === 1 ? slugBase : `${slugBase}-${occurrence}`;
+        headings.push({
+            text,
+            anchor: buildLeafHeadingAnchor(leafId, slug),
+            line: index + 1
+        });
+    }
+    return headings;
+}
+export function injectLeafHeadingAnchors(body, leafId) {
+    const lines = body.split(/\r?\n/);
+    const counts = new Map();
+    return lines.map((line) => {
+        const match = line.match(/^(#{1,6}\s+)(.+?)\s*(?:\{#([^}]+)\})?\s*$/);
+        if (!match) {
+            return line;
+        }
+        const prefix = match[1];
+        const text = match[2].trim();
+        const explicitAnchor = match[3]?.trim();
+        const slugBase = explicitAnchor || slugifyLeafHeading(text);
+        if (!slugBase) {
+            return `${prefix}${text}`;
+        }
+        const seen = counts.get(slugBase) || 0;
+        const occurrence = seen + 1;
+        counts.set(slugBase, occurrence);
+        const slug = occurrence === 1 ? slugBase : `${slugBase}-${occurrence}`;
+        return `${prefix}${text} {#${buildLeafHeadingAnchor(leafId, slug)}}`;
+    }).join("\n");
+}
+export function findLeafHeadingTarget(headings, headingText) {
+    const normalized = headingText.trim().replace(/\s+/g, " ").toLowerCase();
+    const matches = headings.filter((entry) => entry.text.trim().replace(/\s+/g, " ").toLowerCase() === normalized);
+    if (matches.length === 0) {
+        return {};
+    }
+    if (matches.length > 1) {
+        return { ambiguous: true };
+    }
+    return { target: matches[0] };
+}
+function toTitleCase(value) {
+    const normalized = value.replace(/[-_]+/g, " ").trim();
+    if (!normalized) {
+        return value;
+    }
+    return normalized.replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+//# sourceMappingURL=index.js.map

package/dist/domain/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/content/index.ts"],"names":[],"mappings":"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"}

package/dist/domain/layout/docx-layout.d.ts

@@ -0,0 +1,16 @@
+export type DocxLayoutAlign = "left" | "center" | "right";
+export type DocxBlockLayoutSpec = {
+    bookmarkName: string;
+    pageBreak?: boolean;
+    spaceBefore?: string;
+    spaceAfter?: string;
+    insetLeft?: string;
+    insetRight?: string;
+    firstLineIndent?: string;
+    align?: DocxLayoutAlign;
+    keepTogether?: boolean;
+};
+export declare const DOCX_LAYOUT_BOOKMARK_PREFIX = "stego-layout-";
+export declare function createDocxLayoutBookmarkName(index: number): string;
+export declare function isDocxLayoutBookmarkName(value: string | null | undefined): value is string;
+//# sourceMappingURL=docx-layout.d.ts.map

package/dist/domain/layout/docx-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-layout.d.ts","sourceRoot":"","sources":["../../../src/domain/layout/docx-layout.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAE1F"}

package/dist/domain/layout/docx-layout.js

@@ -0,0 +1,8 @@
+export const DOCX_LAYOUT_BOOKMARK_PREFIX = "stego-layout-";
+export function createDocxLayoutBookmarkName(index) {
+    return `${DOCX_LAYOUT_BOOKMARK_PREFIX}${index}`;
+}
+export function isDocxLayoutBookmarkName(value) {
+    return typeof value === "string" && value.startsWith(DOCX_LAYOUT_BOOKMARK_PREFIX);
+}
+//# sourceMappingURL=docx-layout.js.map

package/dist/domain/layout/docx-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-layout.js","sourceRoot":"","sources":["../../../src/domain/layout/docx-layout.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE3D,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,GAAG,2BAA2B,GAAG,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAgC;IACvE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACpF,CAAC"}

package/dist/domain/layout/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./docx-layout.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/domain/layout/index.js

@@ -0,0 +1,2 @@
+export * from "./docx-layout.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/domain/templates/index.d.ts

@@ -0,0 +1,49 @@
+export declare const EXPORT_TARGETS: readonly ["md", "docx", "pdf", "epub"];
+export declare const PRESENTATION_TARGETS: readonly ["docx", "pdf", "epub"];
+export type ExportTarget = (typeof EXPORT_TARGETS)[number];
+export type PresentationTarget = (typeof PRESENTATION_TARGETS)[number];
+export declare const TARGET_CAPABILITIES: {
+    readonly docx: {
+        readonly pageLayout: true;
+        readonly pageTemplate: true;
+        readonly pageNumber: true;
+        readonly keepTogether: true;
+        readonly pageBreak: true;
+        readonly spacing: true;
+        readonly inset: true;
+        readonly indent: true;
+        readonly align: true;
+        readonly imageAlign: true;
+        readonly imageLayout: true;
+    };
+    readonly pdf: {
+        readonly pageLayout: true;
+        readonly pageTemplate: true;
+        readonly pageNumber: true;
+        readonly keepTogether: true;
+        readonly pageBreak: true;
+        readonly spacing: true;
+        readonly inset: true;
+        readonly indent: true;
+        readonly align: true;
+        readonly imageAlign: true;
+        readonly imageLayout: true;
+    };
+    readonly epub: {
+        readonly pageLayout: false;
+        readonly pageTemplate: false;
+        readonly pageNumber: false;
+        readonly keepTogether: false;
+        readonly pageBreak: false;
+        readonly spacing: false;
+        readonly inset: false;
+        readonly indent: false;
+        readonly align: false;
+        readonly imageAlign: false;
+        readonly imageLayout: false;
+    };
+};
+export type TemplateCapability = keyof (typeof TARGET_CAPABILITIES)["docx"];
+export declare function isExportTarget(value: string): value is ExportTarget;
+export declare function isPresentationTarget(value: string): value is PresentationTarget;
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/templates/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,wCAAyC,CAAC;AACrE,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AAErE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E"}

package/dist/domain/templates/index.js

@@ -0,0 +1,50 @@
+export const EXPORT_TARGETS = ["md", "docx", "pdf", "epub"];
+export const PRESENTATION_TARGETS = ["docx", "pdf", "epub"];
+export const TARGET_CAPABILITIES = {
+    docx: {
+        pageLayout: true,
+        pageTemplate: true,
+        pageNumber: true,
+        keepTogether: true,
+        pageBreak: true,
+        spacing: true,
+        inset: true,
+        indent: true,
+        align: true,
+        imageAlign: true,
+        imageLayout: true
+    },
+    pdf: {
+        pageLayout: true,
+        pageTemplate: true,
+        pageNumber: true,
+        keepTogether: true,
+        pageBreak: true,
+        spacing: true,
+        inset: true,
+        indent: true,
+        align: true,
+        imageAlign: true,
+        imageLayout: true
+    },
+    epub: {
+        pageLayout: false,
+        pageTemplate: false,
+        pageNumber: false,
+        keepTogether: false,
+        pageBreak: false,
+        spacing: false,
+        inset: false,
+        indent: false,
+        align: false,
+        imageAlign: false,
+        imageLayout: false
+    }
+};
+export function isExportTarget(value) {
+    return EXPORT_TARGETS.includes(value);
+}
+export function isPresentationTarget(value) {
+    return PRESENTATION_TARGETS.includes(value);
+}
+//# sourceMappingURL=index.js.map

package/dist/domain/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/templates/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAKrE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE;QACJ,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;KAClB;IACD,GAAG,EAAE;QACH,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;KAClB;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,KAAK;KACnB;CACO,CAAC;AAIX,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -4,5 +4,8 @@ export * as CommentsDomain from "./domain/comments/index.ts";
 export * as StagesDomain from "./domain/stages/index.ts";
 export * as ProjectDomain from "./domain/project/index.ts";
 export * as ImagesDomain from "./domain/images/index.ts";
+export * as LayoutDomain from "./domain/layout/index.ts";
+export * as ContentDomain from "./domain/content/index.ts";
+export * as TemplatesDomain from "./domain/templates/index.ts";
 export * as SharedUtils from "./utils/index.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -4,5 +4,8 @@ export * as CommentsDomain from "./domain/comments/index.js";
 export * as StagesDomain from "./domain/stages/index.js";
 export * as ProjectDomain from "./domain/project/index.js";
 export * as ImagesDomain from "./domain/images/index.js";
+export * as LayoutDomain from "./domain/layout/index.js";
+export * as ContentDomain from "./domain/content/index.js";
+export * as TemplatesDomain from "./domain/templates/index.js";
 export * as SharedUtils from "./utils/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stego-labs/shared",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "Shared contracts and domain primitives for Stego packages.",
   "license": "Apache-2.0",
@@ -11,6 +11,10 @@
     "directory": "packages/shared"
   },
   "homepage": "https://github.com/matt-gold/stego/tree/main/packages/shared#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "files": [
     "dist/**",
     "README.md"
@@ -28,6 +32,10 @@
       "types": "./dist/domain/comments/index.d.ts",
       "default": "./dist/domain/comments/index.js"
     },
+    "./domain/content": {
+      "types": "./dist/domain/content/index.d.ts",
+      "default": "./dist/domain/content/index.js"
+    },
     "./domain/frontmatter": {
       "types": "./dist/domain/frontmatter/index.d.ts",
       "default": "./dist/domain/frontmatter/index.js"
@@ -36,10 +44,18 @@
       "types": "./dist/domain/images/index.d.ts",
       "default": "./dist/domain/images/index.js"
     },
+    "./domain/layout": {
+      "types": "./dist/domain/layout/index.d.ts",
+      "default": "./dist/domain/layout/index.js"
+    },
     "./domain/project": {
       "types": "./dist/domain/project/index.d.ts",
       "default": "./dist/domain/project/index.js"
     },
+    "./domain/templates": {
+      "types": "./dist/domain/templates/index.d.ts",
+      "default": "./dist/domain/templates/index.js"
+    },
     "./domain/stages": {
       "types": "./dist/domain/stages/index.d.ts",
       "default": "./dist/domain/stages/index.js"
@@ -54,6 +70,9 @@
       "contracts/cli": [
         "dist/contracts/cli/index.d.ts"
       ],
+      "domain/content": [
+        "dist/domain/content/index.d.ts"
+      ],
       "domain/comments": [
         "dist/domain/comments/index.d.ts"
       ],
@@ -63,9 +82,15 @@
       "domain/images": [
         "dist/domain/images/index.d.ts"
       ],
+      "domain/layout": [
+        "dist/domain/layout/index.d.ts"
+      ],
       "domain/project": [
         "dist/domain/project/index.d.ts"
       ],
+      "domain/templates": [
+        "dist/domain/templates/index.d.ts"
+      ],
       "domain/stages": [
         "dist/domain/stages/index.d.ts"
       ],