handoff-app 1.2.0-0 → 1.2.0-1

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/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-1';
 };
 /**
  * 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/preview/component/builder.js

@@ -27,6 +27,7 @@ exports.ComponentSegment = void 0;
 exports.processComponents = processComponents;
 const cloneDeep_1 = __importDefault(require("lodash/cloneDeep"));
 const cache_1 = require("../../../cache");
+const duration_1 = require("../../../utils/duration");
 const logger_1 = require("../../../utils/logger");
 const schema_1 = require("../../utils/schema");
 const types_1 = require("../types");
@@ -83,6 +84,37 @@ const ensureDefaultPreview = (data) => {
 const getBuildPreviews = (data) => {
     return Object.assign(Object.assign({}, ((data === null || data === void 0 ? void 0 : data.previews) || {})), ((data === null || data === void 0 ? void 0 : data.internalPatternPreviews) || {}));
 };
+/** Vite-backed segments in execution order; extend here if new steps are added. */
+const VITE_BUILD_SEGMENTS = [
+    { key: 'js', label: 'script' },
+    { key: 'css', label: 'styles' },
+    { key: 'previews', label: 'previews' },
+];
+const isFullViteComponentBuild = (plan) => plan.js && plan.css && plan.previews;
+const getActiveViteBuildLabels = (plan) => VITE_BUILD_SEGMENTS.filter(({ key }) => plan[key]).map(({ label }) => label);
+/** e.g. "a", "a and b", "a, b, and c" — common CLI copy style. */
+const formatEnglishList = (items) => {
+    if (items.length === 0)
+        return '';
+    if (items.length === 1)
+        return items[0];
+    if (items.length === 2)
+        return `${items[0]} and ${items[1]}`;
+    return `${items.slice(0, -1).join(', ')}, and ${items[items.length - 1]}`;
+};
+const viteBuildStartMessage = (componentId, plan) => {
+    if (isFullViteComponentBuild(plan)) {
+        return `Building component "${componentId}"…`;
+    }
+    return `Building ${formatEnglishList(getActiveViteBuildLabels(plan))} for component "${componentId}"…`;
+};
+const viteBuildFinishMessage = (componentId, plan, elapsedMs) => {
+    const duration = (0, duration_1.formatDurationMs)(elapsedMs);
+    if (isFullViteComponentBuild(plan)) {
+        return `Finished building component "${componentId}" in ${duration}`;
+    }
+    return `Finished building ${formatEnglishList(getActiveViteBuildLabels(plan))} for component "${componentId}" in ${duration}`;
+};
 /**
  * Returns a normalized build plan describing which component segments need rebuilding.
  *
@@ -170,12 +202,17 @@ function processComponents(handoff, id, segmentToProcess, options) {
             if (cache) {
                 (0, cache_1.pruneRemovedComponents)(cache, allComponentIds);
             }
-            const skippedCount = allComponentIds.length - componentsToBuild.size;
-            if (skippedCount > 0) {
-                logger_1.Logger.info(`Building ${componentsToBuild.size} of ${allComponentIds.length} components (${skippedCount} unchanged)`);
+            const total = allComponentIds.length;
+            const toBuildCount = componentsToBuild.size;
+            const skippedCount = total - toBuildCount;
+            if (total > 0 && toBuildCount === 0) {
+                logger_1.Logger.info(`All ${total} components unchanged; skipping build`);
+            }
+            else if (skippedCount > 0 && toBuildCount > 0) {
+                logger_1.Logger.info(`Building ${toBuildCount} of ${total} components (${skippedCount} unchanged)`);
             }
-            else if (componentsToBuild.size > 0) {
-                logger_1.Logger.info(`Building all ${componentsToBuild.size} components`);
+            else if (toBuildCount > 0) {
+                logger_1.Logger.info(`Building all ${toBuildCount} components`);
             }
             else {
                 logger_1.Logger.info('All components up to date, nothing to build');
@@ -266,6 +303,12 @@ function processComponents(handoff, id, segmentToProcess, options) {
             }
             // Components should always have at least one preview variation.
             ensureDefaultPreview(data);
+            const runsViteBuildSteps = buildPlan.js || buildPlan.css || buildPlan.previews;
+            let viteBuildStartedAtMs = 0;
+            if (runsViteBuildSteps) {
+                viteBuildStartedAtMs = Date.now();
+                logger_1.Logger.info(viteBuildStartMessage(runtimeComponentId, buildPlan));
+            }
             // Build JS if needed (new build, validation missing, or explicit segment request).
             if (buildPlan.js) {
                 data = yield (0, javascript_1.default)(data, handoff);
@@ -278,6 +321,10 @@ function processComponents(handoff, id, segmentToProcess, options) {
             if (buildPlan.previews) {
                 data = yield (0, html_1.default)(Object.assign(Object.assign({}, data), { previews: getBuildPreviews(data) }), handoff, components);
             }
+            if (runsViteBuildSteps) {
+                const elapsedMs = Date.now() - viteBuildStartedAtMs;
+                logger_1.Logger.info(viteBuildFinishMessage(runtimeComponentId, buildPlan, elapsedMs));
+            }
             /**
              * Run validation if explicitly requested and a hook is configured.
              * This allows custom logic to assess the validity of the generated component data.

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

@@ -17,6 +17,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const vite_1 = require("vite");
 const config_1 = require("../../../config");
+const duration_1 = require("../../../utils/duration");
 const logger_1 = require("../../../utils/logger");
 const vite_config_1 = __importDefault(require("../../vite-config"));
 const component_1 = require("../component");
@@ -155,9 +156,9 @@ const buildMainCss = (handoff) => __awaiter(void 0, void 0, void 0, function* ()
         const stat = yield fs_extra_1.default.stat(runtimeConfig.entries.scss);
         const entryPath = stat.isDirectory() ? path_1.default.resolve(runtimeConfig.entries.scss, 'main.scss') : runtimeConfig.entries.scss;
         if (entryPath === runtimeConfig.entries.scss || fs_extra_1.default.existsSync(entryPath)) {
-            logger_1.Logger.success(`Building main CSS file...`);
+            logger_1.Logger.info(`Building styles for global entry (main.css)…`);
+            const startedAt = Date.now();
             try {
-                // Setup SASS load paths
                 const loadPaths = [
                     path_1.default.resolve(handoff.workingPath),
                     path_1.default.resolve(handoff.workingPath, handoff.exportsDirectory, handoff.getProjectId()),
@@ -173,9 +174,10 @@ const buildMainCss = (handoff) => __awaiter(void 0, void 0, void 0, function* ()
                     loadPaths,
                     handoff,
                 });
+                logger_1.Logger.info(`Finished building styles for global entry (main.css) in ${(0, duration_1.formatDurationMs)(Date.now() - startedAt)}`);
             }
-            catch (e) {
-                logger_1.Logger.error(`Failed to build main CSS:`, e);
+            catch (_d) {
+                // buildCssBundle already logs failure for the entry path
             }
         }
     }

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

@@ -18,7 +18,6 @@ export declare const buildComponentJs: (data: TransformComponentTokensResult, ha
  *
  * @param handoff - The Handoff configuration object containing build settings
  * @returns A Promise that resolves when the build process is complete
- * @throws May throw an error if the build process fails
  */
 export declare const buildMainJS: (handoff: Handoff) => Promise<void>;
 export default buildComponentJs;

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

@@ -17,6 +17,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const vite_1 = require("vite");
 const config_1 = require("../../../config");
+const duration_1 = require("../../../utils/duration");
 const logger_1 = require("../../../utils/logger");
 const vite_config_1 = __importDefault(require("../../vite-config"));
 const component_1 = require("../component");
@@ -50,9 +51,6 @@ const buildJsBundle = (_a, handoff_1) => __awaiter(void 0, [_a, handoff_1], void
         }
         yield (0, vite_1.build)(viteConfig);
     }
-    catch (e) {
-        logger_1.Logger.error(`Failed to build JS for "${outputFilename}":`, e);
-    }
     finally {
         // Restore the original NODE_ENV value after vite build completes
         // This prevents interference with Next.js app building/running processes
@@ -83,11 +81,17 @@ const buildComponentJs = (data, handoff) => __awaiter(void 0, void 0, void 0, fu
     const outputPath = (0, component_1.getComponentOutputPath)(handoff);
     try {
         const js = yield fs_extra_1.default.readFile(path_1.default.resolve(entry), 'utf8');
-        yield buildJsBundle({
-            entry,
-            outputPath,
-            outputFilename: `${id}.js`,
-        }, handoff);
+        try {
+            yield buildJsBundle({
+                entry,
+                outputPath,
+                outputFilename: `${id}.js`,
+            }, handoff);
+        }
+        catch (e) {
+            logger_1.Logger.error(`Failed to bundle JS for component "${id}" (${id}.js):`, e);
+            return data;
+        }
         data.js = js;
         const compiled = yield fs_extra_1.default.readFile(path_1.default.resolve(outputPath, `${id}.js`), 'utf8');
         data['jsCompiled'] = compiled;
@@ -106,17 +110,24 @@ exports.buildComponentJs = buildComponentJs;
  *
  * @param handoff - The Handoff configuration object containing build settings
  * @returns A Promise that resolves when the build process is complete
- * @throws May throw an error if the build process fails
  */
 const buildMainJS = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
     const outputPath = (0, component_1.getComponentOutputPath)(handoff);
     const runtimeConfig = (0, config_1.initRuntimeConfig)(handoff)[0];
     if (runtimeConfig && runtimeConfig.entries.js && fs_extra_1.default.existsSync(path_1.default.resolve(runtimeConfig.entries.js))) {
-        yield buildJsBundle({
-            entry: runtimeConfig.entries.js,
-            outputPath,
-            outputFilename: 'main.js',
-        }, handoff);
+        logger_1.Logger.info(`Building script for global entry (main.js)…`);
+        const startedAt = Date.now();
+        try {
+            yield buildJsBundle({
+                entry: runtimeConfig.entries.js,
+                outputPath,
+                outputFilename: 'main.js',
+            }, handoff);
+            logger_1.Logger.info(`Finished building script for global entry (main.js) in ${(0, duration_1.formatDurationMs)(Date.now() - startedAt)}`);
+        }
+        catch (e) {
+            logger_1.Logger.error(`Failed to build global script (main.js):`, e);
+        }
     }
 });
 exports.buildMainJS = buildMainJS;

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

@@ -4,4 +4,8 @@ export declare const getPatternAPIPath: (handoff: Handoff) => string;
 export declare const writePatternApi: (id: string, pattern: PatternObject, handoff: Handoff) => Promise<void>;
 export declare const writePatternHtml: (id: string, html: string, handoff: Handoff) => Promise<void>;
 export declare const writePatternSummaryApi: (handoff: Handoff, patterns: PatternListObject[]) => Promise<void>;
+/**
+ * Reads the pattern list summary when present (used for partial pattern rebuilds).
+ */
+export declare const readPatternSummaryApi: (handoff: Handoff) => Promise<PatternListObject[] | null>;
 export declare const syncPatternArtifacts: (handoff: Handoff, validIds: Iterable<string>) => Promise<void>;

package/dist/transformers/preview/pattern/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.syncPatternArtifacts = exports.writePatternSummaryApi = exports.writePatternHtml = exports.writePatternApi = exports.getPatternAPIPath = void 0;
+exports.syncPatternArtifacts = exports.readPatternSummaryApi = exports.writePatternSummaryApi = exports.writePatternHtml = exports.writePatternApi = exports.getPatternAPIPath = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const getPatternAPIPath = (handoff) => {
@@ -44,6 +44,24 @@ const writePatternSummaryApi = (handoff, patterns) => __awaiter(void 0, void 0,
     yield fs_extra_1.default.writeFile(path_1.default.resolve(apiPath, 'patterns.json'), JSON.stringify(patterns, null, 2));
 });
 exports.writePatternSummaryApi = writePatternSummaryApi;
+/**
+ * Reads the pattern list summary when present (used for partial pattern rebuilds).
+ */
+const readPatternSummaryApi = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
+    const summaryPath = path_1.default.resolve(handoff.workingPath, 'public/api/patterns.json');
+    if (!fs_extra_1.default.existsSync(summaryPath)) {
+        return null;
+    }
+    try {
+        const raw = yield fs_extra_1.default.readFile(summaryPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : null;
+    }
+    catch (_a) {
+        return null;
+    }
+});
+exports.readPatternSummaryApi = readPatternSummaryApi;
 const syncPatternArtifacts = (handoff, validIds) => __awaiter(void 0, void 0, void 0, function* () {
     const validIdSet = new Set(validIds);
     const patternPath = (0, exports.getPatternAPIPath)(handoff);

package/dist/transformers/preview/pattern/builder.d.ts

@@ -1,9 +1,17 @@
 import Handoff from '../../../index';
 import { PatternListObject } from '../types';
+export type ProcessPatternsOptions = {
+    /** When set, only these pattern ids are recomposed; others keep existing artifacts. */
+    onlyPatternIds?: Set<string>;
+};
+/**
+ * Returns pattern ids whose declarations reference any of the given component ids.
+ */
+export declare const getPatternIdsReferencingComponents: (handoff: Handoff, componentIds: string[]) => string[];
 /**
  * Process all pattern declarations and compose their HTML from pre-built
  * component preview files. This function must run AFTER buildComponents
  * so that all component preview HTML files already exist on disk.
  */
-export declare function processPatterns(handoff: Handoff): Promise<PatternListObject[]>;
+export declare function processPatterns(handoff: Handoff, options?: ProcessPatternsOptions): Promise<PatternListObject[]>;
 export default processPatterns;