npm - @harpy-js/core - Versions diffs - 0.4.7 - Mend

@harpy-js/core 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (147) hide show

package/README.md +326 -0
package/dist/cli.d.ts +12 -0
package/dist/cli.js +53 -0
package/dist/client/Link.d.ts +5 -0
package/dist/client/Link.js +62 -0
package/dist/client/__tests__/getActiveItemId.test.d.ts +1 -0
package/dist/client/__tests__/getActiveItemId.test.js +38 -0
package/dist/client/getActiveItemId.d.ts +7 -0
package/dist/client/getActiveItemId.js +55 -0
package/dist/client/use-i18n.d.ts +7 -0
package/dist/client/use-i18n.js +64 -0
package/dist/core/__tests__/component-analyzer.test.d.ts +1 -0
package/dist/core/__tests__/component-analyzer.test.js +151 -0
package/dist/core/__tests__/hydration-manifest.test.d.ts +1 -0
package/dist/core/__tests__/hydration-manifest.test.js +211 -0
package/dist/core/__tests__/jsx.engine.test.d.ts +1 -0
package/dist/core/__tests__/jsx.engine.test.js +118 -0
package/dist/core/app-setup.d.ts +7 -0
package/dist/core/app-setup.js +79 -0
package/dist/core/auto-register.module.d.ts +9 -0
package/dist/core/auto-register.module.js +18 -0
package/dist/core/auto-wrap-middleware.d.ts +4 -0
package/dist/core/auto-wrap-middleware.js +130 -0
package/dist/core/client-component-wrapper.d.ts +5 -0
package/dist/core/client-component-wrapper.js +37 -0
package/dist/core/client-hydration.d.ts +2 -0
package/dist/core/client-hydration.js +93 -0
package/dist/core/client-wrapper-browser.d.ts +2 -0
package/dist/core/client-wrapper-browser.js +22 -0
package/dist/core/component-analyzer.d.ts +4 -0
package/dist/core/component-analyzer.js +98 -0
package/dist/core/component-auto-wrapper.d.ts +2 -0
package/dist/core/component-auto-wrapper.js +63 -0
package/dist/core/component-client-wrapper.d.ts +4 -0
package/dist/core/component-client-wrapper.js +80 -0
package/dist/core/hydration-generator.d.ts +2 -0
package/dist/core/hydration-generator.js +98 -0
package/dist/core/hydration-manifest.d.ts +7 -0
package/dist/core/hydration-manifest.js +83 -0
package/dist/core/hydration.d.ts +16 -0
package/dist/core/hydration.js +72 -0
package/dist/core/jsx.engine.d.ts +9 -0
package/dist/core/jsx.engine.js +161 -0
package/dist/core/live-reload-client.js +32 -0
package/dist/core/live-reload.controller.d.ts +10 -0
package/dist/core/live-reload.controller.js +38 -0
package/dist/core/navigation.service.d.ts +18 -0
package/dist/core/navigation.service.js +206 -0
package/dist/core/router.module.d.ts +2 -0
package/dist/core/router.module.js +21 -0
package/dist/core/static-assets.controller.d.ts +4 -0
package/dist/core/static-assets.controller.js +51 -0
package/dist/core/types/nav.types.d.ts +22 -0
package/dist/core/types/nav.types.js +2 -0
package/dist/core/views/layout.d.ts +8 -0
package/dist/core/views/layout.js +35 -0
package/dist/decorators/jsx.decorator.d.ts +26 -0
package/dist/decorators/jsx.decorator.js +10 -0
package/dist/decorators/layout.decorator.d.ts +4 -0
package/dist/decorators/layout.decorator.js +29 -0
package/dist/i18n/__tests__/i18n.helper.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.helper.test.js +105 -0
package/dist/i18n/__tests__/i18n.interceptor.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.interceptor.test.js +195 -0
package/dist/i18n/__tests__/i18n.module.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.module.test.js +83 -0
package/dist/i18n/__tests__/i18n.service.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.service.test.js +109 -0
package/dist/i18n/__tests__/t.test.d.ts +1 -0
package/dist/i18n/__tests__/t.test.js +66 -0
package/dist/i18n/i18n-module.options.d.ts +10 -0
package/dist/i18n/i18n-module.options.js +4 -0
package/dist/i18n/i18n-switcher.controller.d.ts +12 -0
package/dist/i18n/i18n-switcher.controller.js +80 -0
package/dist/i18n/i18n-types.d.ts +8 -0
package/dist/i18n/i18n-types.js +2 -0
package/dist/i18n/i18n.helper.d.ts +14 -0
package/dist/i18n/i18n.helper.js +70 -0
package/dist/i18n/i18n.interceptor.d.ts +9 -0
package/dist/i18n/i18n.interceptor.js +99 -0
package/dist/i18n/i18n.module.d.ts +5 -0
package/dist/i18n/i18n.module.js +51 -0
package/dist/i18n/i18n.service.d.ts +12 -0
package/dist/i18n/i18n.service.js +61 -0
package/dist/i18n/index.d.ts +10 -0
package/dist/i18n/index.js +20 -0
package/dist/i18n/locale.decorator.d.ts +1 -0
package/dist/i18n/locale.decorator.js +8 -0
package/dist/i18n/t.d.ts +3 -0
package/dist/i18n/t.js +16 -0
package/dist/index.d.ts +19 -0
package/dist/index.js +40 -0
package/package.json +79 -0
package/scripts/analyze-styles.ts +124 -0
package/scripts/auto-wrap-exports.ts +239 -0
package/scripts/build-css.ts +38 -0
package/scripts/build-hydration.ts +313 -0
package/scripts/build-page-styles.ts +43 -0
package/scripts/copy-assets.ts +34 -0
package/scripts/dev.sh +3 -0
package/scripts/dev.ts +257 -0
package/src/cli.ts +71 -0
package/src/client/Link.tsx +62 -0
package/src/client/__tests__/getActiveItemId.test.ts +49 -0
package/src/client/getActiveItemId.ts +54 -0
package/src/client/use-i18n.ts +111 -0
package/src/core/__tests__/component-analyzer.test.ts +141 -0
package/src/core/__tests__/hydration-manifest.test.ts +223 -0
package/src/core/__tests__/jsx.engine.test.ts +137 -0
package/src/core/app-setup.ts +114 -0
package/src/core/auto-register.module.ts +30 -0
package/src/core/auto-wrap-middleware.ts +165 -0
package/src/core/client-component-wrapper.ts +72 -0
package/src/core/client-hydration.tsx +99 -0
package/src/core/client-wrapper-browser.ts +40 -0
package/src/core/component-analyzer.ts +89 -0
package/src/core/component-auto-wrapper.ts +68 -0
package/src/core/component-client-wrapper.ts +112 -0
package/src/core/hydration-generator.ts +94 -0
package/src/core/hydration-manifest.ts +79 -0
package/src/core/hydration.ts +70 -0
package/src/core/jsx.engine.ts +205 -0
package/src/core/live-reload-client.js +32 -0
package/src/core/live-reload.controller.ts +55 -0
package/src/core/navigation.service.ts +257 -0
package/src/core/router.module.ts +9 -0
package/src/core/static-assets.controller.ts +19 -0
package/src/core/types/nav.types.ts +53 -0
package/src/core/views/layout.tsx +61 -0
package/src/decorators/jsx.decorator.ts +49 -0
package/src/decorators/layout.decorator.ts +66 -0
package/src/i18n/__tests__/i18n.helper.test.ts +126 -0
package/src/i18n/__tests__/i18n.interceptor.test.ts +229 -0
package/src/i18n/__tests__/i18n.module.test.ts +98 -0
package/src/i18n/__tests__/i18n.service.test.ts +129 -0
package/src/i18n/__tests__/t.test.ts +88 -0
package/src/i18n/i18n-module.options.ts +53 -0
package/src/i18n/i18n-switcher.controller.ts +99 -0
package/src/i18n/i18n-types.ts +56 -0
package/src/i18n/i18n.helper.ts +75 -0
package/src/i18n/i18n.interceptor.ts +114 -0
package/src/i18n/i18n.module.ts +45 -0
package/src/i18n/i18n.service.ts +95 -0
package/src/i18n/index.ts +37 -0
package/src/i18n/locale.decorator.ts +10 -0
package/src/i18n/t.ts +62 -0
package/src/index.ts +31 -0

package/README.md ADDED Viewed

@@ -0,0 +1,326 @@
+# @harpy-js/core
+Core package for NestJS + React/JSX with server-side rendering and automatic client-side hydration.
+## Features
+- 🎯 **JSX Engine** - Render React components in NestJS controllers
+- 🔄 **Auto Hydration** - Client components marked with `'use client'` automatically hydrate
+- ⚡ **Fast Builds** - Optimized build pipeline with esbuild
+- 🚀 **Performance Optimized** - Shared vendor bundle (188KB) + tiny component chunks (1-3KB)
+- 📦 **Zero Config** - Works out of the box with NestJS
+- 🌐 **I18n Support** - Built-in internationalization with type-safe translations
+- 🍪 **Cookie Management** - Integrated with Fastify for session management
+- 🎨 **CSS Optimization** - Automatic minification with cssnano in production
+## Installation
+```bash
+npm install @harpy-js/core react react-dom
+# or
+yarn add @harpy-js/core react react-dom
+# or
+pnpm add @harpy-js/core react react-dom
+```
+**Required peer dependencies:**
+- `@nestjs/common` ^11.0.0
+- `@nestjs/core` ^11.0.0
+- `@nestjs/platform-fastify` ^11.0.0
+- `react` ^19.0.0
+- `react-dom` ^19.0.0
+## Quick Start
+### 1. Set up the JSX engine in your main.ts
+```typescript
+import "reflect-metadata"; // Required for NestJS
+import { NestFactory } from "@nestjs/core";
+import {
+  FastifyAdapter,
+  NestFastifyApplication,
+} from "@nestjs/platform-fastify";
+import { withJsxEngine } from "@harpy-js/core";
+import { AppModule } from "./app.module";
+import DefaultLayout from "./views/layout";
+import * as path from "path";
+import fastifyStatic from "@fastify/static";
+async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(
+    AppModule,
+    new FastifyAdapter(),
+  );
+  // Enable JSX rendering
+  withJsxEngine(app, DefaultLayout);
+  // Register static file serving
+  const fastify = app.getHttpAdapter().getInstance();
+  await fastify.register(fastifyStatic, {
+    root: path.join(process.cwd(), "dist"),
+    prefix: "/",
+  });
+  await app.listen({
+    port: 3000,
+    host: "0.0.0.0",
+  });
+}
+bootstrap();
+```
+### 2. Create a layout component
+```tsx
+// src/views/layout.tsx
+import React from "react";
+import { JsxLayoutProps } from "@ harpy-js/core";
+export default function Layout({
+  children,
+  meta,
+  hydrationScripts,
+}: JsxLayoutProps) {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>{meta?.title || "My App"}</title>
+        {meta?.description && (
+          <meta name="description" content={meta.description} />
+        )}
+        <link rel="stylesheet" href="/styles/styles.css" />
+      </head>
+      <body>
+        <main id="body">{children}</main>
+        {/* Vendor bundle loads React/ReactDOM once */}
+        {hydrationScripts?.vendorScript && (
+          <script src={hydrationScripts.vendorScript} />
+        )}
+        {/* Component-specific hydration scripts */}
+        {hydrationScripts?.componentScripts?.map((script) => (
+          <script key={script.componentName} src={script.path} />
+        ))}
+      </body>
+    </html>
+  );
+}
+```
+### 3. Create a controller with JSX rendering
+```typescript
+import { Controller, Get } from "@nestjs/common";
+import { JsxRender } from "@ harpy-js/core";
+import Homepage from "./views/homepage";
+@Controller()
+export class HomeController {
+  @Get()
+  @JsxRender(Homepage, {
+    meta: {
+      title: "Welcome",
+      description: "My homepage",
+    },
+  })
+  home() {
+    return {
+      message: "Hello World",
+    };
+  }
+}
+```
+### 4. Create your page component
+```tsx
+// src/features/home/views/homepage.tsx
+import React from "react";
+import Counter from "./counter";
+export default function Homepage({ message }) {
+  return (
+    <div>
+      <h1>{message}</h1>
+      <Counter />
+    </div>
+  );
+}
+```
+### 5. Create a client component
+```tsx
+// src/features/home/views/counter.tsx
+"use client";
+import React from "react";
+export default function Counter() {
+  const [count, setCount] = React.useState(0);
+  return (
+    <div>
+      <p>Count: {count}</p>
+      <button onClick={() => setCount(count + 1)}>Increment</button>
+    </div>
+  );
+}
+```
+## API Reference
+### `withJsxEngine(app, defaultLayout)`
+Sets up the JSX rendering engine on a NestJS Fastify application.
+**Parameters:**
+- `app` - NestFastifyApplication instance
+- `defaultLayout` - React component to use as the default layout
+### `@JsxRender(component, options?)`
+Decorator to render a React component from a controller method.
+**Parameters:**
+- `component` - React component to render
+- `options` - Rendering options
+  - `meta` - Meta tags for the page (title, description, og tags, etc.)
+  - `layout` - Custom layout component (optional)
+### `autoWrapClientComponent(Component, componentName)`
+Wraps a component for automatic hydration. Used internally by the build process.
+## Build Scripts
+The package includes CLI commands for building:
+```bash
+# Build hydration bundles
+harpy build-hydration
+# Auto-wrap client components
+harpy auto-wrap
+# Build styles
+harpy build-styles
+# Development mode
+harpy dev
+```
+## How It Works
+1. **Server-Side Rendering**: Components are rendered to HTML on the server
+2. **Component Registration**: Client components (marked with `'use client'`) register themselves during SSR
+3. **Auto-Wrapping**: Build scripts automatically wrap client components for hydration
+4. **Vendor Bundle Optimization**: React and ReactDOM are bundled once (188KB) and shared across all components
+5. **Client Bundling**: Client components are bundled separately with esbuild (1-3KB each)
+6. **Hydration**: Client bundles load React from the shared vendor and hydrate the SSR'd HTML
+## Performance Optimizations
+The framework implements several performance optimizations:
+- **Shared Vendor Bundle**: React (19.x) and ReactDOM are bundled once (188KB minified) instead of being duplicated in each component
+- **Tiny Component Chunks**: Individual components are only 1-3KB each (97% reduction compared to bundling React in each)
+- **Tree Shaking**: Unused code is automatically removed during production builds
+- **CSS Minification**: Stylesheets are automatically minified with cssnano in production
+- **Production Mode**: `process.env.NODE_ENV` is properly set to enable React optimizations
+## Internationalization (i18n)
+Built-in support for multi-language applications:
+```typescript
+// app.module.ts
+import { Module } from "@nestjs/common";
+import { I18nModule } from "@ harpy-js/i18n";
+@Module({
+  imports: [
+    I18nModule.forRoot({
+      defaultLocale: "en",
+      supportedLocales: ["en", "fr", "ar"],
+      dictionaries: {
+        en: () => import("./dictionaries/en.json"),
+        fr: () => import("./dictionaries/fr.json"),
+        ar: () => import("./dictionaries/ar.json"),
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+**Using translations in components:**
+```tsx
+// Client component
+"use client";
+import { useI18n } from "@ harpy-js/core/client";
+export default function MyComponent() {
+  const { t, locale, setLocale } = useI18n();
+  return (
+    <div>
+      <h1>{t("welcome.title")}</h1>
+      <button onClick={() => setLocale("fr")}>Switch to French</button>
+    </div>
+  );
+}
+```
+**Using translations in controllers (server-side):**
+```typescript
+import { Controller, Get } from "@nestjs/common";
+import { JsxRender } from "@ harpy-js/core";
+import { CurrentLocale, t } from "@ harpy-js/i18n";
+import { getDictionary } from "./i18n/get-dictionary";
+@Controller()
+export class HomeController {
+  @Get()
+  @JsxRender(Homepage)
+  async home(@CurrentLocale() locale: string) {
+    const dict = await getDictionary(locale);
+    return {
+      title: t(dict, "home.title"),
+      message: t(dict, "home.welcome"),
+      dict,
+      locale,
+    };
+  }
+}
+```
+## TypeScript Configuration
+Make sure your `tsconfig.json` includes:
+```json
+{
+  "compilerOptions": {
+    "jsx": "react",
+    "esModuleInterop": true,
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}
+```
+## License
+MIT

package/dist/cli.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+declare const spawn: any;
+declare const path: any;
+declare const command: string;
+declare const args: string[];
+declare const scripts: Record<string, string>;
+declare const scriptPath: string;
+declare const findTsx: () => string;
+declare const tsxCmd: string;
+declare let execCommand: string;
+declare let cmdArgs: string[];
+declare const proc: any;

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+const { spawn } = require("child_process");
+const path = require("path");
+const command = process.argv[2];
+const args = process.argv.slice(3);
+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"),
+    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");
+    process.exit(1);
+}
+const scriptPath = scripts[command];
+const findTsx = () => {
+    const fs = require("fs");
+    const possiblePaths = [
+        path.join(process.cwd(), "node_modules", ".bin", "tsx"),
+        path.join(process.cwd(), "apps", "test-app", "node_modules", ".bin", "tsx"),
+        path.join(__dirname, "../../node_modules", ".bin", "tsx"),
+        path.join(__dirname, "../../../node_modules", ".bin", "tsx"),
+        path.join(__dirname, "../../../../node_modules", ".bin", "tsx"),
+    ];
+    for (const tsxPath of possiblePaths) {
+        if (fs.existsSync(tsxPath)) {
+            return tsxPath;
+        }
+    }
+    throw new Error("tsx not found. Please install tsx in your project: npm install -D tsx");
+};
+const tsxCmd = findTsx();
+let execCommand;
+let cmdArgs;
+if (tsxCmd.startsWith("node ")) {
+    const parts = tsxCmd.split(" ");
+    execCommand = parts[0];
+    cmdArgs = [...parts.slice(1), scriptPath, ...args];
+}
+else {
+    execCommand = tsxCmd;
+    cmdArgs = [scriptPath, ...args];
+}
+const proc = spawn(execCommand, cmdArgs, {
+    stdio: "inherit",
+    shell: false,
+});
+proc.on("exit", (code) => {
+    process.exit(code || 0);
+});

package/dist/client/Link.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import React, { AnchorHTMLAttributes } from "react";
+export type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    replace?: boolean;
+};
+export default function Link({ href, onClick, replace, ...rest }: LinkProps): React.JSX.Element;

package/dist/client/Link.js ADDED Viewed

@@ -0,0 +1,62 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Link;
+const react_1 = __importStar(require("react"));
+function Link({ href = "#", onClick, replace, ...rest }) {
+    const isLocal = typeof href === "string" && href.startsWith("/");
+    const handleClick = (0, react_1.useCallback)((e) => {
+        if (onClick) {
+            onClick(e);
+        }
+        if (e.defaultPrevented)
+            return;
+        if (e.button !== 0 || e.metaKey || e.altKey || e.ctrlKey || e.shiftKey) {
+            return;
+        }
+        if (!isLocal)
+            return;
+        e.preventDefault();
+        try {
+            const method = replace ? "replaceState" : "pushState";
+            window.history[method]({}, "", href);
+            window.dispatchEvent(new PopStateEvent("popstate"));
+        }
+        catch (err) {
+            window.location.assign(href);
+        }
+    }, [href, isLocal, onClick, replace]);
+    return react_1.default.createElement("a", { href: href, onClick: handleClick, ...rest });
+}

package/dist/client/__tests__/getActiveItemId.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/client/__tests__/getActiveItemId.test.js ADDED Viewed

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const getActiveItemId_1 = require("../getActiveItemId");
+describe('getActiveItemId helpers', () => {
+    const items = [
+        { id: 'home', href: '/' },
+        { id: 'docs', href: '/docs' },
+        { id: 'docs-start', href: '/docs/getting-started' },
+        { id: 'about', href: '/about/' },
+    ];
+    test('exact match prefers exact href over ancestor', () => {
+        const id = (0, getActiveItemId_1.getActiveItemIdFromManifest)(items, '/docs/getting-started');
+        expect(id).toBe('docs-start');
+    });
+    test('ancestor matching finds parent when exact missing', () => {
+        const id = (0, getActiveItemId_1.getActiveItemIdFromManifest)(items, '/docs/usage');
+        expect(id).toBe('docs');
+    });
+    test('normalizes query and fragment and trailing slash', () => {
+        const id = (0, getActiveItemId_1.getActiveItemIdFromManifest)(items, '/about?lang=en#team');
+        expect(id).toBe('about');
+    });
+    test('root fallback matches when no other match', () => {
+        const id = (0, getActiveItemId_1.getActiveItemIdFromManifest)(items, '/unknown/path');
+        expect(id).toBe('home');
+    });
+    test('returns undefined when no match and no root', () => {
+        const itemsNoRoot = items.filter((i) => i.href !== '/');
+        const id = (0, getActiveItemId_1.getActiveItemIdFromManifest)(itemsNoRoot, '/unknown/path');
+        expect(id).toBeUndefined();
+    });
+    test('index-based lookup returns same result as manifest-based', () => {
+        const idx = (0, getActiveItemId_1.buildHrefIndex)(items);
+        const byIndex = (0, getActiveItemId_1.getActiveItemIdFromIndex)(idx, '/docs/guide/intro');
+        const byManifest = (0, getActiveItemId_1.getActiveItemIdFromManifest)(items, '/docs/guide/intro');
+        expect(byIndex).toBe(byManifest);
+    });
+});

package/dist/client/getActiveItemId.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export type NavItemLite = {
+    id: string;
+    href?: string;
+};
+export declare function buildHrefIndex(items: NavItemLite[]): Map<string, string[]>;
+export declare function getActiveItemIdFromIndex(hrefIndex: Map<string, string[]>, currentPath?: string): string | undefined;
+export declare function getActiveItemIdFromManifest(items: NavItemLite[], currentPath?: string): string | undefined;

package/dist/client/getActiveItemId.js ADDED Viewed

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHrefIndex = buildHrefIndex;
+exports.getActiveItemIdFromIndex = getActiveItemIdFromIndex;
+exports.getActiveItemIdFromManifest = getActiveItemIdFromManifest;
+function normalizePath(p) {
+    if (!p)
+        return "";
+    const withoutQuery = p.split(/[?#]/)[0];
+    if (withoutQuery.length > 1 && withoutQuery.endsWith("/"))
+        return withoutQuery.slice(0, -1);
+    return withoutQuery;
+}
+function buildHrefIndex(items) {
+    const map = new Map();
+    for (const it of items) {
+        if (!it.href)
+            continue;
+        const key = normalizePath(it.href);
+        const arr = map.get(key) ?? [];
+        arr.push(it.id);
+        map.set(key, arr);
+    }
+    return map;
+}
+function getActiveItemIdFromIndex(hrefIndex, currentPath) {
+    if (!currentPath)
+        return undefined;
+    let cur = normalizePath(currentPath);
+    while (cur !== "") {
+        const entry = hrefIndex.get(cur);
+        if (entry && entry.length > 0)
+            return entry[0];
+        const lastSlash = cur.lastIndexOf("/");
+        if (lastSlash === -1)
+            break;
+        if (lastSlash === 0) {
+            cur = "/";
+        }
+        else {
+            cur = cur.slice(0, lastSlash);
+        }
+        if (cur === "/") {
+            const entryRoot = hrefIndex.get("/");
+            if (entryRoot && entryRoot.length > 0)
+                return entryRoot[0];
+            break;
+        }
+    }
+    return undefined;
+}
+function getActiveItemIdFromManifest(items, currentPath) {
+    const idx = buildHrefIndex(items);
+    return getActiveItemIdFromIndex(idx, currentPath);
+}

package/dist/client/use-i18n.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+interface UseI18nReturn {
+    switchLocale: (locale: string) => void;
+    getCurrentLocale: () => string | null;
+    buildUrl: (path: string, locale?: string) => string;
+}
+export declare function useI18n(): UseI18nReturn;
+export {};

package/dist/client/use-i18n.js ADDED Viewed

@@ -0,0 +1,64 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useI18n = useI18n;
+const react_1 = require("react");
+function useI18n() {
+    (0, react_1.useEffect)(() => {
+        if (typeof window !== "undefined" &&
+            !window.__HARPY_I18N_INITIALIZED__) {
+            window.__HARPY_I18N_INITIALIZED__ = true;
+            const script = document.createElement("script");
+            script.textContent = `
+        (function() {
+          if (window.__HARPY_I18N_NAV_INSTALLED__) return;
+          window.__HARPY_I18N_NAV_INSTALLED__ = true;
+          document.addEventListener('click', function(e) {
+            var target = e.target;
+            while (target && target.tagName !== 'A') {
+              target = target.parentElement;
+            }
+            if (target && target.tagName === 'A' && target.href) {
+              var url = new URL(target.href, window.location.origin);
+              var currentLang = new URLSearchParams(window.location.search).get('lang');
+              if (currentLang && url.origin === window.location.origin && !url.searchParams.has('lang')) {
+                url.searchParams.set('lang', currentLang);
+                target.href = url.toString();
+              }
+            }
+          });
+        })();
+      `;
+            document.head.appendChild(script);
+        }
+    }, []);
+    const switchLocale = (locale) => {
+        if (typeof window === "undefined")
+            return;
+        const url = new URL(window.location.href);
+        url.searchParams.set("lang", locale);
+        window.location.href = url.toString();
+    };
+    const getCurrentLocale = () => {
+        if (typeof window === "undefined")
+            return null;
+        const url = new URL(window.location.href);
+        return url.searchParams.get("lang");
+    };
+    const buildUrl = (path, locale) => {
+        if (typeof window === "undefined")
+            return path;
+        const currentLocale = locale || getCurrentLocale();
+        if (!currentLocale)
+            return path;
+        const url = new URL(path, window.location.origin);
+        url.searchParams.set("lang", currentLocale);
+        return url.pathname + url.search;
+    };
+    return {
+        switchLocale,
+        getCurrentLocale,
+        buildUrl,
+    };
+}

package/dist/core/__tests__/component-analyzer.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};