@harpy-js/core 0.5.1 → 0.5.3

package/dist/cli.js

@@ -8,11 +8,13 @@ const scripts = {
     "build-hydration": path.join(__dirname, "../scripts/build-hydration.ts"),
     "auto-wrap": path.join(__dirname, "../scripts/auto-wrap-exports.ts"),
     "build-styles": path.join(__dirname, "../scripts/build-page-styles.ts"),
+    build: path.join(__dirname, "../scripts/build.ts"),
+    start: path.join(__dirname, "../scripts/start.ts"),
     dev: path.join(__dirname, "../scripts/dev.ts"),
 };
 if (!command || !scripts[command]) {
     console.error("Usage: harpy <command>");
-    console.error("Commands: build-hydration, auto-wrap, build-styles, dev");
+    console.error("Commands: build, start, dev, build-hydration, auto-wrap, build-styles");
     process.exit(1);
 }
 const scriptPath = scripts[command];

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { StaticAssetsController } from "./core/static-assets.controller";
 export { JsxRender } from "./decorators/jsx.decorator";
 export { WithLayout } from "./decorators/layout.decorator";
 export type { MetaOptions, RenderOptions } from "./decorators/jsx.decorator";
+export { SeoModule, BaseSeoService, DefaultSeoService } from "./seo";
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from "./seo";
 export type { JsxLayout, JsxLayoutProps, PageProps } from "./types/jsx.types";
 export { RouterModule } from "./core/router.module";
 export { NavigationService } from "./core/navigation.service";
@@ -17,3 +19,4 @@ export { configureHarpyApp, HarpyAppOptions } from "./core/app-setup";
 export { setupHarpyApp } from "./core/app-setup";
 export { default as Link } from "./client/Link";
 export { buildHrefIndex, getActiveItemIdFromIndex, getActiveItemIdFromManifest, } from "./client/getActiveItemId";
+export { useI18n } from "./client/use-i18n";

package/dist/index.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.getActiveItemIdFromManifest = exports.getActiveItemIdFromIndex = exports.buildHrefIndex = exports.Link = exports.setupHarpyApp = exports.configureHarpyApp = exports.AutoRegisterModule = exports.NavigationService = exports.RouterModule = exports.WithLayout = exports.JsxRender = exports.StaticAssetsController = exports.LiveReloadController = exports.withJsxEngine = exports.getHydrationManifest = exports.getChunkPath = exports.initializeHydrationContext = exports.hydrationContext = exports.autoWrapClientComponent = void 0;
+exports.useI18n = exports.getActiveItemIdFromManifest = exports.getActiveItemIdFromIndex = exports.buildHrefIndex = exports.Link = exports.setupHarpyApp = exports.configureHarpyApp = exports.AutoRegisterModule = exports.NavigationService = exports.RouterModule = exports.DefaultSeoService = exports.BaseSeoService = exports.SeoModule = exports.WithLayout = exports.JsxRender = exports.StaticAssetsController = exports.LiveReloadController = exports.withJsxEngine = exports.getHydrationManifest = exports.getChunkPath = exports.initializeHydrationContext = exports.hydrationContext = exports.autoWrapClientComponent = void 0;
 var client_component_wrapper_1 = require("./core/client-component-wrapper");
 Object.defineProperty(exports, "autoWrapClientComponent", { enumerable: true, get: function () { return client_component_wrapper_1.autoWrapClientComponent; } });
 var hydration_1 = require("./core/hydration");
@@ -22,6 +22,10 @@ var jsx_decorator_1 = require("./decorators/jsx.decorator");
 Object.defineProperty(exports, "JsxRender", { enumerable: true, get: function () { return jsx_decorator_1.JsxRender; } });
 var layout_decorator_1 = require("./decorators/layout.decorator");
 Object.defineProperty(exports, "WithLayout", { enumerable: true, get: function () { return layout_decorator_1.WithLayout; } });
+var seo_1 = require("./seo");
+Object.defineProperty(exports, "SeoModule", { enumerable: true, get: function () { return seo_1.SeoModule; } });
+Object.defineProperty(exports, "BaseSeoService", { enumerable: true, get: function () { return seo_1.BaseSeoService; } });
+Object.defineProperty(exports, "DefaultSeoService", { enumerable: true, get: function () { return seo_1.DefaultSeoService; } });
 var router_module_1 = require("./core/router.module");
 Object.defineProperty(exports, "RouterModule", { enumerable: true, get: function () { return router_module_1.RouterModule; } });
 var navigation_service_1 = require("./core/navigation.service");
@@ -38,3 +42,5 @@ var getActiveItemId_1 = require("./client/getActiveItemId");
 Object.defineProperty(exports, "buildHrefIndex", { enumerable: true, get: function () { return getActiveItemId_1.buildHrefIndex; } });
 Object.defineProperty(exports, "getActiveItemIdFromIndex", { enumerable: true, get: function () { return getActiveItemId_1.getActiveItemIdFromIndex; } });
 Object.defineProperty(exports, "getActiveItemIdFromManifest", { enumerable: true, get: function () { return getActiveItemId_1.getActiveItemIdFromManifest; } });
+var use_i18n_1 = require("./client/use-i18n");
+Object.defineProperty(exports, "useI18n", { enumerable: true, get: function () { return use_i18n_1.useI18n; } });

package/dist/seo/index.d.ts

@@ -0,0 +1,5 @@
+export { SeoModule } from './seo.module';
+export { BaseSeoService, DefaultSeoService } from './seo.service';
+export { RobotsController } from './robots.controller';
+export { SitemapController } from './sitemap.controller';
+export type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';

package/dist/seo/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapController = exports.RobotsController = exports.DefaultSeoService = exports.BaseSeoService = exports.SeoModule = void 0;
+var seo_module_1 = require("./seo.module");
+Object.defineProperty(exports, "SeoModule", { enumerable: true, get: function () { return seo_module_1.SeoModule; } });
+var seo_service_1 = require("./seo.service");
+Object.defineProperty(exports, "BaseSeoService", { enumerable: true, get: function () { return seo_service_1.BaseSeoService; } });
+Object.defineProperty(exports, "DefaultSeoService", { enumerable: true, get: function () { return seo_service_1.DefaultSeoService; } });
+var robots_controller_1 = require("./robots.controller");
+Object.defineProperty(exports, "RobotsController", { enumerable: true, get: function () { return robots_controller_1.RobotsController; } });
+var sitemap_controller_1 = require("./sitemap.controller");
+Object.defineProperty(exports, "SitemapController", { enumerable: true, get: function () { return sitemap_controller_1.SitemapController; } });

package/dist/seo/robots.controller.d.ts

@@ -0,0 +1,6 @@
+import { BaseSeoService } from './seo.service';
+export declare class RobotsController {
+    private readonly seoService;
+    constructor(seoService: BaseSeoService);
+    getRobots(): string;
+}

package/dist/seo/robots.controller.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RobotsController = void 0;
+const common_1 = require("@nestjs/common");
+const seo_service_1 = require("./seo.service");
+let RobotsController = class RobotsController {
+    seoService;
+    constructor(seoService) {
+        this.seoService = seoService;
+    }
+    getRobots() {
+        const config = this.seoService.getRobotsConfig();
+        return this.seoService.formatRobotsTxt(config);
+    }
+};
+exports.RobotsController = RobotsController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, common_1.Header)('Content-Type', 'text/plain'),
+    (0, common_1.Header)('Cache-Control', 'public, max-age=86400'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], RobotsController.prototype, "getRobots", null);
+exports.RobotsController = RobotsController = __decorate([
+    (0, common_1.Controller)('robots.txt'),
+    __metadata("design:paramtypes", [seo_service_1.BaseSeoService])
+], RobotsController);

package/dist/seo/seo.module.d.ts

@@ -0,0 +1,7 @@
+import { DynamicModule, Type } from '@nestjs/common';
+import { BaseSeoService } from './seo.service';
+import type { SeoModuleOptions } from './seo.types';
+export declare class SeoModule {
+    static forRoot(options?: SeoModuleOptions): DynamicModule;
+    static forRootWithService(customService: Type<BaseSeoService>, options?: SeoModuleOptions): DynamicModule;
+}

package/dist/seo/seo.module.js

@@ -0,0 +1,54 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var SeoModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeoModule = void 0;
+const common_1 = require("@nestjs/common");
+const robots_controller_1 = require("./robots.controller");
+const sitemap_controller_1 = require("./sitemap.controller");
+const seo_service_1 = require("./seo.service");
+let SeoModule = SeoModule_1 = class SeoModule {
+    static forRoot(options) {
+        return {
+            module: SeoModule_1,
+            controllers: [robots_controller_1.RobotsController, sitemap_controller_1.SitemapController],
+            providers: [
+                {
+                    provide: seo_service_1.SEO_MODULE_OPTIONS,
+                    useValue: options || {},
+                },
+                {
+                    provide: seo_service_1.BaseSeoService,
+                    useClass: seo_service_1.DefaultSeoService,
+                },
+            ],
+            exports: [seo_service_1.BaseSeoService],
+        };
+    }
+    static forRootWithService(customService, options) {
+        return {
+            module: SeoModule_1,
+            controllers: [robots_controller_1.RobotsController, sitemap_controller_1.SitemapController],
+            providers: [
+                {
+                    provide: seo_service_1.SEO_MODULE_OPTIONS,
+                    useValue: options || {},
+                },
+                {
+                    provide: seo_service_1.BaseSeoService,
+                    useClass: customService,
+                },
+            ],
+            exports: [seo_service_1.BaseSeoService],
+        };
+    }
+};
+exports.SeoModule = SeoModule;
+exports.SeoModule = SeoModule = SeoModule_1 = __decorate([
+    (0, common_1.Module)({})
+], SeoModule);

package/dist/seo/seo.service.d.ts

@@ -0,0 +1,16 @@
+import type { SitemapUrl, RobotsConfig, SeoModuleOptions } from './seo.types';
+export declare const SEO_MODULE_OPTIONS = "SEO_MODULE_OPTIONS";
+export declare abstract class BaseSeoService {
+    protected readonly options?: SeoModuleOptions | undefined;
+    protected readonly baseUrl: string;
+    constructor(options?: SeoModuleOptions | undefined);
+    abstract getSitemapUrls(): Promise<SitemapUrl[]>;
+    abstract getRobotsConfig(): RobotsConfig;
+    formatSitemapXml(urls: SitemapUrl[]): string;
+    formatRobotsTxt(config: RobotsConfig): string;
+    protected escapeXml(str: string): string;
+}
+export declare class DefaultSeoService extends BaseSeoService {
+    getSitemapUrls(): Promise<SitemapUrl[]>;
+    getRobotsConfig(): RobotsConfig;
+}

package/dist/seo/seo.service.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultSeoService = exports.BaseSeoService = exports.SEO_MODULE_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+exports.SEO_MODULE_OPTIONS = 'SEO_MODULE_OPTIONS';
+let BaseSeoService = class BaseSeoService {
+    options;
+    baseUrl;
+    constructor(options) {
+        this.options = options;
+        this.baseUrl = options?.baseUrl || 'http://localhost:3000';
+    }
+    formatSitemapXml(urls) {
+        const urlEntries = urls
+            .map((entry) => {
+            const lastmod = entry.lastModified
+                ? new Date(entry.lastModified).toISOString()
+                : new Date().toISOString();
+            return `  <url>
+    <loc>${this.escapeXml(entry.url)}</loc>
+    <lastmod>${lastmod}</lastmod>
+    ${entry.changeFrequency ? `<changefreq>${entry.changeFrequency}</changefreq>` : ''}
+    ${entry.priority !== undefined ? `<priority>${entry.priority}</priority>` : ''}
+  </url>`;
+        })
+            .join('\n');
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlEntries}
+</urlset>`;
+    }
+    formatRobotsTxt(config) {
+        const rules = Array.isArray(config.rules) ? config.rules : [config.rules];
+        const rulesText = rules
+            .map((rule) => {
+            const userAgents = Array.isArray(rule.userAgent)
+                ? rule.userAgent
+                : [rule.userAgent];
+            const allows = rule.allow
+                ? Array.isArray(rule.allow)
+                    ? rule.allow
+                    : [rule.allow]
+                : [];
+            const disallows = rule.disallow
+                ? Array.isArray(rule.disallow)
+                    ? rule.disallow
+                    : [rule.disallow]
+                : [];
+            let text = userAgents.map((ua) => `User-agent: ${ua}`).join('\n');
+            if (allows.length > 0) {
+                text += '\n' + allows.map((path) => `Allow: ${path}`).join('\n');
+            }
+            if (disallows.length > 0) {
+                text +=
+                    '\n' + disallows.map((path) => `Disallow: ${path}`).join('\n');
+            }
+            if (rule.crawlDelay) {
+                text += `\nCrawl-delay: ${rule.crawlDelay}`;
+            }
+            return text;
+        })
+            .join('\n\n');
+        let result = rulesText;
+        if (config.sitemap) {
+            const sitemaps = Array.isArray(config.sitemap)
+                ? config.sitemap
+                : [config.sitemap];
+            result += '\n\n' + sitemaps.map((s) => `Sitemap: ${s}`).join('\n');
+        }
+        if (config.host) {
+            result += `\n\nHost: ${config.host}`;
+        }
+        return result;
+    }
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+};
+exports.BaseSeoService = BaseSeoService;
+exports.BaseSeoService = BaseSeoService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(exports.SEO_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], BaseSeoService);
+let DefaultSeoService = class DefaultSeoService extends BaseSeoService {
+    async getSitemapUrls() {
+        const now = new Date();
+        return [
+            {
+                url: this.baseUrl,
+                lastModified: now,
+                changeFrequency: 'daily',
+                priority: 1.0,
+            },
+        ];
+    }
+    getRobotsConfig() {
+        const defaultConfig = {
+            rules: {
+                userAgent: '*',
+                allow: '/',
+            },
+            sitemap: `${this.baseUrl}/sitemap.xml`,
+            host: this.baseUrl,
+        };
+        if (this.options?.robotsConfig) {
+            return {
+                ...defaultConfig,
+                ...this.options.robotsConfig,
+            };
+        }
+        return defaultConfig;
+    }
+};
+exports.DefaultSeoService = DefaultSeoService;
+exports.DefaultSeoService = DefaultSeoService = __decorate([
+    (0, common_1.Injectable)()
+], DefaultSeoService);

package/dist/seo/seo.types.d.ts

@@ -0,0 +1,29 @@
+export interface SitemapUrl {
+    url: string;
+    lastModified?: Date | string;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+}
+export interface RobotsConfig {
+    rules: {
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+    } | Array<{
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+        crawlDelay?: number;
+    }>;
+    sitemap?: string | string[];
+    host?: string;
+}
+export interface SeoModuleOptions {
+    baseUrl: string;
+    robotsConfig?: Partial<RobotsConfig>;
+    sitemapGenerator?: () => Promise<SitemapUrl[]>;
+}

package/dist/seo/seo.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/seo/sitemap.controller.d.ts

@@ -0,0 +1,6 @@
+import { BaseSeoService } from './seo.service';
+export declare class SitemapController {
+    private readonly seoService;
+    constructor(seoService: BaseSeoService);
+    getSitemap(): Promise<string>;
+}

package/dist/seo/sitemap.controller.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapController = void 0;
+const common_1 = require("@nestjs/common");
+const seo_service_1 = require("./seo.service");
+let SitemapController = class SitemapController {
+    seoService;
+    constructor(seoService) {
+        this.seoService = seoService;
+    }
+    async getSitemap() {
+        const urls = await this.seoService.getSitemapUrls();
+        return this.seoService.formatSitemapXml(urls);
+    }
+};
+exports.SitemapController = SitemapController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, common_1.Header)('Content-Type', 'application/xml'),
+    (0, common_1.Header)('Cache-Control', 'public, max-age=3600, s-maxage=3600'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SitemapController.prototype, "getSitemap", null);
+exports.SitemapController = SitemapController = __decorate([
+    (0, common_1.Controller)('sitemap.xml'),
+    __metadata("design:paramtypes", [seo_service_1.BaseSeoService])
+], SitemapController);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harpy-js/core",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Harpy - A powerful NestJS + React/JSX SSR framework with automatic hydration and i18n support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/auto-wrap-exports.ts

@@ -11,6 +11,9 @@
 
 import * as fs from "fs";
 import * as path from "path";
+import { Logger } from "./logger";
+
+const logger = new Logger("AutoWrapper");
 
 const PROJECT_ROOT = process.cwd();
 const SRC_DIR = path.join(PROJECT_ROOT, "src");
@@ -213,16 +216,16 @@ function transformCompiledFile(
  * Main function
  */
 function main(): void {
-  console.log("🔄 Auto-wrapping client component exports...\n");
+  logger.log("Auto-wrapping client component exports...");
 
   const clientComponents = findClientComponentsInSource();
 
   if (clientComponents.size === 0) {
-    console.log("⚠️  No client components found\n");
+    logger.warn("No client components found");
     return;
   }
 
-  console.log(`Found ${clientComponents.size} client component(s):\n`);
+  logger.log(`Found ${clientComponents.size} client component(s)`);
 
   let wrapped = 0;
   for (const [compiledPath, componentName] of clientComponents) {
@@ -231,9 +234,7 @@ function main(): void {
     }
   }
 
-  console.log(
-    `\n✨ Auto-wrap complete: ${wrapped}/${clientComponents.size} components wrapped\n`,
-  );
+  logger.log(`Auto-wrap complete: ${wrapped}/${clientComponents.size} components wrapped`);
 }
 
 main();

package/scripts/build-hydration.ts

@@ -13,6 +13,9 @@ import { execSync } from "child_process";
 import * as crypto from "crypto";
 import * as fs from "fs";
 import * as path from "path";
+import { Logger } from "./logger";
+
+const logger = new Logger("HydrationBuilder");
 
 const PROJECT_ROOT = process.cwd();
 const SRC_DIR = path.join(PROJECT_ROOT, "src");
@@ -181,11 +184,11 @@ function main(): void {
     fs.mkdirSync(HYDRATION_ENTRIES_DIR, { recursive: true });
   }
 
-  console.log("🔍 Detecting client components...");
+  logger.log("Detecting client components...");
   const clientComponents = findClientComponents();
 
   if (clientComponents.length === 0) {
-    console.log("⚠️  No client components found");
+    logger.warn("No client components found");
     // Still ensure chunks directory exists and clear manifest
     if (!fs.existsSync(CHUNKS_DIR)) {
       fs.mkdirSync(CHUNKS_DIR, { recursive: true });
@@ -207,7 +210,7 @@ function main(): void {
     fs.mkdirSync(CHUNKS_DIR, { recursive: true });
   }
 
-  console.log("\n📝 Generating hydration entries...");
+  logger.log("Generating hydration entries...");
 
   // Generate hydration entry files
   const entryFiles: { path: string; componentName: string }[] = [];
@@ -223,11 +226,10 @@ function main(): void {
       path: entryPath,
       componentName: component.componentName,
     });
-    console.log(`   ✓ ${component.componentName}.tsx`);
   }
 
   // Build shared vendor bundle first
-  console.log("\n📦 Building shared vendor bundle...");
+  logger.log("Building shared vendor bundle...");
   const vendorEntryPath = path.join(HYDRATION_ENTRIES_DIR, "_vendor.js");
   const vendorContent = `
 import React from 'react';
@@ -242,16 +244,15 @@ window.ReactDOM = ReactDOM;
 
   const vendorOutputPath = path.join(CHUNKS_DIR, VENDOR_BUNDLE);
   try {
-    const vendorCommand = `npx esbuild "${vendorEntryPath}" --bundle --minify --target=es2020 --format=iife --outfile="${vendorOutputPath}" --platform=browser --tree-shaking=true --define:process.env.NODE_ENV=\\"production\\"`;
+    const vendorCommand = `npx esbuild "${vendorEntryPath}" --bundle --minify --target=es2020 --format=iife --outfile="${vendorOutputPath}" --platform=browser --tree-shaking=true --define:process.env.NODE_ENV='"production"'`;
     execSync(vendorCommand, { stdio: "inherit" });
-    console.log(`   ✓ vendor.js (React + ReactDOM)`);
   } catch (error) {
-    console.error(`   ✗ Failed to bundle vendor:`, error);
+    logger.error(`Failed to bundle vendor: ${error}`);
     process.exit(1);
   }
 
   // Bundle each entry file separately with cache-busted names
-  console.log("\n📦 Bundling hydration scripts...");
+  logger.log("Bundling hydration scripts...");
 
   // Create React shim files for aliasing
   const SHIMS_DIR = path.join(DIST_DIR, ".shims");
@@ -301,27 +302,25 @@ module.exports = {
 
     try {
       // Use aliases to redirect React imports to window.React from vendor bundle
-      const command = `npx esbuild "${entry.path}" --bundle --minify --target=es2020 --format=iife --keep-names --outfile="${outputPath}" --platform=browser --tree-shaking=true --define:process.env.NODE_ENV=\\"production\\" --alias:react=${reactShimPath} --alias:react-dom=${reactDomShimPath} --alias:react-dom/client=${reactDomClientShimPath} --alias:react/jsx-runtime=${jsxRuntimeShimPath}`;
+      const command = `npx esbuild "${entry.path}" --bundle --minify --target=es2020 --format=iife --keep-names --outfile="${outputPath}" --platform=browser --tree-shaking=true --define:process.env.NODE_ENV='"production"' --alias:react=${reactShimPath} --alias:react-dom=${reactDomShimPath} --alias:react-dom/client=${reactDomClientShimPath} --alias:react/jsx-runtime=${jsxRuntimeShimPath}`;
       execSync(command, { stdio: "inherit" });
       manifest[entry.componentName] = chunkFilename;
-      console.log(`   ✓ ${entry.componentName} -> ${chunkFilename}`);
     } catch (error) {
-      console.error(`   ✗ Failed to bundle ${entry.componentName}:`, error);
+      logger.error(`Failed to bundle ${entry.componentName}: ${error}`);
       process.exit(1);
     }
   }
 
   // Write manifest file for server-side lookup
-  console.log("\n📋 Writing hydration manifest...");
+  logger.log("Writing hydration manifest...");
   fs.writeFileSync(MANIFEST_FILE, JSON.stringify(manifest, null, 2), "utf-8");
-  console.log(`   ✓ Manifest written to ${MANIFEST_FILE}`);
 
   // Clean up temporary entries directory
   if (fs.existsSync(HYDRATION_ENTRIES_DIR)) {
     fs.rmSync(HYDRATION_ENTRIES_DIR, { recursive: true });
   }
 
-  console.log("\n✨ Hydration build complete!");
+  logger.log("Hydration build complete!");
 }
 
 main();

package/scripts/build-page-styles.ts

@@ -7,7 +7,9 @@
 import { execSync } from "child_process";
 import * as fs from "fs";
 import * as path from "path";
+import { Logger } from "./logger";
 
+const logger = new Logger("StylesBuilder");
 const projectRoot = process.cwd();
 const distDir = path.join(projectRoot, "dist");
 const stylesDir = path.join(distDir, "styles");
@@ -15,7 +17,7 @@ const srcAssetsDir = path.join(projectRoot, "src/assets");
 const outputCssPath = path.join(stylesDir, "styles.css");
 
 async function main(): Promise<void> {
-  console.log("🎨 Building styles...");
+  logger.log("Building styles...");
 
   try {
     // Ensure styles directory exists
@@ -24,7 +26,7 @@ async function main(): Promise<void> {
     }
 
     // Compile Tailwind CSS
-    console.log("   Compiling Tailwind CSS...");
+    logger.log("Compiling Tailwind CSS...");
     execSync(
       `NODE_ENV=production postcss ${path.join(srcAssetsDir, "styles.css")} -o ${outputCssPath}`,
       {
@@ -32,10 +34,9 @@ async function main(): Promise<void> {
       },
     );
 
-    console.log(`   ✓ Generated styles.css`);
-    console.log("✨ Styles build complete!");
+    logger.log("Styles build complete!");
   } catch (error: any) {
-    console.error("❌ CSS generation failed:", error.message);
+    logger.error(`CSS generation failed: ${error.message}`);
     process.exit(1);
   }
 }