@nuasite/cms 0.1.0

package/README.md

@@ -0,0 +1,237 @@
+# @nuasite/astro-cms
+
+Astro integration that adds inline visual editing to any Astro site. Scans your components, marks editable elements with CMS IDs, and serves a live editor overlay during development. All write operations (text, images, colors, components, markdown) are handled locally via a built-in dev server — no external backend required.
+
+## Quick Start
+
+```typescript
+// astro.config.mjs
+import nuaCms from '@nuasite/astro-cms'
+
+export default defineConfig({
+  integrations: [nuaCms()],
+})
+```
+
+That's it. Run `astro dev` and the CMS editor loads automatically. Edits write directly to your source files, and Vite HMR picks up the changes instantly.
+
+## How It Works
+
+The integration operates in two phases:
+
+**HTML Processing** — As Astro renders each page, the integration intercepts the HTML response, parses it, and injects `data-cms-id` attributes on editable elements (text, images, components). It generates a per-page manifest mapping each CMS ID to its source file, line number, and code snippet.
+
+**Dev Server API** — When you save an edit in the visual editor, the request goes to `/_nua/cms/*` endpoints running inside Vite's dev middleware. These handlers read the source file, find the snippet, apply the change, and write the file back. Vite HMR triggers a reload.
+
+## Options
+
+```typescript
+nuaCms({
+  // --- Editor ---
+  src: undefined,         // Custom editor script URL (default: built-in @app/cms bundle)
+  cmsConfig: {            // Passed to window.NuaCmsConfig
+    apiBase: '/_nua/cms', // API endpoint base (auto-set when using local dev server)
+    highlightColor: undefined,
+    debug: false,
+    theme: undefined,
+    themePreset: undefined,
+  },
+
+  // --- Backend ---
+  proxy: undefined,       // Proxy /_nua requests to a remote backend (e.g. 'http://localhost:8787')
+                          // When set, the local dev server API is disabled
+  media: undefined,       // Media storage adapter (default: localMedia() when no proxy)
+
+  // --- Marker ---
+  attributeName: 'data-cms-id',
+  includeTags: null,                                       // null = all tags
+  excludeTags: ['html', 'head', 'body', 'script', 'style'],
+  includeEmptyText: false,
+  generateManifest: true,
+  manifestFile: 'cms-manifest.json',
+  markComponents: true,
+  componentDirs: ['src/components'],
+  contentDir: 'src/content',
+  seo: { trackSeo: true, markTitle: true, parseJsonLd: true },
+})
+```
+
+## Dev Server API
+
+When no `proxy` is configured, the integration spins up a local API at `/_nua/cms/`. This handles all CMS operations without needing the Cloudflare Worker backend.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/_nua/cms/update` | Save text, image, color, and attribute changes |
+| POST | `/_nua/cms/insert-component` | Insert a component before/after a reference |
+| POST | `/_nua/cms/remove-component` | Remove a component from the page |
+| GET | `/_nua/cms/markdown/content` | Read markdown file content + frontmatter |
+| POST | `/_nua/cms/markdown/update` | Update markdown file (partial frontmatter merge) |
+| POST | `/_nua/cms/markdown/create` | Create a new markdown file in a collection |
+| GET | `/_nua/cms/media/list` | List uploaded media files |
+| POST | `/_nua/cms/media/upload` | Upload a file (multipart/form-data) |
+| DELETE | `/_nua/cms/media/:id` | Delete an uploaded file |
+| GET | `/_nua/cms/deployment/status` | Returns `{ currentDeployment: null, pendingCount: 0 }` |
+| OPTIONS | `/_nua/cms/*` | CORS preflight |
+
+### Update Payload
+
+The `POST /update` endpoint accepts a batch of changes:
+
+```typescript
+{
+  changes: [
+    {
+      cmsId: 'cms-0',
+      newValue: 'Updated heading text',
+      originalValue: 'Original heading text',
+      sourcePath: 'src/pages/index.astro',
+      sourceLine: 42,
+      sourceSnippet: '<h1>Original heading text</h1>',
+      // Optional for specific change types:
+      colorChange: { oldClass: 'bg-blue-500', newClass: 'bg-red-500', type: 'bg' },
+      imageChange: { newSrc: '/uploads/photo.webp', newAlt: 'A photo' },
+      attributeChanges: [{ attributeName: 'href', oldValue: '/old', newValue: '/new' }],
+    }
+  ],
+  meta: { source: 'cms-editor', url: 'http://localhost:4321/about' }
+}
+```
+
+Changes are grouped by source file, sorted by line number (descending to avoid offset shifts), and applied in-place. The response returns `{ updated: number, errors?: [...] }`.
+
+## Media Storage Adapters
+
+Media uploads use a pluggable adapter pattern. Three adapters are included:
+
+### Local Filesystem (default)
+
+Stores files in `public/uploads/`. Served directly by Vite's static file server. Zero configuration needed.
+
+```typescript
+import nuaCms, { localMedia } from '@nuasite/astro-cms'
+
+nuaCms({
+  media: localMedia({
+    dir: 'public/uploads',   // default
+    urlPrefix: '/uploads',   // default
+  }),
+})
+```
+
+Files are named with UUIDs to avoid collisions. Listed by modification time (newest first).
+
+### Contember (R2 + Database)
+
+Proxies to the existing Contember worker API. Files are stored in Cloudflare R2, metadata in the Contember database. Includes AI-powered image annotation.
+
+```typescript
+import nuaCms, { contemberMedia } from '@nuasite/astro-cms'
+
+nuaCms({
+  media: contemberMedia({
+    apiBaseUrl: 'https://api.example.com',
+    projectSlug: 'my-project',
+    sessionToken: process.env.NUA_SESSION_TOKEN,
+  }),
+})
+```
+
+This adapter calls the worker's `/cms/:projectSlug/media/*` endpoints, which handle R2 upload, Asset record creation, and image annotation. Authentication uses the `NUA_SITE_SESSION_TOKEN` cookie.
+
+### S3 / R2 Direct
+
+Direct S3-compatible storage. Works with AWS S3, Cloudflare R2, MinIO, or any S3-compatible provider. Requires `@aws-sdk/client-s3` as a peer dependency.
+
+```typescript
+import nuaCms, { s3Media } from '@nuasite/astro-cms'
+
+nuaCms({
+  media: s3Media({
+    bucket: 'my-bucket',
+    region: 'us-east-1',
+    // Optional:
+    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+    endpoint: 'https://account.r2.cloudflarestorage.com', // for R2
+    cdnPrefix: 'https://cdn.example.com',                 // public URL prefix
+    prefix: 'uploads',                                     // key prefix in bucket
+  }),
+})
+```
+
+Install the optional dependency:
+
+```bash
+npm install @aws-sdk/client-s3
+```
+
+### Custom Adapter
+
+Implement the `MediaStorageAdapter` interface to use any storage backend:
+
+```typescript
+import type { MediaStorageAdapter } from '@nuasite/astro-cms'
+
+const myAdapter: MediaStorageAdapter = {
+  async list(options) {
+    // Return { items: MediaItem[], hasMore: boolean, cursor?: string }
+  },
+  async upload(file: Buffer, filename: string, contentType: string) {
+    // Return { success: boolean, url?: string, filename?: string, id?: string, error?: string }
+  },
+  async delete(id: string) {
+    // Return { success: boolean, error?: string }
+  },
+}
+
+nuaCms({ media: myAdapter })
+```
+
+## Proxy Mode
+
+To use the Contember worker backend for all CMS operations (not just media), set the `proxy` option. This disables the local dev server API and forwards all `/_nua` requests to the target:
+
+```typescript
+nuaCms({
+  proxy: 'http://localhost:8787',  // Worker dev server
+})
+```
+
+In proxy mode, the integration only handles HTML processing and manifest serving. All write operations go through the worker (which uses GitHub API for commits and R2 for media).
+
+## Content Collections
+
+The integration auto-detects Astro content collections in `src/content/`. For each collection:
+
+- Scans all `.md`/`.mdx` files to infer a field schema from frontmatter
+- Marks collection pages with a wrapper element for body editing
+- Provides markdown CRUD endpoints for creating/updating entries
+- Parses frontmatter with `yaml` (no `gray-matter` dependency needed)
+
+## Component Operations
+
+Components in `componentDirs` (default: `src/components/`) are scanned for props and registered as insertable/removable elements. The editor can:
+
+- **Insert** a component before or after any existing component on the page
+- **Remove** a component from the page
+
+Both operations find the invocation site (the page file, not the component file itself), locate the correct JSX tag using occurrence indexing, and modify the source with proper indentation.
+
+## Exports
+
+```typescript
+// Default export
+import nuaCms from '@nuasite/astro-cms'
+
+// Media adapters
+import { localMedia, s3Media, contemberMedia } from '@nuasite/astro-cms'
+
+// Types
+import type { MediaStorageAdapter, MediaItem } from '@nuasite/astro-cms'
+import type { CmsManifest, ManifestEntry, ComponentDefinition } from '@nuasite/astro-cms'
+
+// Utilities
+import { scanCollections, getProjectRoot, setProjectRoot } from '@nuasite/astro-cms'
+import { findCollectionSource, parseMarkdownContent } from '@nuasite/astro-cms'
+```

package/dist/src/build-processor.d.ts

@@ -0,0 +1,20 @@
+import type { AstroIntegrationLogger } from 'astro';
+import type { ManifestWriter } from './manifest-writer';
+import type { CmsMarkerOptions } from './types';
+/**
+ * Cluster entries from the same source file into separate component instances.
+ * When a component is used multiple times on a page, its entries are in different
+ * subtrees. We partition by finding which direct child of the LCA each entry belongs to.
+ */
+export declare function clusterComponentEntries<T>(elements: T[], entryIds: string[], findLCA: (els: T[]) => T | null): Array<{
+    clusterEntryIds: string[];
+    clusterElements: T[];
+}>;
+/**
+ * Process build output - processes all HTML files in parallel.
+ * Uses error aggregation to continue processing even if some files fail.
+ */
+export declare function processBuildOutput(dir: URL, config: Required<CmsMarkerOptions>, manifestWriter: ManifestWriter, idCounter: {
+    value: number;
+}, logger?: AstroIntegrationLogger): Promise<void>;
+//# sourceMappingURL=build-processor.d.ts.map

package/dist/src/build-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-processor.d.ts","sourceRoot":"","sources":["../../src/build-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAOnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAcvD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAA;AA6BhE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,GAC7B,KAAK,CAAC;IAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC,CAkD5D;AAwkBD;;;GAGG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAClC,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5B,MAAM,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/src/collection-scanner.d.ts

@@ -0,0 +1,6 @@
+import type { CollectionDefinition } from './types';
+/**
+ * Scan all collections in the content directory
+ */
+export declare function scanCollections(contentDir?: string): Promise<Record<string, CollectionDefinition>>;
+//# sourceMappingURL=collection-scanner.d.ts.map

package/dist/src/collection-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-scanner.d.ts","sourceRoot":"","sources":["../../src/collection-scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAmD,MAAM,SAAS,CAAA;AA+QpG;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAyBvH"}

package/dist/src/component-registry.d.ts

@@ -0,0 +1,63 @@
+import type { ComponentDefinition } from './types';
+/**
+ * Scans Astro component files and extracts their definitions including props
+ */
+export declare class ComponentRegistry {
+    private components;
+    private componentDirs;
+    constructor(componentDirs?: string[]);
+    /**
+     * Scan all component directories and build the registry
+     */
+    scan(): Promise<void>;
+    /**
+     * Get all registered components
+     */
+    getComponents(): Record<string, ComponentDefinition>;
+    /**
+     * Get a specific component by name
+     */
+    getComponent(name: string): ComponentDefinition | undefined;
+    /**
+     * Scan a directory recursively for .astro files
+     */
+    private scanDirectory;
+    /**
+     * Parse a single Astro component file
+     */
+    private parseComponent;
+    /**
+     * Parse Props content and extract individual property definitions
+     * Handles multi-line properties with nested types
+     */
+    private parsePropsContent;
+    /**
+     * Extract content between balanced braces after a pattern match
+     * Properly handles nested objects
+     */
+    private extractBalancedBraces;
+    /**
+     * Extract props from component frontmatter
+     */
+    private extractProps;
+    /**
+     * Extract slot names from template
+     */
+    private extractSlots;
+    /**
+     * Extract component description from JSDoc comment
+     */
+    private extractDescription;
+    /**
+     * Extract @previewWidth value from JSDoc comment
+     */
+    private extractPreviewWidth;
+}
+/**
+ * Parse component usage in an Astro file to extract prop values
+ */
+export declare function parseComponentUsage(content: string, componentName: string): Array<{
+    line: number;
+    props: Record<string, string>;
+}>;
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/src/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/component-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAA;AAEjE;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,aAAa,CAAU;gBAEnB,aAAa,GAAE,MAAM,EAAuB;IAIxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAIpD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI3D;;OAEG;YACW,aAAa;IAe3B;;OAEG;YACW,cAAc;IAuB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2FzB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;YACW,YAAY;IA2C1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAU3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACnB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA0BxD"}

package/dist/src/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Global configuration for cms-marker.
+ * This allows overriding the project root for testing.
+ */
+/**
+ * Get the current project root directory.
+ * Returns the override if set, otherwise process.cwd().
+ */
+export declare function getProjectRoot(): string;
+/**
+ * Set the project root directory override.
+ * Call this to use a specific directory instead of process.cwd().
+ */
+export declare function setProjectRoot(root: string): void;
+/**
+ * Reset the project root to use process.cwd() again.
+ */
+export declare function resetProjectRoot(): void;
+export declare function getValidationRoot(): string;
+/**
+ * Reset the cached validation root (call when project root changes).
+ */
+export declare function resetValidationRoot(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AASD,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/src/dev-middleware.d.ts

@@ -0,0 +1,20 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ManifestWriter } from './manifest-writer';
+import type { MediaStorageAdapter } from './media/types';
+import type { CmsMarkerOptions, ComponentDefinition } from './types';
+/** Minimal ViteDevServer interface to avoid version conflicts between Astro's bundled Vite and root Vite */
+interface ViteDevServerLike {
+    middlewares: {
+        use: (middleware: (req: IncomingMessage, res: ServerResponse, next: () => void) => void) => void;
+    };
+    transformIndexHtml: (url: string, html: string) => Promise<string>;
+}
+export interface DevMiddlewareOptions {
+    enableCmsApi?: boolean;
+    mediaAdapter?: MediaStorageAdapter;
+}
+export declare function createDevMiddleware(server: ViteDevServerLike, config: Required<CmsMarkerOptions>, manifestWriter: ManifestWriter, componentDefinitions: Record<string, ComponentDefinition>, idCounter: {
+    value: number;
+}, options?: DevMiddlewareOptions): void;
+export {};
+//# sourceMappingURL=dev-middleware.d.ts.map

package/dist/src/dev-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-middleware.d.ts","sourceRoot":"","sources":["../../src/dev-middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAkBhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,mBAAmB,EAAe,MAAM,SAAS,CAAA;AAGlG,4GAA4G;AAC5G,UAAU,iBAAiB;IAC1B,WAAW,EAAE;QACZ,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,CAAA;KAChG,CAAA;IACD,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,oBAAoB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,mBAAmB,CAAA;CAClC;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAClC,cAAc,EAAE,cAAc,EAC9B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACzD,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5B,OAAO,GAAE,oBAAyB,QAoMlC"}

package/dist/src/editor/ai.d.ts

@@ -0,0 +1,60 @@
+import { type CmsAiAction } from './api';
+import type { CmsConfig, ComponentProp } from './types';
+export type { CmsAiAction };
+export interface AIRequest {
+    prompt: string;
+    elementId: string;
+    currentContent: string;
+    context?: string;
+}
+export interface AIBlockPropsRequest {
+    prompt: string;
+    componentName: string;
+    props: ComponentProp[];
+    currentValues: Record<string, unknown>;
+    context?: string;
+}
+export interface AIStreamCallbacks {
+    onStart?: () => void;
+    onToken?: (token: string, fullText: string) => void;
+    onComplete?: (finalText: string) => void;
+    onError?: (error: Error) => void;
+    /** Called when AI provides status updates (thinking, coding, building, deploying) */
+    onStatus?: (status: string, message?: string) => void;
+    /** Called when AI requests an action (refresh page, show preview, apply edit) */
+    onAction?: (action: CmsAiAction) => void;
+}
+export interface AIConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+}
+export declare function getAIConfig(config: CmsConfig): AIConfig;
+export declare class AIService {
+    private config;
+    private aiConfig;
+    private abortController;
+    constructor(config: CmsConfig);
+    /**
+     * Stream AI chat request using rich SSE events
+     * Supports status updates, actions (refresh, preview), and streaming text
+     */
+    streamRequest(request: AIRequest, callbacks: AIStreamCallbacks): Promise<void>;
+    abort(): void;
+    isStreaming(): boolean;
+    /**
+     * Generate prop values for a component using AI
+     */
+    generateBlockProps(request: AIBlockPropsRequest): Promise<Record<string, unknown>>;
+    /**
+     * Suggest the best component to use based on user intent
+     */
+    suggestComponent(prompt: string, availableComponents: Array<{
+        name: string;
+        description?: string;
+        props: ComponentProp[];
+    }>): Promise<{
+        componentName: string;
+        suggestedProps: Record<string, unknown>;
+    } | null>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/src/editor/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/editor/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAkE,MAAM,OAAO,CAAA;AAExG,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGvD,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAOvD;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,MAAM,EAAE,SAAS;IAK7B;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDpF,KAAK,IAAI,IAAI;IAOb,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA4BxF;;OAEG;IACG,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC,GACxF,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CAwBrF"}

package/dist/src/editor/api.d.ts

@@ -0,0 +1,140 @@
+import type { CmsManifest, ComponentInsertOperation, DeploymentStatusResponse, SaveBatchRequest, SaveBatchResponse, UpdateMarkdownPageRequest, UpdateMarkdownPageResponse } from './types';
+/**
+ * Response from fetching markdown content
+ */
+export interface GetMarkdownContentResponse {
+    content: string;
+    frontmatter: Record<string, unknown>;
+    filePath: string;
+}
+/**
+ * Types for CMS AI chat communication (SSE events)
+ */
+export interface CmsAiChatRequest {
+    prompt: string;
+    elementId?: string;
+    currentContent?: string;
+    pageUrl: string;
+    /** Source file context for the element being edited */
+    context?: string;
+    sessionId?: string;
+}
+export type CmsAiEvent = CmsAiTokenEvent | CmsAiStatusEvent | CmsAiActionEvent | CmsAiErrorEvent | CmsAiDoneEvent;
+export interface CmsAiTokenEvent {
+    type: 'token';
+    token: string;
+    fullText: string;
+}
+export interface CmsAiStatusEvent {
+    type: 'status';
+    status: 'thinking' | 'coding' | 'building' | 'deploying' | 'complete';
+    message?: string;
+}
+export interface CmsAiActionEvent {
+    type: 'action';
+    action: CmsAiAction;
+}
+export type CmsAiAction = {
+    name: 'refresh';
+} | {
+    name: 'preview';
+    url: string;
+} | {
+    name: 'commit';
+    sha: string;
+    message: string;
+} | {
+    name: 'apply-edit';
+    elementId: string;
+    content: string;
+    htmlContent?: string;
+};
+export interface CmsAiErrorEvent {
+    type: 'error';
+    error: string;
+    code?: string;
+}
+export interface CmsAiDoneEvent {
+    type: 'done';
+    summary?: string;
+}
+export interface CmsAiStreamCallbacks {
+    onToken?: (token: string, fullText: string) => void;
+    onStatus?: (status: CmsAiStatusEvent['status'], message?: string) => void;
+    onAction?: (action: CmsAiAction) => void;
+    onError?: (error: string, code?: string) => void;
+    onDone?: (summary?: string) => void;
+}
+/**
+ * Get the manifest URL for the current page
+ * For example: /about -> /about.json
+ *              / -> /index.json
+ *              /blog/post -> /blog/post.json
+ */
+export declare function getPageManifestUrl(pathname: string): string;
+/**
+ * Fetch manifest by combining page-specific and global manifests:
+ * 1. Per-page manifest (/{page}.json) - contains entries, components for this page
+ * 2. Global manifest (/cms-manifest.json) - contains componentDefinitions, availableColors
+ */
+export declare function fetchManifest(): Promise<CmsManifest>;
+export declare function saveBatchChanges(apiBase: string, request: SaveBatchRequest): Promise<SaveBatchResponse>;
+export interface InsertComponentResponse {
+    success: boolean;
+    message?: string;
+    sourceFile?: string;
+    commit?: string | null;
+    commitMessage?: string;
+    error?: string;
+}
+export declare function insertComponent(apiBase: string, operation: ComponentInsertOperation): Promise<InsertComponentResponse>;
+export interface RemoveComponentResponse {
+    success: boolean;
+    message?: string;
+    sourceFile?: string;
+    commit?: string | null;
+    commitMessage?: string;
+    error?: string;
+}
+export declare function removeComponent(apiBase: string, componentId: string): Promise<RemoveComponentResponse>;
+/**
+ * Parse SSE data line to event
+ */
+export declare function parseSseEvent(data: string): CmsAiEvent | null;
+/**
+ * Stream AI chat response from the server using SSE
+ * Provides rich events including status updates, actions (refresh, preview), and streaming tokens
+ */
+export declare function streamAiChat(apiBase: string, request: CmsAiChatRequest, callbacks: CmsAiStreamCallbacks, abortSignal?: AbortSignal): Promise<void>;
+/**
+ * Chat message type from history endpoint
+ */
+export interface ChatHistoryMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'tool';
+    content: string | null;
+    created_at: string;
+    channel?: string;
+    identifier?: string;
+}
+export interface ChatHistoryResponse {
+    messages: ChatHistoryMessage[];
+    hasMore: boolean;
+}
+/**
+ * Fetch AI chat history for the current project
+ */
+export declare function getChatHistory(apiBase: string, limit?: number): Promise<ChatHistoryResponse>;
+/**
+ * Fetch deployment status for the current project
+ */
+export declare function getDeploymentStatus(apiBase: string): Promise<DeploymentStatusResponse>;
+/**
+ * Fetch markdown content from a file
+ */
+export declare function getMarkdownContent(apiBase: string, filePath: string): Promise<GetMarkdownContentResponse | null>;
+/**
+ * Update markdown page content
+ */
+export declare function updateMarkdownPage(apiBase: string, request: UpdateMarkdownPageRequest): Promise<UpdateMarkdownPageResponse>;
+//# sourceMappingURL=api.d.ts.map

package/dist/src/editor/api.d.ts.map

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