@k2b/ui 0.1.0-rc.0

package/dist/browser/intl/locale.js

@@ -0,0 +1,63 @@
+import { createComponent as _$createComponent } from "solid-js/web";
+import { createContext, useContext } from "solid-js";
+import { isServer } from "solid-js/web";
+
+/**
+ * Deterministic fallback locale used when neither a `LocaleProvider` nor a
+ * browser `<html lang>` value is available.
+ */
+export const DEFAULT_LOCALE = "en";
+const LocaleContext = createContext();
+/**
+ * Provides the render locale to all descendant `@k2b/ui` components.
+ *
+ * On the server this is the only locale source, so SSR consumers wrap their
+ * page in a provider and emit a matching `<html lang>` attribute. A browser
+ * island is an independent Solid root: an outer server-side provider does not
+ * survive the island's browser re-render, which instead falls back to
+ * `document.documentElement.lang`. Keeping `<html lang>` equal to the server
+ * provider locale therefore keeps both passes coherent.
+ */
+export const LocaleProvider = props => _$createComponent(LocaleContext.Provider, {
+  value: () => props.locale,
+  get children() {
+    return props.children;
+  }
+});
+
+/**
+ * Resolves the effective render locale as a reactive accessor.
+ *
+ * Precedence: nearest `LocaleProvider`, then the browser's
+ * `document.documentElement.lang`, then `"en"`. Components with an explicit
+ * `locale` prop apply it before consulting this hook.
+ */
+export const useLocale = () => {
+  const provided = useContext(LocaleContext);
+  if (provided) return provided;
+  if (isServer) return () => DEFAULT_LOCALE;
+  return () => document.documentElement.lang || DEFAULT_LOCALE;
+};
+
+/**
+ * Effective date config for date surfaces: an explicit `dateConfig.locale`
+ * wins, otherwise the inherited render locale fills the gap. Timezone and
+ * week-start configuration pass through untouched.
+ */
+export const useDateConfigLocale = config => {
+  const locale = useLocale();
+  return () => {
+    const current = config();
+    return current?.locale ? current : {
+      ...current,
+      locale: locale()
+    };
+  };
+};
+
+/**
+ * The decimal separator `Intl.NumberFormat` uses for a locale, e.g. `"."`
+ * for English and `","` for German.
+ */
+export const decimalSeparator = locale => new Intl.NumberFormat(locale).formatToParts(1.1).find(part => part.type === "decimal")?.value ?? ".";
+//# sourceMappingURL=locale.js.map

package/dist/browser/intl/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","isServer","DEFAULT_LOCALE","LocaleContext","LocaleProvider","props","_$createComponent","Provider","value","locale","children","useLocale","provided","document","documentElement","lang","useDateConfigLocale","config","current","decimalSeparator","Intl","NumberFormat","formatToParts","find","part","type"],"sources":["intl/locale.tsx"],"sourcesContent":["import type { DateContext } from \"@k2b/stdlib\";\nimport { createContext, type JSX, useContext } from \"solid-js\";\nimport { isServer } from \"solid-js/web\";\n\n/**\n * Deterministic fallback locale used when neither a `LocaleProvider` nor a\n * browser `<html lang>` value is available.\n */\nexport const DEFAULT_LOCALE = \"en\";\n\nconst LocaleContext = createContext<() => string>();\n\nexport type LocaleProviderProps = {\n  /** BCP 47 locale tag, e.g. `\"en\"`, `\"de\"`, or `\"de-AT\"`. */\n  locale: string;\n  children?: JSX.Element;\n};\n\n/**\n * Provides the render locale to all descendant `@k2b/ui` components.\n *\n * On the server this is the only locale source, so SSR consumers wrap their\n * page in a provider and emit a matching `<html lang>` attribute. A browser\n * island is an independent Solid root: an outer server-side provider does not\n * survive the island's browser re-render, which instead falls back to\n * `document.documentElement.lang`. Keeping `<html lang>` equal to the server\n * provider locale therefore keeps both passes coherent.\n */\nexport const LocaleProvider = (props: LocaleProviderProps): JSX.Element => (\n  <LocaleContext.Provider value={() => props.locale}>{props.children}</LocaleContext.Provider>\n);\n\n/**\n * Resolves the effective render locale as a reactive accessor.\n *\n * Precedence: nearest `LocaleProvider`, then the browser's\n * `document.documentElement.lang`, then `\"en\"`. Components with an explicit\n * `locale` prop apply it before consulting this hook.\n */\nexport const useLocale = (): (() => string) => {\n  const provided = useContext(LocaleContext);\n  if (provided) return provided;\n  if (isServer) return () => DEFAULT_LOCALE;\n  return () => document.documentElement.lang || DEFAULT_LOCALE;\n};\n\n/**\n * Effective date config for date surfaces: an explicit `dateConfig.locale`\n * wins, otherwise the inherited render locale fills the gap. Timezone and\n * week-start configuration pass through untouched.\n */\nexport const useDateConfigLocale = (config: () => DateContext | undefined): (() => DateContext) => {\n  const locale = useLocale();\n  return () => {\n    const current = config();\n    return current?.locale ? current : { ...current, locale: locale() };\n  };\n};\n\n/**\n * The decimal separator `Intl.NumberFormat` uses for a locale, e.g. `\".\"`\n * for English and `\",\"` for German.\n */\nexport const decimalSeparator = (locale: string): string =>\n  new Intl.NumberFormat(locale).formatToParts(1.1).find((part) => part.type === \"decimal\")?.value ?? \".\";\n"],"mappings":";AACA,SAASA,aAAa,EAAYC,UAAU,QAAQ,UAAU;AAC9D,SAASC,QAAQ,QAAQ,cAAc;;AAEvC;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,GAAG,IAAI;AAElC,MAAMC,aAAa,GAAGJ,aAAa,CAAe,CAAC;AAQnD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,cAAc,GAAIC,KAA0B,IAAAC,iBAAA,CACtDH,aAAa,CAACI,QAAQ;EAACC,KAAK,EAAEA,CAAA,KAAMH,KAAK,CAACI,MAAM;EAAA,IAAAC,SAAA;IAAA,OAAGL,KAAK,CAACK,QAAQ;EAAA;AAAA,EACnE;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,SAAS,GAAGA,CAAA,KAAsB;EAC7C,MAAMC,QAAQ,GAAGZ,UAAU,CAACG,aAAa,CAAC;EAC1C,IAAIS,QAAQ,EAAE,OAAOA,QAAQ;EAC7B,IAAIX,QAAQ,EAAE,OAAO,MAAMC,cAAc;EACzC,OAAO,MAAMW,QAAQ,CAACC,eAAe,CAACC,IAAI,IAAIb,cAAc;AAC9D,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMc,mBAAmB,GAAIC,MAAqC,IAA0B;EACjG,MAAMR,MAAM,GAAGE,SAAS,CAAC,CAAC;EAC1B,OAAO,MAAM;IACX,MAAMO,OAAO,GAAGD,MAAM,CAAC,CAAC;IACxB,OAAOC,OAAO,EAAET,MAAM,GAAGS,OAAO,GAAG;MAAE,GAAGA,OAAO;MAAET,MAAM,EAAEA,MAAM,CAAC;IAAE,CAAC;EACrE,CAAC;AACH,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMU,gBAAgB,GAAIV,MAAc,IAC7C,IAAIW,IAAI,CAACC,YAAY,CAACZ,MAAM,CAAC,CAACa,aAAa,CAAC,GAAG,CAAC,CAACC,IAAI,CAAEC,IAAI,IAAKA,IAAI,CAACC,IAAI,KAAK,SAAS,CAAC,EAAEjB,KAAK,IAAI,GAAG","ignoreList":[]}