handoff-app 1.1.0-experimental.2 → 1.1.0-experimental.3

package/dist/app-builder/build.d.ts

@@ -3,10 +3,12 @@ import Handoff from '..';
  * Build the Next.js documentation application.
  * @param copyOnlyPaths - If set, do not remove output dir; copy only these paths (relative to out/) into existing output (merge).
  * @param deployDir - If set, copy output to this directory instead of default (workingPath/sitesDirectory/projectId).
+ * @param skipPatterns - If true, skip the pattern build step (useful when patterns were pre-processed for ISR).
  */
 declare const buildApp: (handoff: Handoff, skipComponents?: boolean, options?: {
     copyOnlyPaths?: string[];
     deployDir?: string;
+    skipPatterns?: boolean;
 }) => Promise<void>;
 /**
  * Watch the Next.js application.

package/dist/app-builder/build.js

@@ -17,14 +17,14 @@ const cross_spawn_1 = __importDefault(require("cross-spawn"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const components_1 = require("../pipeline/components");
-const pages_1 = require("../pipeline/pages");
+const patterns_1 = require("../pipeline/patterns");
 const builder_1 = __importDefault(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");
 const client_config_1 = require("./client-config");
 const paths_1 = require("./paths");
-const builder_2 = require("../transformers/preview/page/builder");
+const builder_2 = require("../transformers/preview/pattern/builder");
 const watchers_1 = require("./watchers");
 const websocket_1 = require("./websocket");
 /**
@@ -85,9 +85,12 @@ const initializeProjectApp = (handoff) => __awaiter(void 0, void 0, void 0, func
  * Build the Next.js documentation application.
  * @param copyOnlyPaths - If set, do not remove output dir; copy only these paths (relative to out/) into existing output (merge).
  * @param deployDir - If set, copy output to this directory instead of default (workingPath/sitesDirectory/projectId).
+ * @param skipPatterns - If true, skip the pattern build step (useful when patterns were pre-processed for ISR).
  */
 const buildApp = (handoff, skipComponents, options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
     skipComponents = skipComponents !== null && skipComponents !== void 0 ? skipComponents : false;
+    const skipPatterns = (_a = options === null || options === void 0 ? void 0 : options.skipPatterns) !== null && _a !== void 0 ? _a : false;
     const copyOnlyPaths = options === null || options === void 0 ? void 0 : options.copyOnlyPaths;
     const deployDir = options === null || options === void 0 ? void 0 : options.deployDir;
     // Perform cleanup
@@ -96,8 +99,10 @@ const buildApp = (handoff, skipComponents, options) => __awaiter(void 0, void 0,
     if (!skipComponents) {
         yield (0, components_1.buildComponents)(handoff);
     }
-    // Build pages (must run after components so rendered outputs exist)
-    yield (0, pages_1.buildPages)(handoff);
+    // Build patterns (must run after components so rendered outputs exist)
+    if (!skipPatterns) {
+        yield (0, patterns_1.buildPatterns)(handoff);
+    }
     // Prepare app
     const appPath = yield initializeProjectApp(handoff);
     yield (0, client_config_1.persistClientConfig)(handoff);
@@ -154,8 +159,8 @@ const watchApp = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
     yield (0, builder_1.default)(handoff, undefined, undefined, { useCache: true });
     yield (0, javascript_1.buildMainJS)(handoff);
     yield (0, css_1.buildMainCss)(handoff);
-    // Build pages after components
-    yield (0, builder_2.processPages)(handoff);
+    // Build patterns after components
+    yield (0, builder_2.processPatterns)(handoff);
     const appPath = yield initializeProjectApp(handoff);
     // Persist client configuration
     yield (0, client_config_1.persistClientConfig)(handoff);
@@ -200,7 +205,7 @@ const watchApp = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
     (0, watchers_1.watchRuntimeConfiguration)(handoff, state);
     (0, watchers_1.watchGlobalEntries)(handoff, state, chokidarConfig);
     (0, watchers_1.watchPages)(handoff, chokidarConfig);
-    (0, watchers_1.watchRuntimePages)(handoff, state);
+    (0, watchers_1.watchRuntimePatterns)(handoff, state);
 });
 exports.watchApp = watchApp;
 /**

package/dist/app-builder/isr-paths.d.ts

@@ -42,3 +42,12 @@ export declare function resolveComponentAffectedOutputPaths(componentId: string)
  * Resolve affected output paths for multiple components (union).
  */
 export declare function resolveComponentAffectedOutputPathsBatch(componentIds: string[]): string[];
+/**
+ * Resolve affected static output file paths for a pattern ISR update.
+ * Returns paths under out/ for the pattern API JSON and summary.
+ */
+export declare function resolvePatternAffectedOutputPaths(patternId: string): string[];
+/**
+ * Resolve affected output paths for multiple patterns (union).
+ */
+export declare function resolvePatternAffectedOutputPathsBatch(patternIds: string[]): string[];

package/dist/app-builder/isr-paths.js

@@ -10,6 +10,8 @@ exports.routePathToOutputPaths = routePathToOutputPaths;
 exports.resolveAffectedOutputPaths = resolveAffectedOutputPaths;
 exports.resolveComponentAffectedOutputPaths = resolveComponentAffectedOutputPaths;
 exports.resolveComponentAffectedOutputPathsBatch = resolveComponentAffectedOutputPathsBatch;
+exports.resolvePatternAffectedOutputPaths = resolvePatternAffectedOutputPaths;
+exports.resolvePatternAffectedOutputPathsBatch = resolvePatternAffectedOutputPathsBatch;
 /**
  * ISR path resolver: computes which static output files (under out/) are affected
  * for a given page path or "menu changed", for use with partial deploy.
@@ -211,3 +213,30 @@ function resolveComponentAffectedOutputPathsBatch(componentIds) {
     }
     return unique;
 }
+/**
+ * Resolve affected static output file paths for a pattern ISR update.
+ * Returns paths under out/ for the pattern API JSON and summary.
+ */
+function resolvePatternAffectedOutputPaths(patternId) {
+    return [
+        `api/pattern/${patternId}.json`,
+        'api/patterns.json',
+    ];
+}
+/**
+ * Resolve affected output paths for multiple patterns (union).
+ */
+function resolvePatternAffectedOutputPathsBatch(patternIds) {
+    const out = ['api/patterns.json'];
+    for (const id of patternIds) {
+        out.push(`api/pattern/${id}.json`);
+    }
+    // ES5-compatible alternative to [...new Set(out)]
+    var unique = [];
+    for (var i = 0; i < out.length; i++) {
+        if (unique.indexOf(out[i]) === -1) {
+            unique.push(out[i]);
+        }
+    }
+    return unique;
+}

package/dist/app-builder/watchers.d.ts

@@ -40,9 +40,9 @@ export declare const getRuntimeComponentsPathsToWatch: (handoff: Handoff) => Map
  */
 export declare const watchRuntimeComponents: (handoff: Handoff, state: WatcherState, runtimeComponentPathsToWatch: Map<string, keyof ComponentListObject["entries"]>) => void;
 /**
- * Watches runtime page config files for changes and triggers page rebuilds.
+ * Watches runtime pattern config files for changes and triggers pattern rebuilds.
  */
-export declare const watchRuntimePages: (handoff: Handoff, state: WatcherState) => void;
+export declare const watchRuntimePatterns: (handoff: Handoff, state: WatcherState) => void;
 /**
  * Watches the runtime configuration for changes.
  */

package/dist/app-builder/watchers.js

@@ -35,14 +35,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.watchRuntimeConfiguration = exports.watchRuntimePages = exports.watchRuntimeComponents = exports.getRuntimeComponentsPathsToWatch = exports.mapEntryTypeToSegment = exports.watchGlobalEntries = exports.watchPages = exports.watchAppSource = exports.watchPublicDirectory = void 0;
+exports.watchRuntimeConfiguration = exports.watchRuntimePatterns = exports.watchRuntimeComponents = exports.getRuntimeComponentsPathsToWatch = exports.mapEntryTypeToSegment = exports.watchGlobalEntries = exports.watchPages = exports.watchAppSource = exports.watchPublicDirectory = void 0;
 const chokidar_1 = __importDefault(require("chokidar"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const css_1 = require("../transformers/preview/component/css");
 const javascript_1 = require("../transformers/preview/component/javascript");
 const builder_1 = __importStar(require("../transformers/preview/component/builder"));
-const builder_2 = require("../transformers/preview/page/builder");
+const builder_2 = require("../transformers/preview/pattern/builder");
 const logger_1 = require("../utils/logger");
 const client_config_1 = require("./client-config");
 const paths_1 = require("./paths");
@@ -262,31 +262,31 @@ const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) =>
 };
 exports.watchRuntimeComponents = watchRuntimeComponents;
 /**
- * Watches runtime page config files for changes and triggers page rebuilds.
+ * Watches runtime pattern config files for changes and triggers pattern rebuilds.
  */
-const watchRuntimePages = (handoff, state) => {
+const watchRuntimePatterns = (handoff, state) => {
     var _a, _b, _c, _d, _e;
-    const runtimePages = (_c = (_b = (_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.pages) !== null && _c !== void 0 ? _c : {};
-    const pageConfigPaths = handoff.getConfigFilePaths().filter((configPath) => {
+    const runtimePatterns = (_c = (_b = (_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.patterns) !== null && _c !== void 0 ? _c : {};
+    const patternConfigPaths = handoff.getConfigFilePaths().filter((configPath) => {
         const dirName = path_1.default.basename(path_1.default.dirname(configPath));
-        return dirName in runtimePages;
+        return dirName in runtimePatterns;
     });
-    // Also watch page directories directly
-    const pageIds = Object.keys(runtimePages);
-    if (pageIds.length === 0 && pageConfigPaths.length === 0)
+    // Also watch pattern directories directly
+    const patternIds = Object.keys(runtimePatterns);
+    if (patternIds.length === 0 && patternConfigPaths.length === 0)
         return;
-    const pathsToWatch = pageConfigPaths.length > 0 ? pageConfigPaths : [];
-    // Add page config entry paths from the config
-    for (const pageId of pageIds) {
-        const page = runtimePages[pageId];
-        if (page.path && fs_extra_1.default.existsSync(page.path)) {
-            pathsToWatch.push(page.path);
+    const pathsToWatch = patternConfigPaths.length > 0 ? patternConfigPaths : [];
+    // Add pattern config entry paths from the config
+    for (const patternId of patternIds) {
+        const pattern = runtimePatterns[patternId];
+        if (pattern.path && fs_extra_1.default.existsSync(pattern.path)) {
+            pathsToWatch.push(pattern.path);
         }
     }
-    // Watch the page entry directories from config
-    if ((_e = (_d = handoff.config.entries) === null || _d === void 0 ? void 0 : _d.pages) === null || _e === void 0 ? void 0 : _e.length) {
-        for (const pagePath of handoff.config.entries.pages) {
-            const resolvedPath = path_1.default.resolve(handoff.workingPath, pagePath);
+    // Watch the pattern entry directories from config
+    if ((_e = (_d = handoff.config.entries) === null || _d === void 0 ? void 0 : _d.patterns) === null || _e === void 0 ? void 0 : _e.length) {
+        for (const patternPath of handoff.config.entries.patterns) {
+            const resolvedPath = path_1.default.resolve(handoff.workingPath, patternPath);
             if (fs_extra_1.default.existsSync(resolvedPath)) {
                 pathsToWatch.push(resolvedPath);
             }
@@ -302,12 +302,12 @@ const watchRuntimePages = (handoff, state) => {
                 if (!state.debounce) {
                     state.debounce = true;
                     try {
-                        logger_1.Logger.warn('Page config changed. Rebuilding pages...');
+                        logger_1.Logger.warn('Pattern config changed. Rebuilding patterns...');
                         handoff.reload();
-                        yield (0, builder_2.processPages)(handoff);
+                        yield (0, builder_2.processPatterns)(handoff);
                     }
                     catch (e) {
-                        logger_1.Logger.error('Error processing pages:', e);
+                        logger_1.Logger.error('Error processing patterns:', e);
                     }
                     finally {
                         state.debounce = false;
@@ -317,7 +317,7 @@ const watchRuntimePages = (handoff, state) => {
         }
     }));
 };
-exports.watchRuntimePages = watchRuntimePages;
+exports.watchRuntimePatterns = watchRuntimePatterns;
 /**
  * Watches the runtime configuration for changes.
  */

package/dist/commands/index.js

@@ -14,6 +14,7 @@ const fetch_1 = __importDefault(require("./fetch"));
 const init_1 = __importDefault(require("./init"));
 const component_1 = __importDefault(require("./isr/component"));
 const pages_2 = __importDefault(require("./isr/pages"));
+const pattern_1 = __importDefault(require("./isr/pattern"));
 const component_2 = __importDefault(require("./make/component"));
 const page_1 = __importDefault(require("./make/page"));
 const template_1 = __importDefault(require("./make/template"));
@@ -36,6 +37,7 @@ exports.commands = [
     init_1.default,
     pages_2.default,
     component_1.default,
+    pattern_1.default,
     page_1.default,
     component_2.default,
     template_1.default,

package/dist/commands/isr/pattern.d.ts

@@ -0,0 +1,10 @@
+import { CommandModule } from 'yargs';
+import { SharedArgs } from '../types';
+export interface IsrPatternArgs extends SharedArgs {
+    id?: string;
+    ids?: string[];
+    partial?: boolean;
+    deployDir?: string;
+}
+declare const command: CommandModule<{}, IsrPatternArgs>;
+export default command;

package/dist/commands/isr/pattern.js

@@ -0,0 +1,63 @@
+"use strict";
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = __importDefault(require("../../"));
+const isr_paths_1 = require("../../app-builder/isr-paths");
+const builder_1 = require("../../transformers/preview/pattern/builder");
+const utils_1 = require("../utils");
+const command = {
+    command: 'isr:pattern',
+    describe: 'ISR for pattern changes: rebuild one or more patterns, then rebuild app and optionally deploy only affected routes',
+    builder: (yargs) => {
+        return (0, utils_1.getSharedOptions)(yargs)
+            .option('id', {
+            describe: 'Pattern ID to rebuild (e.g. boilerplate)',
+            type: 'string',
+        })
+            .option('ids', {
+            describe: 'Comma-separated pattern IDs to rebuild',
+            type: 'string',
+            coerce: (arg) => (arg ? arg.split(',').map((p) => p.trim()) : []),
+        })
+            .option('partial', {
+            describe: 'Partial deploy: copy only affected pattern output files into existing site output',
+            type: 'boolean',
+            default: false,
+        })
+            .option('deploy-dir', {
+            describe: 'Copy output to this directory instead of default site output',
+            type: 'string',
+        });
+    },
+    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const handoff = new __1.default(args.debug, args.force);
+        handoff.init();
+        const ids = args.id ? [args.id] : (_a = args.ids) !== null && _a !== void 0 ? _a : [];
+        if (ids.length === 0) {
+            throw new Error('Either --id or --ids is required');
+        }
+        for (const id of ids) {
+            yield (0, builder_1.processPatterns)(handoff, id);
+        }
+        const copyOnlyPaths = args.partial
+            ? (0, isr_paths_1.resolvePatternAffectedOutputPathsBatch)(ids)
+            : undefined;
+        const buildOptions = (copyOnlyPaths === null || copyOnlyPaths === void 0 ? void 0 : copyOnlyPaths.length) || args.deployDir
+            ? { copyOnlyPaths: (copyOnlyPaths === null || copyOnlyPaths === void 0 ? void 0 : copyOnlyPaths.length) ? copyOnlyPaths : undefined, deployDir: args.deployDir }
+            : undefined;
+        yield handoff.build(true, buildOptions);
+    }),
+};
+exports.default = command;

package/dist/config/runtime.d.ts

@@ -30,10 +30,10 @@ export declare const initRuntimeConfig: (handoff: HandoffContext) => [runtimeCon
  */
 export declare const getComponentsForPath: (searchPath: string) => string[];
 /**
- * Returns a list of page directories for a given path.
- * Mirrors getComponentsForPath but for page definitions.
+ * Returns a list of pattern directories for a given path.
+ * Mirrors getComponentsForPath but for pattern definitions.
  */
-export declare const getPagesForPath: (searchPath: string) => string[];
+export declare const getPatternsForPath: (searchPath: string) => string[];
 /**
  * Recursively converts all keys and string values in an object to lowercase.
  */

package/dist/config/runtime.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toLowerCaseKeysAndValues = exports.getPagesForPath = exports.getComponentsForPath = exports.initRuntimeConfig = void 0;
+exports.toLowerCaseKeysAndValues = exports.getPatternsForPath = exports.getComponentsForPath = exports.initRuntimeConfig = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
@@ -24,7 +24,7 @@ const initRuntimeConfig = (handoff) => {
             scss: undefined,
             js: undefined,
             components: {},
-            pages: {},
+            patterns: {},
         },
     };
     if (!!((_a = handoff.config.entries) === null || _a === void 0 ? void 0 : _a.scss)) {
@@ -90,45 +90,45 @@ const initRuntimeConfig = (handoff) => {
             result.entries.components[component.id] = component;
         }
     }
-    if ((_k = (_j = handoff.config.entries) === null || _j === void 0 ? void 0 : _j.pages) === null || _k === void 0 ? void 0 : _k.length) {
-        const pagePaths = handoff.config.entries.pages.flatMap(exports.getPagesForPath);
-        for (const pagePath of pagePaths) {
-            const resolvedPagePath = path_1.default.resolve(handoff.workingPath, pagePath);
-            const pageBaseName = path_1.default.basename(resolvedPagePath);
-            const possibleConfigFiles = [`${pageBaseName}.json`, `${pageBaseName}.js`, `${pageBaseName}.cjs`];
-            const configFileName = possibleConfigFiles.find((file) => fs_extra_1.default.existsSync(path_1.default.resolve(resolvedPagePath, file)));
+    if ((_k = (_j = handoff.config.entries) === null || _j === void 0 ? void 0 : _j.patterns) === null || _k === void 0 ? void 0 : _k.length) {
+        const patternPaths = handoff.config.entries.patterns.flatMap(exports.getPatternsForPath);
+        for (const patternPath of patternPaths) {
+            const resolvedPatternPath = path_1.default.resolve(handoff.workingPath, patternPath);
+            const patternBaseName = path_1.default.basename(resolvedPatternPath);
+            const possibleConfigFiles = [`${patternBaseName}.json`, `${patternBaseName}.js`, `${patternBaseName}.cjs`];
+            const configFileName = possibleConfigFiles.find((file) => fs_extra_1.default.existsSync(path_1.default.resolve(resolvedPatternPath, file)));
             if (!configFileName) {
-                logger_1.Logger.warn(`Missing page config: ${path_1.default.resolve(resolvedPagePath, possibleConfigFiles.join(' or '))}`);
+                logger_1.Logger.warn(`Missing pattern config: ${path_1.default.resolve(resolvedPatternPath, possibleConfigFiles.join(' or '))}`);
                 continue;
             }
-            const resolvedPageConfigPath = path_1.default.resolve(resolvedPagePath, configFileName);
-            configFiles.push(resolvedPageConfigPath);
-            let page;
+            const resolvedPatternConfigPath = path_1.default.resolve(resolvedPatternPath, configFileName);
+            configFiles.push(resolvedPatternConfigPath);
+            let pattern;
             try {
                 if (configFileName.endsWith('.json')) {
-                    const pageJson = fs_extra_1.default.readFileSync(resolvedPageConfigPath, 'utf8');
-                    page = JSON.parse(pageJson);
+                    const patternJson = fs_extra_1.default.readFileSync(resolvedPatternConfigPath, 'utf8');
+                    pattern = JSON.parse(patternJson);
                 }
                 else {
-                    delete require.cache[require.resolve(resolvedPageConfigPath)];
-                    const importedPage = require(resolvedPageConfigPath);
-                    page = importedPage.default || importedPage;
+                    delete require.cache[require.resolve(resolvedPatternConfigPath)];
+                    const importedPattern = require(resolvedPatternConfigPath);
+                    pattern = importedPattern.default || importedPattern;
                 }
             }
             catch (err) {
-                logger_1.Logger.error(`Failed to read or parse page config: ${resolvedPageConfigPath}`, err);
+                logger_1.Logger.error(`Failed to read or parse pattern config: ${resolvedPatternConfigPath}`, err);
                 continue;
             }
-            page.id = pageBaseName;
+            pattern.id = patternBaseName;
             // Validate that referenced components exist
-            if (page.components) {
-                for (const componentId of page.components) {
+            if (pattern.components) {
+                for (const componentId of pattern.components) {
                     if (!result.entries.components[componentId]) {
-                        logger_1.Logger.warn(`Page '${page.id}' references unknown component '${componentId}'`);
+                        logger_1.Logger.warn(`Pattern '${pattern.id}' references unknown component '${componentId}'`);
                     }
                 }
             }
-            result.entries.pages[page.id] = page;
+            result.entries.patterns[pattern.id] = pattern;
         }
     }
     return [result, Array.from(configFiles)];
@@ -171,10 +171,10 @@ const getComponentsForPath = (searchPath) => {
 };
 exports.getComponentsForPath = getComponentsForPath;
 /**
- * Returns a list of page directories for a given path.
- * Mirrors getComponentsForPath but for page definitions.
+ * Returns a list of pattern directories for a given path.
+ * Mirrors getComponentsForPath but for pattern definitions.
  */
-const getPagesForPath = (searchPath) => {
+const getPatternsForPath = (searchPath) => {
     const dirName = path_1.default.basename(searchPath);
     const possibleConfigFiles = [`${dirName}.json`, `${dirName}.js`, `${dirName}.cjs`];
     const hasOwnConfig = possibleConfigFiles.some((file) => fs_extra_1.default.existsSync(path_1.default.resolve(searchPath, file)));
@@ -190,7 +190,7 @@ const getPagesForPath = (searchPath) => {
     }
     return [searchPath];
 };
-exports.getPagesForPath = getPagesForPath;
+exports.getPatternsForPath = getPatternsForPath;
 /**
  * Recursively converts all keys and string values in an object to lowercase.
  */

package/dist/index.d.ts

@@ -29,6 +29,7 @@ declare class Handoff {
     build(skipComponents?: boolean, options?: {
         copyOnlyPaths?: string[];
         deployDir?: string;
+        skipPatterns?: boolean;
     }): Promise<Handoff>;
     ejectConfig(): Promise<Handoff>;
     ejectPages(): Promise<Handoff>;

package/dist/pipeline/index.d.ts

@@ -2,7 +2,7 @@ import 'dotenv/config';
 import Handoff from '..';
 export { readPrevJSONFile, zip, zipAssets } from './archive';
 export { buildComponents } from './components';
-export { buildPages } from './pages';
+export { buildPatterns } from './patterns';
 /**
  * Run the entire Figma data pipeline:
  * 1. Validate runtime requirements

package/dist/pipeline/index.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.buildPages = exports.buildComponents = exports.zipAssets = exports.zip = exports.readPrevJSONFile = void 0;
+exports.buildPatterns = exports.buildComponents = exports.zipAssets = exports.zip = exports.readPrevJSONFile = void 0;
 require("dotenv/config");
 const app_builder_1 = __importDefault(require("../app-builder"));
 const logger_1 = require("../utils/logger");
@@ -26,8 +26,8 @@ Object.defineProperty(exports, "zip", { enumerable: true, get: function () { ret
 Object.defineProperty(exports, "zipAssets", { enumerable: true, get: function () { return archive_1.zipAssets; } });
 var components_1 = require("./components");
 Object.defineProperty(exports, "buildComponents", { enumerable: true, get: function () { return components_1.buildComponents; } });
-var pages_1 = require("./pages");
-Object.defineProperty(exports, "buildPages", { enumerable: true, get: function () { return pages_1.buildPages; } });
+var patterns_1 = require("./patterns");
+Object.defineProperty(exports, "buildPatterns", { enumerable: true, get: function () { return patterns_1.buildPatterns; } });
 /**
  * Run the entire Figma data pipeline:
  * 1. Validate runtime requirements

package/dist/pipeline/patterns.d.ts

@@ -0,0 +1,6 @@
+import Handoff from '..';
+/**
+ * Builds pattern previews by running the pattern processor.
+ * Must be called after buildComponents so component outputs exist.
+ */
+export declare const buildPatterns: (handoff: Handoff) => Promise<void>;

package/dist/pipeline/{pages.js → patterns.js}

@@ -9,13 +9,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildPages = void 0;
-const builder_1 = require("../transformers/preview/page/builder");
+exports.buildPatterns = void 0;
+const builder_1 = require("../transformers/preview/pattern/builder");
 /**
- * Builds page previews by running the page processor.
+ * Builds pattern previews by running the pattern processor.
  * Must be called after buildComponents so component outputs exist.
  */
-const buildPages = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, builder_1.processPages)(handoff);
+const buildPatterns = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, builder_1.processPatterns)(handoff);
 });
-exports.buildPages = buildPages;
+exports.buildPatterns = buildPatterns;

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

@@ -64,7 +64,7 @@ function createSlotMetadata(key, argType, value) {
     var _a, _b;
     const controlType = typeof (argType === null || argType === void 0 ? void 0 : argType.control) === 'string' ? argType.control : (_a = argType === null || argType === void 0 ? void 0 : argType.control) === null || _a === void 0 ? void 0 : _a.type;
     const type = inferSlotType(controlType, value);
-    return {
+    const metadata = {
         id: key,
         name: (argType === null || argType === void 0 ? void 0 : argType.name) || (0, lodash_1.startCase)(key),
         description: (argType === null || argType === void 0 ? void 0 : argType.description) || '',
@@ -75,6 +75,11 @@ function createSlotMetadata(key, argType, value) {
             required: !!(argType === null || argType === void 0 ? void 0 : argType.required),
         },
     };
+    // Capture select/radio options so the Playground can render a proper dropdown
+    if (Array.isArray(argType === null || argType === void 0 ? void 0 : argType.options) && argType.options.length > 0) {
+        metadata.options = argType.options;
+    }
+    return metadata;
 }
 function getStoryEntries(moduleExports) {
     return Object.entries(moduleExports).filter(([key, value]) => {
@@ -119,15 +124,17 @@ function safeRenderToHtml(meta, story, args) {
         return `<div style="padding:1rem;color:#b91c1c;font-family:monospace;font-size:13px">Render error: ${String(error)}</div>`;
     }
 }
-function createHtmlDocument(componentId, previewTitle, renderedHtml) {
-    var _a, _b, _c;
+function createHtmlDocument(componentId, previewTitle, renderedHtml, previewCss) {
+    var _a;
+    const basePath = (_a = process.env.HANDOFF_APP_BASE_PATH) !== null && _a !== void 0 ? _a : '';
+    const previewCssLink = previewCss ? `\n    <link rel="stylesheet" href="${previewCss}" />` : '';
     return `<!DOCTYPE html>
 <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="${(_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" />
+    <link rel="stylesheet" href="${basePath}/api/component/main.css" />
+    <link rel="stylesheet" href="${basePath}/api/component/${componentId}.css" />
+    <link rel="stylesheet" href="${basePath}/assets/css/preview.css" />${previewCssLink}
     <title>${previewTitle}</title>
   </head>
   <body>
@@ -154,7 +161,7 @@ function csfRenderPlugin(componentData, _documentationComponents, handoff) {
         },
         generateBundle(_, bundle) {
             return __awaiter(this, void 0, void 0, function* () {
-                var _a, _b, _c, _d, _e, _f;
+                var _a, _b, _c, _d, _e, _f, _g, _h;
                 for (const [fileName, chunkInfo] of Object.entries(bundle)) {
                     if (chunkInfo.type === 'chunk' && fileName.includes(PLUGIN_CONSTANTS.SCRIPT_ID)) {
                         delete bundle[fileName];
@@ -246,7 +253,7 @@ function csfRenderPlugin(componentData, _documentationComponents, handoff) {
                 for (const [storyKey, storyValue] of stories) {
                     const preview = componentData.previews[storyKey];
                     const rendered = safeRenderToHtml(meta, storyValue, preview.values || {});
-                    const html = yield (0, html_1.formatHtml)(createHtmlDocument(componentId, preview.title, rendered));
+                    const html = yield (0, html_1.formatHtml)(createHtmlDocument(componentId, preview.title, rendered, (_g = (_f = componentData.options) === null || _f === void 0 ? void 0 : _f.preview) === null || _g === void 0 ? void 0 : _g.css));
                     const fileName = `${componentId}-${storyKey}.html`;
                     this.emitFile({
                         type: 'asset',
@@ -262,7 +269,7 @@ function csfRenderPlugin(componentData, _documentationComponents, handoff) {
                     lastHtml = html;
                 }
                 // Emit standalone client module for Playground live rendering
-                const firstStoryKey = (_f = stories[0]) === null || _f === void 0 ? void 0 : _f[0];
+                const firstStoryKey = (_h = stories[0]) === null || _h === void 0 ? void 0 : _h[0];
                 if (firstStoryKey) {
                     try {
                         const clientModuleSource = (0, build_1.generateCsfClientComponentSource)(templatePath, firstStoryKey);

package/dist/transformers/plugins/handlebars-previews.js

@@ -63,6 +63,7 @@ function processComponentInstances(componentData, documentationComponents) {
  */
 function renderHandlebarsTemplate(template, componentData, previewData, injectFieldWrappers) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
         // Register Handlebars helpers with current injection state
         (0, handlebars_2.registerHandlebarsHelpers)({ id: componentData.id, properties: componentData.properties || {} }, injectFieldWrappers);
         const context = (0, handlebars_2.createHandlebarsContext)({
@@ -71,6 +72,7 @@ function renderHandlebarsTemplate(template, componentData, previewData, injectFi
             title: componentData.title
         }, previewData, {
             includeSharedStyles: Boolean(componentData.sharedStyles),
+            previewCss: (_b = (_a = componentData.options) === null || _a === void 0 ? void 0 : _a.preview) === null || _b === void 0 ? void 0 : _b.css,
         });
         const compiled = handlebars_1.default.compile(template)(context);
         return yield (0, html_1.formatHtmlWithWrapper)(compiled);

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

@@ -37,6 +37,7 @@ declare const buildComponentCss: (data: TransformComponentTokensResult, handoff:
     options?: {
         preview?: {
             groupBy?: string;
+            css?: string;
         };
     };
     validations?: Record<string, import("../../../types/preview").ValidationResult>;

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

@@ -37,6 +37,10 @@ export interface SlotMetadata {
     properties?: {
         [key: string]: SlotMetadata;
     };
+    options?: Array<string | {
+        value: string;
+        label: string;
+    }>;
     key?: string;
     rules?: RuleObject;
     docgenType?: string;