@chuzi/shared 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CHUZI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @chuzi/shared
+
+Shared TypeScript types, realm configuration, and theme tokens for CHUZI apps.
+
+## Contents
+
+### Types (`@chuzi/shared/types`)
+
+TypeScript interfaces matching the CHUZI API v1 responses:
+
+- **Auth** — `LoginRequest`, `LoginResponse`
+- **Catalog** — `StoryListItem`, `CatalogResponse`, `StoryPreview`, `StoryProgress`
+- **Watch** — `SceneMapResponse`, `SceneMapEntry`, `SceneChoice`, `WatchSnapshot`
+- **Bookmarks** — `BookmarkResponse`, `BookmarkListResponse`
+- **User** — `UserProfile`, `UpdateRealmRequest`
+- **Realm** — `RealmId`, `RealmDefinition`, `RealmConfigResponse`
+
+### Config (`@chuzi/shared/config`)
+
+Realm/lexicon constants ported from the CHUZI backend `config/chuzi_realms.php`:
+
+- `REALMS` — full realm definitions with lexicons
+- `FALLBACK_LEXICON` — neutral labels when no realm is chosen
+- `t(realmId, key)` — lexicon lookup with fallback
+- `lexiconForRealm(realmId)` — merged lexicon for a realm
+
+### Themes (`@chuzi/shared/themes`)
+
+Design tokens mirroring `chuzi-realms.css` and the scene tree viewer:
+
+- `THEME_TOKENS` — CSS variable equivalents (bgDeep, accent, text, etc.)
+- `SCENE_TREE_THEMES` — d3 scene tree colors, shapes, borders
+- `getThemeTokens(realmId)` / `getSceneTreeTheme(realmId)` — lookup helpers
+
+## Usage
+
+```typescript
+import { t, lexiconForRealm, getThemeTokens } from "@chuzi/shared";
+import type { CatalogResponse, RealmId } from "@chuzi/shared";
+
+const realm: RealmId = "cosmos";
+console.log(t(realm, "story"));          // "Star System"
+console.log(getThemeTokens(realm).accent); // "#7eb8ff"
+```
+
+## Build
+
+```bash
+npm install
+npm run build      # Outputs to dist/
+npm run typecheck   # Type-check only
+```

package/dist/api/index.d.ts

@@ -0,0 +1,122 @@
+import { LoginRequest, LoginResponse, UserProfile, CatalogResponse, LocaleId, RealmConfigResponse, PaginatedResponse, StoryListItem, CreateStoryRequest, SceneMapResponse, TrackEngagementRequest, EngagementResponse, SaveBookmarkRequest, BookmarkResponse, BookmarkListResponse, UpdateRealmRequest, UpdateRealmResponse, UpdateLocaleRequest, UpdateLocaleResponse, UpdateProfileRequest, UpdateProfileResponse } from '../types/index.js';
+
+/**
+ * Token resolver returned by the host app. Called on every request; may be
+ * synchronous (in-memory) or async (SecureStore on RN-tvOS, AsyncStorage on
+ * RN). Return null when the user is unauthenticated.
+ */
+type TokenResolver = () => string | null | Promise<string | null>;
+interface ChuziClientConfig {
+    /** e.g. "https://api.dev.chuzi.app" — no trailing slash required. */
+    baseUrl: string;
+    /** Returns the current bearer token, or null if unauthenticated. */
+    getToken?: TokenResolver;
+    /** Override fetch for testing or RN polyfills. Defaults to globalThis.fetch. */
+    fetch?: typeof fetch;
+    /** Sent as User-Agent (web), or X-Client header (RN). Optional. */
+    client?: string;
+}
+declare class ChuziApiError extends Error {
+    status: number;
+    body: unknown;
+    constructor(status: number, body: unknown, message?: string);
+}
+interface ChuziClient {
+    auth: {
+        login(req: LoginRequest): Promise<LoginResponse>;
+        register(req: LoginRequest & {
+            name: string;
+        }): Promise<LoginResponse>;
+        logout(): Promise<void>;
+        forgotPassword(req: {
+            email: string;
+        }): Promise<{
+            status: string;
+        }>;
+        resetPassword(req: {
+            token: string;
+            email: string;
+            password: string;
+            password_confirmation: string;
+        }): Promise<{
+            status: string;
+        }>;
+        user(): Promise<UserProfile>;
+    };
+    catalog: {
+        index(opts?: {
+            signal?: AbortSignal;
+        }): Promise<CatalogResponse>;
+    };
+    config: {
+        realms(opts?: {
+            locale?: LocaleId;
+            signal?: AbortSignal;
+        }): Promise<RealmConfigResponse>;
+    };
+    stories: {
+        index(opts?: {
+            signal?: AbortSignal;
+        }): Promise<PaginatedResponse<StoryListItem>>;
+        show(id: string, opts?: {
+            signal?: AbortSignal;
+        }): Promise<StoryListItem>;
+        mine(opts?: {
+            signal?: AbortSignal;
+        }): Promise<PaginatedResponse<StoryListItem>>;
+        create(req: CreateStoryRequest): Promise<{
+            data: StoryListItem;
+        }>;
+    };
+    watch: {
+        sceneMap(storyId: string, opts?: {
+            signal?: AbortSignal;
+        }): Promise<SceneMapResponse>;
+        trackEngagement(storyId: string, req: TrackEngagementRequest): Promise<EngagementResponse>;
+        saveBookmark(storyId: string, req: SaveBookmarkRequest): Promise<BookmarkResponse>;
+        listBookmarks(storyId: string, opts?: {
+            signal?: AbortSignal;
+        }): Promise<BookmarkListResponse>;
+    };
+    user: {
+        profile(opts?: {
+            signal?: AbortSignal;
+        }): Promise<UserProfile>;
+        updateRealm(req: UpdateRealmRequest): Promise<UpdateRealmResponse>;
+        updateLocale(req: UpdateLocaleRequest): Promise<UpdateLocaleResponse>;
+        updateProfile(req: UpdateProfileRequest): Promise<UpdateProfileResponse>;
+    };
+    credits: {
+        balance(opts?: {
+            signal?: AbortSignal;
+        }): Promise<{
+            balance: number;
+        }>;
+        ledger(opts?: {
+            signal?: AbortSignal;
+            cursor?: string;
+            limit?: number;
+        }): Promise<{
+            data: unknown[];
+            next_cursor: string | null;
+        }>;
+        packs(opts?: {
+            signal?: AbortSignal;
+        }): Promise<{
+            data: unknown[];
+        }>;
+    };
+}
+/**
+ * Construct a typed CHUZI API client. Bearer-token auth via Authorization
+ * header (works for web/SPA and native apps). The host owns token storage
+ * and lifecycle — pass `getToken` to plug in localStorage / AsyncStorage /
+ * SecureStore as appropriate.
+ *
+ * Surfaces not yet wired: scenes, scene-actions, media, exports, admin,
+ * reports. Add them here as the migration reaches each surface; the route
+ * shapes are documented in chuzi-api/routes/api.php.
+ */
+declare function createChuziClient(config: ChuziClientConfig): ChuziClient;
+
+export { ChuziApiError, type ChuziClient, type ChuziClientConfig, type TokenResolver, createChuziClient };

package/dist/api/index.js

@@ -0,0 +1,108 @@
+// src/api/index.ts
+var ChuziApiError = class extends Error {
+  constructor(status, body, message) {
+    super(message ?? `chuzi-api ${status}`);
+    this.status = status;
+    this.body = body;
+    this.name = "ChuziApiError";
+  }
+  status;
+  body;
+};
+function buildQuery(query) {
+  if (!query) return "";
+  const params = new URLSearchParams();
+  for (const [k, v] of Object.entries(query)) {
+    if (v === void 0) continue;
+    params.set(k, String(v));
+  }
+  const s = params.toString();
+  return s ? `?${s}` : "";
+}
+function makeRequester(config) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  return async function request(method, path, opts = {}) {
+    const headers = {
+      Accept: "application/json"
+    };
+    if (config.client) headers["X-Chuzi-Client"] = config.client;
+    if (config.getToken) {
+      const token = await config.getToken();
+      if (token) headers["Authorization"] = `Bearer ${token}`;
+    }
+    if (opts.body !== void 0) headers["Content-Type"] = "application/json";
+    const res = await fetchFn(`${baseUrl}${path}${buildQuery(opts.query)}`, {
+      method,
+      headers,
+      body: opts.body !== void 0 ? JSON.stringify(opts.body) : void 0,
+      signal: opts.signal
+    });
+    if (res.status === 204) return void 0;
+    let parsed = null;
+    const text = await res.text();
+    if (text.length > 0) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      throw new ChuziApiError(res.status, parsed);
+    }
+    return parsed;
+  };
+}
+function createChuziClient(config) {
+  const request = makeRequester(config);
+  return {
+    auth: {
+      login: (req) => request("POST", "/api/v1/auth/login", { body: req }),
+      register: (req) => request("POST", "/api/v1/auth/register", { body: req }),
+      logout: () => request("POST", "/api/v1/auth/logout"),
+      forgotPassword: (req) => request("POST", "/api/v1/auth/forgot-password", { body: req }),
+      resetPassword: (req) => request("POST", "/api/v1/auth/reset-password", { body: req }),
+      user: () => request("GET", "/api/v1/auth/user")
+    },
+    catalog: {
+      index: (opts) => request("GET", "/api/v1/catalog", opts)
+    },
+    config: {
+      realms: (opts) => request("GET", "/api/v1/config/realms", {
+        signal: opts?.signal,
+        query: opts?.locale ? { locale: opts.locale } : void 0
+      })
+    },
+    stories: {
+      index: (opts) => request("GET", "/api/v1/stories", opts),
+      show: (id, opts) => request("GET", `/api/v1/stories/${encodeURIComponent(id)}`, opts),
+      mine: (opts) => request("GET", "/api/v1/stories/mine", opts),
+      create: (req) => request("POST", "/api/v1/stories", { body: req })
+    },
+    watch: {
+      sceneMap: (storyId, opts) => request("GET", `/api/v1/stories/${encodeURIComponent(storyId)}/scene-map`, opts),
+      trackEngagement: (storyId, req) => request("POST", `/api/v1/stories/${encodeURIComponent(storyId)}/engagement`, { body: req }),
+      saveBookmark: (storyId, req) => request("POST", `/api/v1/stories/${encodeURIComponent(storyId)}/bookmark`, { body: req }),
+      listBookmarks: (storyId, opts) => request("GET", `/api/v1/stories/${encodeURIComponent(storyId)}/bookmarks`, opts)
+    },
+    user: {
+      profile: (opts) => request("GET", "/api/v1/user/profile", opts),
+      updateRealm: (req) => request("PUT", "/api/v1/user/realm", { body: req }),
+      updateLocale: (req) => request("PUT", "/api/v1/user/locale", { body: req }),
+      updateProfile: (req) => request("PUT", "/api/v1/user/profile", { body: req })
+    },
+    credits: {
+      balance: (opts) => request("GET", "/api/v1/credits/balance", opts),
+      ledger: (opts) => request("GET", "/api/v1/credits/ledger", {
+        signal: opts?.signal,
+        query: { cursor: opts?.cursor, limit: opts?.limit }
+      }),
+      packs: (opts) => request("GET", "/api/v1/credits/packs", opts)
+    }
+  };
+}
+
+export { ChuziApiError, createChuziClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  BookmarkListResponse,\n  BookmarkResponse,\n  CatalogResponse,\n  CreateStoryRequest,\n  EngagementResponse,\n  LocaleId,\n  LoginRequest,\n  LoginResponse,\n  PaginatedResponse,\n  RealmConfigResponse,\n  SaveBookmarkRequest,\n  SceneMapResponse,\n  StoryListItem,\n  TrackEngagementRequest,\n  UpdateLocaleRequest,\n  UpdateLocaleResponse,\n  UpdateProfileRequest,\n  UpdateProfileResponse,\n  UpdateRealmRequest,\n  UpdateRealmResponse,\n  UserProfile,\n} from \"../types/index.js\";\n\n/**\n * Token resolver returned by the host app. Called on every request; may be\n * synchronous (in-memory) or async (SecureStore on RN-tvOS, AsyncStorage on\n * RN). Return null when the user is unauthenticated.\n */\nexport type TokenResolver = () => string | null | Promise<string | null>;\n\nexport interface ChuziClientConfig {\n  /** e.g. \"https://api.dev.chuzi.app\" — no trailing slash required. */\n  baseUrl: string;\n  /** Returns the current bearer token, or null if unauthenticated. */\n  getToken?: TokenResolver;\n  /** Override fetch for testing or RN polyfills. Defaults to globalThis.fetch. */\n  fetch?: typeof fetch;\n  /** Sent as User-Agent (web), or X-Client header (RN). Optional. */\n  client?: string;\n}\n\nexport class ChuziApiError extends Error {\n  constructor(\n    public status: number,\n    public body: unknown,\n    message?: string,\n  ) {\n    super(message ?? `chuzi-api ${status}`);\n    this.name = \"ChuziApiError\";\n  }\n}\n\ninterface RequestOptions {\n  query?: Record<string, string | number | boolean | undefined>;\n  body?: unknown;\n  signal?: AbortSignal;\n}\n\nfunction buildQuery(query: RequestOptions[\"query\"]): string {\n  if (!query) return \"\";\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v === undefined) continue;\n    params.set(k, String(v));\n  }\n  const s = params.toString();\n  return s ? `?${s}` : \"\";\n}\n\nfunction makeRequester(config: ChuziClientConfig) {\n  const fetchFn = config.fetch ?? globalThis.fetch;\n  const baseUrl = config.baseUrl.replace(/\\/+$/, \"\");\n\n  return async function request<T>(\n    method: string,\n    path: string,\n    opts: RequestOptions = {},\n  ): Promise<T> {\n    const headers: Record<string, string> = {\n      Accept: \"application/json\",\n    };\n    if (config.client) headers[\"X-Chuzi-Client\"] = config.client;\n    if (config.getToken) {\n      const token = await config.getToken();\n      if (token) headers[\"Authorization\"] = `Bearer ${token}`;\n    }\n    if (opts.body !== undefined) headers[\"Content-Type\"] = \"application/json\";\n\n    const res = await fetchFn(`${baseUrl}${path}${buildQuery(opts.query)}`, {\n      method,\n      headers,\n      body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,\n      signal: opts.signal,\n    });\n\n    if (res.status === 204) return undefined as T;\n\n    let parsed: unknown = null;\n    const text = await res.text();\n    if (text.length > 0) {\n      try {\n        parsed = JSON.parse(text);\n      } catch {\n        parsed = text;\n      }\n    }\n\n    if (!res.ok) {\n      throw new ChuziApiError(res.status, parsed);\n    }\n    return parsed as T;\n  };\n}\n\nexport interface ChuziClient {\n  auth: {\n    login(req: LoginRequest): Promise<LoginResponse>;\n    register(req: LoginRequest & { name: string }): Promise<LoginResponse>;\n    logout(): Promise<void>;\n    forgotPassword(req: { email: string }): Promise<{ status: string }>;\n    resetPassword(req: {\n      token: string;\n      email: string;\n      password: string;\n      password_confirmation: string;\n    }): Promise<{ status: string }>;\n    user(): Promise<UserProfile>;\n  };\n  catalog: {\n    index(opts?: { signal?: AbortSignal }): Promise<CatalogResponse>;\n  };\n  config: {\n    realms(opts?: { locale?: LocaleId; signal?: AbortSignal }): Promise<RealmConfigResponse>;\n  };\n  stories: {\n    index(opts?: { signal?: AbortSignal }): Promise<PaginatedResponse<StoryListItem>>;\n    show(id: string, opts?: { signal?: AbortSignal }): Promise<StoryListItem>;\n    mine(opts?: { signal?: AbortSignal }): Promise<PaginatedResponse<StoryListItem>>;\n    create(req: CreateStoryRequest): Promise<{ data: StoryListItem }>;\n  };\n  watch: {\n    sceneMap(storyId: string, opts?: { signal?: AbortSignal }): Promise<SceneMapResponse>;\n    trackEngagement(storyId: string, req: TrackEngagementRequest): Promise<EngagementResponse>;\n    saveBookmark(storyId: string, req: SaveBookmarkRequest): Promise<BookmarkResponse>;\n    listBookmarks(storyId: string, opts?: { signal?: AbortSignal }): Promise<BookmarkListResponse>;\n  };\n  user: {\n    profile(opts?: { signal?: AbortSignal }): Promise<UserProfile>;\n    updateRealm(req: UpdateRealmRequest): Promise<UpdateRealmResponse>;\n    updateLocale(req: UpdateLocaleRequest): Promise<UpdateLocaleResponse>;\n    updateProfile(req: UpdateProfileRequest): Promise<UpdateProfileResponse>;\n  };\n  credits: {\n    balance(opts?: { signal?: AbortSignal }): Promise<{ balance: number }>;\n    ledger(opts?: {\n      signal?: AbortSignal;\n      cursor?: string;\n      limit?: number;\n    }): Promise<{ data: unknown[]; next_cursor: string | null }>;\n    packs(opts?: { signal?: AbortSignal }): Promise<{ data: unknown[] }>;\n  };\n}\n\n/**\n * Construct a typed CHUZI API client. Bearer-token auth via Authorization\n * header (works for web/SPA and native apps). The host owns token storage\n * and lifecycle — pass `getToken` to plug in localStorage / AsyncStorage /\n * SecureStore as appropriate.\n *\n * Surfaces not yet wired: scenes, scene-actions, media, exports, admin,\n * reports. Add them here as the migration reaches each surface; the route\n * shapes are documented in chuzi-api/routes/api.php.\n */\nexport function createChuziClient(config: ChuziClientConfig): ChuziClient {\n  const request = makeRequester(config);\n\n  return {\n    auth: {\n      login: (req) => request(\"POST\", \"/api/v1/auth/login\", { body: req }),\n      register: (req) => request(\"POST\", \"/api/v1/auth/register\", { body: req }),\n      logout: () => request(\"POST\", \"/api/v1/auth/logout\"),\n      forgotPassword: (req) => request(\"POST\", \"/api/v1/auth/forgot-password\", { body: req }),\n      resetPassword: (req) => request(\"POST\", \"/api/v1/auth/reset-password\", { body: req }),\n      user: () => request(\"GET\", \"/api/v1/auth/user\"),\n    },\n    catalog: {\n      index: (opts) => request(\"GET\", \"/api/v1/catalog\", opts),\n    },\n    config: {\n      realms: (opts) =>\n        request(\"GET\", \"/api/v1/config/realms\", {\n          signal: opts?.signal,\n          query: opts?.locale ? { locale: opts.locale } : undefined,\n        }),\n    },\n    stories: {\n      index: (opts) => request(\"GET\", \"/api/v1/stories\", opts),\n      show: (id, opts) => request(\"GET\", `/api/v1/stories/${encodeURIComponent(id)}`, opts),\n      mine: (opts) => request(\"GET\", \"/api/v1/stories/mine\", opts),\n      create: (req) => request(\"POST\", \"/api/v1/stories\", { body: req }),\n    },\n    watch: {\n      sceneMap: (storyId, opts) =>\n        request(\"GET\", `/api/v1/stories/${encodeURIComponent(storyId)}/scene-map`, opts),\n      trackEngagement: (storyId, req) =>\n        request(\"POST\", `/api/v1/stories/${encodeURIComponent(storyId)}/engagement`, { body: req }),\n      saveBookmark: (storyId, req) =>\n        request(\"POST\", `/api/v1/stories/${encodeURIComponent(storyId)}/bookmark`, { body: req }),\n      listBookmarks: (storyId, opts) =>\n        request(\"GET\", `/api/v1/stories/${encodeURIComponent(storyId)}/bookmarks`, opts),\n    },\n    user: {\n      profile: (opts) => request(\"GET\", \"/api/v1/user/profile\", opts),\n      updateRealm: (req) => request(\"PUT\", \"/api/v1/user/realm\", { body: req }),\n      updateLocale: (req) => request(\"PUT\", \"/api/v1/user/locale\", { body: req }),\n      updateProfile: (req) => request(\"PUT\", \"/api/v1/user/profile\", { body: req }),\n    },\n    credits: {\n      balance: (opts) => request(\"GET\", \"/api/v1/credits/balance\", opts),\n      ledger: (opts) =>\n        request(\"GET\", \"/api/v1/credits/ledger\", {\n          signal: opts?.signal,\n          query: { cursor: opts?.cursor, limit: opts?.limit },\n        }),\n      packs: (opts) => request(\"GET\", \"/api/v1/credits/packs\", opts),\n    },\n  };\n}\n"]}

package/dist/config/index.d.ts

@@ -0,0 +1,39 @@
+import { ContentRating, ContentRatingDefinition, LocaleId, RealmId, RealmDefinition } from '../types/index.js';
+
+declare const REALM_IDS: readonly RealmId[];
+declare const SUPPORTED_LOCALES: readonly LocaleId[];
+declare const LOCALE_LABELS: Record<LocaleId, string>;
+declare const DEFAULT_LOCALE: LocaleId;
+declare function isSupportedLocale(value: unknown): value is LocaleId;
+/**
+ * Normalize a raw locale tag (e.g. "en-US", "pt_BR") to a supported LocaleId,
+ * matching the PHP `LocaleResolver::normalize` behavior.
+ */
+declare function normalizeLocale(value: string | null | undefined): LocaleId | null;
+/**
+ * Pick the best supported locale from a browser Accept-Language string.
+ * Mirrors PHP `LocaleResolver::matchAcceptLanguage` (q-value aware).
+ */
+declare function matchAcceptLanguage(accept: string | null | undefined): LocaleId | null;
+declare const CONTENT_RATING_IDS: readonly ContentRating[];
+declare const CONTENT_RATINGS: Record<ContentRating, ContentRatingDefinition>;
+declare function isContentRating(value: unknown): value is ContentRating;
+declare const REALMS: Record<RealmId, RealmDefinition>;
+declare const FALLBACK_LEXICON: Record<string, string>;
+/**
+ * Per-locale overrides for FALLBACK_LEXICON. Missing keys fall through to
+ * the English fallback. Mirrors PHP `chuzi_realms.fallback_locales`.
+ */
+declare const FALLBACK_LOCALES: Partial<Record<LocaleId, Record<string, string>>>;
+/**
+ * Get a lexicon value for a realm + locale, falling back to the neutral
+ * lexicon (which itself respects locale).
+ */
+declare function t(realmId: RealmId | null | undefined, key: string, fallback?: string, locale?: LocaleId | null | undefined): string;
+/**
+ * Get the full merged lexicon for a realm + locale (realm lexicon on top of
+ * locale-aware fallback).
+ */
+declare function lexiconForRealm(realmId: RealmId | null | undefined, locale?: LocaleId | null | undefined): Record<string, string>;
+
+export { CONTENT_RATINGS, CONTENT_RATING_IDS, DEFAULT_LOCALE, FALLBACK_LEXICON, FALLBACK_LOCALES, LOCALE_LABELS, REALMS, REALM_IDS, SUPPORTED_LOCALES, isContentRating, isSupportedLocale, lexiconForRealm, matchAcceptLanguage, normalizeLocale, t };