@naeil/ui 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -1,6 +1,29 @@
 # Changelog
 
-## 0.7.2 — retired project catalog (candidate)
+## 0.10.0 — shared language runtime (unpublished candidate)
+
+- Add opt-in `naeil-locale` root, client, server, messages, checker and chrome entries for the owned Next applications. English uses unprefixed paths; Korean/Japanese use `/ko` and `/ja`. Strict route/protocol parsing, legacy receiving aliases, selected JSON loading, ICU validation and committed-intent preference writes share one implementation.
+- Keep the transition controller above locale layouts, restore stable focus, and share document-departure protection. Consumers retain business/session state, data authorization and logical-navigation guards.
+- Move canonical header/footer/account copy to one JSON source. Existing React-only imports keep standalone locale props and public overrides; the opt-in chrome entry uses the selected provider dictionary. Generic Navigation/SiteFooter and legacy Nav/Footer routing APIs remain unchanged.
+- Validate all three Next consumers with exact next-intl4.14.8. Publication, receiver deployment, cross-service sending and hosted Docs have separate receipts; see [the integration guide](docs/components/naeil-locale.md).
+
+## 0.9.0 — page-root scrollbar reservation
+
+- Reserve one classic scrollbar gutter at the document root through both package CSS paths; overlay scrollbars reserve no space. The root `data-naeil-scrollbar-gutter="auto"` opt-out disables reservation and shared lock correction together.
+- Remove duplicate Radix body margin/gap compensation under the reserved root without changing scroll prevention, modal focus or cleanup. Preserve all frame, typography and spacing tokens.
+- Document the existing Japanese 320px classic signed-out login toolbar wrap, repair comparison capture ordering and verify real clean React/Next CSS consumers against frozen 0.8.0. See the [adopted acceptance contract](https://github.com/naeil-dev/naeil-ui/blob/434b7d07235316097ca3a55265ee02c1422b0cfd/docs/superpowers/specs/2026-10-29-page-root-scrollbar-gutter.md). Publication, tags, main/site merge and consumer deployments require separate approval.
+
+## 0.8.0 — canonical Home chrome (published 2026-10-28)
+
+Published to npm with dist-tag `next`; `latest` remained 0.7.2 at the 2026-10-29 verification. Frozen source/tag: `3f708e27d05212af7f7a5be769f13f871e8d10c7`; archive SHA-256: `6feb5a8cd50265ace584a0855432683b4127119377e08235282eaebd27081084` (139 files). Hosted Docs and service deployments require separate receipts; see the [release policy](docs/package-release.md#publication-and-deployment).
+
+- Add `appNavigation`, `brandSuffix` and `statusSlot` for complete owned-service header compositions, plus controlled/observer mobile-sheet state on NaeilHeader and Navigation.
+- Isolate canonical chrome typography from host styles and preserve mobile account/confirmation focus handoffs. Keep existing imports, slots, default catalog and consumer routing/save guards.
+- Retain chrome contract version 1 and verify the Home Workspace/LoginGate profiles against the canonical 0.7.2 baseline. See [NaeilHeader](docs/components/naeil-header.md) for API and compatibility limits.
+
+## 0.7.2 — retired project catalog (published)
+
+Published to npm; `latest=0.7.2` at the 2026-10-29 verification. Source/tag: `40a3928e24cd2f0141be3e605eed0a75260938fd`. Registry, hosted Docs and service activation remain separate receipts.
 
 - Narrow the canonical `NaeilHeader` project catalog to naeil-ui. Content Collector, PKM, Sustainability Analyzer and Baby Agent are retired from naeil.dev; their site pages move to `src/app/_archive/` and old URLs temporarily redirect to the project list. The project menu uses one column for a single entry. `projects`, `translations` and `currentProjectKey` overrides are unchanged.
 - Release class `dom`: the standing worker adopts it only through an owner-approved `reviewedMigration` of this exact release; ordinary fix-only patches are unaffected.

package/DESIGN.md

@@ -112,9 +112,13 @@ Demonstrate the system in three neutral compositions: a settings form, a selecta
 
 On 2026-10-16 the owner approved a shared maximum application frame of **1600px**, with responsive inline gutters **clamp(16px, 2.4vw, 40px)**, after inspecting Naeil Home at mobile and desktop widths. This supersedes the prior 1280px branded-header cap and fixed 24px frame gutters. The frame includes its padding, centers on wider screens and shrinks to available space. Numeric values live in `ui.width-frame` and `ui.frame-gutter`; `.ui-app-frame`, `Navigation`, `SiteFooter`, `NaeilHeader`, and the legacy adapters use those same defaults.
 
+The page root reserves scrollbar space. Shared full-page frames use `html { scrollbar-gutter: stable; }`, with one scrollbar-side gutter in classic mode and no reserved space in overlay mode. Header, main and footer use the resulting available page width. Changing page length or opening and closing a scroll-locking surface MUST NOT move those frames or their content horizontally. A consumer using a different document scroll policy MUST declare the documented root opt-out and own that policy consistently across routes.
+
+The 0.9.0 candidate implements this default once in `components.css`, through either `globals.css` or `theme.css + components.css`. Theme-only/JS-only imports do not set it. `<html data-naeil-scrollbar-gutter="auto">` opts out of both the root reservation and its Radix duplicate-compensation correction before first paint. The default profile is LTR with zero body edge spacing; custom scrollers, body margins or dependency helper classes require consumer integration/opt-out. Unsupported browsers retain existing scroll-lock compensation. See the [adopted frame contract](https://github.com/naeil-dev/naeil-ui/blob/434b7d07235316097ca3a55265ee02c1422b0cfd/docs/superpowers/specs/2026-10-29-page-root-scrollbar-gutter.md) and [consumer override guidance](docs/components/application-layout.md).
+
 The optional `@naeil/ui/naeil-header` composition centralizes the actual naeil.dev brand/catalog/control/toolbar/responsive implementation approved on 2026-10-15. Official decorative image URLs remain references; no new artwork rights or redistribution is implied. See [NaeilHeader](docs/components/naeil-header.md).
 
-Application navigation and footer must use the shared compositions: `NaeilHeader` for the canonical naeil catalog, `Navigation` for different product menus, and `SiteFooter` for both compact and full footers. Existing `Nav`/`Footer` preserve Next compatibility while using that core. Services own menu data, route guards, locale/theme providers and authentication through adapters and slots. Extend the shared API when a reusable behavior is missing instead of copying menu, responsive or footer implementations. See [the application starter and consumer-agent rules](docs/components/application-layout.md).
+Application navigation and footer must use the shared compositions: complete `NaeilHeader` with `NaeilFooter` for owned naeil services, supplying product menu data through `appNavigation`; generic `Navigation`/`SiteFooter` for a different product without canonical naeil chrome. Existing `Nav`/`Footer` preserve Next compatibility while using that core. Services own menu data, route guards, locale/theme providers and authentication through adapters and slots. Extend the shared API when a reusable behavior is missing instead of copying menu, responsive or footer implementations. See [the application starter and consumer-agent rules](docs/components/application-layout.md).
 
 The application frame owns navigation placement and outer gutters; each content region owns its purpose-specific width. A narrow settings form inside that frame must not move the shared navigation. For routes using the same frame, keep navigation anchors stable at the same viewport, language and theme, including loading and changing summary counts. A shared Header import alone does not establish this consistency.
 

package/README.md

@@ -2,7 +2,7 @@
 
 React components, semantic design tokens, and shared styles for naeil products. The approved system uses a neutral light/dark palette, Pretendard, 16px controls, comfortable or compact density, purpose-specific content widths, and restrained motion. Radix supplies interaction behavior.
 
-**0.7.1 published and registry-verified — 2026-10-23.** The current published baseline is **0.7.1**. This first published 0.7.x release combines canonical `NaeilFooter`, server-safe `/release` identity and `NaeilHeaderAccountControl`; 0.7.0 remains an unpublished candidate. The frozen package source and `v0.7.1` tag are `32108fd8e1cb1db6dae24a09f3ca72ac9a91f618`. Fresh React/Next registry consumers matched all 139 frozen files and passed types, production builds and browser checks. Maintained guides use separately reviewed source; hosted Docs and standing activation require separate receipts. See the [release policy and receipts](docs/package-release.md#publication-and-deployment).
+**Version 0.9.0 adds the shared page-root scrollbar reservation and scroll-lock correction.** Use an exact version with verified registry publication and archive identity. At the 2026-10-29 verification, the published 0.8.0 archive matched frozen SHA-256 `6feb5a8cd50265ace584a0855432683b4127119377e08235282eaebd27081084` (139 files, source `3f708e27d05212af7f7a5be769f13f871e8d10c7`); tags were `latest=0.7.2`, `next=0.8.0`. Current publication, hosted Docs and per-service deployment have separate receipts in the [release policy](docs/package-release.md#publication-and-deployment).
 
 This repository also contains the **naeil.dev brand/example website** and an **optional agent reference workflow**. Choose the path you need:
 
@@ -15,13 +15,13 @@ This repository also contains the **naeil.dev brand/example website** and an **o
 
 ## Use the UI
 
-Use React 19 / ReactDOM 19 and Tailwind 4. UI v2 names the design generation independently of npm versioning. Install the verified registry release:
+Use React 19 / ReactDOM 19 and Tailwind 4. UI v2 names the design generation independently of npm versioning. The installation example targets 0.9.0; run it after verifying that exact version's registry publication:
 
 ```sh
-pnpm add --save-exact @naeil/ui@0.7.1
+pnpm add --save-exact @naeil/ui@0.9.0
 ```
 
-The [npm 0.7.1 archive](https://registry.npmjs.org/@naeil/ui/-/ui-0.7.1.tgz) is byte-identical to the frozen release archive. Its bundled guides retain the preparation snapshot; use these maintained instructions for current installation. For local development, `pnpm build:pkg` and `npm pack --ignore-scripts --pack-destination /tmp` produce `/tmp/naeil-ui-0.7.1.tgz`. A fresh pack of maintained source differs from the frozen release archive; use the exact frozen file for release verification. The [0.6.0 release record](https://github.com/naeil-dev/naeil-ui/releases/tag/v0.6.0) retains its archive, publication and deployment evidence.
+The [npm 0.8.0 archive](https://registry.npmjs.org/@naeil/ui/-/ui-0.8.0.tgz) is byte-identical to its frozen release archive. Bundled guides record the preparation snapshot; maintained guides record later publication outcomes. For local development, `pnpm build:pkg` and `npm pack --ignore-scripts --pack-destination /tmp` produce `/tmp/naeil-ui-0.9.0.tgz` from the checked-out source. Use the exact reviewed archive for release verification; later source or guide changes require a new freeze. The [0.6.0 release record](https://github.com/naeil-dev/naeil-ui/releases/tag/v0.6.0) retains its archive, publication and deployment evidence.
 
 The preceding [0.5.0 release](https://github.com/naeil-dev/naeil-ui/releases/tag/v0.5.0) was published on 2026-10-15 and introduced the whole shared header. Version 0.6.0 adds the shared 1600px frame; existing applications must upgrade and adopt its layout composition.
 
@@ -34,11 +34,11 @@ Choose the shared application composition before building a header or footer:
 | Actual naeil.dev brand, project catalog and controls | `NaeilHeader` from `@naeil/ui/naeil-header` |
 | Owned-service login, account and logout presentation (0.7.1) | `NaeilHeaderAccountControl` from `@naeil/ui/naeil-header`, passed in `authSlot` |
 | Owned naeil service footer (0.7.1) | `NaeilFooter` from `@naeil/ui/naeil-footer` |
-| A product's own menu | `Navigation` from `@naeil/ui/ui` |
+| A different product without canonical naeil chrome | `Navigation` from `@naeil/ui/ui` |
 | Different product footer or deliberate content override | `SiteFooter` from `@naeil/ui/ui` |
 | Existing Next/next-intl integration | Preserve `Nav` / `Footer` compatibility adapters |
 
-Pair `NaeilHeader` and `NaeilFooter` in owned services. Supply application routing, guards, authentication and menu data through adapters and slots. `NaeilHeaderAccountControl` receives session state, a busy flag and the guarded logout callback; keep pending state and its request lock above the header so desktop/mobile copies share them. Keep the shared menu, mobile sheet, account presentation and footer implementation in the package. The [application layout guide](docs/components/application-layout.md) provides a starter and consumer-agent instructions. Header, main and footer share a 1600px maximum frame with `clamp(16px, 2.4vw, 40px)` gutters; use `ui-app-frame` on main and keep 640px reading/settings or 480px short-form sections inside it.
+Pair the complete `NaeilHeader` and `NaeilFooter` in owned services, including product menus via `appNavigation`. Supply application routing, guards, authentication and menu data through adapters and slots. `NaeilHeaderAccountControl` receives session state, a busy flag and the guarded logout callback; keep pending state and its request lock above the header so desktop/mobile copies share them. Keep the shared menu, mobile sheet, account presentation and footer implementation in the package. The [application layout guide](docs/components/application-layout.md) provides a starter and consumer-agent instructions. Header, main and footer share a 1600px maximum frame with `clamp(16px, 2.4vw, 40px)` gutters; use `ui-app-frame` on main and keep 640px reading/settings or 480px short-form sections inside it.
 
 Import primitives from the dedicated entrypoint:
 

package/dist/{chunk-ULZPJI5X.js → chunk-F7XM5HJ4.js}

@@ -1,8 +1,10 @@
 "use client";
 import {
   Logo,
-  uiRelease
-} from "./chunk-WA5D7UI2.js";
+  NaeilStandaloneMessages,
+  uiRelease,
+  useNaeilMessages
+} from "./chunk-GQO6NMXK.js";
 import {
   Badge,
   Button,
@@ -27,14 +29,13 @@ import {
   cn
 } from "./chunk-JBTDRVZ7.js";
 
-// src/components/naeil-header.tsx
+// src/components/naeil-header-core.tsx
 import { useSyncExternalStore } from "react";
 import { useTheme } from "next-themes";
 import { Moon, Sun } from "lucide-react";
 
-// src/components/naeil-header-content.ts
+// src/components/naeil-header-data.ts
 var headerLocales = ["en", "ko", "ja"];
-var headerLocaleNames = { en: "English", ko: "\uD55C\uAD6D\uC5B4", ja: "\u65E5\u672C\u8A9E" };
 var headerProjects = [
   {
     "key": "naeilUi",
@@ -44,150 +45,14 @@ var headerProjects = [
     "status": "active"
   }
 ];
-var headerContent = {
-  "en": {
-    "nav": {
-      "home": "Home",
-      "projects": "Projects",
-      "blog": "Blog",
-      "navigation": "Main navigation",
-      "menu": "Menu",
-      "closeMenu": "Close menu"
-    },
-    "theme": {
-      "switchToLight": "Switch to light theme",
-      "switchToDark": "Switch to dark theme"
-    },
-    "locale": {
-      "switchLabel": "Language"
-    },
-    "projects": {
-      "cc": {
-        "name": "Content Collector",
-        "description": "Automated content collection from RSS, YouTube, Reddit + AI summarization"
-      },
-      "pkm": {
-        "name": "PKM",
-        "description": "Personal knowledge management \u2014 document parsing, embeddings, semantic search"
-      },
-      "naeilUi": {
-        "name": "naeil-ui",
-        "description": "Minimal design system \u2014 OKLCH tokens, Tailwind v4, shadcn"
-      },
-      "sa": {
-        "name": "Sustainability Analyzer",
-        "description": "AI-powered ESG report analysis \u2014 PDF parsing, qualitative assessment, comparison tables"
-      },
-      "babyAgent": {
-        "name": "Baby Agent",
-        "description": "Parenting AI agent \u2014 LINE-based Q&A, records, reminders"
-      },
-      "status": {
-        "active": "Active",
-        "coming": "Coming Soon"
-      }
-    }
-  },
-  "ko": {
-    "nav": {
-      "home": "\uD648",
-      "projects": "\uD504\uB85C\uC81D\uD2B8",
-      "blog": "\uBE14\uB85C\uADF8",
-      "navigation": "\uC8FC\uC694 \uBA54\uB274",
-      "menu": "\uBA54\uB274",
-      "closeMenu": "\uBA54\uB274 \uB2EB\uAE30"
-    },
-    "theme": {
-      "switchToLight": "\uBC1D\uC740 \uD14C\uB9C8\uB85C \uC804\uD658",
-      "switchToDark": "\uC5B4\uB450\uC6B4 \uD14C\uB9C8\uB85C \uC804\uD658"
-    },
-    "locale": {
-      "switchLabel": "\uC5B8\uC5B4"
-    },
-    "projects": {
-      "cc": {
-        "name": "Content Collector",
-        "description": "RSS, YouTube, Reddit \uC790\uB3D9 \uC218\uC9D1 + AI \uC694\uC57D"
-      },
-      "pkm": {
-        "name": "PKM",
-        "description": "\uAC1C\uC778 \uC9C0\uC2DD \uAD00\uB9AC \u2014 \uBB38\uC11C \uD30C\uC2F1, \uC784\uBCA0\uB529, \uC2DC\uB9E8\uD2F1 \uAC80\uC0C9"
-      },
-      "naeilUi": {
-        "name": "naeil-ui",
-        "description": "\uBBF8\uB2C8\uBA40 \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C \u2014 OKLCH \uD1A0\uD070, Tailwind v4, shadcn"
-      },
-      "sa": {
-        "name": "Sustainability Analyzer",
-        "description": "ESG \uB9AC\uD3EC\uD2B8 AI \uBD84\uC11D \u2014 PDF \uD30C\uC2F1, \uC815\uC131\uD3C9\uAC00, \uBE44\uAD50\uD45C \uC790\uB3D9 \uC0DD\uC131"
-      },
-      "babyAgent": {
-        "name": "Baby Agent",
-        "description": "\uC721\uC544 AI \uC5D0\uC774\uC804\uD2B8 \u2014 LINE \uAE30\uBC18 Q&A, \uAE30\uB85D, \uB9AC\uB9C8\uC778\uB354"
-      },
-      "status": {
-        "active": "\uD65C\uC131",
-        "coming": "\uC900\uBE44 \uC911"
-      }
-    }
-  },
-  "ja": {
-    "nav": {
-      "home": "\u30DB\u30FC\u30E0",
-      "projects": "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8",
-      "blog": "\u30D6\u30ED\u30B0",
-      "navigation": "\u30E1\u30A4\u30F3\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3",
-      "menu": "\u30E1\u30CB\u30E5\u30FC",
-      "closeMenu": "\u30E1\u30CB\u30E5\u30FC\u3092\u9589\u3058\u308B"
-    },
-    "theme": {
-      "switchToLight": "\u30E9\u30A4\u30C8\u30C6\u30FC\u30DE\u306B\u5207\u308A\u66FF\u3048\u308B",
-      "switchToDark": "\u30C0\u30FC\u30AF\u30C6\u30FC\u30DE\u306B\u5207\u308A\u66FF\u3048\u308B"
-    },
-    "locale": {
-      "switchLabel": "\u8A00\u8A9E"
-    },
-    "projects": {
-      "cc": {
-        "name": "Content Collector",
-        "description": "RSS\u3001YouTube\u3001Reddit\u306E\u81EA\u52D5\u53CE\u96C6 + AI\u8981\u7D04"
-      },
-      "pkm": {
-        "name": "PKM",
-        "description": "\u500B\u4EBA\u30CA\u30EC\u30C3\u30B8\u7BA1\u7406 \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u89E3\u6790\u3001\u57CB\u3081\u8FBC\u307F\u3001\u30BB\u30DE\u30F3\u30C6\u30A3\u30C3\u30AF\u691C\u7D22"
-      },
-      "naeilUi": {
-        "name": "naeil-ui",
-        "description": "\u30DF\u30CB\u30DE\u30EB\u30C7\u30B6\u30A4\u30F3\u30B7\u30B9\u30C6\u30E0 \u2014 OKLCH\u30C8\u30FC\u30AF\u30F3\u3001Tailwind v4\u3001shadcn"
-      },
-      "sa": {
-        "name": "Sustainability Analyzer",
-        "description": "ESG\u30EC\u30DD\u30FC\u30C8AI\u5206\u6790 \u2014 PDF\u89E3\u6790\u3001\u5B9A\u6027\u8A55\u4FA1\u3001\u6BD4\u8F03\u8868\u306E\u81EA\u52D5\u751F\u6210"
-      },
-      "babyAgent": {
-        "name": "Baby Agent",
-        "description": "\u80B2\u5150AI\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 \u2014 LINE Q&A\u3001\u8A18\u9332\u3001\u30EA\u30DE\u30A4\u30F3\u30C0\u30FC"
-      },
-      "status": {
-        "active": "\u30A2\u30AF\u30C6\u30A3\u30D6",
-        "coming": "\u6E96\u5099\u4E2D"
-      }
-    }
-  }
-};
 
-// src/components/naeil-header-account.tsx
+// src/components/naeil-header-account-core.tsx
 import { UserRound } from "lucide-react";
 import { useContext, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-var labels = {
-  en: { menu: "Account menu", account: "Account", login: "Log in", logout: "Log out", busy: "Logging out\u2026" },
-  ko: { menu: "\uACC4\uC815 \uBA54\uB274", account: "\uACC4\uC815", login: "\uB85C\uADF8\uC778", logout: "\uB85C\uADF8\uC544\uC6C3", busy: "\uB85C\uADF8\uC544\uC6C3 \uC911\u2026" },
-  ja: { menu: "\u30A2\u30AB\u30A6\u30F3\u30C8\u30E1\u30CB\u30E5\u30FC", account: "\u30A2\u30AB\u30A6\u30F3\u30C8", login: "\u30ED\u30B0\u30A4\u30F3", logout: "\u30ED\u30B0\u30A2\u30A6\u30C8", busy: "\u30ED\u30B0\u30A2\u30A6\u30C8\u4E2D\u2026" }
-};
 var NativeLink = (props) => /* @__PURE__ */ jsx("a", __spreadValues({}, props));
 function NaeilHeaderAccountControl({ locale, account, Link = NativeLink }) {
-  const text = labels[locale];
+  const text = useNaeilMessages(locale).account;
   const handoff = useContext(NavigationSheetAction);
   const pendingAction = useRef(void 0);
   if (account.status === "signed-out") {
@@ -255,11 +120,12 @@ function NaeilHeaderAccountControl({ locale, account, Link = NativeLink }) {
   ] });
 }
 
-// src/components/naeil-header.tsx
+// src/components/naeil-header-core.tsx
 import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var subscribe = () => () => {
 };
 function NaeilHeaderThemeControl({ locale }) {
+  const copy = useNaeilMessages(locale);
   const { resolvedTheme, setTheme } = useTheme();
   const mounted = useSyncExternalStore(subscribe, () => true, () => false);
   const dark = mounted && resolvedTheme === "dark";
@@ -270,23 +136,25 @@ function NaeilHeaderThemeControl({ locale }) {
       size: "icon",
       className: "size-11 shrink-0",
       disabled: !mounted,
-      "aria-label": headerContent[locale].theme[dark ? "switchToLight" : "switchToDark"],
+      "aria-label": copy.header.theme[dark ? "switchToLight" : "switchToDark"],
       onClick: () => setTheme(dark ? "light" : "dark"),
       children: dark ? /* @__PURE__ */ jsx2(Sun, { "aria-hidden": "true" }) : /* @__PURE__ */ jsx2(Moon, { "aria-hidden": "true" })
     }
   );
 }
 function NaeilHeaderLocaleControl({ locale, onLocaleChange }) {
+  const copy = useNaeilMessages(locale);
   return /* @__PURE__ */ jsxs2(Select, { value: locale, onValueChange: (value) => onLocaleChange(value), children: [
     /* @__PURE__ */ jsx2(
       SelectTrigger,
       {
+        "data-naeil-focus-id": "locale-control",
         className: "h-11 w-auto min-w-20 border-transparent bg-transparent px-2",
-        "aria-label": headerContent[locale].locale.switchLabel,
+        "aria-label": copy.header.locale.switchLabel,
         children: /* @__PURE__ */ jsx2(SelectValue, { children: locale.toUpperCase() })
       }
     ),
-    /* @__PURE__ */ jsx2(SelectContent, { align: "end", "data-naeil-chrome": "", "data-naeil-locale-menu": "", lang: locale, children: headerLocales.map((value) => /* @__PURE__ */ jsx2(SelectItem, { value, className: "min-h-11", lang: value, children: headerLocaleNames[value] }, value)) })
+    /* @__PURE__ */ jsx2(SelectContent, { align: "end", "data-naeil-chrome": "", "data-naeil-locale-menu": "", lang: locale, children: headerLocales.map((value) => /* @__PURE__ */ jsx2(SelectItem, { value, className: "min-h-11", lang: value, children: copy.locale.names[value] }, value)) })
   ] });
 }
 var NativeLink2 = (props) => /* @__PURE__ */ jsx2("a", __spreadValues({}, props));
@@ -312,7 +180,7 @@ function NaeilHeader(_a) {
     subNav,
     currentProjectKey,
     currentProjectHref,
-    labels: labels2,
+    labels,
     Link = NativeLink2,
     currentHref,
     onNavigate,
@@ -347,7 +215,7 @@ function NaeilHeader(_a) {
     "containerClassName"
   ]);
   var _b2, _c;
-  const content = headerContent[locale];
+  const content = useNaeilMessages(locale).header;
   const projectLinks = !showProjects ? [] : projects != null ? projects : headerProjects.map((project) => {
     var _a3, _b3, _c2;
     const current = project.key === currentProjectKey;
@@ -425,7 +293,7 @@ function NaeilHeader(_a) {
         ...appNavigation != null ? appNavigation : [],
         ...(subNav != null ? subNav : []).map((item) => __spreadProps(__spreadValues({}, item), { id: item.href }))
       ],
-      labels: labels2 != null ? labels2 : { navigation: content.nav.navigation, menu: content.nav.menu, close: content.nav.closeMenu },
+      labels: labels != null ? labels : { navigation: content.nav.navigation, menu: content.nav.menu, close: content.nav.closeMenu },
       toolbar,
       mobileToolbar: toolbar,
       className: cn("naeil-header fixed top-0 w-full", className),
@@ -434,10 +302,28 @@ function NaeilHeader(_a) {
   );
 }
 
+// src/components/naeil-header-account.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+function NaeilHeaderAccountControl2(props) {
+  return /* @__PURE__ */ jsx3(NaeilStandaloneMessages, { locale: props.locale, children: /* @__PURE__ */ jsx3(NaeilHeaderAccountControl, __spreadValues({}, props)) });
+}
+
+// src/components/naeil-header.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+function NaeilHeader2(props) {
+  return /* @__PURE__ */ jsx4(NaeilStandaloneMessages, { locale: props.locale, children: /* @__PURE__ */ jsx4(NaeilHeader, __spreadValues({}, props)) });
+}
+function NaeilHeaderThemeControl2(props) {
+  return /* @__PURE__ */ jsx4(NaeilStandaloneMessages, { locale: props.locale, children: /* @__PURE__ */ jsx4(NaeilHeaderThemeControl, __spreadValues({}, props)) });
+}
+function NaeilHeaderLocaleControl2(props) {
+  return /* @__PURE__ */ jsx4(NaeilStandaloneMessages, { locale: props.locale, children: /* @__PURE__ */ jsx4(NaeilHeaderLocaleControl, __spreadValues({}, props)) });
+}
+
 export {
   headerLocales,
-  NaeilHeaderAccountControl,
-  NaeilHeaderThemeControl,
-  NaeilHeaderLocaleControl,
-  NaeilHeader
+  NaeilHeaderAccountControl2 as NaeilHeaderAccountControl,
+  NaeilHeader2 as NaeilHeader,
+  NaeilHeaderThemeControl2 as NaeilHeaderThemeControl,
+  NaeilHeaderLocaleControl2 as NaeilHeaderLocaleControl
 };

package/dist/{chunk-WA5D7UI2.js → chunk-GQO6NMXK.js}

@@ -1164,10 +1164,275 @@ function Logo(_a) {
   );
 }
 
+// src/naeil-locale/messages/en.json
+var en_default = {
+  naeil: {
+    header: {
+      nav: {
+        home: "Home",
+        projects: "Projects",
+        blog: "Blog",
+        navigation: "Main navigation",
+        menu: "Menu",
+        closeMenu: "Close menu"
+      },
+      theme: {
+        switchToLight: "Switch to light theme",
+        switchToDark: "Switch to dark theme"
+      },
+      locale: {
+        switchLabel: "Language"
+      },
+      projects: {
+        cc: {
+          name: "Content Collector",
+          description: "Automated content collection from RSS, YouTube, Reddit + AI summarization"
+        },
+        pkm: {
+          name: "PKM",
+          description: "Personal knowledge management \u2014 document parsing, embeddings, semantic search"
+        },
+        naeilUi: {
+          name: "naeil-ui",
+          description: "Minimal design system \u2014 OKLCH tokens, Tailwind v4, shadcn"
+        },
+        sa: {
+          name: "Sustainability Analyzer",
+          description: "AI-powered ESG report analysis \u2014 PDF parsing, qualitative assessment, comparison tables"
+        },
+        babyAgent: {
+          name: "Baby Agent",
+          description: "Parenting AI agent \u2014 LINE-based Q&A, records, reminders"
+        },
+        status: {
+          active: "Active",
+          coming: "Coming Soon"
+        }
+      }
+    },
+    account: {
+      menu: "Account menu",
+      account: "Account",
+      login: "Log in",
+      logout: "Log out",
+      busy: "Logging out\u2026"
+    },
+    footer: {
+      navigation: "Navigation",
+      projects: "Projects",
+      blog: "Blog",
+      social: "Social",
+      description: "Tomorrow starts here."
+    },
+    locale: {
+      names: {
+        en: "English",
+        ko: "\uD55C\uAD6D\uC5B4",
+        ja: "\u65E5\u672C\u8A9E"
+      },
+      pending: "Changing language\u2026",
+      failed: "The language could not be changed. Your work is still here.",
+      retry: "Try again",
+      errors: {
+        badRequest: "This address is not valid.",
+        notFound: "Page not found.",
+        unauthenticated: "Sign in to continue.",
+        forbidden: "You do not have access to this page.",
+        unavailable: "The service is temporarily unavailable. Please try again."
+      }
+    }
+  }
+};
+
+// src/naeil-locale/messages/ko.json
+var ko_default = {
+  naeil: {
+    header: {
+      nav: {
+        home: "\uD648",
+        projects: "\uD504\uB85C\uC81D\uD2B8",
+        blog: "\uBE14\uB85C\uADF8",
+        navigation: "\uC8FC\uC694 \uBA54\uB274",
+        menu: "\uBA54\uB274",
+        closeMenu: "\uBA54\uB274 \uB2EB\uAE30"
+      },
+      theme: {
+        switchToLight: "\uBC1D\uC740 \uD14C\uB9C8\uB85C \uC804\uD658",
+        switchToDark: "\uC5B4\uB450\uC6B4 \uD14C\uB9C8\uB85C \uC804\uD658"
+      },
+      locale: {
+        switchLabel: "\uC5B8\uC5B4"
+      },
+      projects: {
+        cc: {
+          name: "Content Collector",
+          description: "RSS, YouTube, Reddit \uC790\uB3D9 \uC218\uC9D1 + AI \uC694\uC57D"
+        },
+        pkm: {
+          name: "PKM",
+          description: "\uAC1C\uC778 \uC9C0\uC2DD \uAD00\uB9AC \u2014 \uBB38\uC11C \uD30C\uC2F1, \uC784\uBCA0\uB529, \uC2DC\uB9E8\uD2F1 \uAC80\uC0C9"
+        },
+        naeilUi: {
+          name: "naeil-ui",
+          description: "\uBBF8\uB2C8\uBA40 \uB514\uC790\uC778 \uC2DC\uC2A4\uD15C \u2014 OKLCH \uD1A0\uD070, Tailwind v4, shadcn"
+        },
+        sa: {
+          name: "Sustainability Analyzer",
+          description: "ESG \uB9AC\uD3EC\uD2B8 AI \uBD84\uC11D \u2014 PDF \uD30C\uC2F1, \uC815\uC131\uD3C9\uAC00, \uBE44\uAD50\uD45C \uC790\uB3D9 \uC0DD\uC131"
+        },
+        babyAgent: {
+          name: "Baby Agent",
+          description: "\uC721\uC544 AI \uC5D0\uC774\uC804\uD2B8 \u2014 LINE \uAE30\uBC18 Q&A, \uAE30\uB85D, \uB9AC\uB9C8\uC778\uB354"
+        },
+        status: {
+          active: "\uD65C\uC131",
+          coming: "\uC900\uBE44 \uC911"
+        }
+      }
+    },
+    account: {
+      menu: "\uACC4\uC815 \uBA54\uB274",
+      account: "\uACC4\uC815",
+      login: "\uB85C\uADF8\uC778",
+      logout: "\uB85C\uADF8\uC544\uC6C3",
+      busy: "\uB85C\uADF8\uC544\uC6C3 \uC911\u2026"
+    },
+    footer: {
+      navigation: "\uB124\uBE44\uAC8C\uC774\uC158",
+      projects: "\uD504\uB85C\uC81D\uD2B8",
+      blog: "\uBE14\uB85C\uADF8",
+      social: "\uC18C\uC15C",
+      description: "Tomorrow starts here."
+    },
+    locale: {
+      names: {
+        en: "English",
+        ko: "\uD55C\uAD6D\uC5B4",
+        ja: "\u65E5\u672C\u8A9E"
+      },
+      pending: "\uC5B8\uC5B4\uB97C \uBCC0\uACBD\uD558\uB294 \uC911\u2026",
+      failed: "\uC5B8\uC5B4\uB97C \uBCC0\uACBD\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC791\uC5C5 \uB0B4\uC6A9\uC740 \uC720\uC9C0\uB429\uB2C8\uB2E4.",
+      retry: "\uB2E4\uC2DC \uC2DC\uB3C4",
+      errors: {
+        badRequest: "\uC62C\uBC14\uB974\uC9C0 \uC54A\uC740 \uC8FC\uC18C\uC785\uB2C8\uB2E4.",
+        notFound: "\uD398\uC774\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+        unauthenticated: "\uACC4\uC18D\uD558\uB824\uBA74 \uB85C\uADF8\uC778\uD558\uC138\uC694.",
+        forbidden: "\uC774 \uD398\uC774\uC9C0\uC5D0 \uC811\uADFC\uD560 \uAD8C\uD55C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+        unavailable: "\uC77C\uC2DC\uC801\uC73C\uB85C \uC11C\uBE44\uC2A4\uB97C \uC774\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."
+      }
+    }
+  }
+};
+
+// src/naeil-locale/messages/ja.json
+var ja_default = {
+  naeil: {
+    header: {
+      nav: {
+        home: "\u30DB\u30FC\u30E0",
+        projects: "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8",
+        blog: "\u30D6\u30ED\u30B0",
+        navigation: "\u30E1\u30A4\u30F3\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3",
+        menu: "\u30E1\u30CB\u30E5\u30FC",
+        closeMenu: "\u30E1\u30CB\u30E5\u30FC\u3092\u9589\u3058\u308B"
+      },
+      theme: {
+        switchToLight: "\u30E9\u30A4\u30C8\u30C6\u30FC\u30DE\u306B\u5207\u308A\u66FF\u3048\u308B",
+        switchToDark: "\u30C0\u30FC\u30AF\u30C6\u30FC\u30DE\u306B\u5207\u308A\u66FF\u3048\u308B"
+      },
+      locale: {
+        switchLabel: "\u8A00\u8A9E"
+      },
+      projects: {
+        cc: {
+          name: "Content Collector",
+          description: "RSS\u3001YouTube\u3001Reddit\u306E\u81EA\u52D5\u53CE\u96C6 + AI\u8981\u7D04"
+        },
+        pkm: {
+          name: "PKM",
+          description: "\u500B\u4EBA\u30CA\u30EC\u30C3\u30B8\u7BA1\u7406 \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u89E3\u6790\u3001\u57CB\u3081\u8FBC\u307F\u3001\u30BB\u30DE\u30F3\u30C6\u30A3\u30C3\u30AF\u691C\u7D22"
+        },
+        naeilUi: {
+          name: "naeil-ui",
+          description: "\u30DF\u30CB\u30DE\u30EB\u30C7\u30B6\u30A4\u30F3\u30B7\u30B9\u30C6\u30E0 \u2014 OKLCH\u30C8\u30FC\u30AF\u30F3\u3001Tailwind v4\u3001shadcn"
+        },
+        sa: {
+          name: "Sustainability Analyzer",
+          description: "ESG\u30EC\u30DD\u30FC\u30C8AI\u5206\u6790 \u2014 PDF\u89E3\u6790\u3001\u5B9A\u6027\u8A55\u4FA1\u3001\u6BD4\u8F03\u8868\u306E\u81EA\u52D5\u751F\u6210"
+        },
+        babyAgent: {
+          name: "Baby Agent",
+          description: "\u80B2\u5150AI\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8 \u2014 LINE Q&A\u3001\u8A18\u9332\u3001\u30EA\u30DE\u30A4\u30F3\u30C0\u30FC"
+        },
+        status: {
+          active: "\u30A2\u30AF\u30C6\u30A3\u30D6",
+          coming: "\u6E96\u5099\u4E2D"
+        }
+      }
+    },
+    account: {
+      menu: "\u30A2\u30AB\u30A6\u30F3\u30C8\u30E1\u30CB\u30E5\u30FC",
+      account: "\u30A2\u30AB\u30A6\u30F3\u30C8",
+      login: "\u30ED\u30B0\u30A4\u30F3",
+      logout: "\u30ED\u30B0\u30A2\u30A6\u30C8",
+      busy: "\u30ED\u30B0\u30A2\u30A6\u30C8\u4E2D\u2026"
+    },
+    footer: {
+      navigation: "\u30CA\u30D3\u30B2\u30FC\u30B7\u30E7\u30F3",
+      projects: "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8",
+      blog: "\u30D6\u30ED\u30B0",
+      social: "\u30BD\u30FC\u30B7\u30E3\u30EB",
+      description: "Tomorrow starts here."
+    },
+    locale: {
+      names: {
+        en: "English",
+        ko: "\uD55C\uAD6D\uC5B4",
+        ja: "\u65E5\u672C\u8A9E"
+      },
+      pending: "\u8A00\u8A9E\u3092\u5909\u66F4\u3057\u3066\u3044\u307E\u3059\u2026",
+      failed: "\u8A00\u8A9E\u3092\u5909\u66F4\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u4F5C\u696D\u5185\u5BB9\u306F\u4FDD\u6301\u3055\u308C\u3066\u3044\u307E\u3059\u3002",
+      retry: "\u518D\u8A66\u884C",
+      errors: {
+        badRequest: "\u3053\u306E\u30A2\u30C9\u30EC\u30B9\u306F\u7121\u52B9\u3067\u3059\u3002",
+        notFound: "\u30DA\u30FC\u30B8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
+        unauthenticated: "\u7D9A\u3051\u308B\u306B\u306F\u30ED\u30B0\u30A4\u30F3\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+        forbidden: "\u3053\u306E\u30DA\u30FC\u30B8\u3078\u306E\u30A2\u30AF\u30BB\u30B9\u6A29\u9650\u304C\u3042\u308A\u307E\u305B\u3093\u3002",
+        unavailable: "\u30B5\u30FC\u30D3\u30B9\u3092\u4E00\u6642\u7684\u306B\u5229\u7528\u3067\u304D\u307E\u305B\u3093\u3002\u3082\u3046\u4E00\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002"
+      }
+    }
+  }
+};
+
+// src/components/naeil-messages-context.tsx
+import { createContext, useContext } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var NaeilMessages = createContext(null);
+function NaeilMessagesProvider({ locale, messages: messages2, children }) {
+  return /* @__PURE__ */ jsx3(NaeilMessages.Provider, { value: { locale, messages: messages2 }, children });
+}
+function useNaeilMessages(locale) {
+  const value = useContext(NaeilMessages);
+  if (!value || value.locale !== locale) throw new Error("Naeil chrome requires messages for its current locale");
+  return value.messages;
+}
+
+// src/components/naeil-standalone-messages.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+var messages = { en: en_default.naeil, ko: ko_default.naeil, ja: ja_default.naeil };
+function NaeilStandaloneMessages({ locale, children }) {
+  return /* @__PURE__ */ jsx4(NaeilMessagesProvider, { locale, messages: messages[locale], children });
+}
+
 // src/lib/ui-release.ts
-var uiRelease = { version: "0.8.0", contractVersion: "1" };
+var uiRelease = { version: "0.10.0", contractVersion: "1" };
 
 export {
   Logo,
-  uiRelease
+  uiRelease,
+  useNaeilMessages,
+  en_default,
+  ko_default,
+  ja_default,
+  NaeilStandaloneMessages
 };