@glw907/cairn-cms 0.9.0 → 0.11.0

package/dist/delivery/content-index.js

@@ -45,7 +45,7 @@ export function createContentIndex(files, descriptor) {
             excerpt: deriveExcerpt(body, { description: asString(frontmatter.description) }),
             wordCount: wordCount(body),
             draft: frontmatter.draft === true,
-            frontmatter,
+            frontmatter: frontmatter,
             body,
         };
     });

package/dist/delivery/index.d.ts

@@ -0,0 +1,22 @@
+export { createContentIndex, fromGlob } from './content-index.js';
+export type { RawFile, ContentSummary, ContentEntry, ContentIndex } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export type { SiteIndex, ConceptIndex } from './site-index.js';
+export { siteDescriptors } from './site-descriptors.js';
+export { deriveExcerpt, wordCount } from './excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './feeds.js';
+export type { FeedChannel, FeedItem } from './feeds.js';
+export { buildSitemap } from './sitemap.js';
+export type { SitemapUrl } from './sitemap.js';
+export { buildRobots } from './robots.js';
+export { buildSeoMeta } from './seo.js';
+export type { SeoInput, SeoMeta } from './seo.js';
+export { paginate } from './paginate.js';
+export type { Page } from './paginate.js';
+export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './responses.js';
+export { jsonLdScript } from './json-ld.js';
+export { permalink } from '../content/permalink.js';
+export { createPublicRoutes } from '../sveltekit/public-routes.js';
+export type { PublicRoutesDeps, ListData, TagData, TagIndexData, EntryData, } from '../sveltekit/public-routes.js';
+export { default as CairnHead } from './CairnHead.svelte';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,SAAS,GACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/delivery/index.js

@@ -0,0 +1,19 @@
+// cairn-cms: the public delivery entry (@glw907/cairn-cms/delivery). The complete, canonical,
+// backend-free toolkit a SvelteKit site wires its public pages with: the content index and the
+// site resolver, the descriptor helper, the syndication and SEO builders, the endpoint response
+// helpers, the catch-all route loaders, and the head component. It imports nothing from auth,
+// github, or email, so importing it does not pull the server backend into a public bundle.
+export { createContentIndex, fromGlob } from './content-index.js';
+export { createSiteIndex } from './site-index.js';
+export { siteDescriptors } from './site-descriptors.js';
+export { deriveExcerpt, wordCount } from './excerpt.js';
+export { buildRssFeed, buildJsonFeed } from './feeds.js';
+export { buildSitemap } from './sitemap.js';
+export { buildRobots } from './robots.js';
+export { buildSeoMeta } from './seo.js';
+export { paginate } from './paginate.js';
+export { rssResponse, jsonFeedResponse, sitemapResponse, robotsResponse } from './responses.js';
+export { jsonLdScript } from './json-ld.js';
+export { permalink } from '../content/permalink.js';
+export { createPublicRoutes } from '../sveltekit/public-routes.js';
+export { default as CairnHead } from './CairnHead.svelte';

package/dist/delivery/json-ld.d.ts

@@ -0,0 +1,2 @@
+export declare function jsonLdScript(data: Record<string, unknown>): string;
+//# sourceMappingURL=json-ld.d.ts.map

package/dist/delivery/json-ld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/json-ld.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQlE"}

package/dist/delivery/json-ld.js

@@ -0,0 +1,16 @@
+// cairn-cms: serialize a JSON-LD object into a safe inline script string. JSON.stringify does
+// not escape <, >, or &, so a value containing "</script>" would close the element and inject
+// markup. Escaping the three characters to their JSON unicode forms keeps the structured data
+// identical for a parser while making the bytes unable to break out of the script element.
+// The line separator U+2028 and paragraph separator U+2029 get the same treatment: they are
+// legal inside a JSON string but unsafe in inline script text, where some parsers read them as
+// line terminators, so an author pasting one into frontmatter would corrupt the JSON-LD block.
+export function jsonLdScript(data) {
+    const json = JSON.stringify(data)
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+    return `<script type="application/ld+json">${json}</script>`;
+}

package/dist/delivery/responses.d.ts

@@ -0,0 +1,14 @@
+import { type FeedChannel, type FeedItem } from './feeds.js';
+import { type SitemapUrl } from './sitemap.js';
+/** An RSS 2.0 feed response. */
+export declare function rssResponse(channel: FeedChannel, items: FeedItem[]): Response;
+/** A JSON Feed 1.1 response. */
+export declare function jsonFeedResponse(channel: FeedChannel, items: FeedItem[]): Response;
+/** A sitemap response. */
+export declare function sitemapResponse(urls: SitemapUrl[]): Response;
+/** A robots.txt response. */
+export declare function robotsResponse(opts: {
+    sitemapUrl: string;
+    disallow?: string[];
+}): Response;
+//# sourceMappingURL=responses.d.ts.map

package/dist/delivery/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/responses.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG7D,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAI7E;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAIlF;AAED,0BAA0B;AAC1B,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CAI5D;AAED,6BAA6B;AAC7B,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,QAAQ,CAI1F"}

package/dist/delivery/responses.js

@@ -0,0 +1,30 @@
+// cairn-cms: response helpers for the public delivery endpoints. Each wraps a builder in a
+// Response with the correct Content-Type, so a site's +server.ts GET is a single call. The
+// content type is the one detail every site otherwise copies and occasionally gets wrong.
+import { buildRssFeed, buildJsonFeed } from './feeds.js';
+import { buildSitemap } from './sitemap.js';
+import { buildRobots } from './robots.js';
+/** An RSS 2.0 feed response. */
+export function rssResponse(channel, items) {
+    return new Response(buildRssFeed(channel, items), {
+        headers: { 'Content-Type': 'application/rss+xml; charset=utf-8' },
+    });
+}
+/** A JSON Feed 1.1 response. */
+export function jsonFeedResponse(channel, items) {
+    return new Response(buildJsonFeed(channel, items), {
+        headers: { 'Content-Type': 'application/feed+json; charset=utf-8' },
+    });
+}
+/** A sitemap response. */
+export function sitemapResponse(urls) {
+    return new Response(buildSitemap(urls), {
+        headers: { 'Content-Type': 'application/xml; charset=utf-8' },
+    });
+}
+/** A robots.txt response. */
+export function robotsResponse(opts) {
+    return new Response(buildRobots(opts), {
+        headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+    });
+}

package/dist/delivery/seo.d.ts

@@ -12,6 +12,10 @@ export interface SeoInput {
         json?: string;
     };
     image?: string;
+    /** A robots meta directive, e.g. "noindex, nofollow". Omitted from the head when absent. */
+    robots?: string;
+    /** Author name, emitted as article:author for the article type. */
+    author?: string;
 }
 /** Plain-data head: a title, meta tags, link tags, and one JSON-LD object. */
 export interface SeoMeta {

package/dist/delivery/seo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/seo.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CA6CrD"}
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/seo.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAsDrD"}

package/dist/delivery/seo.js

@@ -17,6 +17,17 @@ export function buildSeoMeta(input) {
         meta.push({ property: 'og:image', content: input.image });
         meta.push({ name: 'twitter:image', content: input.image });
     }
+    if (input.robots) {
+        meta.push({ name: 'robots', content: input.robots });
+    }
+    if (type === 'article') {
+        if (input.published)
+            meta.push({ property: 'article:published_time', content: input.published });
+        if (input.modified)
+            meta.push({ property: 'article:modified_time', content: input.modified });
+        if (input.author)
+            meta.push({ property: 'article:author', content: input.author });
+    }
     const links = [{ rel: 'canonical', href: input.canonicalUrl }];
     if (input.feeds?.rss) {
         links.push({ rel: 'alternate', type: 'application/rss+xml', href: input.feeds.rss, title: input.siteName });

package/dist/delivery/site-descriptors.d.ts

@@ -0,0 +1,5 @@
+import type { CairnAdapter, ConceptDescriptor } from '../content/types.js';
+import type { SiteConfig } from '../nav/site-config.js';
+/** Per-concept descriptors for a site, from its adapter content and its parsed site config. */
+export declare function siteDescriptors(adapter: CairnAdapter, siteConfig: SiteConfig): ConceptDescriptor[];
+//# sourceMappingURL=site-descriptors.d.ts.map

package/dist/delivery/site-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-descriptors.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-descriptors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,iBAAiB,EAAE,CAElG"}

package/dist/delivery/site-descriptors.js

@@ -0,0 +1,9 @@
+// cairn-cms: the one-call descriptor helper. A delivery site needs the same per-concept
+// descriptors the admin runtime uses; this wraps the two calls that derive them so the
+// pairing is not tribal knowledge. The YAML URL policy stays the single source of truth.
+import { normalizeConcepts } from '../content/concepts.js';
+import { urlPolicyFrom } from '../nav/site-config.js';
+/** Per-concept descriptors for a site, from its adapter content and its parsed site config. */
+export function siteDescriptors(adapter, siteConfig) {
+    return normalizeConcepts(adapter.content, urlPolicyFrom(siteConfig));
+}

package/dist/delivery/site-index.d.ts

@@ -23,6 +23,12 @@ export interface SiteIndex {
     /** Every non-draft summary across concepts, for the site-wide sitemap. */
     all(): ContentSummary[];
 }
-/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
-export declare function createSiteIndex(concepts: ConceptIndex[]): SiteIndex;
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any entry whose frontmatter fails its concept's validator,
+ * so malformed content fails the build instead of shipping.
+ */
+export declare function createSiteIndex(concepts: ConceptIndex[], opts?: {
+    validate?: boolean;
+}): SiteIndex;
 //# sourceMappingURL=site-index.d.ts.map

package/dist/delivery/site-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErF,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACpF,uGAAuG;IACvG,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,0EAA0E;IAC1E,GAAG,IAAI,cAAc,EAAE,CAAC;CACzB;AAOD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,SAAS,CAkCnE"}
+{"version":3,"file":"site-index.d.ts","sourceRoot":"","sources":["../../src/lib/delivery/site-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErF,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACpF,uGAAuG;IACvG,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,0EAA0E;IAC1E,GAAG,IAAI,cAAc,EAAE,CAAC;CACzB;AA2BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,CAmCtG"}

package/dist/delivery/site-index.js

@@ -2,8 +2,34 @@
 function normalizePath(path) {
     return path.length > 1 ? path.replace(/\/+$/, '') : path;
 }
-/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
-export function createSiteIndex(concepts) {
+/** Validate every entry (drafts included) against its concept, aggregating failures. */
+function validateAll(concepts) {
+    const problems = [];
+    for (const { descriptor, index } of concepts) {
+        for (const summary of index.all({ includeDrafts: true })) {
+            const entry = index.byId(summary.id);
+            if (!entry)
+                continue;
+            const result = descriptor.validate(entry.frontmatter, entry.body);
+            if (!result.ok) {
+                for (const [field, message] of Object.entries(result.errors)) {
+                    problems.push(`${descriptor.dir}/${summary.id}: ${field}: ${message}`);
+                }
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`site index: ${problems.length} invalid frontmatter field(s):\n  ${problems.join('\n  ')}`);
+    }
+}
+/**
+ * Union per-concept indexes into a site-level resolver. Throws on a duplicate permalink and,
+ * unless `validate` is `false`, on any entry whose frontmatter fails its concept's validator,
+ * so malformed content fails the build instead of shipping.
+ */
+export function createSiteIndex(concepts, opts = {}) {
+    if (opts.validate !== false)
+        validateAll(concepts);
     const byPath = new Map();
     const byId = new Map();
     for (const { descriptor, index } of concepts) {

package/dist/index.d.ts

@@ -9,8 +9,14 @@ export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown,
 export { validateFields } from './content/validate.js';
 export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, composeDatedId, } from './content/ids.js';
 export type { DatePrefix } from './content/ids.js';
-export { defineRegistry } from './render/registry.js';
-export type { ComponentDef, ComponentRegistry } from './render/registry.js';
+export { defineRegistry, emptyValues } from './render/registry.js';
+export type { ComponentDef, ComponentRegistry, FieldType, AttributeField, SlotKind, SlotDef, ComponentValues, } from './render/registry.js';
+export { serializeComponent, parseComponent } from './render/component-grammar.js';
+export { validateComponent } from './render/component-validate.js';
+export type { ComponentValidation } from './render/component-validate.js';
+export { buildComponentInsert, type ComponentInsert } from './render/component-insert.js';
+export { generateComponentReference } from './render/component-reference.js';
+export type { ReferenceOptions } from './render/component-reference.js';
 export { glyph } from './render/glyph.js';
 export type { IconSet } from './render/glyph.js';
 export { remarkDirectiveStamp } from './render/remark-directives.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EACL,OAAO,EACP,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKhE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC3E,YAAY,EACV,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,YAAY,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,7 +8,11 @@ export { frontmatterFromForm, dateInputValue, serializeMarkdown, parseMarkdown,
 export { validateFields } from './content/validate.js';
 export { isValidId, idFromFilename, filenameFromId, slugify, slugFromId, composeDatedId, } from './content/ids.js';
 // Render engine (Plan 04): generic directive pipeline; sites own the component registry.
-export { defineRegistry } from './render/registry.js';
+export { defineRegistry, emptyValues } from './render/registry.js';
+export { serializeComponent, parseComponent } from './render/component-grammar.js';
+export { validateComponent } from './render/component-validate.js';
+export { buildComponentInsert } from './render/component-insert.js';
+export { generateComponentReference } from './render/component-reference.js';
 export { glyph } from './render/glyph.js';
 export { remarkDirectiveStamp } from './render/remark-directives.js';
 export { rehypeDispatch, isElement, strProp, iconSpan, splitHead, cardShell, markFirstList, } from './render/rehype-dispatch.js';

package/dist/render/component-grammar.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentDef, ComponentValues } from './registry.js';
+export declare function serializeComponent(def: ComponentDef, values: ComponentValues): string;
+/** Parse a serialized component directive back into guided-form values, the inverse of
+ *  {@link serializeComponent}. The grammar is reversible, so the editor can round-trip a
+ *  saved directive through the form. */
+export declare function parseComponent(markdown: string, def: ComponentDef): Promise<ComponentValues>;
+/** The raw attribute keys present on the component's opening directive, read from the parsed tree
+ *  (quote-aware, unlike a regex over the source). Used by validation to flag unknown keys. */
+export declare function parseRawAttributeKeys(markdown: string, def: ComponentDef): string[];
+//# sourceMappingURL=component-grammar.d.ts.map

package/dist/render/component-grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-grammar.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-grammar.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAW,MAAM,eAAe,CAAC;AA8B5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA2BrF;AAwBD;;wCAEwC;AACxC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAqClG;AAED;8FAC8F;AAC9F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAMnF"}

package/dist/render/component-grammar.js

@@ -0,0 +1,140 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkDirective from 'remark-directive';
+import remarkStringify from 'remark-stringify';
+const COLON = ':';
+function attrBlock(def, values) {
+    const parts = [];
+    for (const field of def.attributes ?? []) {
+        const v = values.attributes[field.key];
+        if (field.type === 'boolean') {
+            if (v === true)
+                parts.push(`${field.key}="true"`);
+        }
+        else if (typeof v === 'string' && v !== '') {
+            // The directive attribute grammar (mdast-util-directive) treats a literal `"` as the value
+            // terminator and decodes HTML entities, so a backslash escape does not survive a round-trip.
+            // Encode `&` first (so existing entities are not double-decoded) then `"`; the parser decodes
+            // both back. A backslash is literal in this grammar and needs no escaping.
+            const escaped = v.replace(/&/g, '&').replace(/"/g, '"');
+            parts.push(`${field.key}="${escaped}"`);
+        }
+    }
+    return parts.length ? `{${parts.join(' ')}}` : '';
+}
+function slotByName(def, name) {
+    return (def.slots ?? []).find((s) => s.name === name);
+}
+function nestedSlots(def) {
+    return (def.slots ?? []).filter((s) => s.name !== 'title' && s.name !== 'body');
+}
+export function serializeComponent(def, values) {
+    const fence = COLON.repeat(nestedSlots(def).length > 0 ? 4 : 3);
+    const title = slotByName(def, 'title') ? values.slots.title ?? '' : '';
+    // Escape brackets in the label so a `[` or `]` in the title does not break the directive label
+    // grammar; remark un-escapes them back to literal text on parse, so readLabel recovers them.
+    const label = title ? `[${title.replace(/\[/g, '\\[').replace(/\]/g, '\\]')}]` : '';
+    const open = `${fence}${def.name}${label}${attrBlock(def, values)}`;
+    const lines = [open];
+    const body = slotByName(def, 'body') ? values.slots.body ?? '' : '';
+    if (body)
+        lines.push(body);
+    for (const slot of nestedSlots(def)) {
+        const raw = values.slots[slot.name];
+        const content = slot.kind === 'repeatable'
+            ? (Array.isArray(raw) ? raw : []).filter((i) => i !== '').map((i) => `- ${i}`).join('\n')
+            : (raw ?? '');
+        if (!content)
+            continue;
+        if (lines.length > 1)
+            lines.push(''); // blank line before this block
+        lines.push(`${COLON.repeat(3)}${slot.name}`, content, COLON.repeat(3));
+    }
+    lines.push(fence);
+    return lines.join('\n');
+}
+function isContainer(node) {
+    return node.type === 'containerDirective';
+}
+// Pin the bullet to `-` so a markdown body or slot that uses dash bullets round-trips unchanged
+// rather than drifting to remark-stringify's default `*`, which would silently mutate author content.
+const toMd = unified().use(remarkStringify, { bullet: '-' });
+/** Render mdast children back to trimmed markdown text. */
+function childrenToText(children) {
+    const root = { type: 'root', children };
+    return String(toMd.stringify(root)).trim();
+}
+/** Parse a serialized component directive back into guided-form values, the inverse of
+ *  {@link serializeComponent}. The grammar is reversible, so the editor can round-trip a
+ *  saved directive through the form. */
+export async function parseComponent(markdown, def) {
+    const tree = unified().use(remarkParse).use(remarkDirective).parse(markdown);
+    const root = tree.children.find((c) => isContainer(c) && c.name === def.name);
+    const values = emptyComponentValues(def);
+    if (!root)
+        return values;
+    for (const field of def.attributes ?? []) {
+        const raw = root.attributes?.[field.key];
+        if (field.type === 'boolean')
+            values.attributes[field.key] = raw === 'true';
+        else if (typeof raw === 'string')
+            values.attributes[field.key] = raw;
+    }
+    const titleSlot = slotByName(def, 'title');
+    const bodySlot = slotByName(def, 'body');
+    const nested = nestedSlots(def);
+    const nestedNames = new Set(nested.map((s) => s.name));
+    const directChildren = root.children.filter((c) => !(isContainer(c) && nestedNames.has(c.name)) && !isDirectiveLabel(c));
+    const nestedChildren = root.children.filter((c) => isContainer(c) && nestedNames.has(c.name));
+    if (titleSlot)
+        values.slots.title = readLabel(root) ?? '';
+    if (bodySlot)
+        values.slots.body = childrenToText(directChildren);
+    for (const slot of nested) {
+        const node = nestedChildren.find((c) => c.name === slot.name);
+        if (!node)
+            continue;
+        if (slot.kind === 'repeatable')
+            values.slots[slot.name] = readListItems(node.children);
+        else
+            values.slots[slot.name] = childrenToText(node.children);
+    }
+    return values;
+}
+/** The raw attribute keys present on the component's opening directive, read from the parsed tree
+ *  (quote-aware, unlike a regex over the source). Used by validation to flag unknown keys. */
+export function parseRawAttributeKeys(markdown, def) {
+    const tree = unified().use(remarkParse).use(remarkDirective).parse(markdown);
+    const root = tree.children.find((c) => isContainer(c) && c.name === def.name);
+    return Object.keys(root?.attributes ?? {});
+}
+// A bare parse base: empty strings, false, and empty lists, with no attribute defaults applied. The
+// `emptyValues` helper in registry.ts seeds form defaults instead, so it is deliberately not reused
+// here; the parse must overwrite only the fields actually present in the markdown.
+function emptyComponentValues(def) {
+    const attributes = {};
+    for (const f of def.attributes ?? [])
+        attributes[f.key] = f.type === 'boolean' ? false : '';
+    const slots = {};
+    for (const s of def.slots ?? [])
+        slots[s.name] = s.kind === 'repeatable' ? [] : '';
+    return { attributes, slots };
+}
+// mdast-util-directive carries the `[label]` as a paragraph whose `data.directiveLabel` is set.
+function isDirectiveLabel(node) {
+    return Boolean(node.data?.directiveLabel);
+}
+function readLabel(root) {
+    for (const child of root.children) {
+        const p = child;
+        if (p.type === 'paragraph' && p.data?.directiveLabel)
+            return (p.children ?? []).map((c) => c.value ?? '').join('');
+    }
+    return undefined;
+}
+function readListItems(children) {
+    const list = children.find((c) => c.type === 'list');
+    if (!list?.children)
+        return [];
+    return list.children.map((li) => childrenToText(li.children ?? []));
+}

package/dist/render/component-insert.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentDef, ComponentValues } from './registry.js';
+/** The outcome of preparing a guided-form component for insertion: the markdown to insert, or the
+ *  field-keyed errors to show on the form. */
+export type ComponentInsert = {
+    ok: true;
+    markdown: string;
+} | {
+    ok: false;
+    errors: Record<string, string>;
+};
+/** Serialize a component's form values, then validate the result against its schema. Returns the
+ *  markdown to insert at the cursor, or the field errors keyed by attribute key or slot name. */
+export declare function buildComponentInsert(def: ComponentDef, values: ComponentValues): Promise<ComponentInsert>;
+//# sourceMappingURL=component-insert.d.ts.map

package/dist/render/component-insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-insert.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-insert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE;8CAC8C;AAC9C,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE7G;iGACiG;AACjG,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAI/G"}

package/dist/render/component-insert.js

@@ -0,0 +1,9 @@
+import { serializeComponent } from './component-grammar.js';
+import { validateComponent } from './component-validate.js';
+/** Serialize a component's form values, then validate the result against its schema. Returns the
+ *  markdown to insert at the cursor, or the field errors keyed by attribute key or slot name. */
+export async function buildComponentInsert(def, values) {
+    const markdown = serializeComponent(def, values);
+    const verdict = await validateComponent(markdown, def);
+    return verdict.ok ? { ok: true, markdown } : { ok: false, errors: verdict.errors };
+}

package/dist/render/component-reference.d.ts

@@ -0,0 +1,11 @@
+import { type ComponentRegistry } from './registry.js';
+export interface ReferenceOptions {
+    /** The H1 title of the reference document. */
+    title: string;
+    /** The one-line blockquote summary under the title. */
+    summary: string;
+}
+/** Build a self-contained markdown reference (the llms-full.txt shape) for a component registry, for
+ *  authors and for pointing an LLM at one curated file. */
+export declare function generateComponentReference(registry: ComponentRegistry, opts: ReferenceOptions): string;
+//# sourceMappingURL=component-reference.d.ts.map

package/dist/render/component-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-reference.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-reference.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,iBAAiB,EAAwB,MAAM,eAAe,CAAC;AAE7G,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;2DAC2D;AAC3D,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAGtG"}

package/dist/render/component-reference.js

@@ -0,0 +1,34 @@
+import { serializeComponent } from './component-grammar.js';
+import { emptyValues } from './registry.js';
+/** Build a self-contained markdown reference (the llms-full.txt shape) for a component registry, for
+ *  authors and for pointing an LLM at one curated file. */
+export function generateComponentReference(registry, opts) {
+    const sections = registry.defs.map((def) => componentSection(def));
+    return `# ${opts.title}\n\n> ${opts.summary}\n\n${sections.join('\n\n')}\n`;
+}
+function componentSection(def) {
+    const lines = [`## ${def.label} (\`:::${def.name}\`)`, '', def.description ?? ''];
+    if (def.use)
+        lines.push('', `**When to use:** ${def.use}`);
+    lines.push('', '```', serializeComponent(def, exampleValues(def)), '```');
+    return lines.join('\n');
+}
+/** Seed example values that show every declared field: an ellipsis for strings, one sample list item. */
+function exampleValues(def) {
+    const values = emptyValues(def);
+    for (const field of def.attributes ?? []) {
+        if (field.type === 'boolean')
+            values.attributes[field.key] = false;
+        else
+            values.attributes[field.key] = field.options?.[0] ?? '…';
+    }
+    for (const slot of def.slots ?? []) {
+        if (slot.kind === 'repeatable')
+            values.slots[slot.name] = ['…'];
+        else if (slot.name === 'title')
+            values.slots[slot.name] = 'Title';
+        else
+            values.slots[slot.name] = '…';
+    }
+    return values;
+}

package/dist/render/component-validate.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentDef } from './registry.js';
+/** A validation verdict: ok, or field-keyed error messages. */
+export type ComponentValidation = {
+    ok: true;
+} | {
+    ok: false;
+    errors: Record<string, string>;
+};
+export declare function validateComponent(markdown: string, def: ComponentDef): Promise<ComponentValidation>;
+//# sourceMappingURL=component-validate.d.ts.map

package/dist/render/component-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-validate.d.ts","sourceRoot":"","sources":["../../src/lib/render/component-validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE/F,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6BzG"}

package/dist/render/component-validate.js

@@ -0,0 +1,30 @@
+import { parseComponent, parseRawAttributeKeys } from './component-grammar.js';
+export async function validateComponent(markdown, def) {
+    const values = await parseComponent(markdown, def);
+    const errors = {};
+    const declared = new Set((def.attributes ?? []).map((f) => f.key));
+    for (const field of def.attributes ?? []) {
+        const v = values.attributes[field.key];
+        const filled = field.type === 'boolean' ? true : typeof v === 'string' && v !== '';
+        if (field.required && !filled) {
+            errors[field.key] = `${field.label} is required.`;
+            continue;
+        }
+        if (field.type === 'select' && typeof v === 'string' && v !== '' && !(field.options ?? []).includes(v)) {
+            errors[field.key] = `${field.label} must be one of: ${(field.options ?? []).join(', ')}.`;
+        }
+    }
+    for (const key of parseRawAttributeKeys(markdown, def)) {
+        if (!declared.has(key))
+            errors[key] = `Unknown attribute "${key}".`;
+    }
+    for (const slot of def.slots ?? []) {
+        if (!slot.required)
+            continue;
+        const v = values.slots[slot.name];
+        const filled = Array.isArray(v) ? v.length > 0 : typeof v === 'string' && v !== '';
+        if (!filled)
+            errors[slot.name] = `${slot.label} is required.`;
+    }
+    return Object.keys(errors).length ? { ok: false, errors } : { ok: true };
+}