canopycms 0.0.25 → 0.0.27

package/dist/entry-link-resolver.js

@@ -0,0 +1,226 @@
+/**
+ * Entry link resolution for body content.
+ *
+ * Resolves `entry:CONTENT_ID` patterns in markdown/MDX body text to actual URL paths.
+ * This extends the reference-by-ID pattern (already used for structured reference fields)
+ * to inline links in content bodies.
+ *
+ * Syntax:
+ *   [Link text](entry:vh2WdhwAFiSL)
+ *   [Link text](entry:vh2WdhwAFiSL#section-heading)
+ *
+ * Resolution skips fenced code blocks and inline code spans to avoid
+ * corrupting code examples.
+ */
+import { createDebugLogger } from './utils/debug.js';
+import { computeEntryUrl } from './utils/entry-url.js';
+const log = createDebugLogger({ prefix: 'EntryLinks' });
+/**
+ * Base58 alphabet pattern (matches content IDs).
+ * Excludes ambiguous characters: 0, O, I, l
+ */
+/** Base58 alphabet character class (excludes ambiguous: 0, O, I, l). */
+export const BASE58_CHAR = '[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]';
+/**
+ * Pattern matching `entry:CONTENT_ID` with optional anchor fragment.
+ * Uses the `g` flag — safe to share when used only with `.replace()`.
+ */
+export const ENTRY_LINK_PATTERN = new RegExp(`entry:(${BASE58_CHAR}{12})(#[^\\s)>"']*)?`, 'g');
+/**
+ * Compute a URL path from an entry's location in the content tree.
+ * Delegates to the shared `computeEntryUrl` utility.
+ */
+export function resolveEntryUrl(location, contentRoot) {
+    return computeEntryUrl(location.collection ?? '', location.slug ?? '', contentRoot);
+}
+/**
+ * Replace `entry:CONTENT_ID` patterns in text with resolved URL paths.
+ *
+ * Skips code blocks (fenced ``` and inline `code`) to avoid corrupting
+ * code examples that mention the entry: syntax.
+ *
+ * Missing IDs are replaced with "#" (dead link) and logged as warnings.
+ * Anchor fragments are preserved: entry:ID#heading => /path#heading
+ */
+export function resolveEntryLinksInText(text, idIndex, contentRoot, customResolver) {
+    // Split text into protected regions (code blocks/spans) and resolvable regions
+    const parts = splitByCodeRegions(text);
+    return parts
+        .map((part) => {
+        if (part.isCode)
+            return part.text;
+        return part.text.replace(ENTRY_LINK_PATTERN, (_match, id, anchor) => {
+            const location = idIndex.findById(id);
+            if (!location || location.type !== 'entry' || !location.collection || !location.slug) {
+                log.warn('resolve', `Entry link target not found: entry:${id}`);
+                return anchor ?? '#';
+            }
+            let url;
+            if (customResolver) {
+                url = customResolver({
+                    collection: location.collection,
+                    slug: location.slug,
+                    id,
+                });
+            }
+            else {
+                url = resolveEntryUrl(location, contentRoot);
+            }
+            return `${url}${anchor ?? ''}`;
+        });
+    })
+        .join('');
+}
+/** Quick-check pattern for early bail-out (no `g` flag, safe for `.test()`). */
+export const ENTRY_LINK_QUICK_CHECK = /entry:[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{12}/;
+/**
+ * Recursively resolve entry:ID patterns in all string values of a data object.
+ *
+ * This handles nested objects, arrays, and mixed structures — important for
+ * JSON entries where markdown fields live inside nested objects (e.g., hero.body).
+ *
+ * Returns the same object reference if nothing changed (structural sharing).
+ */
+export function resolveEntryLinksInData(data, idIndex, contentRoot, customResolver) {
+    if (typeof data === 'string') {
+        if (!ENTRY_LINK_QUICK_CHECK.test(data))
+            return data;
+        return resolveEntryLinksInText(data, idIndex, contentRoot, customResolver);
+    }
+    if (Array.isArray(data)) {
+        let changed = false;
+        const result = data.map((item) => {
+            const resolved = resolveEntryLinksInData(item, idIndex, contentRoot, customResolver);
+            if (resolved !== item)
+                changed = true;
+            return resolved;
+        });
+        return changed ? result : data;
+    }
+    if (data != null && typeof data === 'object') {
+        let changed = false;
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            const resolved = resolveEntryLinksInData(value, idIndex, contentRoot, customResolver);
+            result[key] = resolved;
+            if (resolved !== value)
+                changed = true;
+        }
+        return changed ? result : data;
+    }
+    return data;
+}
+/**
+ * Extract all entry link IDs from text (for validation, not resolution).
+ * Returns IDs found in entry:ID patterns, skipping code blocks.
+ */
+export function extractEntryLinkIds(text) {
+    const parts = splitByCodeRegions(text);
+    const results = [];
+    for (const part of parts) {
+        if (part.isCode)
+            continue;
+        const regex = new RegExp(ENTRY_LINK_PATTERN.source, 'g');
+        let match;
+        while ((match = regex.exec(part.text)) !== null) {
+            results.push({
+                id: match[1],
+                anchor: match[2] || undefined,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Split text into alternating code/non-code regions.
+ *
+ * Handles:
+ * - Fenced code blocks (``` or ~~~), including with language tags
+ * - Inline code spans (`code` and ``code``)
+ *
+ * This ensures entry:ID inside code is never resolved.
+ */
+function splitByCodeRegions(text) {
+    const parts = [];
+    let current = '';
+    let i = 0;
+    while (i < text.length) {
+        // Check for fenced code block (``` or ~~~)
+        if ((text[i] === '`' || text[i] === '~') &&
+            i + 2 < text.length &&
+            text[i + 1] === text[i] &&
+            text[i + 2] === text[i]) {
+            const fence = text[i];
+            // Count fence length (could be ``` or ```` etc.)
+            let fenceLen = 0;
+            while (i + fenceLen < text.length && text[i + fenceLen] === fence)
+                fenceLen++;
+            // Find end of opening fence line
+            const lineEnd = text.indexOf('\n', i + fenceLen);
+            if (lineEnd === -1) {
+                // No newline — rest of text is code block
+                if (current)
+                    parts.push({ text: current, isCode: false });
+                parts.push({ text: text.slice(i), isCode: true });
+                return parts;
+            }
+            // Find closing fence
+            const closingPattern = fence.repeat(fenceLen);
+            let closeStart = lineEnd + 1;
+            let found = false;
+            while (closeStart < text.length) {
+                const nextNewline = text.indexOf('\n', closeStart);
+                const lineContent = nextNewline === -1 ? text.slice(closeStart) : text.slice(closeStart, nextNewline);
+                if (lineContent.trim().startsWith(closingPattern)) {
+                    const endPos = nextNewline === -1 ? text.length : nextNewline + 1;
+                    if (current)
+                        parts.push({ text: current, isCode: false });
+                    current = '';
+                    parts.push({ text: text.slice(i, endPos), isCode: true });
+                    i = endPos;
+                    found = true;
+                    break;
+                }
+                if (nextNewline === -1)
+                    break;
+                closeStart = nextNewline + 1;
+            }
+            if (!found) {
+                // Unclosed code block — treat rest as code
+                if (current)
+                    parts.push({ text: current, isCode: false });
+                parts.push({ text: text.slice(i), isCode: true });
+                return parts;
+            }
+            continue;
+        }
+        // Check for inline code span (` or ``)
+        if (text[i] === '`') {
+            // Count opening backticks
+            let ticks = 0;
+            while (i + ticks < text.length && text[i + ticks] === '`')
+                ticks++;
+            // Find matching closing backticks
+            const closer = '`'.repeat(ticks);
+            const closeIdx = text.indexOf(closer, i + ticks);
+            if (closeIdx !== -1) {
+                if (current)
+                    parts.push({ text: current, isCode: false });
+                current = '';
+                parts.push({ text: text.slice(i, closeIdx + ticks), isCode: true });
+                i = closeIdx + ticks;
+                continue;
+            }
+            // No closing backticks — treat as regular text
+            current += text.slice(i, i + ticks);
+            i += ticks;
+            continue;
+        }
+        current += text[i];
+        i++;
+    }
+    if (current)
+        parts.push({ text: current, isCode: false });
+    return parts;
+}
+//# sourceMappingURL=entry-link-resolver.js.map

package/dist/entry-link-resolver.js.map

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

package/dist/schema/schema-store.d.ts

@@ -57,15 +57,15 @@ declare const entryTypeInputSchema: z.ZodObject<{
     name: string;
     format: "mdx" | "md" | "json";
     schema: string;
-    label?: string | undefined;
     default?: boolean | undefined;
+    label?: string | undefined;
     maxItems?: number | undefined;
 }, {
     name: string;
     format: "mdx" | "md" | "json";
     schema: string;
-    label?: string | undefined;
     default?: boolean | undefined;
+    label?: string | undefined;
     maxItems?: number | undefined;
 }>;
 declare const createCollectionInputSchema: z.ZodObject<{
@@ -83,15 +83,15 @@ declare const createCollectionInputSchema: z.ZodObject<{
         name: string;
         format: "mdx" | "md" | "json";
         schema: string;
-        label?: string | undefined;
         default?: boolean | undefined;
+        label?: string | undefined;
         maxItems?: number | undefined;
     }, {
         name: string;
         format: "mdx" | "md" | "json";
         schema: string;
-        label?: string | undefined;
         default?: boolean | undefined;
+        label?: string | undefined;
         maxItems?: number | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -99,8 +99,8 @@ declare const createCollectionInputSchema: z.ZodObject<{
         name: string;
         format: "mdx" | "md" | "json";
         schema: string;
-        label?: string | undefined;
         default?: boolean | undefined;
+        label?: string | undefined;
         maxItems?: number | undefined;
     }[];
     name: string;
@@ -111,8 +111,8 @@ declare const createCollectionInputSchema: z.ZodObject<{
         name: string;
         format: "mdx" | "md" | "json";
         schema: string;
-        label?: string | undefined;
         default?: boolean | undefined;
+        label?: string | undefined;
         maxItems?: number | undefined;
     }[];
     name: string;
@@ -126,14 +126,14 @@ declare const updateCollectionInputSchema: z.ZodObject<{
     order: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
+    slug?: string | undefined;
     label?: string | undefined;
     order?: string[] | undefined;
-    slug?: string | undefined;
 }, {
     name?: string | undefined;
+    slug?: string | undefined;
     label?: string | undefined;
     order?: string[] | undefined;
-    slug?: string | undefined;
 }>;
 declare const updateEntryTypeInputSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
@@ -142,16 +142,16 @@ declare const updateEntryTypeInputSchema: z.ZodObject<{
     default: z.ZodOptional<z.ZodBoolean>;
     maxItems: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    default?: boolean | undefined;
     label?: string | undefined;
     format?: "mdx" | "md" | "json" | undefined;
     schema?: string | undefined;
-    default?: boolean | undefined;
     maxItems?: number | undefined;
 }, {
+    default?: boolean | undefined;
     label?: string | undefined;
     format?: "mdx" | "md" | "json" | undefined;
     schema?: string | undefined;
-    default?: boolean | undefined;
     maxItems?: number | undefined;
 }>;
 export declare class SchemaOps {

package/dist/server.d.ts

@@ -14,4 +14,7 @@ export { buildContentTree } from './content-tree';
 export type { ContentTreeNode, BuildContentTreeOptions, ContentTreeExtractMeta, } from './content-tree';
 export { listEntries } from './content-listing';
 export type { ListEntriesItem, ListEntriesOptions } from './content-listing';
+export { resolveEntryUrl, resolveEntryLinksInText, resolveEntryLinksInData, extractEntryLinkIds, } from './entry-link-resolver';
+export type { EntryLinkUrlResolver } from './entry-link-resolver';
+export { computeEntryUrl } from './utils/entry-url';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClE,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClE,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/server.js

@@ -11,4 +11,6 @@ export { createEntrySchemaRegistry, validateEntrySchemaRegistry } from './entry-
 export { generateId, isValidId } from './id.js';
 export { buildContentTree } from './content-tree.js';
 export { listEntries } from './content-listing.js';
+export { resolveEntryUrl, resolveEntryLinksInText, resolveEntryLinksInData, extractEntryLinkIds, } from './entry-link-resolver.js';
+export { computeEntryUrl } from './utils/entry-url.js';
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/utils/entry-url.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared entry URL computation — used by both server and client code.
+ *
+ * This module has NO server-only dependencies (no node:fs, etc.)
+ * so it can be safely imported into browser bundles.
+ */
+/**
+ * Compute a URL path from an entry's collection path and slug.
+ *
+ * Logic:
+ * - Strip the contentRoot prefix (e.g., "content/") from the collection path
+ * - Append the slug (unless it's "index", which collapses to the parent path)
+ * - Always returns a path starting with "/"
+ *
+ * Examples:
+ *   ("content/posts", "hello-world", "content") => "/posts/hello-world"
+ *   ("content/docs/api", "index", "content")    => "/docs/api"
+ *   ("content", "index", "content")              => "/"
+ */
+export declare function computeEntryUrl(collection: string, slug: string, contentRoot: string): string;
+//# sourceMappingURL=entry-url.d.ts.map

package/dist/utils/entry-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-url.d.ts","sourceRoot":"","sources":["../../src/utils/entry-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAsB7F"}

package/dist/utils/entry-url.js

@@ -0,0 +1,41 @@
+/**
+ * Shared entry URL computation — used by both server and client code.
+ *
+ * This module has NO server-only dependencies (no node:fs, etc.)
+ * so it can be safely imported into browser bundles.
+ */
+import { trimSlashes } from '../paths/normalize.js';
+/**
+ * Compute a URL path from an entry's collection path and slug.
+ *
+ * Logic:
+ * - Strip the contentRoot prefix (e.g., "content/") from the collection path
+ * - Append the slug (unless it's "index", which collapses to the parent path)
+ * - Always returns a path starting with "/"
+ *
+ * Examples:
+ *   ("content/posts", "hello-world", "content") => "/posts/hello-world"
+ *   ("content/docs/api", "index", "content")    => "/docs/api"
+ *   ("content", "index", "content")              => "/"
+ */
+export function computeEntryUrl(collection, slug, contentRoot) {
+    const root = trimSlashes(contentRoot);
+    // Strip contentRoot prefix
+    let stripped = collection;
+    if (root && collection.startsWith(`${root}/`)) {
+        stripped = collection.slice(root.length + 1);
+    }
+    else if (collection === root) {
+        stripped = '';
+    }
+    // Build URL segments
+    const segments = stripped.split('/').filter(Boolean);
+    // Append slug unless it's "index" (index entries collapse to parent)
+    if (slug && slug !== 'index') {
+        segments.push(slug);
+    }
+    const path = segments.length > 0 ? `/${segments.join('/')}` : '/';
+    // Lowercase to match content-listing.ts and content-tree.ts URL conventions
+    return path.toLowerCase();
+}
+//# sourceMappingURL=entry-url.js.map

package/dist/utils/entry-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-url.js","sourceRoot":"","sources":["../../src/utils/entry-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,IAAY,EAAE,WAAmB;IACnF,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IAErC,2BAA2B;IAC3B,IAAI,QAAQ,GAAG,UAAU,CAAA;IACzB,IAAI,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC9C,CAAC;SAAM,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC/B,QAAQ,GAAG,EAAE,CAAA;IACf,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEpD,qEAAqE;IACrE,IAAI,IAAI,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IACjE,4EAA4E;IAC5E,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;AAC3B,CAAC"}

package/dist/validation/entry-link-validator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * EntryLinkValidator validates that entry:ID patterns in body/markdown fields
+ * reference existing entries.
+ *
+ * Returns warnings (not errors) — saves are never blocked by broken entry links.
+ * This parallels ReferenceValidator but operates on inline links in text content
+ * rather than structured reference fields.
+ */
+import type { ContentIdIndex } from '../content-id-index';
+import type { FieldConfig } from '../config';
+export interface EntryLinkWarning {
+    field: string;
+    fieldPath: string;
+    id: string;
+    message: string;
+}
+export interface EntryLinkValidationResult {
+    warnings: EntryLinkWarning[];
+}
+/**
+ * Validate entry links in body/markdown/mdx fields of the provided data.
+ *
+ * Scans all markdown, mdx, and rich-text fields for entry:ID patterns
+ * and checks that each referenced ID exists in the content index.
+ */
+export declare function validateEntryLinks(data: Record<string, unknown>, schema: readonly FieldConfig[], idIndex: ContentIdIndex, bodyContent?: string): EntryLinkValidationResult;
+//# sourceMappingURL=entry-link-validator.d.ts.map

package/dist/validation/entry-link-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-link-validator.d.ts","sourceRoot":"","sources":["../../src/validation/entry-link-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAI5C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,yBAAyB,CAoB3B"}

package/dist/validation/entry-link-validator.js

@@ -0,0 +1,49 @@
+/**
+ * EntryLinkValidator validates that entry:ID patterns in body/markdown fields
+ * reference existing entries.
+ *
+ * Returns warnings (not errors) — saves are never blocked by broken entry links.
+ * This parallels ReferenceValidator but operates on inline links in text content
+ * rather than structured reference fields.
+ */
+import { extractEntryLinkIds } from '../entry-link-resolver.js';
+import { findFieldsByType } from './field-traversal.js';
+/**
+ * Validate entry links in body/markdown/mdx fields of the provided data.
+ *
+ * Scans all markdown, mdx, and rich-text fields for entry:ID patterns
+ * and checks that each referenced ID exists in the content index.
+ */
+export function validateEntryLinks(data, schema, idIndex, bodyContent) {
+    const warnings = [];
+    // Check body content (for md/mdx entries, body is separate from data)
+    if (bodyContent) {
+        checkText(bodyContent, 'body', 'body', idIndex, warnings);
+    }
+    // Check markdown/mdx/rich-text fields in structured data
+    const markdownTypes = ['markdown', 'mdx', 'rich-text'];
+    for (const fieldType of markdownTypes) {
+        const contexts = findFieldsByType(schema, data, fieldType);
+        for (const ctx of contexts) {
+            if (typeof ctx.value === 'string' && ctx.value) {
+                checkText(ctx.value, ctx.field.name, ctx.path, idIndex, warnings);
+            }
+        }
+    }
+    return { warnings };
+}
+function checkText(text, fieldName, fieldPath, idIndex, warnings) {
+    const links = extractEntryLinkIds(text);
+    for (const link of links) {
+        const location = idIndex.findById(link.id);
+        if (!location || location.type !== 'entry') {
+            warnings.push({
+                field: fieldName,
+                fieldPath,
+                id: link.id,
+                message: `Entry link target not found: entry:${link.id}`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=entry-link-validator.js.map

package/dist/validation/entry-link-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-link-validator.js","sourceRoot":"","sources":["../../src/validation/entry-link-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAapD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA6B,EAC7B,MAA8B,EAC9B,OAAuB,EACvB,WAAoB;IAEpB,MAAM,QAAQ,GAAuB,EAAE,CAAA;IAEvC,sEAAsE;IACtE,IAAI,WAAW,EAAE,CAAC;QAChB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC3D,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAU,CAAA;IAC/D,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;QAC1D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC/C,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC;AAED,SAAS,SAAS,CAChB,IAAY,EACZ,SAAiB,EACjB,SAAiB,EACjB,OAAuB,EACvB,QAA4B;IAE5B,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,SAAS;gBAChB,SAAS;gBACT,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,OAAO,EAAE,sCAAsC,IAAI,CAAC,EAAE,EAAE;aACzD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "@codemirror/language, @lezer/highlight: workaround — @mdxeditor/editor uses cm6-theme-basic-light which peer-requires these but mdxeditor doesn't declare them as dependencies",
   "name": "canopycms",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "CanopyCMS core package: schema-driven content, branch-aware editing, and editor UI for Next.js.",
   "license": "MIT",
   "repository": {