handoff-app 1.0.6 → 1.1.0-0

package/dist/app-builder/watchers.js

@@ -0,0 +1,302 @@
+"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) {
+        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 });
+exports.watchRuntimeConfiguration = 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 logger_1 = require("../utils/logger");
+const client_config_1 = require("./client-config");
+const paths_1 = require("./paths");
+/**
+ * Watches the working public directory for changes and updates the app.
+ */
+const watchPublicDirectory = (handoff, wss, state, chokidarConfig) => {
+    if (fs_extra_1.default.existsSync(path_1.default.resolve(handoff.workingPath, 'public'))) {
+        chokidar_1.default.watch(path_1.default.resolve(handoff.workingPath, 'public'), chokidarConfig).on('all', (event, path) => __awaiter(void 0, void 0, void 0, function* () {
+            switch (event) {
+                case 'add':
+                case 'change':
+                case 'unlink':
+                    if (!state.debounce) {
+                        state.debounce = true;
+                        try {
+                            logger_1.Logger.warn('Public directory changed. Handoff will ingest the new data...');
+                            yield (0, paths_1.syncPublicFiles)(handoff);
+                            wss(JSON.stringify({ type: 'reload' }));
+                        }
+                        catch (e) {
+                            logger_1.Logger.error('Error syncing public directory:', e);
+                        }
+                        finally {
+                            state.debounce = false;
+                        }
+                    }
+                    break;
+            }
+        }));
+    }
+};
+exports.watchPublicDirectory = watchPublicDirectory;
+/**
+ * Watches the application source code for changes.
+ */
+const watchAppSource = (handoff, initializeProjectApp) => {
+    chokidar_1.default
+        .watch(path_1.default.resolve(handoff.modulePath, 'src', 'app'), {
+        ignored: /(^|[\/\\])\../, // ignore dotfiles
+        persistent: true,
+        ignoreInitial: true,
+    })
+        .on('all', (event, path) => __awaiter(void 0, void 0, void 0, function* () {
+        switch (event) {
+            case 'add':
+            case 'change':
+            case 'unlink':
+                try {
+                    yield initializeProjectApp(handoff);
+                }
+                catch (e) {
+                    logger_1.Logger.error('Error initializing project app:', e);
+                }
+                break;
+        }
+    }));
+};
+exports.watchAppSource = watchAppSource;
+/**
+ * Watches the user's pages directory for changes.
+ */
+const watchPages = (handoff, chokidarConfig) => {
+    if (fs_extra_1.default.existsSync(path_1.default.resolve(handoff.workingPath, 'pages'))) {
+        chokidar_1.default.watch(path_1.default.resolve(handoff.workingPath, 'pages'), chokidarConfig).on('all', (event, path) => __awaiter(void 0, void 0, void 0, function* () {
+            switch (event) {
+                case 'add':
+                case 'change':
+                case 'unlink':
+                    try {
+                        logger_1.Logger.warn(`Doc page ${event}ed. Please reload browser to see changes...`);
+                        logger_1.Logger.debug(`Path: ${path}`);
+                    }
+                    catch (e) {
+                        logger_1.Logger.error('Error watching pages:', e);
+                    }
+                    break;
+            }
+        }));
+    }
+};
+exports.watchPages = watchPages;
+/**
+ * Watches global SCSS and JS entry points for changes.
+ * Rebuilds the main bundles and all components when a global entry changes,
+ * since per-component builds may depend on these shared entries.
+ */
+const watchGlobalEntries = (handoff, state, chokidarConfig) => {
+    var _a, _b, _c, _d;
+    const scssEntry = (_b = (_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.scss;
+    const jsEntry = (_d = (_c = handoff.runtimeConfig) === null || _c === void 0 ? void 0 : _c.entries) === null || _d === void 0 ? void 0 : _d.js;
+    const scssPathsToWatch = [];
+    const jsPathsToWatch = [];
+    if (scssEntry && fs_extra_1.default.existsSync(scssEntry)) {
+        const stat = fs_extra_1.default.statSync(scssEntry);
+        scssPathsToWatch.push(stat.isDirectory() ? scssEntry : path_1.default.dirname(scssEntry));
+    }
+    if (jsEntry && fs_extra_1.default.existsSync(jsEntry)) {
+        jsPathsToWatch.push(path_1.default.dirname(jsEntry));
+    }
+    const pathsToWatch = [...scssPathsToWatch, ...jsPathsToWatch];
+    if (pathsToWatch.length === 0)
+        return;
+    const isPathInside = (filePath, parentPath) => {
+        const normalizedFilePath = path_1.default.resolve(filePath);
+        const normalizedParentPath = path_1.default.resolve(parentPath);
+        return normalizedFilePath === normalizedParentPath || normalizedFilePath.startsWith(`${normalizedParentPath}${path_1.default.sep}`);
+    };
+    chokidar_1.default.watch(pathsToWatch, chokidarConfig).on('all', (event, file) => __awaiter(void 0, void 0, void 0, function* () {
+        switch (event) {
+            case 'add':
+            case 'change':
+            case 'unlink':
+                if (!state.debounce) {
+                    state.debounce = true;
+                    try {
+                        logger_1.Logger.warn('Global entry changed. Rebuilding bundles and components...');
+                        const shouldRebuildMainCss = !!scssEntry && scssPathsToWatch.some((watchPath) => isPathInside(file, watchPath));
+                        const shouldRebuildMainJs = !!jsEntry && jsPathsToWatch.some((watchPath) => isPathInside(file, watchPath));
+                        if (shouldRebuildMainCss) {
+                            yield (0, css_1.buildMainCss)(handoff);
+                        }
+                        if (shouldRebuildMainJs) {
+                            yield (0, javascript_1.buildMainJS)(handoff);
+                        }
+                        yield (0, builder_1.default)(handoff);
+                    }
+                    catch (e) {
+                        logger_1.Logger.error('Error rebuilding after global entry change:', e);
+                    }
+                    finally {
+                        state.debounce = false;
+                    }
+                }
+                break;
+        }
+    }));
+};
+exports.watchGlobalEntries = watchGlobalEntries;
+/**
+ * Maps configuration entry types to component segments.
+ */
+const mapEntryTypeToSegment = (type) => {
+    return {
+        js: builder_1.ComponentSegment.JavaScript,
+        scss: builder_1.ComponentSegment.Style,
+        template: builder_1.ComponentSegment.Previews,
+        templates: builder_1.ComponentSegment.Previews,
+    }[type];
+};
+exports.mapEntryTypeToSegment = mapEntryTypeToSegment;
+/**
+ * Gets the paths of runtime components to watch.
+ *
+ * @returns A Map of paths to watch and their entry types
+ */
+const getRuntimeComponentsPathsToWatch = (handoff) => {
+    var _a, _b, _c;
+    const result = new Map();
+    for (const runtimeComponentId of Object.keys((_b = (_a = handoff.runtimeConfig) === null || _a === void 0 ? void 0 : _a.entries.components) !== null && _b !== void 0 ? _b : {})) {
+        const runtimeComponent = handoff.runtimeConfig.entries.components[runtimeComponentId];
+        for (const [runtimeComponentEntryType, runtimeComponentEntryPath] of Object.entries((_c = runtimeComponent.entries) !== null && _c !== void 0 ? _c : {})) {
+            const normalizedComponentEntryPath = runtimeComponentEntryPath;
+            if (fs_extra_1.default.existsSync(normalizedComponentEntryPath)) {
+                const entryType = runtimeComponentEntryType;
+                if (fs_extra_1.default.statSync(normalizedComponentEntryPath).isFile()) {
+                    result.set(path_1.default.resolve(normalizedComponentEntryPath), entryType);
+                }
+                else {
+                    result.set(normalizedComponentEntryPath, entryType);
+                }
+            }
+        }
+    }
+    return result;
+};
+exports.getRuntimeComponentsPathsToWatch = getRuntimeComponentsPathsToWatch;
+/**
+ * Watches runtime components for changes.
+ */
+const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) => {
+    if (state.runtimeComponentsWatcher) {
+        state.runtimeComponentsWatcher.close();
+    }
+    if (runtimeComponentPathsToWatch.size > 0) {
+        const pathsToWatch = Array.from(runtimeComponentPathsToWatch.keys());
+        state.runtimeComponentsWatcher = chokidar_1.default.watch(pathsToWatch, {
+            ignoreInitial: true,
+        });
+        state.runtimeComponentsWatcher.on('all', (event, file) => __awaiter(void 0, void 0, void 0, function* () {
+            if (handoff.getConfigFilePaths().includes(file)) {
+                return;
+            }
+            switch (event) {
+                case 'add':
+                case 'change':
+                case 'unlink':
+                    if (!state.debounce) {
+                        state.debounce = true;
+                        try {
+                            const entryType = runtimeComponentPathsToWatch.get(file);
+                            const segmentToUpdate = entryType ? (0, exports.mapEntryTypeToSegment)(entryType) : undefined;
+                            const componentDir = path_1.default.basename(path_1.default.dirname(file));
+                            yield (0, builder_1.default)(handoff, componentDir, segmentToUpdate);
+                        }
+                        catch (e) {
+                            logger_1.Logger.error('Error processing component:', e);
+                        }
+                        finally {
+                            state.debounce = false;
+                        }
+                    }
+                    break;
+            }
+        }));
+    }
+};
+exports.watchRuntimeComponents = watchRuntimeComponents;
+/**
+ * Watches the runtime configuration for changes.
+ */
+const watchRuntimeConfiguration = (handoff, state) => {
+    if (state.runtimeConfigurationWatcher) {
+        state.runtimeConfigurationWatcher.close();
+    }
+    if (handoff.getConfigFilePaths().length > 0) {
+        state.runtimeConfigurationWatcher = chokidar_1.default.watch(handoff.getConfigFilePaths(), { ignoreInitial: true });
+        state.runtimeConfigurationWatcher.on('all', (event, file) => __awaiter(void 0, void 0, void 0, function* () {
+            switch (event) {
+                case 'add':
+                case 'change':
+                case 'unlink':
+                    if (!state.debounce) {
+                        state.debounce = true;
+                        try {
+                            file = path_1.default.dirname(file);
+                            // Reload the Handoff instance to pick up configuration changes
+                            handoff.reload();
+                            // After reloading, persist the updated client configuration
+                            yield (0, client_config_1.persistClientConfig)(handoff);
+                            // Restart the runtime components watcher to track potentially updated/added/removed components
+                            (0, exports.watchRuntimeComponents)(handoff, state, (0, exports.getRuntimeComponentsPathsToWatch)(handoff));
+                            // Process components based on the updated configuration and file path
+                            yield (0, builder_1.default)(handoff, path_1.default.basename(file));
+                        }
+                        catch (e) {
+                            logger_1.Logger.error('Error reloading runtime configuration:', e);
+                        }
+                        finally {
+                            state.debounce = false;
+                        }
+                    }
+                    break;
+            }
+        }));
+    }
+};
+exports.watchRuntimeConfiguration = watchRuntimeConfiguration;

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

@@ -0,0 +1,12 @@
+import { WebSocket } from 'ws';
+export interface HandoffWebSocket extends WebSocket {
+    isAlive: boolean;
+}
+/**
+ * Creates a WebSocket server that broadcasts messages to connected clients.
+ * Designed for development mode to help with hot-reloading.
+ *
+ * @param port - Optional port number for the WebSocket server; defaults to 3001.
+ * @returns A function that accepts a message string and broadcasts it to all connected clients.
+ */
+export declare const createWebSocketServer: (port?: number) => Promise<(message: string) => void>;

package/dist/app-builder/websocket.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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocketServer = void 0;
+const ws_1 = require("ws");
+const logger_1 = require("../utils/logger");
+/**
+ * Creates a WebSocket server that broadcasts messages to connected clients.
+ * Designed for development mode to help with hot-reloading.
+ *
+ * @param port - Optional port number for the WebSocket server; defaults to 3001.
+ * @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) {
+    const wss = new ws_1.WebSocket.Server({ port });
+    // Heartbeat function to mark a connection as alive.
+    const heartbeat = function () {
+        this.isAlive = true;
+    };
+    // Setup a new connection
+    wss.on('connection', (ws) => {
+        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('pong', heartbeat);
+    });
+    // Periodically ping clients to ensure they are still connected
+    const pingInterval = setInterval(() => {
+        wss.clients.forEach((client) => {
+            const extWs = client;
+            if (!extWs.isAlive) {
+                logger_1.Logger.warn('Terminating inactive client');
+                return client.terminate();
+            }
+            extWs.isAlive = false;
+            client.ping();
+        });
+    }, 30000);
+    // Clean up the interval when the server closes
+    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)`);
+        wss.clients.forEach((client) => {
+            if (client.readyState === ws_1.WebSocket.OPEN) {
+                client.send(message);
+            }
+        });
+    };
+});
+exports.createWebSocketServer = createWebSocketServer;

package/dist/cache/build-cache.d.ts

@@ -17,8 +17,6 @@ export interface ComponentCacheEntry {
 export interface GlobalDepsState {
     /** tokens.json file state */
     tokens?: FileState;
-    /** shared.scss or shared.css file state */
-    sharedStyles?: FileState;
     /** Global SCSS entry file state */
     globalScss?: FileState;
     /** Global JS entry file state */

package/dist/cache/build-cache.js

@@ -94,24 +94,18 @@ function saveBuildCache(handoff, cache) {
  */
 function computeGlobalDepsState(handoff) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g;
         const result = {};
         // tokens.json
         const tokensPath = handoff.getTokensFilePath();
         result.tokens = (_a = (yield (0, file_state_1.computeFileState)(tokensPath))) !== null && _a !== void 0 ? _a : undefined;
-        // shared.scss or shared.css
-        const sharedScssPath = path_1.default.resolve(handoff.workingPath, 'integration/components/shared.scss');
-        const sharedCssPath = path_1.default.resolve(handoff.workingPath, 'integration/components/shared.css');
-        const sharedScssState = yield (0, file_state_1.computeFileState)(sharedScssPath);
-        const sharedCssState = yield (0, file_state_1.computeFileState)(sharedCssPath);
-        result.sharedStyles = (_b = sharedScssState !== null && sharedScssState !== void 0 ? sharedScssState : sharedCssState) !== null && _b !== void 0 ? _b : undefined;
         // Global SCSS entry
-        if ((_d = (_c = handoff.runtimeConfig) === null || _c === void 0 ? void 0 : _c.entries) === null || _d === void 0 ? void 0 : _d.scss) {
-            result.globalScss = (_e = (yield (0, file_state_1.computeFileState)(handoff.runtimeConfig.entries.scss))) !== null && _e !== void 0 ? _e : undefined;
+        if ((_c = (_b = handoff.runtimeConfig) === null || _b === void 0 ? void 0 : _b.entries) === null || _c === void 0 ? void 0 : _c.scss) {
+            result.globalScss = (_d = (yield (0, file_state_1.computeFileState)(handoff.runtimeConfig.entries.scss))) !== null && _d !== void 0 ? _d : undefined;
         }
         // Global JS entry
-        if ((_g = (_f = handoff.runtimeConfig) === null || _f === void 0 ? void 0 : _f.entries) === null || _g === void 0 ? void 0 : _g.js) {
-            result.globalJs = (_h = (yield (0, file_state_1.computeFileState)(handoff.runtimeConfig.entries.js))) !== null && _h !== void 0 ? _h : undefined;
+        if ((_f = (_e = handoff.runtimeConfig) === null || _e === void 0 ? void 0 : _e.entries) === null || _f === void 0 ? void 0 : _f.js) {
+            result.globalJs = (_g = (yield (0, file_state_1.computeFileState)(handoff.runtimeConfig.entries.js))) !== null && _g !== void 0 ? _g : undefined;
         }
         return result;
     });
@@ -127,10 +121,6 @@ function haveGlobalDepsChanged(cached, current) {
         logger_1.Logger.debug('Global dependency changed: tokens.json');
         return true;
     }
-    if (!(0, file_state_1.statesMatch)(cached.sharedStyles, current.sharedStyles)) {
-        logger_1.Logger.debug('Global dependency changed: shared styles');
-        return true;
-    }
     if (!(0, file_state_1.statesMatch)(cached.globalScss, current.globalScss)) {
         logger_1.Logger.debug('Global dependency changed: global SCSS entry');
         return true;
@@ -205,7 +195,7 @@ function computeComponentFileStates(handoff, componentId) {
         }
         let templateDirFiles;
         if (templateDir) {
-            templateDirFiles = yield (0, file_state_1.computeDirectoryState)(templateDir, ['.hbs', '.html']);
+            templateDirFiles = yield (0, file_state_1.computeDirectoryState)(templateDir, ['.hbs', '.html', '.tsx', '.ts']);
         }
         return { files, templateDirFiles };
     });

package/dist/{create.js → cli/create.js}

@@ -45,7 +45,7 @@ const path = __importStar(require("path"));
  */
 const getVersion = () => {
     try {
-        const packageJsonPath = path.resolve(__dirname, '../package.json');
+        const packageJsonPath = path.resolve(__dirname, '../../package.json');
         const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
         return packageJson.version || 'unknown';
     }
@@ -237,7 +237,7 @@ const create = () => __awaiter(void 0, void 0, void 0, function* () {
         // Create files
         const spinner = p.spinner();
         spinner.start('Creating project files...');
-        const templateDir = path.resolve(__dirname, '../templates/default');
+        const templateDir = path.resolve(__dirname, '../../templates/default');
         if (!fs.existsSync(templateDir)) {
             throw new CreateError(`Template directory not found at ${templateDir}. This may indicate a packaging issue.`);
         }

package/dist/cli/eject.d.ts

@@ -5,12 +5,12 @@ import Handoff from '../index';
  */
 export declare const ejectConfig: (handoff: Handoff) => Promise<Handoff>;
 /**
- * Eject the integration to the working directory
+ * Eject pages to the working directory
  * @param handoff
  */
 export declare const ejectPages: (handoff: Handoff) => Promise<Handoff>;
 /**
- * Eject the integration to the working directory
+ * Eject theme to the working directory
  * @param handoff
  */
 export declare const ejectTheme: (handoff: Handoff) => Promise<Handoff>;

package/dist/cli/eject.js

@@ -35,7 +35,7 @@ const ejectConfig = (handoff) => __awaiter(void 0, void 0, void 0, function* ()
 });
 exports.ejectConfig = ejectConfig;
 /**
- * Eject the integration to the working directory
+ * Eject pages to the working directory
  * @param handoff
  */
 const ejectPages = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
@@ -54,7 +54,7 @@ const ejectPages = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
 });
 exports.ejectPages = ejectPages;
 /**
- * Eject the integration to the working directory
+ * Eject theme to the working directory
  * @param handoff
  */
 const ejectTheme = (handoff) => __awaiter(void 0, void 0, void 0, function* () {

package/dist/cli/make.d.ts

@@ -9,8 +9,4 @@ export declare const makeTemplate: (handoff: Handoff, component: string, state:
  * @param handoff
  */
 export declare const makePage: (handoff: Handoff, name: string, parent: string | undefined) => Promise<Handoff>;
-/**
- * Make a new component
- * @param handoff
- */
 export declare const makeComponent: (handoff: Handoff, name: string) => Promise<Handoff>;

package/dist/cli/make.js

@@ -134,13 +134,25 @@ exports.makePage = makePage;
  * Make a new component
  * @param handoff
  */
+const DEFAULT_COMPONENTS_DIR = 'components';
 const makeComponent = (handoff, name) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
     if (!name) {
         logger_1.Logger.error(`Component name must be set`);
         return;
     }
     name = name.replace('.html', '');
-    let workingPath = path_1.default.resolve(path_1.default.join(handoff.workingPath, `integration/components/${name}`));
+    let componentsRoot;
+    if ((_c = (_b = (_a = handoff.config) === null || _a === void 0 ? void 0 : _a.entries) === null || _b === void 0 ? void 0 : _b.components) === null || _c === void 0 ? void 0 : _c.length) {
+        componentsRoot = path_1.default.resolve(handoff.workingPath, handoff.config.entries.components[0]);
+    }
+    else {
+        componentsRoot = path_1.default.resolve(handoff.workingPath, DEFAULT_COMPONENTS_DIR);
+        logger_1.Logger.warn(`No entries.components configured in handoff.config.js. ` +
+            `Scaffolding into "${DEFAULT_COMPONENTS_DIR}/". ` +
+            `Add this path to entries.components in your config so the build picks it up.`);
+    }
+    let workingPath = path_1.default.resolve(componentsRoot, name);
     if (!fs_extra_1.default.existsSync(workingPath)) {
         fs_extra_1.default.mkdirSync(workingPath, { recursive: true });
     }
@@ -151,7 +163,7 @@ const makeComponent = (handoff, name) => __awaiter(void 0, void 0, void 0, funct
             return;
         }
     }
-    const templatePath = path_1.default.join(handoff.modulePath, 'config', 'templates/integration/components/template');
+    const templatePath = path_1.default.join(handoff.modulePath, 'config', 'templates/component');
     const htmlPath = path_1.default.resolve(templatePath, 'template.hbs');
     const htmlTemplate = fs_extra_1.default.readFileSync(htmlPath, 'utf8');
     fs_extra_1.default.writeFileSync(targetHtml, htmlTemplate);

package/dist/cli.js

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

package/dist/commands/build/components.js

@@ -16,7 +16,7 @@ const __1 = __importDefault(require("../.."));
 const utils_1 = require("../utils");
 const command = {
     command: 'build:components [component]',
-    describe: 'Build the current integration components. Pass a name to build a specific component.',
+    describe: 'Build the current project components. Pass a name to build a specific component.',
     builder: (yargs) => {
         return (0, utils_1.getSharedOptions)(yargs).positional('component', {
             describe: 'The name of the component',

package/dist/commands/init/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 });
-const create_1 = __importDefault(require("../../create"));
+const create_1 = __importDefault(require("../../cli/create"));
 const command = {
     command: 'init',
     describe: 'Initialize a new Handoff project with interactive wizard',

package/dist/commands/utils.d.ts

@@ -1,5 +1,5 @@
 import { Argv } from 'yargs';
-export declare const getSharedOptions: (yargs: Argv) => Argv<import("yargs").Omit<{}, "config" | "debug" | "force"> & import("yargs").InferredOptionTypes<{
+export declare const getSharedOptions: (yargs: Argv) => Argv<import("yargs").Omit<{}, "debug" | "config" | "force"> & import("yargs").InferredOptionTypes<{
     config: {
         alias: string;
         type: "string";

package/dist/{config.d.ts → config/defaults.d.ts}

@@ -1,5 +1,4 @@
-import Handoff from '.';
-import { ClientConfig, Config } from './types/config';
+import { ClientConfig, Config } from '../types/config';
 export interface ImageStyle {
     name: string;
     style: string;
@@ -11,7 +10,7 @@ export declare const defaultConfig: () => Config;
 /**
  * Retrieves the client configuration from the provided handoff configuration.
  *
- * @param handoff - The handoff object containing the configuration details.
+ * @param config - The full handoff Config object.
  * @returns The client configuration object.
  */
-export declare const getClientConfig: (handoff: Handoff) => ClientConfig;
+export declare const getClientConfig: (config: Config) => ClientConfig;

package/dist/{config.js → config/defaults.js}

@@ -2,13 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getClientConfig = exports.defaultConfig = void 0;
 const defaultConfig = () => {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d;
     return ({
         dev_access_token: (_a = process.env.HANDOFF_DEV_ACCESS_TOKEN) !== null && _a !== void 0 ? _a : null,
         figma_project_id: (_b = process.env.HANDOFF_FIGMA_PROJECT_ID) !== null && _b !== void 0 ? _b : null,
         exportsOutputDirectory: (_c = process.env.HANDOFF_OUTPUT_DIR) !== null && _c !== void 0 ? _c : 'exported',
         sitesOutputDirectory: (_d = process.env.HANDOFF_SITES_DIR) !== null && _d !== void 0 ? _d : 'out',
-        useVariables: (_e = Boolean(process.env.HANDOFF_USE_VARIABLES)) !== null && _e !== void 0 ? _e : false,
+        useVariables: process.env.HANDOFF_USE_VARIABLES === 'true',
+        reactDocgen: {
+            maxDepth: 7,
+            excludeDirectories: ['dist', 'build', '.next'],
+        },
         app: {
             theme: 'default',
             title: 'Convertiv Design System',
@@ -48,11 +52,10 @@ exports.defaultConfig = defaultConfig;
 /**
  * Retrieves the client configuration from the provided handoff configuration.
  *
- * @param handoff - The handoff object containing the configuration details.
+ * @param config - The full handoff Config object.
  * @returns The client configuration object.
  */
-const getClientConfig = (handoff) => {
-    const config = handoff.config;
+const getClientConfig = (config) => {
     const { app, exportsOutputDirectory, sitesOutputDirectory, assets_zip_links = { icons: null, logos: null }, useVariables, } = Object.assign(Object.assign({}, (0, exports.defaultConfig)()), config);
     return {
         app,

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export { defaultConfig, getClientConfig } from './defaults';
+export type { ImageStyle } from './defaults';
+export { initConfig } from './loader';
+export { initRuntimeConfig } from './runtime';
+export { validateConfig } from './validator';

package/dist/config/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = exports.initRuntimeConfig = exports.initConfig = exports.getClientConfig = exports.defaultConfig = void 0;
+// Config defaults and client config
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "defaultConfig", { enumerable: true, get: function () { return defaults_1.defaultConfig; } });
+Object.defineProperty(exports, "getClientConfig", { enumerable: true, get: function () { return defaults_1.getClientConfig; } });
+// Config file loading
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "initConfig", { enumerable: true, get: function () { return loader_1.initConfig; } });
+// Runtime config resolution
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "initRuntimeConfig", { enumerable: true, get: function () { return runtime_1.initRuntimeConfig; } });
+// Config validation
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return validator_1.validateConfig; } });