@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/media-library/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media-library/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,eAAe,EAEf,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,GAIpB,MAAM,SAAS,CAAC"}

package/dist/media-library/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * UI labels for media library kinds. Kind unions / item shapes live in
+ * `@se-studio/core-data-types` so REST + UI cannot drift.
+ */
+export { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, type MediaLibraryItem, type MediaLibraryKind, type MediaLibraryPage as MediaLibraryPageData, } from '@se-studio/core-data-types';
+import type { MediaLibraryKind } from '@se-studio/core-data-types';
+export declare const MEDIA_LIBRARY_KIND_LABELS: Record<MediaLibraryKind, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/media-library/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/media-library/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,IAAI,oBAAoB,GAC9C,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAKtE,CAAC"}

package/dist/media-library/types.js

@@ -0,0 +1,12 @@
+/**
+ * UI labels for media library kinds. Kind unions / item shapes live in
+ * `@se-studio/core-data-types` so REST + UI cannot drift.
+ */
+export { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, } from '@se-studio/core-data-types';
+export const MEDIA_LIBRARY_KIND_LABELS = {
+    images: 'Images',
+    videos: 'Videos',
+    animations: 'Animations',
+    'external-videos': 'External videos',
+};
+//# sourceMappingURL=types.js.map

package/dist/media-library/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/media-library/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,4BAA4B,CAAC;AAIpC,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,iBAAiB,EAAE,iBAAiB;CACrC,CAAC"}

package/dist/route-handlers/createCmsTxtHandler.d.ts

@@ -0,0 +1,19 @@
+export interface CmsTxtHandlerOptions {
+    /** Display name for this app (e.g. "example-empty", "brightline") */
+    appName: string;
+    /** Local dev port (e.g. 3010) */
+    port: number;
+    /** Optional additional content appended after the standard sections */
+    extraContent?: string;
+}
+/**
+ * Creates a Next.js GET handler for the /cms.txt route.
+ *
+ * Returns a Markdown document listing all CMS tooling routes available on the site.
+ * Designed to be the first place an agent or tool looks when working with the CMS.
+ *
+ * Auth note: On deployed environments (e.g. Vercel) the whole app is behind auth.
+ * Pass the same auth credential to ALL endpoints listed here. No auth on localhost.
+ */
+export declare function createCmsTxtHandler(options: CmsTxtHandlerOptions): (request?: Request) => Response;
+//# sourceMappingURL=createCmsTxtHandler.d.ts.map

package/dist/route-handlers/createCmsTxtHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCmsTxtHandler.d.ts","sourceRoot":"","sources":["../../src/route-handlers/createCmsTxtHandler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,QAAQ,CAgJjC"}

package/dist/route-handlers/createCmsTxtHandler.js

@@ -0,0 +1,154 @@
+import { NextResponse } from 'next/server';
+/**
+ * Creates a Next.js GET handler for the /cms.txt route.
+ *
+ * Returns a Markdown document listing all CMS tooling routes available on the site.
+ * Designed to be the first place an agent or tool looks when working with the CMS.
+ *
+ * Auth note: On deployed environments (e.g. Vercel) the whole app is behind auth.
+ * Pass the same auth credential to ALL endpoints listed here. No auth on localhost.
+ */
+export function createCmsTxtHandler(options) {
+    const { appName, port, extraContent } = options;
+    return function GET() {
+        const content = `# CMS Tools and Resources — ${appName}
+
+## Auth
+
+When deployed (e.g. on Vercel preview), all endpoints below are behind site-level auth.
+Pass the same credential used to access this page to all listed endpoints.
+When running locally (http://localhost:${port}) there is no auth required.
+
+---
+
+## Component Showcase
+
+Browse and interact with every CMS component and collection using mock data.
+Useful for visualising what content looks like before editing in Contentful.
+
+  URL: /cms/showcase
+  Type: HTML (interactive browser tool)
+  Query: ?type=<TypeName>&mode=component|collection&view=single|all&controls=true&debug=true
+  Note: Controls panel is closed by default; pass controls=true to open it.
+  Note: Pass layout maps from buildComponentMaps/buildCollectionMaps into ShowcasePage
+        when using registration showcaseLayout (document|viewport|compact).
+
+Render a specific component or collection directly (no browser UI):
+
+  URL: /cms/showcase/render?type=<TypeName>&mode=<component|collection>
+  Example: /cms/showcase/render?type=Hero&mode=component
+  Example: /cms/showcase/render?type=Hero&mode=component&backgroundColour=Navy&textColour=Off+White
+  Example: /cms/showcase/render?type=Cards+Grid&mode=collection
+
+Render all components or collections on one page:
+
+  URL: /cms/showcase/render-all?mode=<component|collection>
+
+---
+
+## Media library (space inventory)
+
+Browse every image, video, Lottie/DotLottie animation asset, and external video entry
+in the Contentful space (Preview API — includes drafts). HTML shows image thumbnails;
+videos/animations/external play on click (one at a time). Not the component showcase.
+
+  URL: /cms/media
+  Type: HTML hub with links to each kind
+
+  URL: /cms/media/images
+  URL: /cms/media/videos
+  URL: /cms/media/animations
+  URL: /cms/media/external-videos
+  Type: HTML thumbnail grids
+  Query: ?page=1 (limit fixed at 50 on HTML pages)
+
+Machine-readable (same data as HTML pages; non-production only — 404 in production):
+
+  URL: /cms/media.json?kind=images&page=1&limit=50
+  Type: application/json
+  kind: images | videos | animations | external-videos
+  Cache: private, no-store when using Preview API
+
+  URL: /cms/media.md?kind=images&page=1&limit=50
+  Type: text/markdown
+
+---
+
+## Component Guidelines (LLM-ready)
+
+Self-contained documentation of every component and collection: layout, fields,
+behaviour, typography, colours, and impact of content changes.
+Intended for LLMs creating or editing pages — does not require code access.
+
+  URL: /cms/guidelines.md
+  Type: text/markdown (full guidelines document)
+
+Single component, collection, or external (smaller context):
+
+  URL: /cms/guidelines.md?component=<TypeName>
+  URL: /cms/guidelines.md?collection=<TypeName>
+  URL: /cms/guidelines.md?external=<TypeName>
+  Example: /cms/guidelines.md?component=Hero
+  Example: /cms/guidelines.md?external=formstack
+
+The guidelines are generated periodically and committed to the repository.
+For components not yet documented, the document notes they are pending.
+Regeneration: see docs/cms-guidelines/README.md for the full pipeline.
+
+---
+
+## Discovery API (JSON)
+
+Machine-readable dump of all available types, their used fields, colour hints,
+and the site palette. Use this to understand what can be added to a page and
+what fields each type supports — without reading the full guidelines.
+
+Single dump (all types):
+
+  URL: /api/cms/discovery
+  Type: application/json
+
+Single type (smaller context, for editing one component):
+
+  URL: /api/cms/discovery?type=component&name=Hero
+  URL: /api/cms/discovery?type=collection&name=Cards+Grid
+  URL: /api/cms/discovery?type=externalComponent&name=formstack
+  Type: application/json
+
+The response includes:
+  - components[]: name, usedFields[], fieldMetadata (types + enum values), colourHint
+  - collections[]: name, usedFields[], cardUsedFields[], fieldMetadata, colourHint
+  - externals[]: name, fieldMetadata
+  - palette: { background[], text[] }
+
+colourHint describes how backgroundColour and textColour apply for this type
+(e.g. "section" = full-width section, "card" = per-card inside collection).
+fieldMetadata provides the CMS field label, type, required flag, and enum values.
+
+---
+
+## CMS Preview
+
+Render a single Contentful entry (requires preview token):
+
+  URL: /cms/preview/render?id=<entryId>
+  URL: /cms/preview/render-json (JSON mode)
+
+---
+
+## Other
+
+  /llms.txt            — LLM-friendly index of site content (pages and articles)
+  /markdown-index.txt  — Complete list of all markdown URLs on this site
+  /site-info.md        — Factual site summary for support and AI
+  /sitemap.xml         — Standard XML sitemap
+${extraContent ? `\n---\n\n${extraContent}` : ''}`;
+        return new NextResponse(content, {
+            headers: {
+                'Content-Type': 'text/markdown; charset=utf-8',
+                'Cache-Control': 'public, max-age=3600',
+            },
+        });
+    };
+}
+//# sourceMappingURL=createCmsTxtHandler.js.map

package/dist/route-handlers/createCmsTxtHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCmsTxtHandler.js","sourceRoot":"","sources":["../../src/route-handlers/createCmsTxtHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEhD,OAAO,SAAS,GAAG;QACjB,MAAM,OAAO,GAAG,+BAA+B,OAAO;;;;;;yCAMjB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6H3C,YAAY,CAAC,CAAC,CAAC,YAAY,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAE/C,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE;YAC/B,OAAO,EAAE;gBACP,cAAc,EAAE,8BAA8B;gBAC9C,eAAe,EAAE,sBAAsB;aACxC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/route-handlers/createDiscoveryHandler.d.ts

@@ -0,0 +1,67 @@
+export type FieldMeta = {
+    id: string;
+    label: string;
+    required: boolean;
+    type: string;
+    summary?: string;
+    enumValues?: string[];
+};
+export type ColourHint = {
+    colourApplication: string;
+    notes?: string;
+};
+export type ComponentEntry = {
+    name: string;
+    usedFields: string[];
+    fieldMetadata?: FieldMeta[];
+    colourHint?: ColourHint;
+};
+export type CollectionEntry = {
+    name: string;
+    usedFields: string[];
+    cardUsedFields: string[];
+    fieldMetadata?: FieldMeta[];
+    colourHint?: ColourHint;
+};
+export type ExternalEntry = {
+    name: string;
+    fieldMetadata?: FieldMeta[];
+    colourHint?: ColourHint;
+};
+export type Palette = {
+    background: string[];
+    text: string[];
+};
+export type DiscoveryResponse = {
+    components: ComponentEntry[];
+    collections: CollectionEntry[];
+    externals: ExternalEntry[];
+    palette: Palette;
+};
+export interface DiscoveryHandlerOptions {
+    componentMap: Record<string, unknown>;
+    componentFieldsMap: Record<string, Set<string> | undefined>;
+    collectionMap: Record<string, unknown>;
+    collectionFieldsMap: Record<string, Set<string> | undefined>;
+    collectionCardFieldsMap: Record<string, Set<string> | undefined>;
+    externalComponentMap: Record<string, unknown>;
+    palette: Palette;
+    cwd: string;
+}
+/**
+ * Creates a Next.js GET handler for the /api/cms/discovery route.
+ *
+ * Returns a machine-readable dump of all CMS types available in the app:
+ * - components[]: name, usedFields[], fieldMetadata, colourHint
+ * - collections[]: name, usedFields[], cardUsedFields[], fieldMetadata, colourHint
+ * - externals[]: name, fieldMetadata
+ * - palette: background and text colours
+ *
+ * Supports single-type queries: ?type=component&name=Hero
+ *
+ * fieldMetadata is merged when generated/cms-discovery/field-list.json exists.
+ * colourHint is merged when generated/cms-discovery/colour-hints.json exists.
+ * Both fall back gracefully when absent.
+ */
+export declare function createDiscoveryHandler(options: DiscoveryHandlerOptions): (request: Request) => Response;
+//# sourceMappingURL=createDiscoveryHandler.d.ts.map

package/dist/route-handlers/createDiscoveryHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDiscoveryHandler.d.ts","sourceRoot":"","sources":["../../src/route-handlers/createDiscoveryHandler.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAQF,MAAM,MAAM,UAAU,GAAG;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7D,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IACjE,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAqCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,CAyKhC"}

package/dist/route-handlers/createDiscoveryHandler.js

@@ -0,0 +1,190 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { NextResponse } from 'next/server';
+function loadFieldList(cwd) {
+    try {
+        const raw = readFileSync(join(cwd, 'generated/cms-discovery/field-list.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function loadColourHints(cwd) {
+    try {
+        const raw = readFileSync(join(cwd, 'generated/cms-discovery/colour-hints.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/** Return only the fields that appear in usedFields (by field id), in usedFields order */
+function filterFieldMeta(allFields, usedFields) {
+    if (!allFields) {
+        return undefined;
+    }
+    const usedSet = new Set(usedFields);
+    const filtered = allFields.filter((f) => usedSet.has(f.id));
+    if (filtered.length === 0) {
+        return undefined;
+    }
+    const byId = new Map(filtered.map((f) => [f.id, f]));
+    return usedFields.map((id) => byId.get(id)).filter((f) => f !== undefined);
+}
+/**
+ * Creates a Next.js GET handler for the /api/cms/discovery route.
+ *
+ * Returns a machine-readable dump of all CMS types available in the app:
+ * - components[]: name, usedFields[], fieldMetadata, colourHint
+ * - collections[]: name, usedFields[], cardUsedFields[], fieldMetadata, colourHint
+ * - externals[]: name, fieldMetadata
+ * - palette: background and text colours
+ *
+ * Supports single-type queries: ?type=component&name=Hero
+ *
+ * fieldMetadata is merged when generated/cms-discovery/field-list.json exists.
+ * colourHint is merged when generated/cms-discovery/colour-hints.json exists.
+ * Both fall back gracefully when absent.
+ */
+export function createDiscoveryHandler(options) {
+    const { componentMap, componentFieldsMap, collectionMap, collectionFieldsMap, collectionCardFieldsMap, externalComponentMap, palette, cwd, } = options;
+    // Load generated artifacts once per handler instance
+    let fieldListCache;
+    let colourHintsCache;
+    function getFieldList() {
+        if (fieldListCache === undefined) {
+            fieldListCache = loadFieldList(cwd);
+        }
+        return fieldListCache;
+    }
+    function getColourHints() {
+        if (colourHintsCache === undefined) {
+            colourHintsCache = loadColourHints(cwd);
+        }
+        return colourHintsCache;
+    }
+    function buildComponents() {
+        const fl = getFieldList();
+        const hints = getColourHints();
+        const allComponentFields = fl?.['component']?.fields;
+        return Object.keys(componentMap).map((name) => {
+            const usedFields = Array.from(componentFieldsMap[name] ?? new Set()).sort();
+            const entry = { name, usedFields };
+            const fieldMetadata = filterFieldMeta(allComponentFields, usedFields);
+            if (fieldMetadata) {
+                entry.fieldMetadata = fieldMetadata;
+            }
+            const hint = hints[name];
+            if (hint) {
+                entry.colourHint = hint;
+            }
+            return entry;
+        });
+    }
+    function buildCollections() {
+        const fl = getFieldList();
+        const hints = getColourHints();
+        const allCollectionFields = fl?.['collection']?.fields;
+        return Object.keys(collectionMap).map((name) => {
+            const usedFields = Array.from(collectionFieldsMap[name] ?? new Set()).sort();
+            const cardUsedFields = Array.from(collectionCardFieldsMap[name] ?? new Set()).sort();
+            const entry = { name, usedFields, cardUsedFields };
+            const fieldMetadata = filterFieldMeta(allCollectionFields, usedFields);
+            if (fieldMetadata) {
+                entry.fieldMetadata = fieldMetadata;
+            }
+            const hint = hints[name];
+            if (hint) {
+                entry.colourHint = hint;
+            }
+            return entry;
+        });
+    }
+    function buildExternals() {
+        const fl = getFieldList();
+        const hints = getColourHints();
+        const allExternalFields = fl?.['externalComponent']?.fields;
+        return Object.keys(externalComponentMap).map((name) => {
+            const entry = { name };
+            if (allExternalFields) {
+                entry.fieldMetadata = allExternalFields;
+            }
+            const hint = hints[name];
+            if (hint) {
+                entry.colourHint = hint;
+            }
+            return entry;
+        });
+    }
+    function handleSingleType(type, name) {
+        const fl = getFieldList();
+        const hints = getColourHints();
+        if (type === 'component') {
+            if (!(name in componentMap)) {
+                return NextResponse.json({ error: `Component "${name}" not found` }, { status: 404 });
+            }
+            const usedFields = Array.from(componentFieldsMap[name] ?? new Set()).sort();
+            const entry = { name, usedFields };
+            const fieldMetadata = filterFieldMeta(fl?.['component']?.fields, usedFields);
+            if (fieldMetadata) {
+                entry.fieldMetadata = fieldMetadata;
+            }
+            const hint = hints[name];
+            if (hint) {
+                entry.colourHint = hint;
+            }
+            return NextResponse.json({ component: entry, palette });
+        }
+        if (type === 'collection') {
+            if (!(name in collectionMap)) {
+                return NextResponse.json({ error: `Collection "${name}" not found` }, { status: 404 });
+            }
+            const usedFields = Array.from(collectionFieldsMap[name] ?? new Set()).sort();
+            const cardUsedFields = Array.from(collectionCardFieldsMap[name] ?? new Set()).sort();
+            const entry = { name, usedFields, cardUsedFields };
+            const fieldMetadata = filterFieldMeta(fl?.['collection']?.fields, usedFields);
+            if (fieldMetadata) {
+                entry.fieldMetadata = fieldMetadata;
+            }
+            const hint = hints[name];
+            if (hint) {
+                entry.colourHint = hint;
+            }
+            return NextResponse.json({ collection: entry, palette });
+        }
+        if (type === 'externalComponent') {
+            if (!(name in externalComponentMap)) {
+                return NextResponse.json({ error: `External component "${name}" not found` }, { status: 404 });
+            }
+            const entry = { name };
+            const allExternalFields = fl?.['externalComponent']?.fields;
+            if (allExternalFields) {
+                entry.fieldMetadata = allExternalFields;
+            }
+            const extHint = hints[name];
+            if (extHint) {
+                entry.colourHint = extHint;
+            }
+            return NextResponse.json({ external: entry, palette });
+        }
+        return NextResponse.json({ error: `Unknown type "${type}". Use component, collection, or externalComponent.` }, { status: 400 });
+    }
+    // biome-ignore lint/style/useNamingConvention: Route handler name convention
+    return function GET(request) {
+        const { searchParams } = new URL(request.url);
+        const typeParam = searchParams.get('type');
+        const nameParam = searchParams.get('name');
+        if (typeParam && nameParam) {
+            return handleSingleType(typeParam, nameParam);
+        }
+        const payload = {
+            components: buildComponents(),
+            collections: buildCollections(),
+            externals: buildExternals(),
+            palette,
+        };
+        return NextResponse.json(payload);
+    };
+}
+//# sourceMappingURL=createDiscoveryHandler.js.map

package/dist/route-handlers/createDiscoveryHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDiscoveryHandler.js","sourceRoot":"","sources":["../../src/route-handlers/createDiscoveryHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoE3C,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,yCAAyC,CAAC,EAAE,MAAM,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,2CAA2C,CAAC,EAAE,MAAM,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,SAAS,eAAe,CACtB,SAAkC,EAClC,UAAoB;IAEpB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgC;IAEhC,MAAM,EACJ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,OAAO,EACP,GAAG,GACJ,GAAG,OAAO,CAAC;IAEZ,qDAAqD;IACrD,IAAI,cAAgD,CAAC;IACrD,IAAI,gBAA6C,CAAC;IAElD,SAAS,YAAY;QACnB,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,SAAS,cAAc;QACrB,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,gBAAgB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,SAAS,eAAe;QACtB,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,MAAM,kBAAkB,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YACpF,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACnD,MAAM,aAAa,GAAG,eAAe,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;YACtE,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,gBAAgB;QACvB,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,MAAM,mBAAmB,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YACrF,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7F,MAAM,KAAK,GAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;YACpE,MAAM,aAAa,GAAG,eAAe,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;YACvE,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,cAAc;QACrB,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAC/B,MAAM,iBAAiB,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpD,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,CAAC;YACtC,IAAI,iBAAiB,EAAE,CAAC;gBACtB,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC;YAC1C,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,IAAY;QAClD,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;QAE/B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC,EAAE,CAAC;gBAC5B,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YACpF,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACnD,MAAM,aAAa,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC7E,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,IAAI,IAAI,aAAa,CAAC,EAAE,CAAC;gBAC7B,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,IAAI,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YACrF,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7F,MAAM,KAAK,GAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;YACpE,MAAM,aAAa,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC9E,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,IAAI,IAAI,oBAAoB,CAAC,EAAE,CAAC;gBACpC,OAAO,YAAY,CAAC,IAAI,CACtB,EAAE,KAAK,EAAE,uBAAuB,IAAI,aAAa,EAAE,EACnD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,CAAC;YACtC,MAAM,iBAAiB,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC5D,IAAI,iBAAiB,EAAE,CAAC;gBACtB,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC;YAC1C,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC;YAC7B,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CACtB,EAAE,KAAK,EAAE,iBAAiB,IAAI,qDAAqD,EAAE,EACrF,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,OAAO,SAAS,GAAG,CAAC,OAAgB;QAClC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,OAAO,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,OAAO,GAAsB;YACjC,UAAU,EAAE,eAAe,EAAE;YAC7B,WAAW,EAAE,gBAAgB,EAAE;YAC/B,SAAS,EAAE,cAAc,EAAE;YAC3B,OAAO;SACR,CAAC;QAEF,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/route-handlers/createGuidelinesHandler.d.ts

@@ -0,0 +1,16 @@
+export interface GuidelinesHandlerOptions {
+    cwd: string;
+}
+/**
+ * Creates a Next.js GET handler for the /cms/guidelines.md route.
+ *
+ * Serves the committed COMPONENT_GUIDELINES_FOR_LLM.md document as Markdown (Content-Type: text/markdown).
+ * The document is self-contained: no source code access is required to read it.
+ *
+ * Optional query params:
+ *   ?component=Hero          — returns only the Hero section
+ *   ?collection=Cards+Grid   — returns only the Cards Grid section
+ *   ?external=formstack      — returns only the formstack section
+ */
+export declare function createGuidelinesHandler(options: GuidelinesHandlerOptions): (request: Request) => Response;
+//# sourceMappingURL=createGuidelinesHandler.d.ts.map

package/dist/route-handlers/createGuidelinesHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGuidelinesHandler.d.ts","sourceRoot":"","sources":["../../src/route-handlers/createGuidelinesHandler.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,CA2DhC"}

package/dist/route-handlers/createGuidelinesHandler.js

@@ -0,0 +1,100 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { NextResponse } from 'next/server';
+/**
+ * Extract the section for a given type name from the merged guidelines document.
+ * Returns everything from "# <TypeName>" up to (but not including) the next "---"
+ * separator. Stops only at fragment boundaries, not at ## headings inside the section.
+ */
+function extractSection(content, typeName) {
+    const escapedName = typeName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const sectionPattern = new RegExp(`(^# ${escapedName}\\s*$[\\s\\S]*?)(?=^---$)`, 'mi');
+    const match = sectionPattern.exec(content);
+    if (match?.[1]) {
+        return match[1].trim();
+    }
+    // Fallback: case-insensitive partial match
+    const lowerName = typeName.toLowerCase();
+    const lines = content.split('\n');
+    let startLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (line.startsWith('# ') && line.toLowerCase().includes(lowerName)) {
+            startLine = i;
+            break;
+        }
+    }
+    if (startLine === -1) {
+        return null;
+    }
+    const sectionLines = [];
+    for (let i = startLine; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (i !== startLine && line === '---') {
+            break;
+        }
+        sectionLines.push(line);
+    }
+    return sectionLines.join('\n').trim();
+}
+/**
+ * Creates a Next.js GET handler for the /cms/guidelines.md route.
+ *
+ * Serves the committed COMPONENT_GUIDELINES_FOR_LLM.md document as Markdown (Content-Type: text/markdown).
+ * The document is self-contained: no source code access is required to read it.
+ *
+ * Optional query params:
+ *   ?component=Hero          — returns only the Hero section
+ *   ?collection=Cards+Grid   — returns only the Cards Grid section
+ *   ?external=formstack      — returns only the formstack section
+ */
+export function createGuidelinesHandler(options) {
+    const guidelinesPath = join(options.cwd, 'docs/cms-guidelines/COMPONENT_GUIDELINES_FOR_LLM.md');
+    function loadGuidelines() {
+        if (!existsSync(guidelinesPath)) {
+            return null;
+        }
+        try {
+            return readFileSync(guidelinesPath, 'utf8');
+        }
+        catch {
+            return null;
+        }
+    }
+    return function GET(request) {
+        const { searchParams } = new URL(request.url);
+        const component = searchParams.get('component');
+        const collection = searchParams.get('collection');
+        const external = searchParams.get('external');
+        const typeName = component ?? collection ?? external;
+        const guidelines = loadGuidelines();
+        if (!guidelines) {
+            return new NextResponse('# CMS Guidelines not yet generated\n\nRun the guideline generation pipeline to produce this document.\nSee docs/cms-guidelines/README.md for instructions.', {
+                status: 404,
+                headers: { 'Content-Type': 'text/markdown; charset=utf-8' },
+            });
+        }
+        if (typeName) {
+            const section = extractSection(guidelines, typeName);
+            if (!section) {
+                return new NextResponse(`# Not found\n\nNo guideline found for "${typeName}".\n\nAvailable at /cms/guidelines.md (full document).`, {
+                    status: 404,
+                    headers: { 'Content-Type': 'text/markdown; charset=utf-8' },
+                });
+            }
+            return new NextResponse(section, {
+                headers: {
+                    'Content-Type': 'text/markdown; charset=utf-8',
+                    'Cache-Control': 'public, max-age=3600',
+                },
+            });
+        }
+        return new NextResponse(guidelines, {
+            headers: {
+                'Content-Type': 'text/markdown; charset=utf-8',
+                'Cache-Control': 'public, max-age=3600',
+            },
+        });
+    };
+}
+//# sourceMappingURL=createGuidelinesHandler.js.map

package/dist/route-handlers/createGuidelinesHandler.js.map

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

package/dist/route-handlers/createMediaLibraryHandler.d.ts

@@ -0,0 +1,19 @@
+import { type ContentfulConfig } from '@se-studio/contentful-rest-api';
+export type MediaLibraryHandlerOptions = {
+    /** Resolve Contentful config (prefer preview token for draft assets). */
+    getConfig: (preview?: boolean) => ContentfulConfig;
+    /**
+     * Required. When true, handlers return 404 (same intent as CmsDevLayout).
+     * Route handlers do not run React layouts — pass the app `isProduction` flag.
+     * Fail closed if omitted at runtime (optional for older call sites until rebuild).
+     */
+    isProduction: boolean;
+    /** Default true — include draft assets via Preview API. */
+    preview?: boolean;
+};
+/**
+ * Creates GET handlers for `/cms/media.json` and `/cms/media.md` agent surfaces.
+ */
+export declare function createMediaLibraryJsonHandler(options: MediaLibraryHandlerOptions): (request: Request) => Promise<Response>;
+export declare function createMediaLibraryMarkdownHandler(options: MediaLibraryHandlerOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=createMediaLibraryHandler.d.ts.map

package/dist/route-handlers/createMediaLibraryHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMediaLibraryHandler.d.ts","sourceRoot":"","sources":["../../src/route-handlers/createMediaLibraryHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,gCAAgC,CAAC;AAGxC,MAAM,MAAM,0BAA0B,GAAG;IACvC,yEAAyE;IACzE,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,gBAAgB,CAAC;IACnD;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA+BF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,IAKrD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAuB/D;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,0BAA0B,IAIzD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA2B/D"}