@lattice-php/lattice 0.1.0 → 0.3.0

package/dist/i18n/backend.js

@@ -0,0 +1,54 @@
+import { localeHeader } from "./locale.js";
+import { setConfig } from "./config.js";
+import { ensureI18n, i18n, preloadLanguages } from "./instance.js";
+import HttpBackend from "i18next-http-backend";
+//#region resources/js/i18n/backend.ts
+/** laravel-i18next's namespaced routes; an app behind a custom prefix overrides them via {@link BackendOptions}. */
+var DEFAULT_LOAD_PATH = "/locales/{{lng}}/{{ns}}.json";
+var DEFAULT_ADD_PATH = "/locales/add/{{lng}}/{{ns}}";
+/** Apply the i18n config shared from the backend; wires the HTTP backend only when `enabled`. */
+async function configureI18n(config, options = {}) {
+	setConfig(config);
+	if (!config?.enabled) {
+		await ensureI18n((base) => ({
+			...base,
+			ns: options.namespaces ?? base.ns
+		}));
+		return;
+	}
+	await enableBackend({
+		saveMissing: config.saveMissing,
+		namespaces: options.namespaces
+	});
+	preloadLanguages(config.preloadLocales);
+}
+/**
+* Load translations from a backend such as bambamboole/laravel-i18next,
+* overriding the renderer's inline English defaults. Call before the first
+* render. Importing this module is the opt-in: apps that never call it don't
+* bundle the HTTP backend.
+*/
+async function enableBackend(options = {}) {
+	const { namespaces, loadPath = DEFAULT_LOAD_PATH, addPath = DEFAULT_ADD_PATH, saveMissing = false, customHeaders } = options;
+	const customHeadersWithLocale = () => ({
+		...localeHeader(),
+		...customHeaders?.()
+	});
+	i18n.use(HttpBackend);
+	await ensureI18n((base) => ({
+		...base,
+		ns: namespaces ?? base.ns,
+		partialBundledLanguages: true,
+		saveMissing,
+		backend: {
+			loadPath,
+			addPath,
+			customHeaders: customHeadersWithLocale,
+			withCredentials: true
+		}
+	}));
+}
+//#endregion
+export { configureI18n, enableBackend };
+
+//# sourceMappingURL=backend.js.map

package/dist/i18n/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","names":[],"sources":["../../resources/js/i18n/backend.ts"],"sourcesContent":["import type { I18nConfig } from \"@lattice-php/lattice/types/generated\";\nimport HttpBackend from \"i18next-http-backend\";\nimport { setConfig } from \"./config\";\nimport { ensureI18n, i18n, preloadLanguages } from \"./instance\";\nimport { localeHeader } from \"./locale\";\n\n/** The i18n settings the backend shares to the frontend (Inertia `lattice.i18n`). */\nexport type { I18nConfig };\n\n/** laravel-i18next's namespaced routes; an app behind a custom prefix overrides them via {@link BackendOptions}. */\nconst DEFAULT_LOAD_PATH = \"/locales/{{lng}}/{{ns}}.json\";\nconst DEFAULT_ADD_PATH = \"/locales/add/{{lng}}/{{ns}}\";\n\nexport type BackendOptions = {\n  namespaces?: string[];\n  /** i18next-http-backend load path. Defaults to laravel-i18next's namespaced route. */\n  loadPath?: string;\n  /** Path that receives keys reported by saveMissing. */\n  addPath?: string;\n  /** Report missing keys back to the backend (laravel-i18next persists them). */\n  saveMissing?: boolean;\n  /** Extra request headers, e.g. the CSRF token for the saveMissing POST. */\n  customHeaders?: () => Record<string, string>;\n};\n\nexport type ConfigureI18nOptions = {\n  namespaces?: string[];\n};\n/** Apply the i18n config shared from the backend; wires the HTTP backend only when `enabled`. */\nexport async function configureI18n(\n  config: I18nConfig | undefined,\n  options: ConfigureI18nOptions = {},\n): Promise<void> {\n  setConfig(config);\n\n  if (!config?.enabled) {\n    await ensureI18n((base) => ({\n      ...base,\n      ns: options.namespaces ?? base.ns,\n    }));\n\n    return;\n  }\n\n  await enableBackend({ saveMissing: config.saveMissing, namespaces: options.namespaces });\n\n  // Fire-and-forget so warming the other locales never delays the active one.\n  void preloadLanguages(config.preloadLocales);\n}\n\n/**\n * Load translations from a backend such as bambamboole/laravel-i18next,\n * overriding the renderer's inline English defaults. Call before the first\n * render. Importing this module is the opt-in: apps that never call it don't\n * bundle the HTTP backend.\n */\nexport async function enableBackend(options: BackendOptions = {}): Promise<void> {\n  const {\n    namespaces,\n    loadPath = DEFAULT_LOAD_PATH,\n    addPath = DEFAULT_ADD_PATH,\n    saveMissing = false,\n    customHeaders,\n  } = options;\n\n  const customHeadersWithLocale = (): Record<string, string> => ({\n    ...localeHeader(),\n    ...customHeaders?.(),\n  });\n\n  i18n.use(HttpBackend);\n\n  await ensureI18n((base) => ({\n    ...base,\n    ns: namespaces ?? base.ns,\n    partialBundledLanguages: true,\n    saveMissing,\n    backend: { loadPath, addPath, customHeaders: customHeadersWithLocale, withCredentials: true },\n  }));\n}\n"],"mappings":";;;;;;AAUA,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;;AAkBzB,eAAsB,cACpB,QACA,UAAgC,CAAC,GAClB;CACf,UAAU,MAAM;CAEhB,IAAI,CAAC,QAAQ,SAAS;EACpB,MAAM,YAAY,UAAU;GAC1B,GAAG;GACH,IAAI,QAAQ,cAAc,KAAK;EACjC,EAAE;EAEF;CACF;CAEA,MAAM,cAAc;EAAE,aAAa,OAAO;EAAa,YAAY,QAAQ;CAAW,CAAC;CAGvF,iBAAsB,OAAO,cAAc;AAC7C;;;;;;;AAQA,eAAsB,cAAc,UAA0B,CAAC,GAAkB;CAC/E,MAAM,EACJ,YACA,WAAW,mBACX,UAAU,kBACV,cAAc,OACd,kBACE;CAEJ,MAAM,iCAAyD;EAC7D,GAAG,aAAa;EAChB,GAAG,gBAAgB;CACrB;CAEA,KAAK,IAAI,WAAW;CAEpB,MAAM,YAAY,UAAU;EAC1B,GAAG;EACH,IAAI,cAAc,KAAK;EACvB,yBAAyB;EACzB;EACA,SAAS;GAAE;GAAU;GAAS,eAAe;GAAyB,iBAAiB;EAAK;CAC9F,EAAE;AACJ"}

package/dist/i18n/config.d.ts

@@ -0,0 +1,6 @@
+import { I18nConfig } from '../types/generated';
+export type Config = {
+    readonly locales: readonly string[];
+};
+export declare function setConfig(config: I18nConfig | undefined): void;
+export declare function useConfig(): Config;

package/dist/i18n/config.js

@@ -0,0 +1,36 @@
+import { useSyncExternalStore } from "react";
+//#region resources/js/i18n/config.ts
+var fallback = { locales: [] };
+var listeners = /* @__PURE__ */ new Set();
+var active = fallback;
+function normalizeLocales(locales) {
+	return Array.from(new Set((locales ?? []).map((locale) => locale.trim()).filter(Boolean)));
+}
+function sameLocales(left, right) {
+	return left.length === right.length && left.every((locale, index) => locale === right[index]);
+}
+function snapshot() {
+	return active;
+}
+function subscribe(callback) {
+	listeners.add(callback);
+	return () => {
+		listeners.delete(callback);
+	};
+}
+function notify() {
+	listeners.forEach((listener) => listener());
+}
+function setConfig(config) {
+	const locales = normalizeLocales(config?.locales);
+	if (sameLocales(active.locales, locales)) return;
+	active = { locales };
+	notify();
+}
+function useConfig() {
+	return useSyncExternalStore(subscribe, snapshot, () => fallback);
+}
+//#endregion
+export { setConfig, useConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/i18n/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../resources/js/i18n/config.ts"],"sourcesContent":["import type { I18nConfig } from \"@lattice-php/lattice/types/generated\";\nimport { useSyncExternalStore } from \"react\";\n\nexport type Config = {\n  readonly locales: readonly string[];\n};\n\nconst fallback: Config = { locales: [] };\nconst listeners = new Set<() => void>();\n\nlet active: Config = fallback;\n\nfunction normalizeLocales(locales: readonly string[] | undefined): string[] {\n  return Array.from(new Set((locales ?? []).map((locale) => locale.trim()).filter(Boolean)));\n}\n\nfunction sameLocales(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((locale, index) => locale === right[index]);\n}\n\nfunction snapshot(): Config {\n  return active;\n}\n\nfunction subscribe(callback: () => void): () => void {\n  listeners.add(callback);\n\n  return () => {\n    listeners.delete(callback);\n  };\n}\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nexport function setConfig(config: I18nConfig | undefined): void {\n  const locales = normalizeLocales(config?.locales);\n\n  if (sameLocales(active.locales, locales)) {\n    return;\n  }\n\n  active = { locales };\n  notify();\n}\n\nexport function useConfig(): Config {\n  return useSyncExternalStore(subscribe, snapshot, () => fallback);\n}\n"],"mappings":";;AAOA,IAAM,WAAmB,EAAE,SAAS,CAAC,EAAE;AACvC,IAAM,4BAAY,IAAI,IAAgB;AAEtC,IAAI,SAAiB;AAErB,SAAS,iBAAiB,SAAkD;CAC1E,OAAO,MAAM,KAAK,IAAI,KAAK,WAAW,CAAC,GAAG,KAAK,WAAW,OAAO,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;AAC3F;AAEA,SAAS,YAAY,MAAyB,OAAmC;CAC/E,OAAO,KAAK,WAAW,MAAM,UAAU,KAAK,OAAO,QAAQ,UAAU,WAAW,MAAM,MAAM;AAC9F;AAEA,SAAS,WAAmB;CAC1B,OAAO;AACT;AAEA,SAAS,UAAU,UAAkC;CACnD,UAAU,IAAI,QAAQ;CAEtB,aAAa;EACX,UAAU,OAAO,QAAQ;CAC3B;AACF;AAEA,SAAS,SAAe;CACtB,UAAU,SAAS,aAAa,SAAS,CAAC;AAC5C;AAEA,SAAgB,UAAU,QAAsC;CAC9D,MAAM,UAAU,iBAAiB,QAAQ,OAAO;CAEhD,IAAI,YAAY,OAAO,SAAS,OAAO,GACrC;CAGF,SAAS,EAAE,QAAQ;CACnB,OAAO;AACT;AAEA,SAAgB,YAAoB;CAClC,OAAO,qBAAqB,WAAW,gBAAgB,QAAQ;AACjE"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,9 @@
+export { i18n, useT, translate } from './instance';
+export { configureI18n, enableBackend } from './backend';
+export { currentLocale, localeHeader, setLocale, useLocale } from './locale';
+export { LocaleReload } from './locale-reload';
+export { LocaleSwitcher, useLocaleOptions } from './locale-switcher';
+export { configureI18nFromPageProps, i18nConfigFromPageProps } from './page-props';
+export type { BackendOptions, ConfigureI18nOptions, I18nConfig } from './backend';
+export type { LocaleOption, LocaleSwitcherProps, UseLocaleOptionsOptions, UseLocaleOptionsReturn, } from './locale-switcher';
+export type { UseLocaleReturn } from './locale';

package/dist/i18n/index.js

@@ -0,0 +1,7 @@
+import { currentLocale, localeHeader, setLocale, useLocale } from "./locale.js";
+import { i18n, translate, useT } from "./instance.js";
+import { configureI18n, enableBackend } from "./backend.js";
+import { LocaleReload } from "./locale-reload.js";
+import { LocaleSwitcher, useLocaleOptions } from "./locale-switcher.js";
+import { configureI18nFromPageProps, i18nConfigFromPageProps } from "./page-props.js";
+export { LocaleReload, LocaleSwitcher, configureI18n, configureI18nFromPageProps, currentLocale, enableBackend, i18n, i18nConfigFromPageProps, localeHeader, setLocale, translate, useLocale, useLocaleOptions, useT };

package/dist/i18n/instance.d.ts

@@ -0,0 +1,27 @@
+import { i18n as I18nInstance, InitOptions } from 'i18next';
+type TranslationFunction = (key: string, defaultValue?: string, options?: Record<string, unknown>) => string;
+export type TranslationResult = {
+    t: TranslationFunction;
+    i18n: I18nInstance;
+    locale: string;
+    locales: readonly string[];
+    ready: boolean;
+    setLocale: (locale: string) => void;
+};
+export declare const i18n: I18nInstance;
+/**
+ * Initialize the instance exactly once. The first caller wins — a rendered
+ * component (inline English, zero config) or `enableBackend()`, which registers
+ * its backend first because i18next can only wire a backend during `init`.
+ */
+export declare function ensureI18n(extend?: (base: InitOptions) => InitOptions): Promise<unknown>;
+/**
+ * Eagerly load the namespaces for the given locales so a later
+ * `changeLanguage` resolves them from the store instead of an HTTP round-trip,
+ * which would otherwise flash the fallback language on switch. The active
+ * locale is already loaded by {@link ensureI18n}, so it is skipped.
+ */
+export declare function preloadLanguages(locales: readonly string[]): Promise<void>;
+export declare function useT(namespace: string): TranslationResult;
+export declare function translate(namespace: string, key: string, defaultValue: string, options?: Record<string, unknown>): string;
+export {};

package/dist/i18n/instance.js

@@ -0,0 +1,95 @@
+import { currentLocale, subscribeLocale, useLocale } from "./locale.js";
+import { useConfig } from "./config.js";
+import { useCallback, useSyncExternalStore } from "react";
+import i18next from "i18next";
+//#region resources/js/i18n/instance.ts
+var NAMESPACE = "lattice";
+var i18n = i18next.createInstance();
+var initialization;
+var revision = 0;
+function subscribe(onStoreChange) {
+	const listener = () => {
+		revision += 1;
+		onStoreChange();
+	};
+	i18n.on("initialized", listener);
+	i18n.on("loaded", listener);
+	i18n.on("languageChanged", listener);
+	i18n.store?.on("added", listener);
+	i18n.store?.on("removed", listener);
+	return () => {
+		i18n.off("initialized", listener);
+		i18n.off("loaded", listener);
+		i18n.off("languageChanged", listener);
+		i18n.store?.off("added", listener);
+		i18n.store?.off("removed", listener);
+	};
+}
+function snapshot() {
+	return revision;
+}
+/**
+* Initialize the instance exactly once. The first caller wins — a rendered
+* component (inline English, zero config) or `enableBackend()`, which registers
+* its backend first because i18next can only wire a backend during `init`.
+*/
+function ensureI18n(extend) {
+	if (!initialization) {
+		const base = {
+			lng: currentLocale(),
+			fallbackLng: "en",
+			ns: [NAMESPACE],
+			defaultNS: NAMESPACE,
+			interpolation: { escapeValue: false }
+		};
+		initialization = i18n.init(extend ? extend(base) : base);
+	}
+	return initialization;
+}
+subscribeLocale((locale) => {
+	ensureI18n().then(() => {
+		if (i18n.language !== locale) i18n.changeLanguage(locale);
+	});
+});
+/**
+* Eagerly load the namespaces for the given locales so a later
+* `changeLanguage` resolves them from the store instead of an HTTP round-trip,
+* which would otherwise flash the fallback language on switch. The active
+* locale is already loaded by {@link ensureI18n}, so it is skipped.
+*/
+async function preloadLanguages(locales) {
+	const pending = locales.filter((locale) => locale !== currentLocale());
+	if (pending.length === 0) return;
+	await ensureI18n();
+	await i18n.loadLanguages([...pending]);
+}
+function useT(namespace) {
+	ensureI18n();
+	useSyncExternalStore(subscribe, snapshot, snapshot);
+	const { locales } = useConfig();
+	const { locale, setLocale } = useLocale();
+	return {
+		t: useCallback((key, defaultValue = key, options = {}) => translate(namespace, key, defaultValue, options), [namespace]),
+		i18n,
+		locale,
+		locales,
+		ready: i18n.isInitialized,
+		setLocale
+	};
+}
+function translate(namespace, key, defaultValue, options) {
+	ensureI18n();
+	if (!i18n.isInitialized || !i18n.hasLoadedNamespace(namespace)) return i18n.t(key, defaultValue, {
+		ns: namespace,
+		...options,
+		saveMissing: false
+	});
+	return i18n.t(key, defaultValue, {
+		ns: namespace,
+		...options
+	});
+}
+//#endregion
+export { ensureI18n, i18n, preloadLanguages, translate, useT };
+
+//# sourceMappingURL=instance.js.map

package/dist/i18n/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","names":[],"sources":["../../resources/js/i18n/instance.ts"],"sourcesContent":["import i18next, { type i18n as I18nInstance, type InitOptions } from \"i18next\";\nimport { useCallback, useSyncExternalStore } from \"react\";\nimport { useConfig } from \"./config\";\nimport { currentLocale, subscribeLocale, useLocale } from \"./locale\";\n\nconst NAMESPACE = \"lattice\";\n\ntype TranslationFunction = (\n  key: string,\n  defaultValue?: string,\n  options?: Record<string, unknown>,\n) => string;\n\nexport type TranslationResult = {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n  locale: string;\n  locales: readonly string[];\n  ready: boolean;\n  setLocale: (locale: string) => void;\n};\n\nexport const i18n: I18nInstance = i18next.createInstance();\n\nlet initialization: Promise<unknown> | undefined;\nlet revision = 0;\n\nfunction subscribe(onStoreChange: () => void): () => void {\n  const listener = () => {\n    revision += 1;\n    onStoreChange();\n  };\n\n  i18n.on(\"initialized\", listener);\n  i18n.on(\"loaded\", listener);\n  i18n.on(\"languageChanged\", listener);\n  i18n.store?.on(\"added\", listener);\n  i18n.store?.on(\"removed\", listener);\n\n  return () => {\n    i18n.off(\"initialized\", listener);\n    i18n.off(\"loaded\", listener);\n    i18n.off(\"languageChanged\", listener);\n    i18n.store?.off(\"added\", listener);\n    i18n.store?.off(\"removed\", listener);\n  };\n}\n\nfunction snapshot(): number {\n  return revision;\n}\n\n/**\n * Initialize the instance exactly once. The first caller wins — a rendered\n * component (inline English, zero config) or `enableBackend()`, which registers\n * its backend first because i18next can only wire a backend during `init`.\n */\nexport function ensureI18n(extend?: (base: InitOptions) => InitOptions): Promise<unknown> {\n  if (!initialization) {\n    const base: InitOptions = {\n      lng: currentLocale(),\n      fallbackLng: \"en\",\n      ns: [NAMESPACE],\n      defaultNS: NAMESPACE,\n      interpolation: { escapeValue: false },\n    };\n\n    initialization = i18n.init(extend ? extend(base) : base);\n  }\n\n  return initialization;\n}\n\nsubscribeLocale((locale) => {\n  void ensureI18n().then(() => {\n    if (i18n.language !== locale) {\n      void i18n.changeLanguage(locale);\n    }\n  });\n});\n\n/**\n * Eagerly load the namespaces for the given locales so a later\n * `changeLanguage` resolves them from the store instead of an HTTP round-trip,\n * which would otherwise flash the fallback language on switch. The active\n * locale is already loaded by {@link ensureI18n}, so it is skipped.\n */\nexport async function preloadLanguages(locales: readonly string[]): Promise<void> {\n  const pending = locales.filter((locale) => locale !== currentLocale());\n\n  if (pending.length === 0) {\n    return;\n  }\n\n  await ensureI18n();\n  await i18n.loadLanguages([...pending]);\n}\n\nexport function useT(namespace: string): TranslationResult {\n  ensureI18n();\n  useSyncExternalStore(subscribe, snapshot, snapshot);\n  const { locales } = useConfig();\n  const { locale, setLocale } = useLocale();\n\n  const t = useCallback<TranslationFunction>(\n    (key, defaultValue = key, options = {}) => translate(namespace, key, defaultValue, options),\n    [namespace],\n  );\n\n  return { t, i18n, locale, locales, ready: i18n.isInitialized, setLocale };\n}\n\nexport function translate(\n  namespace: string,\n  key: string,\n  defaultValue: string,\n  options?: Record<string, unknown>,\n): string {\n  ensureI18n();\n\n  if (!i18n.isInitialized || !i18n.hasLoadedNamespace(namespace)) {\n    return i18n.t(key, defaultValue, { ns: namespace, ...options, saveMissing: false });\n  }\n\n  return i18n.t(key, defaultValue, { ns: namespace, ...options });\n}\n"],"mappings":";;;;;AAKA,IAAM,YAAY;AAiBlB,IAAa,OAAqB,QAAQ,eAAe;AAEzD,IAAI;AACJ,IAAI,WAAW;AAEf,SAAS,UAAU,eAAuC;CACxD,MAAM,iBAAiB;EACrB,YAAY;EACZ,cAAc;CAChB;CAEA,KAAK,GAAG,eAAe,QAAQ;CAC/B,KAAK,GAAG,UAAU,QAAQ;CAC1B,KAAK,GAAG,mBAAmB,QAAQ;CACnC,KAAK,OAAO,GAAG,SAAS,QAAQ;CAChC,KAAK,OAAO,GAAG,WAAW,QAAQ;CAElC,aAAa;EACX,KAAK,IAAI,eAAe,QAAQ;EAChC,KAAK,IAAI,UAAU,QAAQ;EAC3B,KAAK,IAAI,mBAAmB,QAAQ;EACpC,KAAK,OAAO,IAAI,SAAS,QAAQ;EACjC,KAAK,OAAO,IAAI,WAAW,QAAQ;CACrC;AACF;AAEA,SAAS,WAAmB;CAC1B,OAAO;AACT;;;;;;AAOA,SAAgB,WAAW,QAA+D;CACxF,IAAI,CAAC,gBAAgB;EACnB,MAAM,OAAoB;GACxB,KAAK,cAAc;GACnB,aAAa;GACb,IAAI,CAAC,SAAS;GACd,WAAW;GACX,eAAe,EAAE,aAAa,MAAM;EACtC;EAEA,iBAAiB,KAAK,KAAK,SAAS,OAAO,IAAI,IAAI,IAAI;CACzD;CAEA,OAAO;AACT;AAEA,iBAAiB,WAAW;CAC1B,WAAgB,EAAE,WAAW;EAC3B,IAAI,KAAK,aAAa,QACpB,KAAU,eAAe,MAAM;CAEnC,CAAC;AACH,CAAC;;;;;;;AAQD,eAAsB,iBAAiB,SAA2C;CAChF,MAAM,UAAU,QAAQ,QAAQ,WAAW,WAAW,cAAc,CAAC;CAErE,IAAI,QAAQ,WAAW,GACrB;CAGF,MAAM,WAAW;CACjB,MAAM,KAAK,cAAc,CAAC,GAAG,OAAO,CAAC;AACvC;AAEA,SAAgB,KAAK,WAAsC;CACzD,WAAW;CACX,qBAAqB,WAAW,UAAU,QAAQ;CAClD,MAAM,EAAE,YAAY,UAAU;CAC9B,MAAM,EAAE,QAAQ,cAAc,UAAU;CAOxC,OAAO;EAAE,GALC,aACP,KAAK,eAAe,KAAK,UAAU,CAAC,MAAM,UAAU,WAAW,KAAK,cAAc,OAAO,GAC1F,CAAC,SAAS,CAGH;EAAG;EAAM;EAAQ;EAAS,OAAO,KAAK;EAAe;CAAU;AAC1E;AAEA,SAAgB,UACd,WACA,KACA,cACA,SACQ;CACR,WAAW;CAEX,IAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,mBAAmB,SAAS,GAC3D,OAAO,KAAK,EAAE,KAAK,cAAc;EAAE,IAAI;EAAW,GAAG;EAAS,aAAa;CAAM,CAAC;CAGpF,OAAO,KAAK,EAAE,KAAK,cAAc;EAAE,IAAI;EAAW,GAAG;CAAQ,CAAC;AAChE"}

package/dist/i18n/locale-reload.d.ts

@@ -0,0 +1,3 @@
+import { VisitOptions } from '@inertiajs/core';
+export type LocaleReloadProps = Pick<VisitOptions, "preserveScroll" | "preserveState">;
+export declare function LocaleReload({ preserveScroll, preserveState }: LocaleReloadProps): import("react").JSX.Element;

package/dist/i18n/locale-reload.js

@@ -0,0 +1,17 @@
+import { EventBridge } from "../events/event-bridge.js";
+import { useCallback } from "react";
+import { router } from "@inertiajs/react";
+import { jsx } from "react/jsx-runtime";
+//#region resources/js/i18n/locale-reload.tsx
+function LocaleReload({ preserveScroll = true, preserveState = true }) {
+	return /* @__PURE__ */ jsx(EventBridge, { onLocaleChange: useCallback(() => {
+		router.visit(window.location.href, {
+			preserveScroll,
+			preserveState
+		});
+	}, [preserveScroll, preserveState]) });
+}
+//#endregion
+export { LocaleReload };
+
+//# sourceMappingURL=locale-reload.js.map

package/dist/i18n/locale-reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-reload.js","names":[],"sources":["../../resources/js/i18n/locale-reload.tsx"],"sourcesContent":["import type { VisitOptions } from \"@inertiajs/core\";\nimport { router } from \"@inertiajs/react\";\nimport { useCallback } from \"react\";\nimport { EventBridge } from \"../events/event-bridge\";\n\nexport type LocaleReloadProps = Pick<VisitOptions, \"preserveScroll\" | \"preserveState\">;\n\n// preserveState by default: the visit only re-fetches the re-localized props,\n// so keeping the page mounted avoids remounting the whole tree (and losing\n// table sort/filter, form input, focus) on every locale switch.\nexport function LocaleReload({ preserveScroll = true, preserveState = true }: LocaleReloadProps) {\n  const reload = useCallback(() => {\n    router.visit(window.location.href, { preserveScroll, preserveState });\n  }, [preserveScroll, preserveState]);\n\n  return <EventBridge onLocaleChange={reload} />;\n}\n"],"mappings":";;;;;AAUA,SAAgB,aAAa,EAAE,iBAAiB,MAAM,gBAAgB,QAA2B;CAK/F,OAAO,oBAAC,aAAD,EAAa,gBAJL,kBAAkB;EAC/B,OAAO,MAAM,OAAO,SAAS,MAAM;GAAE;GAAgB;EAAc,CAAC;CACtE,GAAG,CAAC,gBAAgB,aAAa,CAEG,EAAS,CAAA;AAC/C"}

package/dist/i18n/locale-switcher.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+export type LocaleOption = {
+    readonly value: string;
+    readonly label: string;
+    readonly active: boolean;
+};
+export type UseLocaleOptionsOptions = {
+    readonly namespace?: string;
+    readonly label?: (locale: string) => string;
+};
+export type UseLocaleOptionsReturn = {
+    readonly locale: string;
+    readonly locales: readonly string[];
+    readonly options: readonly LocaleOption[];
+    readonly setLocale: (locale: string) => void;
+};
+export type LocaleSwitcherProps = UseLocaleOptionsOptions & {
+    readonly children: (state: UseLocaleOptionsReturn) => ReactNode;
+};
+export declare function useLocaleOptions({ namespace, label, }?: UseLocaleOptionsOptions): UseLocaleOptionsReturn;
+export declare function LocaleSwitcher({ children, ...options }: LocaleSwitcherProps): import("react").JSX.Element;

package/dist/i18n/locale-switcher.js

@@ -0,0 +1,25 @@
+import { useT } from "./instance.js";
+import { Fragment, jsx } from "react/jsx-runtime";
+//#region resources/js/i18n/locale-switcher.tsx
+function useLocaleOptions({ namespace = "lattice", label } = {}) {
+	const { t, locale, locales, setLocale } = useT(namespace);
+	const values = locales.length > 0 ? locales : [locale];
+	const labelFor = label ?? ((value) => t(`language.${value}`, value));
+	return {
+		locale,
+		locales: values,
+		options: values.map((value) => ({
+			value,
+			label: labelFor(value),
+			active: value === locale
+		})),
+		setLocale
+	};
+}
+function LocaleSwitcher({ children, ...options }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useLocaleOptions(options)) });
+}
+//#endregion
+export { LocaleSwitcher, useLocaleOptions };
+
+//# sourceMappingURL=locale-switcher.js.map

package/dist/i18n/locale-switcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-switcher.js","names":[],"sources":["../../resources/js/i18n/locale-switcher.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useT } from \"./instance\";\n\nexport type LocaleOption = {\n  readonly value: string;\n  readonly label: string;\n  readonly active: boolean;\n};\n\nexport type UseLocaleOptionsOptions = {\n  readonly namespace?: string;\n  readonly label?: (locale: string) => string;\n};\n\nexport type UseLocaleOptionsReturn = {\n  readonly locale: string;\n  readonly locales: readonly string[];\n  readonly options: readonly LocaleOption[];\n  readonly setLocale: (locale: string) => void;\n};\n\nexport type LocaleSwitcherProps = UseLocaleOptionsOptions & {\n  readonly children: (state: UseLocaleOptionsReturn) => ReactNode;\n};\n\nexport function useLocaleOptions({\n  namespace = \"lattice\",\n  label,\n}: UseLocaleOptionsOptions = {}): UseLocaleOptionsReturn {\n  const { t, locale, locales, setLocale } = useT(namespace);\n  const values = locales.length > 0 ? locales : [locale];\n  const labelFor = label ?? ((value: string): string => t(`language.${value}`, value));\n\n  return {\n    locale,\n    locales: values,\n    options: values.map((value) => ({\n      value,\n      label: labelFor(value),\n      active: value === locale,\n    })),\n    setLocale,\n  };\n}\n\nexport function LocaleSwitcher({ children, ...options }: LocaleSwitcherProps) {\n  return <>{children(useLocaleOptions(options))}</>;\n}\n"],"mappings":";;;AAyBA,SAAgB,iBAAiB,EAC/B,YAAY,WACZ,UAC2B,CAAC,GAA2B;CACvD,MAAM,EAAE,GAAG,QAAQ,SAAS,cAAc,KAAK,SAAS;CACxD,MAAM,SAAS,QAAQ,SAAS,IAAI,UAAU,CAAC,MAAM;CACrD,MAAM,WAAW,WAAW,UAA0B,EAAE,YAAY,SAAS,KAAK;CAElF,OAAO;EACL;EACA,SAAS;EACT,SAAS,OAAO,KAAK,WAAW;GAC9B;GACA,OAAO,SAAS,KAAK;GACrB,QAAQ,UAAU;EACpB,EAAE;EACF;CACF;AACF;AAEA,SAAgB,eAAe,EAAE,UAAU,GAAG,WAAgC;CAC5E,OAAO,oBAAA,UAAA,EAAA,UAAG,SAAS,iBAAiB,OAAO,CAAC,EAAI,CAAA;AAClD"}

package/dist/i18n/locale.d.ts

@@ -0,0 +1,9 @@
+export type UseLocaleReturn = {
+    readonly locale: string;
+    readonly setLocale: (locale: string) => void;
+};
+export declare function currentLocale(): string;
+export declare function localeHeader(): Record<string, string>;
+export declare function subscribeLocale(callback: (locale: string) => void): () => void;
+export declare function setLocale(locale: string): void;
+export declare function useLocale(): UseLocaleReturn;

package/dist/i18n/locale.js

@@ -0,0 +1,93 @@
+import { LATTICE_EVENT } from "../events/event-names.js";
+import { useSyncExternalStore } from "react";
+//#region resources/js/i18n/locale.ts
+var key = "locale";
+var fallback = "en";
+var maxAge = 365 * 24 * 60 * 60;
+var listeners = /* @__PURE__ */ new Set();
+var active;
+function normalize(value) {
+	const next = value.trim();
+	return next === "" ? fallback : next;
+}
+function storedValue() {
+	if (typeof window === "undefined") return null;
+	try {
+		return localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+}
+function cookieValue() {
+	if (typeof document === "undefined") return null;
+	const item = document.cookie.split(";").map((cookie) => cookie.trim()).find((cookie) => cookie.startsWith(`${key}=`));
+	if (!item) return null;
+	try {
+		return decodeURIComponent(item.slice(7));
+	} catch {
+		return null;
+	}
+}
+function documentValue() {
+	if (typeof document === "undefined") return null;
+	return document.documentElement.lang || null;
+}
+function detectedLocale() {
+	return normalize(storedValue() ?? cookieValue() ?? documentValue() ?? fallback);
+}
+function persist(locale) {
+	if (typeof document !== "undefined") {
+		document.cookie = `${key}=${encodeURIComponent(locale)};path=/;max-age=${maxAge};SameSite=Lax`;
+		document.documentElement.lang = locale;
+	}
+	if (typeof window !== "undefined") try {
+		localStorage.setItem(key, locale);
+	} catch {
+		return;
+	}
+}
+function snapshot() {
+	active ??= detectedLocale();
+	return active;
+}
+function subscribe(callback) {
+	listeners.add(callback);
+	return () => {
+		listeners.delete(callback);
+	};
+}
+function notify() {
+	listeners.forEach((listener) => listener());
+}
+function dispatch(locale) {
+	if (typeof window === "undefined") return;
+	window.dispatchEvent(new CustomEvent(LATTICE_EVENT.localeChange, { detail: { locale } }));
+}
+function currentLocale() {
+	return snapshot();
+}
+function localeHeader() {
+	return { "Accept-Language": currentLocale() };
+}
+function subscribeLocale(callback) {
+	return subscribe(() => callback(currentLocale()));
+}
+function setLocale(locale) {
+	const previous = currentLocale();
+	const next = normalize(locale);
+	active = next;
+	persist(next);
+	if (next === previous) return;
+	notify();
+	dispatch(next);
+}
+function useLocale() {
+	return {
+		locale: useSyncExternalStore(subscribe, snapshot, () => fallback),
+		setLocale
+	};
+}
+//#endregion
+export { currentLocale, localeHeader, setLocale, subscribeLocale, useLocale };
+
+//# sourceMappingURL=locale.js.map

package/dist/i18n/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","names":[],"sources":["../../resources/js/i18n/locale.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport { LATTICE_EVENT } from \"../events/event-names\";\n\nexport type UseLocaleReturn = {\n  readonly locale: string;\n  readonly setLocale: (locale: string) => void;\n};\n\nconst key = \"locale\";\nconst fallback = \"en\";\nconst maxAge = 365 * 24 * 60 * 60;\nconst listeners = new Set<() => void>();\n\nlet active: string | undefined;\n\nfunction normalize(value: string): string {\n  const next = value.trim();\n\n  return next === \"\" ? fallback : next;\n}\n\nfunction storedValue(): string | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  try {\n    return localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction cookieValue(): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n\n  const item = document.cookie\n    .split(\";\")\n    .map((cookie) => cookie.trim())\n    .find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!item) {\n    return null;\n  }\n\n  try {\n    return decodeURIComponent(item.slice(key.length + 1));\n  } catch {\n    return null;\n  }\n}\n\nfunction documentValue(): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n\n  return document.documentElement.lang || null;\n}\n\nfunction detectedLocale(): string {\n  return normalize(storedValue() ?? cookieValue() ?? documentValue() ?? fallback);\n}\n\nfunction persist(locale: string): void {\n  if (typeof document !== \"undefined\") {\n    document.cookie = `${key}=${encodeURIComponent(locale)};path=/;max-age=${maxAge};SameSite=Lax`;\n    document.documentElement.lang = locale;\n  }\n\n  if (typeof window !== \"undefined\") {\n    try {\n      localStorage.setItem(key, locale);\n    } catch {\n      return;\n    }\n  }\n}\n\nfunction snapshot(): string {\n  active ??= detectedLocale();\n\n  return active;\n}\n\nfunction subscribe(callback: () => void): () => void {\n  listeners.add(callback);\n\n  return () => {\n    listeners.delete(callback);\n  };\n}\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nfunction dispatch(locale: string): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  window.dispatchEvent(new CustomEvent(LATTICE_EVENT.localeChange, { detail: { locale } }));\n}\n\nexport function currentLocale(): string {\n  return snapshot();\n}\n\nexport function localeHeader(): Record<string, string> {\n  return { \"Accept-Language\": currentLocale() };\n}\n\nexport function subscribeLocale(callback: (locale: string) => void): () => void {\n  return subscribe(() => callback(currentLocale()));\n}\n\nexport function setLocale(locale: string): void {\n  const previous = currentLocale();\n  const next = normalize(locale);\n\n  active = next;\n  persist(next);\n\n  if (next === previous) {\n    return;\n  }\n\n  notify();\n  dispatch(next);\n}\n\nexport function useLocale(): UseLocaleReturn {\n  const locale = useSyncExternalStore(subscribe, snapshot, () => fallback);\n\n  return { locale, setLocale } as const;\n}\n"],"mappings":";;;AAQA,IAAM,MAAM;AACZ,IAAM,WAAW;AACjB,IAAM,SAAS,MAAM,KAAK,KAAK;AAC/B,IAAM,4BAAY,IAAI,IAAgB;AAEtC,IAAI;AAEJ,SAAS,UAAU,OAAuB;CACxC,MAAM,OAAO,MAAM,KAAK;CAExB,OAAO,SAAS,KAAK,WAAW;AAClC;AAEA,SAAS,cAA6B;CACpC,IAAI,OAAO,WAAW,aACpB,OAAO;CAGT,IAAI;EACF,OAAO,aAAa,QAAQ,GAAG;CACjC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,cAA6B;CACpC,IAAI,OAAO,aAAa,aACtB,OAAO;CAGT,MAAM,OAAO,SAAS,OACnB,MAAM,GAAG,EACT,KAAK,WAAW,OAAO,KAAK,CAAC,EAC7B,MAAM,WAAW,OAAO,WAAW,GAAG,IAAI,EAAE,CAAC;CAEhD,IAAI,CAAC,MACH,OAAO;CAGT,IAAI;EACF,OAAO,mBAAmB,KAAK,MAAM,CAAc,CAAC;CACtD,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,gBAA+B;CACtC,IAAI,OAAO,aAAa,aACtB,OAAO;CAGT,OAAO,SAAS,gBAAgB,QAAQ;AAC1C;AAEA,SAAS,iBAAyB;CAChC,OAAO,UAAU,YAAY,KAAK,YAAY,KAAK,cAAc,KAAK,QAAQ;AAChF;AAEA,SAAS,QAAQ,QAAsB;CACrC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,SAAS,GAAG,IAAI,GAAG,mBAAmB,MAAM,EAAE,kBAAkB,OAAO;EAChF,SAAS,gBAAgB,OAAO;CAClC;CAEA,IAAI,OAAO,WAAW,aACpB,IAAI;EACF,aAAa,QAAQ,KAAK,MAAM;CAClC,QAAQ;EACN;CACF;AAEJ;AAEA,SAAS,WAAmB;CAC1B,WAAW,eAAe;CAE1B,OAAO;AACT;AAEA,SAAS,UAAU,UAAkC;CACnD,UAAU,IAAI,QAAQ;CAEtB,aAAa;EACX,UAAU,OAAO,QAAQ;CAC3B;AACF;AAEA,SAAS,SAAe;CACtB,UAAU,SAAS,aAAa,SAAS,CAAC;AAC5C;AAEA,SAAS,SAAS,QAAsB;CACtC,IAAI,OAAO,WAAW,aACpB;CAGF,OAAO,cAAc,IAAI,YAAY,cAAc,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1F;AAEA,SAAgB,gBAAwB;CACtC,OAAO,SAAS;AAClB;AAEA,SAAgB,eAAuC;CACrD,OAAO,EAAE,mBAAmB,cAAc,EAAE;AAC9C;AAEA,SAAgB,gBAAgB,UAAgD;CAC9E,OAAO,gBAAgB,SAAS,cAAc,CAAC,CAAC;AAClD;AAEA,SAAgB,UAAU,QAAsB;CAC9C,MAAM,WAAW,cAAc;CAC/B,MAAM,OAAO,UAAU,MAAM;CAE7B,SAAS;CACT,QAAQ,IAAI;CAEZ,IAAI,SAAS,UACX;CAGF,OAAO;CACP,SAAS,IAAI;AACf;AAEA,SAAgB,YAA6B;CAG3C,OAAO;EAAE,QAFM,qBAAqB,WAAW,gBAAgB,QAEtD;EAAQ;CAAU;AAC7B"}

package/dist/i18n/page-props.d.ts

@@ -0,0 +1,3 @@
+import { ConfigureI18nOptions, I18nConfig } from './backend';
+export declare function i18nConfigFromPageProps(props: unknown): I18nConfig | undefined;
+export declare function configureI18nFromPageProps(props: unknown, options?: ConfigureI18nOptions): Promise<void>;

package/dist/i18n/page-props.js

@@ -0,0 +1,24 @@
+import { configureI18n } from "./backend.js";
+//#region resources/js/i18n/page-props.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isI18nConfig(value) {
+	return isRecord(value) && typeof value.enabled === "boolean" && typeof value.saveMissing === "boolean" && isStringArray(value.locales) && isStringArray(value.preloadLocales);
+}
+function i18nConfigFromPageProps(props) {
+	if (!isRecord(props)) return;
+	const shared = props.lattice;
+	const config = isRecord(shared) ? shared.i18n : void 0;
+	return isI18nConfig(config) ? config : void 0;
+}
+function configureI18nFromPageProps(props, options = {}) {
+	return configureI18n(i18nConfigFromPageProps(props), options);
+}
+//#endregion
+export { configureI18nFromPageProps, i18nConfigFromPageProps };
+
+//# sourceMappingURL=page-props.js.map

package/dist/i18n/page-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-props.js","names":[],"sources":["../../resources/js/i18n/page-props.ts"],"sourcesContent":["import { configureI18n, type ConfigureI18nOptions, type I18nConfig } from \"./backend\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nfunction isI18nConfig(value: unknown): value is I18nConfig {\n  return (\n    isRecord(value) &&\n    typeof value.enabled === \"boolean\" &&\n    typeof value.saveMissing === \"boolean\" &&\n    isStringArray(value.locales) &&\n    isStringArray(value.preloadLocales)\n  );\n}\n\nexport function i18nConfigFromPageProps(props: unknown): I18nConfig | undefined {\n  if (!isRecord(props)) {\n    return undefined;\n  }\n\n  const shared = props.lattice;\n  const config = isRecord(shared) ? shared.i18n : undefined;\n\n  return isI18nConfig(config) ? config : undefined;\n}\n\nexport function configureI18nFromPageProps(\n  props: unknown,\n  options: ConfigureI18nOptions = {},\n): Promise<void> {\n  return configureI18n(i18nConfigFromPageProps(props), options);\n}\n"],"mappings":";;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,cAAc,OAAmC;CACxD,OAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,OAAO,SAAS,QAAQ;AAC/E;AAEA,SAAS,aAAa,OAAqC;CACzD,OACE,SAAS,KAAK,KACd,OAAO,MAAM,YAAY,aACzB,OAAO,MAAM,gBAAgB,aAC7B,cAAc,MAAM,OAAO,KAC3B,cAAc,MAAM,cAAc;AAEtC;AAEA,SAAgB,wBAAwB,OAAwC;CAC9E,IAAI,CAAC,SAAS,KAAK,GACjB;CAGF,MAAM,SAAS,MAAM;CACrB,MAAM,SAAS,SAAS,MAAM,IAAI,OAAO,OAAO,KAAA;CAEhD,OAAO,aAAa,MAAM,IAAI,SAAS,KAAA;AACzC;AAEA,SAAgB,2BACd,OACA,UAAgC,CAAC,GAClB;CACf,OAAO,cAAc,wBAAwB,KAAK,GAAG,OAAO;AAC9D"}

package/dist/icons/icon-renderer.js

@@ -1,8 +1,9 @@
-import { renderBundledIcon, renderMissingIcon } from "./default-icons.js";
+import { cn } from "../lib/utils.js";
+import { Icon, useSprite } from "./sprite.js";
 import { createContext, useContext, useMemo } from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region resources/js/icons/icon-renderer.tsx
-var IconRenderersContext = createContext([renderBundledIcon]);
+var IconRenderersContext = createContext([]);
 function IconRendererProvider({ children, mode = "stack", renderer }) {
 	const parentRenderers = useContext(IconRenderersContext);
 	const renderers = useMemo(() => mode === "replace" ? [renderer] : [renderer, ...parentRenderers], [
@@ -17,6 +18,7 @@ function IconRendererProvider({ children, mode = "stack", renderer }) {
 }
 function IconRenderer({ className, icon }) {
 	const renderers = useContext(IconRenderersContext);
+	const { ids } = useSprite();
 	for (const renderer of renderers) {
 		const rendered = renderer({
 			className,
@@ -24,9 +26,32 @@ function IconRenderer({ className, icon }) {
 		});
 		if (rendered !== null && rendered !== void 0 && rendered !== false) return rendered;
 	}
-	return renderMissingIcon({
+	if (ids && !ids.includes(icon)) return /* @__PURE__ */ jsx(MissingIcon, { className });
+	return /* @__PURE__ */ jsx(Icon, {
 		className,
-		icon
+		name: icon
+	});
+}
+function MissingIcon({ className }) {
+	return /* @__PURE__ */ jsxs("svg", {
+		"aria-hidden": "true",
+		className: cn("size-lt-icon-md text-lt-muted-fg", className),
+		"data-lattice-missing-icon": "",
+		fill: "none",
+		stroke: "currentColor",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		strokeWidth: "2",
+		viewBox: "0 0 24 24",
+		children: [
+			/* @__PURE__ */ jsx("circle", {
+				cx: "12",
+				cy: "12",
+				r: "10"
+			}),
+			/* @__PURE__ */ jsx("path", { d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" }),
+			/* @__PURE__ */ jsx("path", { d: "M12 17h.01" })
+		]
 	});
 }
 //#endregion

package/dist/icons/icon-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon-renderer.js","names":[],"sources":["../../resources/js/icons/icon-renderer.tsx"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { renderBundledIcon, renderMissingIcon } from \"./default-icons\";\n\nexport type IconRendererProps = {\n  className?: string;\n  icon: string;\n};\n\nexport type IconRendererFunction = (props: IconRendererProps) => ReactNode;\n\ntype IconRendererProviderProps = {\n  children: ReactNode;\n  mode?: \"replace\" | \"stack\";\n  renderer: IconRendererFunction;\n};\n\nconst IconRenderersContext = createContext<IconRendererFunction[]>([renderBundledIcon]);\nconst loggedMissingIcons = new Set<string>();\n\nexport function IconRendererProvider({\n  children,\n  mode = \"stack\",\n  renderer,\n}: IconRendererProviderProps) {\n  const parentRenderers = useContext(IconRenderersContext);\n  const renderers = useMemo(\n    () => (mode === \"replace\" ? [renderer] : [renderer, ...parentRenderers]),\n    [mode, parentRenderers, renderer],\n  );\n\n  return (\n    <IconRenderersContext.Provider value={renderers}>{children}</IconRenderersContext.Provider>\n  );\n}\n\nexport function IconRenderer({ className, icon }: IconRendererProps) {\n  const renderers = useContext(IconRenderersContext);\n\n  for (const renderer of renderers) {\n    const rendered = renderer({ className, icon });\n\n    if (rendered !== null && rendered !== undefined && rendered !== false) {\n      return rendered;\n    }\n  }\n\n  logMissingIcon(icon);\n\n  return renderMissingIcon({ className, icon });\n}\n\nfunction logMissingIcon(icon: string): void {\n  if (!import.meta.env.DEV || loggedMissingIcons.has(icon)) {\n    return;\n  }\n\n  loggedMissingIcons.add(icon);\n  console.log(`[Lattice] Missing icon renderer for \"${icon}\".`);\n}\n"],"mappings":";;;;AAiBA,IAAM,uBAAuB,cAAsC,CAAC,iBAAiB,CAAC;AAGtF,SAAgB,qBAAqB,EACnC,UACA,OAAO,SACP,YAC4B;CAC5B,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,YAAY,cACT,SAAS,YAAY,CAAC,QAAQ,IAAI,CAAC,UAAU,GAAG,eAAe,GACtE;EAAC;EAAM;EAAiB;CAAQ,CAClC;CAEA,OACE,oBAAC,qBAAqB,UAAtB;EAA+B,OAAO;EAAY;CAAwC,CAAA;AAE9F;AAEA,SAAgB,aAAa,EAAE,WAAW,QAA2B;CACnE,MAAM,YAAY,WAAW,oBAAoB;CAEjD,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,WAAW,SAAS;GAAE;GAAW;EAAK,CAAC;EAE7C,IAAI,aAAa,QAAQ,aAAa,KAAA,KAAa,aAAa,OAC9D,OAAO;CAEX;CAIA,OAAO,kBAAkB;EAAE;EAAW;CAAK,CAAC;AAC9C"}
+{"version":3,"file":"icon-renderer.js","names":[],"sources":["../../resources/js/icons/icon-renderer.tsx"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon, useSprite } from \"./sprite\";\n\nexport type IconRendererProps = {\n  className?: string;\n  icon: string;\n};\n\nexport type IconRendererFunction = (props: IconRendererProps) => ReactNode;\n\ntype IconRendererProviderProps = {\n  children: ReactNode;\n  mode?: \"replace\" | \"stack\";\n  renderer: IconRendererFunction;\n};\n\nconst IconRenderersContext = createContext<IconRendererFunction[]>([]);\nconst loggedMissingIcons = new Set<string>();\n\nexport function IconRendererProvider({\n  children,\n  mode = \"stack\",\n  renderer,\n}: IconRendererProviderProps) {\n  const parentRenderers = useContext(IconRenderersContext);\n  const renderers = useMemo(\n    () => (mode === \"replace\" ? [renderer] : [renderer, ...parentRenderers]),\n    [mode, parentRenderers, renderer],\n  );\n\n  return (\n    <IconRenderersContext.Provider value={renderers}>{children}</IconRenderersContext.Provider>\n  );\n}\n\nexport function IconRenderer({ className, icon }: IconRendererProps) {\n  const renderers = useContext(IconRenderersContext);\n  const { ids } = useSprite();\n\n  // Custom renderers (the override stack) take precedence over the sprite.\n  for (const renderer of renderers) {\n    const rendered = renderer({ className, icon });\n\n    if (rendered !== null && rendered !== undefined && rendered !== false) {\n      return rendered;\n    }\n  }\n\n  // When the sprite is wired and the icon is genuinely absent, show a visible\n  // marker. When `ids` is unknown (not yet wired), optimistically emit the\n  // sprite reference rather than crying wolf.\n  if (ids && !ids.includes(icon)) {\n    logMissingIcon(icon);\n    return <MissingIcon className={className} />;\n  }\n\n  return <Icon className={className} name={icon} />;\n}\n\nfunction MissingIcon({ className }: { className?: string }) {\n  return (\n    <svg\n      aria-hidden=\"true\"\n      className={cn(\"size-lt-icon-md text-lt-muted-fg\", className)}\n      data-lattice-missing-icon=\"\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      strokeWidth=\"2\"\n      viewBox=\"0 0 24 24\"\n    >\n      <circle cx=\"12\" cy=\"12\" r=\"10\" />\n      <path d=\"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3\" />\n      <path d=\"M12 17h.01\" />\n    </svg>\n  );\n}\n\nfunction logMissingIcon(icon: string): void {\n  if (!import.meta.env.DEV || loggedMissingIcons.has(icon)) {\n    return;\n  }\n\n  loggedMissingIcons.add(icon);\n  console.log(`[Lattice] Missing icon renderer for \"${icon}\".`);\n}\n"],"mappings":";;;;;AAkBA,IAAM,uBAAuB,cAAsC,CAAC,CAAC;AAGrE,SAAgB,qBAAqB,EACnC,UACA,OAAO,SACP,YAC4B;CAC5B,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,YAAY,cACT,SAAS,YAAY,CAAC,QAAQ,IAAI,CAAC,UAAU,GAAG,eAAe,GACtE;EAAC;EAAM;EAAiB;CAAQ,CAClC;CAEA,OACE,oBAAC,qBAAqB,UAAtB;EAA+B,OAAO;EAAY;CAAwC,CAAA;AAE9F;AAEA,SAAgB,aAAa,EAAE,WAAW,QAA2B;CACnE,MAAM,YAAY,WAAW,oBAAoB;CACjD,MAAM,EAAE,QAAQ,UAAU;CAG1B,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,WAAW,SAAS;GAAE;GAAW;EAAK,CAAC;EAE7C,IAAI,aAAa,QAAQ,aAAa,KAAA,KAAa,aAAa,OAC9D,OAAO;CAEX;CAKA,IAAI,OAAO,CAAC,IAAI,SAAS,IAAI,GAE3B,OAAO,oBAAC,aAAD,EAAwB,UAAY,CAAA;CAG7C,OAAO,oBAAC,MAAD;EAAiB;EAAW,MAAM;CAAO,CAAA;AAClD;AAEA,SAAS,YAAY,EAAE,aAAqC;CAC1D,OACE,qBAAC,OAAD;EACE,eAAY;EACZ,WAAW,GAAG,oCAAoC,SAAS;EAC3D,6BAA0B;EAC1B,MAAK;EACL,QAAO;EACP,eAAc;EACd,gBAAe;EACf,aAAY;EACZ,SAAQ;YATV;GAWE,oBAAC,UAAD;IAAQ,IAAG;IAAK,IAAG;IAAK,GAAE;GAAM,CAAA;GAChC,oBAAC,QAAD,EAAM,GAAE,uCAAwC,CAAA;GAChD,oBAAC,QAAD,EAAM,GAAE,aAAc,CAAA;EACnB;;AAET"}

package/dist/icons/index.d.ts

@@ -1,2 +1,4 @@
+export { Icon, SpriteProvider, useSprite } from './sprite';
+export type { IconName, KnownIcons, SpriteValue } from './sprite';
 export { IconRenderer, IconRendererProvider } from './icon-renderer';
 export type { IconRendererFunction, IconRendererProps } from './icon-renderer';

package/dist/icons/index.js

@@ -1,2 +1,3 @@
+import { Icon, SpriteProvider, useSprite } from "./sprite.js";
 import { IconRenderer, IconRendererProvider } from "./icon-renderer.js";
-export { IconRenderer, IconRendererProvider };
+export { Icon, IconRenderer, IconRendererProvider, SpriteProvider, useSprite };

package/dist/icons/sprite.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+export interface KnownIcons {
+}
+export type IconName = keyof KnownIcons | (string & {});
+export type SpriteValue = {
+    /** The sprite URL. Empty when the sprite is inlined into the document (dev). */
+    href: string;
+    /** Every symbol id in the sprite, or undefined when not yet wired/known. */
+    ids?: readonly string[];
+    /** Inline sprite markup to inject once (dev); empty/omitted in builds. */
+    source?: string;
+};
+/**
+ * Seeds the icon sprite for everything below it. When `sprite.source` is set
+ * (dev), it's injected once so same-document `<use href="#id">` references
+ * resolve; in builds `href` points at the emitted sprite asset instead.
+ */
+export declare function SpriteProvider({ children, sprite }: {
+    children: ReactNode;
+    sprite: SpriteValue;
+}): import("react").JSX.Element;
+export declare function useSprite(): SpriteValue;
+/**
+ * Renders a single sprite symbol by name. Used for Lattice's own UI chrome and
+ * as the resolved default for server-driven icons. Extra `<svg>` props are
+ * forwarded, so callers can override `aria-hidden`, set a `role`, etc.
+ */
+export declare function Icon({ className, name, ...props }: {
+    name: IconName;
+} & React.ComponentProps<"svg">): import("react").JSX.Element;