handoff-app 1.1.0-experimental.2 → 1.1.1

package/Changelog.md

@@ -6,10 +6,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## \[1.2.0]
+## \[1.1.1] - 2026-03-12
 
-* Upgrade to Next16
-* Add pagination data structure to arrays
+This patch release focuses on Windows stabilization and consistency across environments.
+
+It includes targeted fixes to reduce platform-specific issues in local development and documentation rendering, especially around path handling, routing/navigation behavior, and runtime update detection. These changes aim to make behavior on Windows align more closely with Mac and Linux, with no intended breaking changes.
+
+Also includes a fallback for components with empty previews definitions, preventing preview generation failures during builds.
 
 ## \[1.1.0] - 2026-03-05
 

package/config/docs/system.md

@@ -16,6 +16,4 @@ menu:
     tokens: true
   - title: Components
     components: true
-  - title: Pages
-    pages: true
 ---

package/dist/app/components/Component/Cards.jsx

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const lucide_react_1 = require("lucide-react");
+const react_1 = __importDefault(require("react"));
+const PracticeLine = ({ line, type }) => (<li className="flex items-start gap-3">
+    {type === 'positive' ? (<lucide_react_1.Check className="mt-[5px] h-3 w-3 shrink-0 text-emerald-600" strokeWidth={3}/>) : type === 'negative' ? (<lucide_react_1.X className="mt-[5px] h-3 w-3 shrink-0 text-gray-400" strokeWidth={3}/>) : (<span className="mt-[5px] h-3 w-3 shrink-0"/>)}
+    <p className="text-sm">{line}</p>
+  </li>);
+const CardItem = ({ card }) => {
+    // Split content by newlines and render each line as a separate item
+    const lines = card.content.split('\n').filter((line) => line.trim());
+    return (<ul className="space-y-3 text-emerald-800">
+      {lines.map((line, index) => (<PracticeLine line={line} type={card.type} key={`do-rule-${index}`}/>))}
+    </ul>);
+};
+const Cards = ({ cards, maxCardsPerRow = 2, className = '' }) => {
+    if (!cards || cards.length === 0) {
+        return null;
+    }
+    return (<div className="grid grid-cols-[repeat(auto-fit,minmax(100%,1fr))] gap-6 sm:grid-cols-[repeat(auto-fit,minmax(300px,1fr))]">
+      {cards.map((card, index) => (<div key={`card-${index}`} className="relative rounded-lg border bg-gray-50 p-8 text-gray-600 dark:bg-gray-800">
+          <h2 className="mb-3 font-normal text-gray-700">
+            {card.title}
+          </h2>
+          <CardItem card={card}/>
+        </div>))}
+    </div>);
+};
+exports.default = Cards;

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

@@ -1,13 +1,8 @@
 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).
  */
-declare const buildApp: (handoff: Handoff, skipComponents?: boolean, options?: {
-    copyOnlyPaths?: string[];
-    deployDir?: string;
-}) => Promise<void>;
+declare const buildApp: (handoff: Handoff, skipComponents?: boolean) => Promise<void>;
 /**
  * Watch the Next.js application.
  * Starts a custom dev server with Handoff-specific watchers and hot-reloading.

package/dist/app-builder/build.js

@@ -17,16 +17,15 @@ 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 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 builder_1 = __importDefault(require("../transformers/preview/component/builder"));
 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 watchers_1 = require("./watchers");
 const websocket_1 = require("./websocket");
+const escapeForSingleQuotedJsString = (value) => value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
 /**
  * Performs cleanup of the application directory by removing the existing app directory if it exists.
  */
@@ -59,8 +58,7 @@ const initializeProjectApp = (handoff) => __awaiter(void 0, void 0, void 0, func
         yield fs_extra_1.default.copy(customThemePath, destPath, { overwrite: true });
         logger_1.Logger.success(`Custom theme.css loaded`);
     }
-    // Prepare project app configuration
-    // Warning: Regex replacement is fragile and depends on exact formatting in next.config.mjs
+    // Prepare project app configuration using stable placeholder replacement.
     const handoffProjectId = handoff.getProjectId();
     const handoffAppBasePath = (_a = handoff.config.app.base_path) !== null && _a !== void 0 ? _a : '';
     const handoffWorkingPath = path_1.default.resolve(handoff.workingPath);
@@ -69,38 +67,42 @@ const initializeProjectApp = (handoff) => __awaiter(void 0, void 0, void 0, func
     const nextConfigPath = path_1.default.resolve(srcPath, 'next.config.mjs');
     const targetPath = path_1.default.resolve(appPath, 'next.config.mjs');
     const handoffWebsocketPort = (_c = (_b = handoff.config.app.ports) === null || _b === void 0 ? void 0 : _b.websocket) !== null && _c !== void 0 ? _c : 3001;
-    const nextConfigContent = (yield fs_extra_1.default.readFile(nextConfigPath, 'utf-8'))
-        .replace(/basePath:\s+''/g, `basePath: '${handoffAppBasePath}'`)
-        .replace(/HANDOFF_PROJECT_ID:\s+''/g, `HANDOFF_PROJECT_ID: '${handoffProjectId}'`)
-        .replace(/HANDOFF_APP_BASE_PATH:\s+''/g, `HANDOFF_APP_BASE_PATH: '${handoffAppBasePath}'`)
-        .replace(/HANDOFF_WORKING_PATH:\s+''/g, `HANDOFF_WORKING_PATH: '${handoffWorkingPath}'`)
-        .replace(/HANDOFF_MODULE_PATH:\s+''/g, `HANDOFF_MODULE_PATH: '${handoffModulePath}'`)
-        .replace(/HANDOFF_EXPORT_PATH:\s+''/g, `HANDOFF_EXPORT_PATH: '${handoffExportPath}'`)
-        .replace(/HANDOFF_WEBSOCKET_PORT:\s+''/g, `HANDOFF_WEBSOCKET_PORT: '${handoffWebsocketPort}'`)
-        .replace(/%HANDOFF_MODULE_PATH%/g, handoffModulePath);
+    const escapedAppBasePath = escapeForSingleQuotedJsString(handoffAppBasePath);
+    const escapedProjectId = escapeForSingleQuotedJsString(handoffProjectId);
+    const escapedWorkingPath = escapeForSingleQuotedJsString(handoffWorkingPath);
+    const escapedModulePath = escapeForSingleQuotedJsString(handoffModulePath);
+    const escapedExportPath = escapeForSingleQuotedJsString(handoffExportPath);
+    const escapedWebsocketPort = escapeForSingleQuotedJsString(String(handoffWebsocketPort));
+    const placeholderValues = {
+        '%HANDOFF_PROJECT_ID%': escapedProjectId,
+        '%HANDOFF_APP_BASE_PATH%': escapedAppBasePath,
+        '%HANDOFF_WORKING_PATH%': escapedWorkingPath,
+        '%HANDOFF_MODULE_PATH%': escapedModulePath,
+        '%HANDOFF_EXPORT_PATH%': escapedExportPath,
+        '%HANDOFF_WEBSOCKET_PORT%': escapedWebsocketPort,
+    };
+    let nextConfigContent = yield fs_extra_1.default.readFile(nextConfigPath, 'utf-8');
+    for (const [placeholder, value] of Object.entries(placeholderValues)) {
+        nextConfigContent = nextConfigContent.split(placeholder).join(value);
+    }
     yield fs_extra_1.default.writeFile(targetPath, nextConfigContent);
     return appPath;
 });
 /**
  * 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).
  */
-const buildApp = (handoff, skipComponents, options) => __awaiter(void 0, void 0, void 0, function* () {
+const buildApp = (handoff, skipComponents) => __awaiter(void 0, void 0, void 0, function* () {
     skipComponents = skipComponents !== null && skipComponents !== void 0 ? skipComponents : 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
     yield cleanupAppDirectory(handoff);
     // Build components
     if (!skipComponents) {
         yield (0, components_1.buildComponents)(handoff);
     }
-    // Build pages (must run after components so rendered outputs exist)
-    yield (0, pages_1.buildPages)(handoff);
     // Prepare app
     const appPath = yield initializeProjectApp(handoff);
     yield (0, client_config_1.persistClientConfig)(handoff);
+    // Build app
     const buildResult = cross_spawn_1.default.sync('npx', ['next', 'build'], {
         cwd: appPath,
         stdio: 'inherit',
@@ -113,35 +115,16 @@ const buildApp = (handoff, skipComponents, options) => __awaiter(void 0, void 0,
         }
         throw new Error(errorMsg);
     }
-    // Resolve output directory: explicit deployDir or default under working path
-    const outputRoot = deployDir
-        ? path_1.default.resolve(deployDir)
-        : path_1.default.resolve(handoff.workingPath, handoff.sitesDirectory);
-    const output = deployDir ? outputRoot : path_1.default.resolve(outputRoot, handoff.getProjectId());
-    if (!deployDir) {
-        yield fs_extra_1.default.ensureDir(path_1.default.resolve(handoff.workingPath, handoff.sitesDirectory));
-    }
-    if (copyOnlyPaths && copyOnlyPaths.length > 0) {
-        // Partial deploy: merge only the listed paths into existing output
-        yield fs_extra_1.default.ensureDir(output);
-        const outDir = path_1.default.resolve(appPath, 'out');
-        for (const relativePath of copyOnlyPaths) {
-            const src = path_1.default.join(outDir, relativePath);
-            const dest = path_1.default.join(output, relativePath);
-            if (fs_extra_1.default.existsSync(src)) {
-                yield fs_extra_1.default.ensureDir(path_1.default.dirname(dest));
-                yield fs_extra_1.default.copy(src, dest, { overwrite: true });
-            }
-        }
-    }
-    else {
-        // Full deploy: replace output with full out
-        if (fs_extra_1.default.existsSync(output)) {
-            yield fs_extra_1.default.remove(output);
-        }
-        yield fs_extra_1.default.ensureDir(output);
-        yield fs_extra_1.default.copy(path_1.default.resolve(appPath, 'out'), output);
+    // Ensure output root directory exists
+    const outputRoot = path_1.default.resolve(handoff.workingPath, handoff.sitesDirectory);
+    yield fs_extra_1.default.ensureDir(outputRoot);
+    // Clean the project output directory (if exists)
+    const output = path_1.default.resolve(outputRoot, handoff.getProjectId());
+    if (fs_extra_1.default.existsSync(output)) {
+        yield fs_extra_1.default.remove(output);
     }
+    // Copy the build files into the project output directory
+    yield fs_extra_1.default.copy(path_1.default.resolve(appPath, 'out'), output);
 });
 /**
  * Watch the Next.js application.
@@ -154,8 +137,6 @@ 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);
     const appPath = yield initializeProjectApp(handoff);
     // Persist client configuration
     yield (0, client_config_1.persistClientConfig)(handoff);
@@ -170,7 +151,7 @@ const watchApp = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
         // create empty directory
         yield fs_extra_1.default.ensureDir(moduleOutput);
     }
-    const nextProcess = (0, cross_spawn_1.default)('npx', ['next', 'dev', '--port', String(port)], {
+    const nextProcess = (0, cross_spawn_1.default)('npx', ['next', 'dev', '--turbopack', '--port', String(port)], {
         cwd: appPath,
         stdio: 'inherit',
         env: Object.assign(Object.assign({}, process.env), { NODE_ENV: 'development' }),
@@ -200,7 +181,6 @@ 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);
 });
 exports.watchApp = watchApp;
 /**
@@ -219,7 +199,7 @@ 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', '--port', String((_b = (_a = handoff.config.app.ports) === null || _a === void 0 ? void 0 : _a.app) !== null && _b !== void 0 ? _b : 3000)], {
+    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)], {
         cwd: appPath,
         stdio: 'inherit',
         env: Object.assign(Object.assign({}, process.env), { NODE_ENV: 'development' }),

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

@@ -1,3 +1,2 @@
 export { buildComponents } from '../pipeline/components';
 export { default, devApp, watchApp } from './build';
-export { getL1StaticPathSegments, getL2StaticPathSegments, normalizeRoutePath, resolveAffectedOutputPaths, resolveComponentAffectedOutputPaths, resolveComponentAffectedOutputPathsBatch, routePathToOutputPaths, } from './isr-paths';

package/dist/app-builder/index.js

@@ -3,18 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.routePathToOutputPaths = exports.resolveComponentAffectedOutputPathsBatch = exports.resolveComponentAffectedOutputPaths = exports.resolveAffectedOutputPaths = exports.normalizeRoutePath = exports.getL2StaticPathSegments = exports.getL1StaticPathSegments = exports.watchApp = exports.devApp = exports.default = exports.buildComponents = void 0;
+exports.watchApp = exports.devApp = exports.default = exports.buildComponents = void 0;
 var components_1 = require("../pipeline/components");
 Object.defineProperty(exports, "buildComponents", { enumerable: true, get: function () { return components_1.buildComponents; } });
 var build_1 = require("./build");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(build_1).default; } });
 Object.defineProperty(exports, "devApp", { enumerable: true, get: function () { return build_1.devApp; } });
 Object.defineProperty(exports, "watchApp", { enumerable: true, get: function () { return build_1.watchApp; } });
-var isr_paths_1 = require("./isr-paths");
-Object.defineProperty(exports, "getL1StaticPathSegments", { enumerable: true, get: function () { return isr_paths_1.getL1StaticPathSegments; } });
-Object.defineProperty(exports, "getL2StaticPathSegments", { enumerable: true, get: function () { return isr_paths_1.getL2StaticPathSegments; } });
-Object.defineProperty(exports, "normalizeRoutePath", { enumerable: true, get: function () { return isr_paths_1.normalizeRoutePath; } });
-Object.defineProperty(exports, "resolveAffectedOutputPaths", { enumerable: true, get: function () { return isr_paths_1.resolveAffectedOutputPaths; } });
-Object.defineProperty(exports, "resolveComponentAffectedOutputPaths", { enumerable: true, get: function () { return isr_paths_1.resolveComponentAffectedOutputPaths; } });
-Object.defineProperty(exports, "resolveComponentAffectedOutputPathsBatch", { enumerable: true, get: function () { return isr_paths_1.resolveComponentAffectedOutputPathsBatch; } });
-Object.defineProperty(exports, "routePathToOutputPaths", { enumerable: true, get: function () { return isr_paths_1.routePathToOutputPaths; } });

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

@@ -34,15 +34,11 @@ export declare const mapEntryTypeToSegment: (type: keyof ComponentListObject["en
  *
  * @returns A Map of paths to watch and their entry types
  */
-export declare const getRuntimeComponentsPathsToWatch: (handoff: Handoff) => Map<string, "js" | "scss" | "template">;
+export declare const getRuntimeComponentsPathsToWatch: (handoff: Handoff) => Map<string, "template" | "js" | "scss">;
 /**
  * Watches runtime components for changes.
  */
 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.
- */
-export declare const watchRuntimePages: (handoff: Handoff, state: WatcherState) => void;
 /**
  * Watches the runtime configuration for changes.
  */

package/dist/app-builder/watchers.js

@@ -35,15 +35,15 @@ 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.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 logger_1 = require("../utils/logger");
+const path_2 = require("../utils/path");
 const client_config_1 = require("./client-config");
 const paths_1 = require("./paths");
 /**
@@ -146,11 +146,6 @@ const watchGlobalEntries = (handoff, state, chokidarConfig) => {
     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':
@@ -160,8 +155,8 @@ const watchGlobalEntries = (handoff, state, chokidarConfig) => {
                     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));
+                        const shouldRebuildMainCss = !!scssEntry && scssPathsToWatch.some((watchPath) => (0, path_2.isPathInside)(file, watchPath));
+                        const shouldRebuildMainJs = !!jsEntry && jsPathsToWatch.some((watchPath) => (0, path_2.isPathInside)(file, watchPath));
                         if (shouldRebuildMainCss) {
                             yield (0, css_1.buildMainCss)(handoff);
                         }
@@ -229,11 +224,14 @@ const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) =>
     }
     if (runtimeComponentPathsToWatch.size > 0) {
         const pathsToWatch = Array.from(runtimeComponentPathsToWatch.keys());
+        const runtimeComponentEntryTypeByPath = new Map(Array.from(runtimeComponentPathsToWatch.entries()).map(([watchPath, entryType]) => [(0, path_2.normalizePathForCompare)(watchPath), entryType]));
+        const configFileSet = new Set(handoff.getConfigFilePaths().map((configPath) => (0, path_2.normalizePathForCompare)(configPath)));
         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)) {
+            const normalizedFile = (0, path_2.normalizePathForCompare)(file);
+            if (configFileSet.has(normalizedFile)) {
                 return;
             }
             switch (event) {
@@ -243,7 +241,7 @@ const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) =>
                     if (!state.debounce) {
                         state.debounce = true;
                         try {
-                            const entryType = runtimeComponentPathsToWatch.get(file);
+                            const entryType = runtimeComponentEntryTypeByPath.get(normalizedFile);
                             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);
@@ -261,63 +259,6 @@ const watchRuntimeComponents = (handoff, state, runtimeComponentPathsToWatch) =>
     }
 };
 exports.watchRuntimeComponents = watchRuntimeComponents;
-/**
- * Watches runtime page config files for changes and triggers page rebuilds.
- */
-const watchRuntimePages = (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 dirName = path_1.default.basename(path_1.default.dirname(configPath));
-        return dirName in runtimePages;
-    });
-    // Also watch page directories directly
-    const pageIds = Object.keys(runtimePages);
-    if (pageIds.length === 0 && pageConfigPaths.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);
-        }
-    }
-    // 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);
-            if (fs_extra_1.default.existsSync(resolvedPath)) {
-                pathsToWatch.push(resolvedPath);
-            }
-        }
-    }
-    if (pathsToWatch.length === 0)
-        return;
-    chokidar_1.default.watch(pathsToWatch, { ignoreInitial: true }).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('Page config changed. Rebuilding pages...');
-                        handoff.reload();
-                        yield (0, builder_2.processPages)(handoff);
-                    }
-                    catch (e) {
-                        logger_1.Logger.error('Error processing pages:', e);
-                    }
-                    finally {
-                        state.debounce = false;
-                    }
-                }
-                break;
-        }
-    }));
-};
-exports.watchRuntimePages = watchRuntimePages;
 /**
  * Watches the runtime configuration for changes.
  */

package/dist/cache/build-cache.js

@@ -27,6 +27,7 @@ exports.pruneRemovedComponents = pruneRemovedComponents;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
+const path_2 = require("../utils/path");
 const file_state_1 = require("./file-state");
 /** Current cache format version - bump when structure changes */
 const CACHE_VERSION = '1.0.0';
@@ -142,23 +143,17 @@ function getComponentFilePaths(handoff, componentId) {
     }
     const files = [];
     let templateDir;
-    // Find the config file path for this component
-    const configPaths = handoff.getConfigFilePaths();
-    for (const configPath of configPaths) {
-        // Check if this config path belongs to this component
-        if (configPath.includes(componentId)) {
-            files.push(configPath);
-            break;
-        }
-    }
-    // Add entry files
+    const componentDirs = new Set();
+    // Add entry files and infer component directories from resolved entry paths
     const entries = runtimeComponent.entries;
     if (entries) {
         if (entries.js) {
             files.push(entries.js);
+            componentDirs.add((0, path_2.normalizePathForCompare)(path_1.default.dirname(entries.js)));
         }
         if (entries.scss) {
             files.push(entries.scss);
+            componentDirs.add((0, path_2.normalizePathForCompare)(path_1.default.dirname(entries.scss)));
         }
         // Handle both 'template' (singular) and 'templates' (plural) entry types
         const templatePath = entries.template || entries.templates;
@@ -167,17 +162,37 @@ function getComponentFilePaths(handoff, componentId) {
                 const stat = fs_extra_1.default.statSync(templatePath);
                 if (stat.isDirectory()) {
                     templateDir = templatePath;
+                    componentDirs.add((0, path_2.normalizePathForCompare)(templatePath));
                 }
                 else {
                     files.push(templatePath);
+                    componentDirs.add((0, path_2.normalizePathForCompare)(path_1.default.dirname(templatePath)));
                 }
             }
             catch (_d) {
                 // File doesn't exist, still add to track
                 files.push(templatePath);
+                componentDirs.add((0, path_2.normalizePathForCompare)(path_1.default.dirname(templatePath)));
             }
         }
     }
+    // Find the config file path for this component using exact config filename + directory matching.
+    const configPaths = handoff.getConfigFilePaths();
+    const expectedConfigFileNames = new Set([`${componentId}.json`, `${componentId}.js`, `${componentId}.cjs`]);
+    const matchingConfigPath = configPaths.find((configPath) => {
+        const configFileName = path_1.default.basename(configPath);
+        if (!expectedConfigFileNames.has(configFileName)) {
+            return false;
+        }
+        if (componentDirs.size === 0) {
+            return true;
+        }
+        const configDir = (0, path_2.normalizePathForCompare)(path_1.default.dirname(configPath));
+        return componentDirs.has(configDir);
+    });
+    if (matchingConfigPath) {
+        files.push(matchingConfigPath);
+    }
     return { files, templateDir };
 }
 /**

package/dist/cli.js

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

package/dist/commands/index.js

@@ -12,16 +12,9 @@ const pages_1 = __importDefault(require("./eject/pages"));
 const theme_1 = __importDefault(require("./eject/theme"));
 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 component_2 = __importDefault(require("./make/component"));
+const component_1 = __importDefault(require("./make/component"));
 const page_1 = __importDefault(require("./make/page"));
 const template_1 = __importDefault(require("./make/template"));
-const init_2 = __importDefault(require("./platform/init"));
-const login_1 = __importDefault(require("./platform/login"));
-const logout_1 = __importDefault(require("./platform/logout"));
-const pull_1 = __importDefault(require("./platform/pull"));
-const push_1 = __importDefault(require("./platform/push"));
 const scaffold_1 = __importDefault(require("./scaffold"));
 const start_1 = __importDefault(require("./start"));
 const components_2 = __importDefault(require("./validate/components"));
@@ -34,16 +27,9 @@ exports.commands = [
     theme_1.default,
     fetch_1.default,
     init_1.default,
-    pages_2.default,
-    component_1.default,
     page_1.default,
-    component_2.default,
+    component_1.default,
     template_1.default,
-    login_1.default,
-    init_2.default,
-    pull_1.default,
-    push_1.default,
-    logout_1.default,
     scaffold_1.default,
     start_1.default,
     components_2.default,

package/dist/config/runtime.d.ts

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