handoff-app 1.2.0-0 → 1.2.0-2

package/dist/app-builder/build.js

@@ -107,9 +107,11 @@ const buildApp = (handoff, skipComponents) => __awaiter(void 0, void 0, void 0,
     // Build app
     const buildResult = cross_spawn_1.default.sync('npx', ['next', 'build'], {
         cwd: appPath,
-        stdio: 'inherit',
+        stdio: ['inherit', 'pipe', 'pipe'],
         env: Object.assign(Object.assign({}, process.env), { NODE_ENV: 'production' }),
     });
+    logger_1.Logger.childProcessBuffer(buildResult.stdout);
+    logger_1.Logger.childProcessBuffer(buildResult.stderr);
     if (buildResult.status !== 0) {
         let errorMsg = `Next.js build failed with exit code ${buildResult.status}`;
         if (buildResult.error) {
@@ -155,19 +157,28 @@ const watchApp = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
         // create empty directory
         yield fs_extra_1.default.ensureDir(moduleOutput);
     }
+    logger_1.Logger.info(`Starting Next.js dev server (Turbopack) at http://${hostname}:${port}…`);
     const nextProcess = (0, cross_spawn_1.default)('npx', ['next', 'dev', '--turbopack', '--port', String(port)], {
         cwd: appPath,
-        stdio: 'inherit',
+        stdio: ['inherit', 'pipe', 'pipe'],
         env: Object.assign(Object.assign({}, process.env), { NODE_ENV: 'development' }),
     });
-    logger_1.Logger.success(`Ready on http://${hostname}:${port}`);
+    logger_1.Logger.pipeChildStreams(nextProcess.stdout, nextProcess.stderr);
     nextProcess.on('error', (error) => {
-        logger_1.Logger.error(`Next.js dev process error: ${error}`);
+        logger_1.Logger.error(`Next.js dev process failed to start: ${error}`);
         process.exit(1);
     });
-    nextProcess.on('close', (code) => {
-        logger_1.Logger.success(`Next.js dev process closed with code ${code}`);
-        process.exit(code);
+    nextProcess.on('close', (code, signal) => {
+        if (code === 0) {
+            logger_1.Logger.success(`Next.js dev process exited normally`);
+        }
+        else if (signal) {
+            logger_1.Logger.warn(`Next.js dev process stopped (${signal})`);
+        }
+        else {
+            logger_1.Logger.error(`Next.js dev process exited with code ${code}`);
+        }
+        process.exit(code !== null && code !== void 0 ? code : 1);
     });
     const wss = yield (0, websocket_1.createWebSocketServer)((_d = (_c = handoff.config.app.ports) === null || _c === void 0 ? void 0 : _c.websocket) !== null && _d !== void 0 ? _d : 3001);
     const chokidarConfig = {
@@ -205,12 +216,15 @@ const devApp = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
     }
     // Persist client configuration
     yield (0, client_config_1.persistClientConfig)(handoff);
-    // Run
-    const devResult = cross_spawn_1.default.sync('npx', ['next', 'dev', '--turbopack', '--port', String((_b = (_a = handoff.config.app.ports) === null || _a === void 0 ? void 0 : _a.app) !== null && _b !== void 0 ? _b : 3000)], {
+    const devPort = (_b = (_a = handoff.config.app.ports) === null || _a === void 0 ? void 0 : _a.app) !== null && _b !== void 0 ? _b : 3000;
+    logger_1.Logger.info(`Starting Next.js dev server (Turbopack) on port ${devPort}…`);
+    const devResult = cross_spawn_1.default.sync('npx', ['next', 'dev', '--turbopack', '--port', String(devPort)], {
         cwd: appPath,
-        stdio: 'inherit',
+        stdio: ['inherit', 'pipe', 'pipe'],
         env: Object.assign(Object.assign({}, process.env), { NODE_ENV: 'development' }),
     });
+    logger_1.Logger.childProcessBuffer(devResult.stdout);
+    logger_1.Logger.childProcessBuffer(devResult.stderr);
     if (devResult.status !== 0) {
         let errorMsg = `Next.js dev failed with exit code ${devResult.status}`;
         if (devResult.error) {

package/dist/app-builder/config-diff/index.d.ts

@@ -1,4 +1,4 @@
-export type { ConfigDiffStrategy, RebuildHandle } from './types';
+export type { ConfigDiffStrategy, FinalizeContext, RebuildHandle } from './types';
 export { type MapSnapshot, diffMapSnapshots, stableStringify } from './snapshot';
 export { patternDiffStrategy } from './strategies/pattern';
 export { getAllStrategies, getStrategy, runAllFinalizers } from './registry';

package/dist/app-builder/config-diff/registry.d.ts

@@ -1,9 +1,9 @@
 import Handoff from '../..';
-import { ConfigDiffStrategy } from './types';
+import { ConfigDiffStrategy, FinalizeContext } from './types';
 export declare const getStrategy: (kind: string) => ConfigDiffStrategy | undefined;
 export declare const getAllStrategies: () => ConfigDiffStrategy[];
 /**
  * Runs every registered strategy finalizer.
  * Called after component rebuilds so derived artifacts stay up-to-date.
  */
-export declare const runAllFinalizers: (handoff: Handoff) => Promise<void>;
+export declare const runAllFinalizers: (handoff: Handoff, context?: FinalizeContext) => Promise<void>;

package/dist/app-builder/config-diff/registry.js

@@ -22,9 +22,9 @@ exports.getAllStrategies = getAllStrategies;
  * Runs every registered strategy finalizer.
  * Called after component rebuilds so derived artifacts stay up-to-date.
  */
-const runAllFinalizers = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
+const runAllFinalizers = (handoff, context) => __awaiter(void 0, void 0, void 0, function* () {
     for (const strategy of strategies.values()) {
-        yield strategy.finalize(handoff);
+        yield strategy.finalize(handoff, context);
     }
 });
 exports.runAllFinalizers = runAllFinalizers;

package/dist/app-builder/config-diff/strategies/pattern.js

@@ -35,6 +35,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.patternDiffStrategy = void 0;
 const patterns_1 = require("../../../pipeline/patterns");
 const builder_1 = __importStar(require("../../../transformers/preview/component/builder"));
+const builder_2 = require("../../../transformers/preview/pattern/builder");
 const logger_1 = require("../../../utils/logger");
 const snapshot_1 = require("../snapshot");
 /**
@@ -85,8 +86,20 @@ exports.patternDiffStrategy = {
             },
         };
     },
-    finalize(handoff) {
+    finalize(handoff, context) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (context === null || context === void 0 ? void 0 : context.skipPatternFinalizer) {
+                return;
+            }
+            const componentIds = context === null || context === void 0 ? void 0 : context.patternRebuildComponentIds;
+            if (componentIds === null || componentIds === void 0 ? void 0 : componentIds.length) {
+                const patternIds = (0, builder_2.getPatternIdsReferencingComponents)(handoff, componentIds);
+                if (patternIds.length === 0) {
+                    return;
+                }
+                yield (0, patterns_1.buildPatterns)(handoff, { onlyPatternIds: new Set(patternIds) });
+                return;
+            }
             yield (0, patterns_1.buildPatterns)(handoff);
         });
     },

package/dist/app-builder/config-diff/types.d.ts

@@ -1,4 +1,18 @@
 import Handoff from '../..';
+/**
+ * Optional hints for post-build finalizers (e.g. selective pattern rebuild).
+ */
+export type FinalizeContext = {
+    /**
+     * Only patterns that reference at least one of these component ids are rebuilt.
+     * When omitted, all patterns are rebuilt.
+     */
+    patternRebuildComponentIds?: string[];
+    /**
+     * When true, skip pattern artifact generation (no component preview HTML changed).
+     */
+    skipPatternFinalizer?: boolean;
+};
 /**
  * Handle returned by ConfigDiffStrategy.capture().
  *
@@ -15,5 +29,5 @@ export interface RebuildHandle {
 export interface ConfigDiffStrategy {
     readonly kind: string;
     capture(handoff: Handoff, entityId: string): RebuildHandle;
-    finalize(handoff: Handoff): Promise<void>;
+    finalize(handoff: Handoff, context?: FinalizeContext): Promise<void>;
 }

package/dist/app-builder/paths.js

@@ -41,6 +41,15 @@ const getAppPath = (handoff) => {
     return path_1.default.resolve(handoff.modulePath, '.handoff', `${handoff.getProjectId()}`);
 };
 exports.getAppPath = getAppPath;
+const mirrorDirectory = (sourcePath, destinationPath) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!(yield fs_extra_1.default.pathExists(sourcePath))) {
+        yield fs_extra_1.default.remove(destinationPath);
+        return;
+    }
+    yield fs_extra_1.default.remove(destinationPath);
+    yield fs_extra_1.default.ensureDir(path_1.default.dirname(destinationPath));
+    yield fs_extra_1.default.copy(sourcePath, destinationPath, { overwrite: true });
+});
 /**
  * Copy the public dir from the working dir to the module dir.
  */
@@ -48,9 +57,17 @@ const syncPublicFiles = (handoff) => __awaiter(void 0, void 0, void 0, function*
     const appPath = (0, exports.getAppPath)(handoff);
     const workingPublicPath = (0, exports.getWorkingPublicPath)(handoff);
     if (workingPublicPath) {
-        yield fs_extra_1.default.copy(workingPublicPath, path_1.default.resolve(appPath, 'public'), {
+        const destinationPublicPath = path_1.default.resolve(appPath, 'public');
+        const sourceApiPath = path_1.default.resolve(workingPublicPath, 'api');
+        const destinationApiPath = path_1.default.resolve(destinationPublicPath, 'api');
+        yield fs_extra_1.default.copy(workingPublicPath, destinationPublicPath, {
             overwrite: true,
+            filter: (file) => {
+                const relativePath = path_1.default.relative(workingPublicPath, file);
+                return relativePath !== 'api' && !relativePath.startsWith(`api${path_1.default.sep}`);
+            },
         });
+        yield mirrorDirectory(sourceApiPath, destinationApiPath);
     }
 });
 exports.syncPublicFiles = syncPublicFiles;

package/dist/app-builder/watchers.js

@@ -1,4 +1,27 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -16,7 +39,7 @@ exports.watchComponentDirectories = exports.watchRuntimeConfiguration = exports.
 const chokidar_1 = __importDefault(require("chokidar"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
-const builder_1 = __importDefault(require("../transformers/preview/component/builder"));
+const builder_1 = __importStar(require("../transformers/preview/component/builder"));
 const css_1 = require("../transformers/preview/component/css");
 const javascript_1 = require("../transformers/preview/component/javascript");
 const logger_1 = require("../utils/logger");
@@ -181,8 +204,17 @@ const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) =>
                             const entryType = runtimeComponentEntryTypeByPath.get(normalizedFile);
                             const segmentToUpdate = entryType ? (0, component_1.mapEntryTypeToSegment)(entryType) : undefined;
                             const componentId = (0, component_1.resolveComponentIdForChangedFile)(handoff, file);
+                            const skipPatterns = segmentToUpdate === builder_1.ComponentSegment.JavaScript ||
+                                segmentToUpdate === builder_1.ComponentSegment.Style;
+                            let finalizeContext;
+                            if (skipPatterns) {
+                                finalizeContext = { skipPatternFinalizer: true };
+                            }
+                            else if (componentId) {
+                                finalizeContext = { patternRebuildComponentIds: [componentId] };
+                            }
                             yield (0, builder_1.default)(handoff, componentId, segmentToUpdate);
-                            yield (0, config_diff_1.runAllFinalizers)(handoff);
+                            yield (0, config_diff_1.runAllFinalizers)(handoff, finalizeContext);
                         }
                         catch (e) {
                             logger_1.Logger.error('Error processing component:', e);
@@ -298,7 +330,7 @@ const watchComponentDirectories = (handoff, state, chokidarConfig) => {
                 (0, exports.watchRuntimeComponents)(handoff, state, (0, component_1.getRuntimeComponentsPathsToWatch)(handoff));
                 (0, exports.watchRuntimeConfiguration)(handoff, state);
                 yield (0, builder_1.default)(handoff, dirName);
-                yield (0, config_diff_1.runAllFinalizers)(handoff);
+                yield (0, config_diff_1.runAllFinalizers)(handoff, { patternRebuildComponentIds: [dirName] });
             }
             catch (e) {
                 logger_1.Logger.error('Error processing new component:', e);

package/dist/app-builder/websocket.js

@@ -20,7 +20,14 @@ const logger_1 = require("../utils/logger");
  * @returns A function that accepts a message string and broadcasts it to all connected clients.
  */
 const createWebSocketServer = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (port = 3001) {
+    logger_1.Logger.info(`Starting WebSocket server for live reload on port ${port}…`);
     const wss = new ws_1.WebSocket.Server({ port });
+    wss.on('listening', () => {
+        logger_1.Logger.info(`WebSocket server listening on ws://localhost:${port} (live reload)`);
+    });
+    wss.on('error', (err) => {
+        logger_1.Logger.error(`WebSocket server failed${err instanceof Error ? `: ${err.message}` : ''}`, err instanceof Error ? err : undefined);
+    });
     // Heartbeat function to mark a connection as alive.
     const heartbeat = function () {
         this.isAlive = true;
@@ -30,7 +37,7 @@ const createWebSocketServer = (...args_1) => __awaiter(void 0, [...args_1], void
         const extWs = ws;
         extWs.isAlive = true;
         extWs.send(JSON.stringify({ type: 'WELCOME' }));
-        extWs.on('error', (error) => logger_1.Logger.error('WebSocket error:', error));
+        extWs.on('error', (error) => logger_1.Logger.error('WebSocket client error:', error));
         extWs.on('pong', heartbeat);
     });
     // Periodically ping clients to ensure they are still connected
@@ -38,7 +45,7 @@ const createWebSocketServer = (...args_1) => __awaiter(void 0, [...args_1], void
         wss.clients.forEach((client) => {
             const extWs = client;
             if (!extWs.isAlive) {
-                logger_1.Logger.warn('Terminating inactive client');
+                logger_1.Logger.debug('Terminating inactive WebSocket client');
                 return client.terminate();
             }
             extWs.isAlive = false;
@@ -49,10 +56,9 @@ const createWebSocketServer = (...args_1) => __awaiter(void 0, [...args_1], void
     wss.on('close', () => {
         clearInterval(pingInterval);
     });
-    logger_1.Logger.success(`WebSocket server listening on ws://localhost:${port}`);
     // Return a function to broadcast a message to all connected clients
     return (message) => {
-        logger_1.Logger.success(`Broadcasting message to ${wss.clients.size} client(s)`);
+        logger_1.Logger.debug(`Broadcasting reload to ${wss.clients.size} WebSocket client(s)`);
         wss.clients.forEach((client) => {
             if (client.readyState === ws_1.WebSocket.OPEN) {
                 client.send(message);

package/dist/cli.js

@@ -19,7 +19,7 @@ class HandoffCliError extends Error {
  * Show the help message
  */
 const showVersion = () => {
-    return 'Handoff App - 1.2.0-0';
+    return 'Handoff App - 1.2.0-2';
 };
 /**
  * Define a CLI error

package/dist/config/normalizers/pattern.d.ts

@@ -3,7 +3,6 @@ type RawPatternDeclaration = Record<string, any>;
 type NormalizePatternOptions = {
     declarationPath: string;
     fallbackId: string;
-    warn: (message: string) => void;
 };
 export declare const normalizePatternDeclaration: (raw: RawPatternDeclaration, options: NormalizePatternOptions) => PatternListObject;
 export {};

package/dist/config/normalizers/pattern.js

@@ -13,9 +13,6 @@ const normalizePatternDeclaration = (raw, options) => {
             throw new Error(`Pattern "${options.fallbackId}" in "${options.declarationPath}" has an invalid component reference at index ${index}: missing "id".`);
         }
         const preview = typeof ref.preview === 'string' ? ref.preview.trim() : undefined;
-        if (!preview && !ref.args) {
-            options.warn(`Pattern "${options.fallbackId}" component ref "${ref.id}" at index ${index} has neither "preview" nor "args". The component's default preview will be used.`);
-        }
         return {
             id: ref.id.trim(),
             preview,

package/dist/config/runtime.js

@@ -217,7 +217,6 @@ const initRuntimeConfig = (handoff) => {
                 pattern = (0, pattern_1.normalizePatternDeclaration)(rawPattern, {
                     declarationPath: resolvedPatternConfigPath,
                     fallbackId: patternBaseName,
-                    warn: (message) => logger_1.Logger.warn(message),
                 });
             }
             catch (err) {
@@ -313,11 +312,18 @@ const injectPatternPreviews = (result) => {
                 ref.resolvedPreview = ref.preview;
                 continue;
             }
-            // Case 2: no preview AND no args -> use the component's first existing preview
+            // Case 2: no preview AND no args -> use the component's first existing preview (never assume "default")
             if (!ref.preview && !ref.args) {
                 const previewKeys = Object.keys(component.previews || {});
-                ref.resolvedPreview = previewKeys[0] || 'default';
-                ref.resolved = true;
+                const firstPreview = previewKeys[0];
+                if (firstPreview) {
+                    ref.resolvedPreview = firstPreview;
+                    ref.resolved = true;
+                }
+                else {
+                    logger_1.Logger.warn(`Pattern "${patternId}" component ref "${ref.id}" has neither "preview" nor "args", and the component has no previews. This fragment will be skipped.`);
+                    ref.resolved = false;
+                }
                 continue;
             }
             // Case 3: args present (with or without preview base) -> create synthetic preview

package/dist/pipeline/patterns.d.ts

@@ -1,6 +1,8 @@
 import Handoff from '..';
+import { ProcessPatternsOptions } from '../transformers/preview/pattern/builder';
+export type { ProcessPatternsOptions };
 /**
  * Builds pattern previews by composing pre-built component preview HTML.
  * Must be called AFTER buildComponents.
  */
-export declare const buildPatterns: (handoff: Handoff) => Promise<void>;
+export declare const buildPatterns: (handoff: Handoff, options?: ProcessPatternsOptions) => Promise<void>;

package/dist/pipeline/patterns.js

@@ -15,7 +15,7 @@ const builder_1 = require("../transformers/preview/pattern/builder");
  * Builds pattern previews by composing pre-built component preview HTML.
  * Must be called AFTER buildComponents.
  */
-const buildPatterns = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, builder_1.processPatterns)(handoff);
+const buildPatterns = (handoff, options) => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, builder_1.processPatterns)(handoff, options);
 });
 exports.buildPatterns = buildPatterns;

package/dist/transformers/plugins/csf-render.js

@@ -22,6 +22,7 @@ const react_element_to_jsx_string_1 = __importDefault(require("react-element-to-
 const logger_1 = require("../../utils/logger");
 const docgen_1 = require("../docgen");
 const component_1 = require("../preview/component");
+const css_1 = require("../preview/component/css");
 const html_1 = require("../utils/html");
 const module_1 = require("../utils/module");
 const schema_1 = require("../utils/schema");
@@ -240,7 +241,7 @@ function createHtmlDocument(componentId, previewTitle, renderedHtml) {
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="stylesheet" href="${(_a = process.env.HANDOFF_APP_BASE_PATH) !== null && _a !== void 0 ? _a : ''}/api/component/main.css" />
+    <link rel="stylesheet" href="${(_a = process.env.HANDOFF_APP_BASE_PATH) !== null && _a !== void 0 ? _a : ''}/api/component/${css_1.MAIN_COMPONENT_CSS_FILE}" />
     <link rel="stylesheet" href="${(_b = process.env.HANDOFF_APP_BASE_PATH) !== null && _b !== void 0 ? _b : ''}/api/component/${componentId}.css" />
     <link rel="stylesheet" href="${(_c = process.env.HANDOFF_APP_BASE_PATH) !== null && _c !== void 0 ? _c : ''}/assets/css/preview.css" />
     <title>${previewTitle}</title>

package/dist/transformers/plugins/ssr-render.js

@@ -21,6 +21,7 @@ const server_1 = __importDefault(require("react-dom/server"));
 const vite_1 = require("vite");
 const logger_1 = require("../../utils/logger");
 const docgen_1 = require("../docgen");
+const css_1 = require("../preview/component/css");
 const build_1 = require("../utils/build");
 const html_1 = require("../utils/html");
 const module_1 = require("../utils/module");
@@ -117,7 +118,7 @@ function generateHtmlDocument(componentId, previewTitle, renderedHtml, clientJs,
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="stylesheet" href="${(_a = process.env.HANDOFF_APP_BASE_PATH) !== null && _a !== void 0 ? _a : ''}/api/component/main.css" />
+    <link rel="stylesheet" href="${(_a = process.env.HANDOFF_APP_BASE_PATH) !== null && _a !== void 0 ? _a : ''}/api/component/${css_1.MAIN_COMPONENT_CSS_FILE}" />
     <link rel="stylesheet" href="${(_b = process.env.HANDOFF_APP_BASE_PATH) !== null && _b !== void 0 ? _b : ''}/api/component/${componentId}.css" />
     <link rel="stylesheet" href="${(_c = process.env.HANDOFF_APP_BASE_PATH) !== null && _c !== void 0 ? _c : ''}/assets/css/preview.css" />
     <script id="${PLUGIN_CONSTANTS.PROPS_SCRIPT_ID}" type="application/json">${JSON.stringify(props)}</script>

package/dist/transformers/preview/component/api.d.ts

@@ -1,19 +1,8 @@
 import Handoff from '../../../index';
 import { ComponentListObject, TransformComponentTokensResult } from '../types';
+export declare const sanitizeComponentApiData: (component: TransformComponentTokensResult) => TransformComponentTokensResult;
 export declare const getAPIPath: (handoff: Handoff) => string;
-/**
- * Build the preview API from the component data
- * @param handoff
- * @param componentData
- */
-declare const writeComponentSummaryAPI: (handoff: Handoff, componentData: ComponentListObject[]) => Promise<void>;
 export declare const writeComponentApi: (id: string, component: TransformComponentTokensResult, handoff: Handoff, preserveKeys?: string[]) => Promise<void>;
-/**
- * Update the main component summary API with the new component data
- * @param handoff
- * @param componentData
- */
-export declare const updateComponentSummaryApi: (handoff: Handoff, componentData: ComponentListObject[], isFullRebuild?: boolean) => Promise<void>;
 /**
  * Read the component API data
  * @param handoff
@@ -28,4 +17,4 @@ export declare const readComponentApi: (handoff: Handoff, id: string) => Promise
  * @returns The component summary or null if not found
  */
 export declare const readComponentMetadataApi: (handoff: Handoff, id: string) => Promise<ComponentListObject | null>;
-export default writeComponentSummaryAPI;
+export default writeComponentApi;

package/dist/transformers/preview/component/api.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readComponentMetadataApi = exports.readComponentApi = exports.updateComponentSummaryApi = exports.writeComponentApi = exports.getAPIPath = void 0;
+exports.readComponentMetadataApi = exports.readComponentApi = exports.writeComponentApi = exports.getAPIPath = exports.sanitizeComponentApiData = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const previews_1 = require("./previews");
@@ -23,6 +23,7 @@ const sanitizeComponentApiData = (component) => {
     delete sanitized.internalPatternPreviews;
     return sanitized;
 };
+exports.sanitizeComponentApiData = sanitizeComponentApiData;
 /**
  * Merges values from a source object into a target object, returning a new object.
  * For each key present in either object:
@@ -62,28 +63,19 @@ const getAPIPath = (handoff) => {
     return apiPath;
 };
 exports.getAPIPath = getAPIPath;
-/**
- * Build the preview API from the component data
- * @param handoff
- * @param componentData
- */
-const writeComponentSummaryAPI = (handoff, componentData) => __awaiter(void 0, void 0, void 0, function* () {
-    componentData.sort((a, b) => a.title.localeCompare(b.title));
-    yield fs_extra_1.default.writeFile(path_1.default.resolve((0, exports.getAPIPath)(handoff), 'components.json'), JSON.stringify(componentData, null, 2));
-});
 const writeComponentApi = (id_1, component_1, handoff_1, ...args_1) => __awaiter(void 0, [id_1, component_1, handoff_1, ...args_1], void 0, function* (id, component, handoff, preserveKeys = []) {
     const outputDirPath = path_1.default.resolve((0, exports.getAPIPath)(handoff), 'component');
     const outputFilePath = path_1.default.resolve(outputDirPath, `${id}.json`);
-    const sanitizedComponent = sanitizeComponentApiData(component);
+    const sanitizedComponent = (0, exports.sanitizeComponentApiData)(component);
     if (fs_extra_1.default.existsSync(outputFilePath)) {
         const existingJson = yield fs_extra_1.default.readFile(outputFilePath, 'utf8');
         if (existingJson) {
             try {
-                const existingData = sanitizeComponentApiData(JSON.parse(existingJson));
+                const existingData = (0, exports.sanitizeComponentApiData)(JSON.parse(existingJson));
                 // Special case: always allow page to be cleared when undefined
                 // This handles the case where page slices are removed
                 const finalPreserveKeys = sanitizedComponent.page === undefined ? preserveKeys.filter((key) => key !== 'page') : preserveKeys;
-                const mergedData = sanitizeComponentApiData(updateObject(existingData, sanitizedComponent, finalPreserveKeys));
+                const mergedData = (0, exports.sanitizeComponentApiData)(updateObject(existingData, sanitizedComponent, finalPreserveKeys));
                 yield fs_extra_1.default.writeFile(outputFilePath, JSON.stringify(mergedData, null, 2));
                 return;
             }
@@ -98,37 +90,6 @@ const writeComponentApi = (id_1, component_1, handoff_1, ...args_1) => __awaiter
     yield fs_extra_1.default.writeFile(outputFilePath, JSON.stringify(sanitizedComponent, null, 2));
 });
 exports.writeComponentApi = writeComponentApi;
-/**
- * Update the main component summary API with the new component data
- * @param handoff
- * @param componentData
- */
-const updateComponentSummaryApi = (handoff_1, componentData_1, ...args_1) => __awaiter(void 0, [handoff_1, componentData_1, ...args_1], void 0, function* (handoff, componentData, isFullRebuild = false) {
-    if (isFullRebuild) {
-        // Full rebuild: replace the entire file
-        yield writeComponentSummaryAPI(handoff, componentData);
-        return;
-    }
-    // Partial update: merge with existing data
-    const apiPath = path_1.default.resolve((0, exports.getAPIPath)(handoff), 'components.json');
-    let existingData = [];
-    if (fs_extra_1.default.existsSync(apiPath)) {
-        try {
-            const existing = yield fs_extra_1.default.readFile(apiPath, 'utf8');
-            existingData = JSON.parse(existing).map((component) => (Object.assign(Object.assign({}, component), { previews: (0, previews_1.getDocumentedPreviews)(component.previews) })));
-        }
-        catch (_a) {
-            // Corrupt or missing JSON — treat as empty
-            existingData = [];
-        }
-    }
-    // Replace existing entries with same ID
-    const incomingIds = new Set(componentData.map((c) => c.id));
-    const merged = [...componentData, ...existingData.filter((c) => !incomingIds.has(c.id))];
-    // Always write the file (even if merged is empty)
-    yield writeComponentSummaryAPI(handoff, merged);
-});
-exports.updateComponentSummaryApi = updateComponentSummaryApi;
 /**
  * Read the component API data
  * @param handoff
@@ -141,7 +102,7 @@ const readComponentApi = (handoff, id) => __awaiter(void 0, void 0, void 0, func
         try {
             const existingJson = yield fs_extra_1.default.readFile(outputFilePath, 'utf8');
             if (existingJson) {
-                return sanitizeComponentApiData(JSON.parse(existingJson));
+                return (0, exports.sanitizeComponentApiData)(JSON.parse(existingJson));
             }
         }
         catch (_) {
@@ -180,4 +141,4 @@ const readComponentMetadataApi = (handoff, id) => __awaiter(void 0, void 0, void
     };
 });
 exports.readComponentMetadataApi = readComponentMetadataApi;
-exports.default = writeComponentSummaryAPI;
+exports.default = exports.writeComponentApi;

package/dist/transformers/preview/component/artifacts.d.ts

@@ -0,0 +1,4 @@
+import Handoff from '../../../index';
+export declare const getComponentApiPath: (handoff: Handoff) => string;
+export declare const removeComponentApi: (handoff: Handoff, id: string) => Promise<void>;
+export declare const syncComponentArtifacts: (handoff: Handoff) => Promise<void>;