@devslab/site-kit 0.3.0 → 0.5.0

package/README.ko.md

@@ -1,6 +1,6 @@
 # @devslab/site-kit
 
-DevsLab 제품의 공개 웹사이트를 위한 공개 인프라 패키지다. 엄격한 14개 로케일 카탈로그, 로케일 협상, SEO/GEO 문서 생성기, 접근 가능한 SolidJS 2 사이트 셸을 제공한다. 제품명·주장·내비게이션·번역 문구는 항상 소비 앱이 소유한다.
+DevsLab 제품의 공개 웹사이트를 위한 공개 인프라 패키지다. 가족 로케일에 대한 엄격한 카탈로그(제품별 확장 가능), 로케일 협상, SEO/GEO 문서 생성기, 접근 가능한 SolidJS 2 사이트 셸을 제공한다. 제품명·주장·내비게이션·번역 문구는 항상 소비 앱이 소유한다.
 
 ## 진입점
 
@@ -9,10 +9,55 @@ DevsLab 제품의 공개 웹사이트를 위한 공개 인프라 패키지다.
 - `@devslab/site-kit/tanstack-start` — 중립 메타데이터를 TanStack Start head descriptor로 변환
 - `@devslab/site-kit/styles.css` — 논리 속성과 RTL을 지원하는 공통 사이트 스타일
 
-카탈로그 생성은 의도적으로 엄격하다. 14개 로케일 모두 동일한 키와 이름 기반 placeholder를 가져야 하며 런타임 문구 폴백은 없다.
+카탈로그 생성은 의도적으로 엄격하다. 레지스트리의 모든 로케일이 동일한 키와 이름 기반 placeholder를 가져야 하며 런타임 문구 폴백은 없다.
 
-사이트맵은 14개 로케일 alternate와 `x-default`를 출력한다.
+사이트맵은 레지스트리 로케일마다 alternate 하나와 `x-default`를 출력한다.
 `buildVerifiedJsonLd`는 검토된 schema type과 claim allowlist만 허용하고 모든
 claim leaf가 검증된 사실 레지스트리를 참조하도록 강제한다. `buildRobots`의
 기존 environment-only 출력은 유지되며, 선택적 `policies`로 검색 인덱싱,
 인용 crawler, 모델 학습 crawler를 각각 제어할 수 있다.
+
+## 제품 로케일
+
+`LOCALES`는 **가족 목록**이다 — devslab.kr이 마케팅하는 14개 언어이자 모든
+제품이 기본으로 받는 바닥. 모든 제품의 목록은 아니다. 가족이 갖지 않은
+언어로 파는 제품은 레지스트리를 만든다:
+
+```js
+import { defineLocaleRegistry } from "@devslab/site-kit";
+
+export const locales = defineLocaleRegistry({
+  extra: [
+    { code: "ta", language: "Tamil", nativeName: "தமிழ்", dir: "ltr", flagCountry: "in" },
+  ],
+});
+```
+
+로케일을 다루는 헬퍼는 전부 이것을 받는다: `validateCatalogs(catalogs, "en", { registry })`,
+`buildMetadata({ …, registry })`, `buildSitemap({ …, registry })`,
+`localizedPath(path, locale, defaultLocale, registry)`,
+`<SiteHeader localeRegistry={…}>`. 안 넘기면 가족 레지스트리이므로
+`defineLocaleRegistry`를 부른 적 없는 소비자는 영향이 없다.
+
+`flagCountry`는 이 패키지가 **이미 벤더링한** 나라를 지목해야 한다
+(`FLAG_COUNTRY` 참조). 제품은 국기 아트워크를 싣지 않는다 — 라이선스가 있고,
+생성되며, 여기서 스캔된다. 그리고 국기는 나라를 가리키지 언어를 가리키지
+않으므로 인도 로케일 7개가 정당하게 `in`을 공유한다.
+
+레지스트리는 전부 넘기거나 전혀 안 넘기거나다. 레지스트리로 그린 페이지의
+메타데이터를 레지스트리 없이 만들면, 페이지는 타밀어로 렌더되면서 검색
+엔진에는 타밀어가 없다고 말한다.
+
+## 로케일 메뉴 variant
+
+`LocaleMenu`는 기본으로 네이티브 `<select>`를 렌더링한다. `variant="flag"`는
+트리거가 현재 로케일의 국기이고 행마다 국기 + 자국어 이름 링크인 `<details>`
+디스클로저를 렌더링한다 — JavaScript 없이도 동작하며, Solid는 Escape로 닫기와
+`onLocaleChange(locale, href)` 콜백을 더한다. `SiteHeader`는 `localeVariant`를
+그대로 전달한다. 국기 데이터(`FLAG_COUNTRY`, `LOCALE_FLAGS`, `flagFor`)는
+런타임 중립 `.` entry가 아니라 전용 서브패스 `@devslab/site-kit/flags`에서
+export된다 — 벤더링한 아트워크가 SVG ~110 KB라 대부분의 소비자는 국기 메뉴를
+렌더링하지 않기 때문이다. 아트워크는 flag-icons에서 벤더링했다(MIT,
+`flags/LICENSE-flag-icons.txt`). 국기는 `dds-icons` 항목이 아니라 site-kit
+데이터다 — 아이콘 세트의 계약이 단색 `currentColor` 스트로크를 요구하기
+때문이다.

package/README.md

@@ -1,6 +1,6 @@
 # @devslab/site-kit
 
-Public product-site infrastructure for DevsLab products. It provides strict 14-locale catalogs, locale negotiation, SEO/GEO document builders, and accessible SolidJS 2 site shells. Product names, claims, navigation, and translated copy always remain in the consuming application.
+Public product-site infrastructure for DevsLab products. It provides strict catalogs over the family locales (extensible per product), locale negotiation, SEO/GEO document builders, and accessible SolidJS 2 site shells. Product names, claims, navigation, and translated copy always remain in the consuming application.
 
 ## Entry points
 
@@ -9,10 +9,45 @@ Public product-site infrastructure for DevsLab products. It provides strict 14-l
 - `@devslab/site-kit/tanstack-start` — conversion of neutral metadata to TanStack Start head descriptors.
 - `@devslab/site-kit/styles.css` — logical-property, RTL-aware shared site styles.
 
-Catalog construction is intentionally strict: all 14 locales must have exactly the same keys and named placeholders. There is no runtime copy fallback.
+Catalog construction is intentionally strict: every locale in the registry must have exactly the same keys and named placeholders. There is no runtime copy fallback.
 
-Sitemaps emit 14 locale alternates plus `x-default`. `buildVerifiedJsonLd`
+Sitemaps emit one alternate per registry locale plus `x-default`. `buildVerifiedJsonLd`
 accepts only the reviewed schema-type and claim allowlists, and every claim leaf
 still references the verified-fact registry. `buildRobots` keeps its legacy
 environment-only output, while an optional `policies` object can independently
 control search indexing, citation crawlers, and model-training crawlers.
+
+## Product locales
+
+`LOCALES` is the family list — the fourteen languages devslab.kr markets in,
+and the floor every product gets. It is not every product's list. A product
+that sells in languages the family does not carry builds a registry:
+
+```js
+import { defineLocaleRegistry } from "@devslab/site-kit";
+
+export const locales = defineLocaleRegistry({
+  extra: [
+    { code: "ta", language: "Tamil", nativeName: "தமிழ்", dir: "ltr", flagCountry: "in" },
+  ],
+});
+```
+
+Every locale-aware helper takes one: `validateCatalogs(catalogs, "en", { registry })`,
+`buildMetadata({ …, registry })`, `buildSitemap({ …, registry })`,
+`localizedPath(path, locale, defaultLocale, registry)`, and
+`<SiteHeader localeRegistry={…}>`. Omit it and you get the family registry, so
+a consumer that never calls `defineLocaleRegistry` is unaffected.
+
+`flagCountry` must name a country this package already vendors — see
+`FLAG_COUNTRY` for the list. Products do not ship flag artwork: it is
+licensed, generated and scanned here, and a flag names a country, not a
+language, so seven Indian locales legitimately share `in`.
+
+Pass the registry everywhere or nowhere. A page built with the registry but
+metadata built without it renders in Tamil while telling search engines Tamil
+does not exist.
+
+## Locale menu variants
+
+`LocaleMenu` renders a native `<select>` by default. `variant="flag"` renders a `<details>` disclosure whose trigger is the current locale's flag and whose rows are flag + native-name links — it works without JavaScript; Solid adds Escape-to-close and the `onLocaleChange(locale, href)` callback. `SiteHeader` forwards `localeVariant`. Flag data (`FLAG_COUNTRY`, `LOCALE_FLAGS`, `flagFor`) is exported from `@devslab/site-kit/flags`, a dedicated subpath — not the runtime-neutral `.` entry — because the vendored artwork is ~110 KB of SVG and most consumers never render a flag menu. The artwork is vendored from flag-icons (MIT, `flags/LICENSE-flag-icons.txt`). Flags are site-kit data, not `dds-icons` entries, because the icon set's contract requires single-colour `currentColor` strokes.

package/dist/chrome.d.ts

@@ -1,12 +1,8 @@
 import { type JSX } from "solid-js";
-import { type SiteLocale } from "../core/locales.mjs";
+import { type LocaleMenuProps, type LocaleMenuVariant } from "./locale-menu";
+import type { LocaleRegistry } from "../core/locales.mjs";
 import type { LocaleState, SiteBrand, SiteLink, SiteMessages, ThemePreference } from "./types";
-export interface LocaleMenuProps {
-    state: LocaleState;
-    messages: SiteMessages;
-    onLocaleChange?: (locale: SiteLocale, href: string) => void;
-}
-export declare function LocaleMenu(props: LocaleMenuProps): JSX.Element;
+export type { LocaleMenuProps };
 export interface ThemeToggleProps {
     messages: SiteMessages;
     value?: ThemePreference;
@@ -22,6 +18,13 @@ export interface SiteHeaderProps {
     messages: SiteMessages;
     theme?: Omit<ThemeToggleProps, "messages">;
     onLocaleChange?: LocaleMenuProps["onLocaleChange"];
+    localeVariant?: LocaleMenuVariant;
+    /**
+     * The languages the picker offers. Defaults to the family's fourteen;
+     * pass the registry from `defineLocaleRegistry` if this product sells in
+     * languages the family does not carry.
+     */
+    localeRegistry?: LocaleRegistry<string>;
     actions?: JSX.Element;
 }
 export declare function SiteHeader(props: SiteHeaderProps): JSX.Element;

package/dist/chrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../src/solid/chrome.tsx"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eAqBhD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,eA0ClD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eAyBhD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eAUhD"}
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../src/solid/chrome.tsx"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/F,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,eA0ClD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eA2BhD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eAUhD"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { LocaleMenu, SiteFooter, SiteHeader, ThemeToggle, type LocaleMenuProps, type SiteFooterProps, type SiteHeaderProps, type ThemeToggleProps } from "./chrome";
+export { LocaleMenu, type LocaleMenuProps, type LocaleMenuVariant } from "./locale-menu";
+export { SiteFooter, SiteHeader, ThemeToggle, type SiteFooterProps, type SiteHeaderProps, type ThemeToggleProps } from "./chrome";
 export { ErrorLayout, LegalLayout, MarketingShell, NotFoundLayout, StatusBanner, type ErrorLayoutProps, type LegalLayoutProps, type MarketingShellProps, type NotFoundLayoutProps, type StatusBannerProps } from "./layouts";
 export { RequestAccessForm, type RequestAccessFormProps, type RequestAccessMessages } from "./request-access";
 export { OssProductMark, type OssProductMarkProps } from "./oss-product-mark";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/solid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACpK,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7N,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/solid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClI,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7N,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/locale-menu.d.ts

@@ -0,0 +1,18 @@
+import { type JSX } from "solid-js";
+import { type LocaleRegistry, type SiteLocale } from "../core/locales.mjs";
+import type { LocaleState, SiteMessages } from "./types";
+export type LocaleMenuVariant = "select" | "flag";
+export interface LocaleMenuProps {
+    state: LocaleState;
+    messages: SiteMessages;
+    variant?: LocaleMenuVariant;
+    onLocaleChange?: (locale: SiteLocale, href: string) => void;
+    /**
+     * The languages to offer. Defaults to the family's fourteen; a product
+     * that added its own passes the registry it built with
+     * `defineLocaleRegistry`.
+     */
+    registry?: LocaleRegistry<string>;
+}
+export declare function LocaleMenu(props: LocaleMenuProps): JSX.Element;
+//# sourceMappingURL=locale-menu.d.ts.map

package/dist/locale-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-menu.d.ts","sourceRoot":"","sources":["../src/solid/locale-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CACnC;AAoHD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,eAEhD"}