@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/provider/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAGlB,KAAK,cAAc,EACnB,KAAK,YAAY,EAIlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,KAAK,SAAS,EAA8D,MAAM,gBAAgB,CAAC;AAgB5G,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,YAAY,CAAC;AAEvF,OAAO,gBAAgB,CAAC;AACxB,OAAO,aAAa,CAAC;AAErB,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IAC/C,kHAAkH;IAClH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CA8N5D"}

package/dist/provider/provider.jsx

@@ -0,0 +1,290 @@
+import { assertRequiredCapabilities, createCultureStore, createDiagnostics, createIconFontRegistry, createPreferences, createSafeExecutor, createStrings, createThemeStore, toCssVariables, toLayoutCssVariables, toMetricCssVariables } from "@g9tm/lynxcontrols-foundation";
+import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "@lynx-js/react";
+import { useStableCallback } from "../base/use-stable-callback.jsx";
+import { g9Hosts } from "../host/registry.jsx";
+import { G9CoreContext, G9CultureContext, G9DiagnosticsContext, G9InsetsContext, G9KeyboardContext, G9SettingsContext, G9WindowContext } from "./contexts.jsx";
+import { addGlobalListener } from "./global-events.jsx";
+import { g9DefaultErrorPresenter, resolveSettings } from "./settings.jsx";
+import { applyThemeVariables, changedVariables } from "./theme-root.jsx";
+import "./provider.css";
+import "./theme.css";
+const THEME_PREFERENCE_KEY = 'theme';
+const THEME_MODES = [
+    'system',
+    'light',
+    'dark'
+];
+let providerSequence = 0;
+function isCultureStore(value) {
+    return 'object' == typeof value && null !== value && 'function' == typeof value.getSnapshot;
+}
+function isThemeStore(value) {
+    return 'object' == typeof value && null !== value && 'function' == typeof value.getSnapshot;
+}
+function initialWindow() {
+    var _ref, _ref1;
+    const info = globalThis.SystemInfo;
+    const ratio = (null == info ? void 0 : info.pixelRatio) && info.pixelRatio > 0 ? info.pixelRatio : 1;
+    return Object.freeze({
+        width: (null != (_ref = null == info ? void 0 : info.pixelWidth) ? _ref : 0) / ratio,
+        height: (null != (_ref1 = null == info ? void 0 : info.pixelHeight) ? _ref1 : 0) / ratio
+    });
+}
+const HIDDEN_KEYBOARD = Object.freeze({
+    visible: false,
+    height: 0,
+    compatHeight: 0
+});
+function finite(value) {
+    return 'number' == typeof value && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function G9Provider(props) {
+    var _props_diagnostics, _props_culture;
+    const { services, persistTheme = true } = props;
+    assertRequiredCapabilities(services);
+    const [ownDiagnostics] = useState(createDiagnostics);
+    const diagnostics = null != (_props_diagnostics = props.diagnostics) ? _props_diagnostics : ownDiagnostics;
+    const [iconFonts] = useState(createIconFontRegistry);
+    const settings = useMemo(()=>resolveSettings(props.settings, iconFonts), [
+        props.settings,
+        iconFonts
+    ]);
+    const cultureProp = null != (_props_culture = props.culture) ? _props_culture : 'en';
+    const [ownCulture] = useState(()=>createCultureStore(isCultureStore(cultureProp) ? 'en' : cultureProp));
+    const cultureStore = isCultureStore(cultureProp) ? cultureProp : ownCulture;
+    useEffect(()=>{
+        if (!isCultureStore(cultureProp)) ownCulture.setCulture(cultureProp);
+    }, [
+        cultureProp,
+        ownCulture
+    ]);
+    const culture = useSyncExternalStore(cultureStore.subscribe, cultureStore.getSnapshot);
+    const strings = useMemo(()=>createStrings({
+            ...settings.strings,
+            culture
+        }), [
+        settings.strings,
+        culture
+    ]);
+    const cultureValue = useMemo(()=>({
+            culture,
+            strings,
+            store: cultureStore
+        }), [
+        culture,
+        strings,
+        cultureStore
+    ]);
+    const themeProp = props.theme;
+    const [ownTheme] = useState(()=>createThemeStore(isThemeStore(themeProp) ? {} : null != themeProp ? themeProp : {}));
+    const themeStore = isThemeStore(themeProp) ? themeProp : ownTheme;
+    const options = isThemeStore(themeProp) ? void 0 : themeProp;
+    useEffect(()=>{
+        if (!options) return;
+        ownTheme.beginBatch();
+        try {
+            if (void 0 !== options.mode) ownTheme.setMode(options.mode);
+            if (void 0 !== options.systemScheme) ownTheme.setSystemScheme(options.systemScheme);
+            ownTheme.setPalettes(options.palettes);
+            ownTheme.setOverrides(options.overrides);
+        } finally{
+            ownTheme.endBatch();
+        }
+    }, [
+        ownTheme,
+        null == options ? void 0 : options.mode,
+        null == options ? void 0 : options.systemScheme,
+        null == options ? void 0 : options.palettes,
+        null == options ? void 0 : options.overrides
+    ]);
+    useEffect(()=>{
+        if (void 0 !== props.systemScheme) themeStore.setSystemScheme(props.systemScheme);
+    }, [
+        themeStore,
+        props.systemScheme
+    ]);
+    const executorStrings = useRef(strings);
+    executorStrings.current = strings;
+    const [rootId] = useState(()=>{
+        providerSequence += 1;
+        return `g9-provider-${providerSequence}`;
+    });
+    const core = useMemo(()=>{
+        var _executorSettings_showError;
+        const preferences = createPreferences({
+            store: services.preferences,
+            onStoreError: (error, failure)=>diagnostics.log({
+                    level: 'warning',
+                    message: `Preference ${failure.operation} failed for '${failure.key}'.`,
+                    source: 'G9Provider',
+                    error
+                })
+        });
+        const executorSettings = settings.executor;
+        const executor = createSafeExecutor({
+            clock: services.clock,
+            diagnostics,
+            strings: {
+                get: (key)=>executorStrings.current.get(key)
+            },
+            showError: null != (_executorSettings_showError = executorSettings.showError) ? _executorSettings_showError : (request)=>{
+                const presenter = g9DefaultErrorPresenter.current;
+                if (presenter) return presenter(request);
+                diagnostics.log({
+                    level: 'warning',
+                    message: `No error presenter is configured; not shown: ${request.message}`,
+                    source: request.source
+                });
+            },
+            ...executorSettings.diagnosticsHandler ? {
+                diagnosticsHandler: executorSettings.diagnosticsHandler
+            } : {},
+            ...executorSettings.diagnosticsAvailable ? {
+                diagnosticsAvailable: executorSettings.diagnosticsAvailable
+            } : {},
+            ...executorSettings.defaults ? {
+                defaults: executorSettings.defaults
+            } : {}
+        });
+        return Object.freeze({
+            services,
+            themeStore,
+            preferences,
+            diagnostics,
+            executor,
+            rootId
+        });
+    }, [
+        services,
+        themeStore,
+        diagnostics,
+        settings.executor,
+        rootId
+    ]);
+    useEffect(()=>()=>core.executor.dispose(), [
+        core
+    ]);
+    const [initialVariables] = useState(()=>({
+            ...toMetricCssVariables(),
+            ...toLayoutCssVariables(),
+            ...toCssVariables(themeStore.getSnapshot())
+        }));
+    const [initialScheme] = useState(()=>themeStore.getSnapshot().scheme);
+    const applied = useRef({});
+    const [fallbackVariables, setFallbackVariables] = useState(null);
+    useEffect(()=>{
+        const apply = ()=>{
+            const next = {
+                ...initialVariables,
+                ...applied.current,
+                ...toCssVariables(themeStore.getSnapshot())
+            };
+            const diff = changedVariables(applied.current, next);
+            applied.current = next;
+            if (!diff) return;
+            if (!applyThemeVariables(rootId, diff)) setFallbackVariables(next);
+        };
+        apply();
+        return themeStore.subscribe(apply);
+    }, [
+        themeStore,
+        rootId,
+        initialVariables
+    ]);
+    useEffect(()=>{
+        if (!persistTheme) return;
+        let alive = true;
+        const save = ()=>{
+            const value = THEME_MODES.indexOf(themeStore.getSnapshot().mode);
+            if (core.preferences.getInt(THEME_PREFERENCE_KEY, -1) !== value) core.preferences.setInt(THEME_PREFERENCE_KEY, value);
+        };
+        let lastMode = themeStore.getSnapshot().mode;
+        const unsubscribe = themeStore.subscribe((theme)=>{
+            if (theme.mode === lastMode) return;
+            lastMode = theme.mode;
+            save();
+        });
+        core.preferences.hydrate().then(()=>{
+            if (!alive) return;
+            const stored = THEME_MODES[core.preferences.getInt(THEME_PREFERENCE_KEY, -1)];
+            if (stored) themeStore.setMode(stored);
+        }, (error)=>diagnostics.log({
+                level: 'warning',
+                message: 'Theme restore failed.',
+                source: 'G9Provider',
+                error
+            }));
+        return ()=>{
+            alive = false;
+            unsubscribe();
+        };
+    }, [
+        persistTheme,
+        themeStore,
+        core,
+        diagnostics
+    ]);
+    const [keyboard, setKeyboard] = useState(HIDDEN_KEYBOARD);
+    useEffect(()=>addGlobalListener('keyboardstatuschanged', (status, height, compatHeight)=>{
+            setKeyboard('on' === status ? Object.freeze({
+                visible: true,
+                height: finite(height),
+                compatHeight: finite(compatHeight)
+            }) : HIDDEN_KEYBOARD);
+        }, (error)=>diagnostics.log({
+                level: 'warning',
+                message: 'Keyboard events are unavailable on this host.',
+                source: 'G9Provider',
+                error
+            })), [
+        diagnostics
+    ]);
+    const [windowState, setWindowState] = useState(initialWindow);
+    useEffect(()=>addGlobalListener('onWindowResize', (width, height)=>{
+            setWindowState((current)=>{
+                const next = {
+                    width: 'number' == typeof width && width >= 0 ? width : current.width,
+                    height: 'number' == typeof height && height >= 0 ? height : current.height
+                };
+                return next.width === current.width && next.height === current.height ? current : Object.freeze(next);
+            });
+        }), []);
+    const [insets, setInsets] = useState(()=>services.host.getSafeInsets());
+    useEffect(()=>{
+        setInsets(services.host.getSafeInsets());
+        return services.host.subscribeSafeInsets((next)=>setInsets(next));
+    }, [
+        services.host
+    ]);
+    const onBack = useStableCallback(()=>{
+        const host = g9Hosts.active();
+        if (host && host.services === services && 'handled' === host.back.dispatch()) return;
+        services.host.exit();
+    });
+    useEffect(()=>addGlobalListener(settings.backEventName, onBack), [
+        settings.backEventName,
+        onBack
+    ]);
+    const rootStyle = null != fallbackVariables ? fallbackVariables : initialVariables;
+    const directionClass = 'rtl' === culture.direction ? 'g9-dir-rtl' : 'g9-dir-ltr';
+    return <G9CoreContext.Provider value={core}>
+      <G9DiagnosticsContext.Provider value={diagnostics}>
+        <G9SettingsContext.Provider value={settings}>
+          <G9CultureContext.Provider value={cultureValue}>
+            <G9KeyboardContext.Provider value={keyboard}>
+              <G9WindowContext.Provider value={windowState}>
+                <G9InsetsContext.Provider value={insets}>
+                  <view id={rootId} className={`g9-provider g9-theme-${initialScheme} ${directionClass}${props.className ? ` ${props.className}` : ''}`} style={rootStyle}>
+                    {props.children}
+                  </view>
+                </G9InsetsContext.Provider>
+              </G9WindowContext.Provider>
+            </G9KeyboardContext.Provider>
+          </G9CultureContext.Provider>
+        </G9SettingsContext.Provider>
+      </G9DiagnosticsContext.Provider>
+    </G9CoreContext.Provider>;
+}
+export { G9Provider };
+
+//# sourceMappingURL=provider.jsx.map

package/dist/provider/provider.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/provider.jsx","sources":["../../src/provider/provider.tsx"],"sourcesContent":["import {\n  assertRequiredCapabilities,\n  createCultureStore,\n  createDiagnostics,\n  createIconFontRegistry,\n  createPreferences,\n  createSafeExecutor,\n  createStrings,\n  createThemeStore,\n  type G9Capabilities,\n  type G9ColorScheme,\n  type G9CssVariables,\n  type G9Culture,\n  type G9CultureStore,\n  type G9Diagnostics,\n  type G9SafeInsets,\n  type G9ThemeMode,\n  type G9ThemeOptions,\n  type G9ThemeStore,\n  toCssVariables,\n  toLayoutCssVariables,\n  toMetricCssVariables,\n} from '@g9tm/lynxcontrols-foundation';\nimport { type ReactNode, useEffect, useMemo, useRef, useState, useSyncExternalStore } from '@lynx-js/react';\nimport { useStableCallback } from '../base/use-stable-callback';\nimport { g9Hosts } from '../host/registry';\nimport {\n  G9CoreContext,\n  G9CultureContext,\n  G9DiagnosticsContext,\n  G9InsetsContext,\n  G9KeyboardContext,\n  type G9KeyboardState,\n  type G9ProviderCore,\n  G9SettingsContext,\n  G9WindowContext,\n  type G9WindowState,\n} from './contexts';\nimport { addGlobalListener } from './global-events';\nimport { type G9Settings, g9DefaultErrorPresenter, resolveSettings } from './settings';\nimport { applyThemeVariables, changedVariables } from './theme-root';\nimport './provider.css';\nimport './theme.css';\n\n/** Props of {@link G9Provider}. */\nexport interface G9ProviderProps {\n  /**\n   * The app's platform services (plan/specs/01 §8). `clock`, `preferences` and `host` are required: a missing one\n   * throws `G9CapabilityMissingError` naming it when the provider mounts. Pass a stable object.\n   */\n  readonly services: Partial<G9Capabilities>;\n  /**\n   * The culture: a store the app drives (`createCultureStore`), or a culture value / locale tag the provider keeps in\n   * its own store (a new value switches it). Default `'en'`.\n   */\n  readonly culture?: G9CultureStore | G9Culture | string;\n  /**\n   * The theme: a store the app drives (`createThemeStore`), or options for the provider's own store (changes to\n   * `mode`, `systemScheme`, `palettes`, `overrides` are applied to it). Default: system mode, stock palettes.\n   */\n  readonly theme?: G9ThemeStore | G9ThemeOptions;\n  /** The platform's current colour scheme (MAUI `RequestedThemeChanged`); followed while the mode is `'system'`. */\n  readonly systemScheme?: G9ColorScheme;\n  /**\n   * Save the theme mode in preferences and restore it at mount (MAUI `G9Theme.ChangeTheme` / `Init`, key\n   * `g9controls.theme`, values 0 system, 1 light, 2 dark). Default `true`.\n   */\n  readonly persistTheme?: boolean;\n  /** App-wide settings (plan/specs/03 §6). Validated at mount and on change. */\n  readonly settings?: G9Settings;\n  /** The diagnostics hub. Default: a hub the provider creates. */\n  readonly diagnostics?: G9Diagnostics;\n  readonly className?: string;\n  readonly children?: ReactNode;\n}\n\nconst THEME_PREFERENCE_KEY = 'theme';\nconst THEME_MODES: readonly G9ThemeMode[] = ['system', 'light', 'dark'];\n\nlet providerSequence = 0;\n\nfunction isCultureStore(value: G9ProviderProps['culture']): value is G9CultureStore {\n  return typeof value === 'object' && value !== null && typeof (value as G9CultureStore).getSnapshot === 'function';\n}\n\nfunction isThemeStore(value: G9ProviderProps['theme']): value is G9ThemeStore {\n  return typeof value === 'object' && value !== null && typeof (value as G9ThemeStore).getSnapshot === 'function';\n}\n\n/** The logical window size the platform reports at startup (`SystemInfo` is in physical pixels). */\nfunction initialWindow(): G9WindowState {\n  const info = (globalThis as { SystemInfo?: { pixelWidth?: number; pixelHeight?: number; pixelRatio?: number } })\n    .SystemInfo;\n  const ratio = info?.pixelRatio && info.pixelRatio > 0 ? info.pixelRatio : 1;\n  return Object.freeze({ width: (info?.pixelWidth ?? 0) / ratio, height: (info?.pixelHeight ?? 0) / ratio });\n}\n\nconst HIDDEN_KEYBOARD: G9KeyboardState = Object.freeze({ visible: false, height: 0, compatHeight: 0 });\n\nfunction finite(value: unknown): number {\n  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;\n}\n\n/**\n * The root every G9 component lives in (plan/specs/01 §5, MAUI `G9Theme`/`G9Culture`/`G9Strings` statics,\n * `G9ServiceProvider`, `G9ScreenHelper`, `G9KeyboardHelper`): culture and strings, the theme as CSS variables on one\n * root `<view>`, settings, services and capabilities, the diagnostics hub, the shared safe executor, keyboard, window\n * and safe-area state, and the dispatch of the system back event to the active `G9Host`. Mount it once per LynxView.\n *\n * - A theme change updates the root's CSS variables with `setProperty`: nothing re-renders except `useG9Theme`\n *   readers. A culture change re-renders culture readers.\n * - One `keyboardstatuschanged` and one `onWindowResize` listener for the whole tree.\n * - The back event (`settings.backEventName`, default `g9:back`) goes to the active host's back stack; when nothing\n *   handles it, `services.host.exit()` runs (desktop hosts send the same event for Escape).\n * - Unmounting removes every listener, subscription and timer it created.\n */\nexport function G9Provider(props: G9ProviderProps): ReactNode {\n  const { services, persistTheme = true } = props;\n  assertRequiredCapabilities(services);\n\n  const [ownDiagnostics] = useState(createDiagnostics);\n  const diagnostics = props.diagnostics ?? ownDiagnostics;\n  const [iconFonts] = useState(createIconFontRegistry);\n  const settings = useMemo(() => resolveSettings(props.settings, iconFonts), [props.settings, iconFonts]);\n\n  // Culture: the app's store, or one the provider keeps in step with the prop.\n  const cultureProp = props.culture ?? 'en';\n  const [ownCulture] = useState(() => createCultureStore(isCultureStore(cultureProp) ? 'en' : cultureProp));\n  const cultureStore = isCultureStore(cultureProp) ? cultureProp : ownCulture;\n  useEffect(() => {\n    if (!isCultureStore(cultureProp)) ownCulture.setCulture(cultureProp);\n  }, [cultureProp, ownCulture]);\n  const culture = useSyncExternalStore(cultureStore.subscribe, cultureStore.getSnapshot);\n  const strings = useMemo(() => createStrings({ ...settings.strings, culture }), [settings.strings, culture]);\n  const cultureValue = useMemo(() => ({ culture, strings, store: cultureStore }), [culture, strings, cultureStore]);\n\n  // Theme: the app's store, or one the provider keeps in step with the options.\n  const themeProp = props.theme;\n  const [ownTheme] = useState(() => createThemeStore(isThemeStore(themeProp) ? {} : (themeProp ?? {})));\n  const themeStore = isThemeStore(themeProp) ? themeProp : ownTheme;\n  const options = isThemeStore(themeProp) ? undefined : themeProp;\n  useEffect(() => {\n    if (!options) return;\n    ownTheme.beginBatch();\n    try {\n      if (options.mode !== undefined) ownTheme.setMode(options.mode);\n      if (options.systemScheme !== undefined) ownTheme.setSystemScheme(options.systemScheme);\n      ownTheme.setPalettes(options.palettes);\n      ownTheme.setOverrides(options.overrides);\n    } finally {\n      ownTheme.endBatch();\n    }\n    // Field-wise on purpose: an inline `theme={{ … }}` object must not re-apply (and undo a restored mode) per render.\n  }, [ownTheme, options?.mode, options?.systemScheme, options?.palettes, options?.overrides]);\n  useEffect(() => {\n    if (props.systemScheme !== undefined) themeStore.setSystemScheme(props.systemScheme);\n  }, [themeStore, props.systemScheme]);\n\n  const executorStrings = useRef(strings);\n  executorStrings.current = strings;\n  const [rootId] = useState(() => {\n    providerSequence += 1;\n    return `g9-provider-${providerSequence}`;\n  });\n\n  const core = useMemo<G9ProviderCore>(() => {\n    const preferences = createPreferences({\n      store: services.preferences,\n      onStoreError: (error, failure) =>\n        diagnostics.log({\n          level: 'warning',\n          message: `Preference ${failure.operation} failed for '${failure.key}'.`,\n          source: 'G9Provider',\n          error,\n        }),\n    });\n    const executorSettings = settings.executor;\n    const executor = createSafeExecutor({\n      clock: services.clock,\n      diagnostics,\n      strings: { get: (key) => executorStrings.current.get(key) },\n      // No app presenter: the default one (the error popup, registered by `@g9tm/lynxcontrols/popup`) if loaded.\n      showError:\n        executorSettings.showError ??\n        ((request) => {\n          const presenter = g9DefaultErrorPresenter.current;\n          if (presenter) return presenter(request);\n          diagnostics.log({\n            level: 'warning',\n            message: `No error presenter is configured; not shown: ${request.message}`,\n            source: request.source,\n          });\n          return undefined;\n        }),\n      ...(executorSettings.diagnosticsHandler ? { diagnosticsHandler: executorSettings.diagnosticsHandler } : {}),\n      ...(executorSettings.diagnosticsAvailable ? { diagnosticsAvailable: executorSettings.diagnosticsAvailable } : {}),\n      ...(executorSettings.defaults ? { defaults: executorSettings.defaults } : {}),\n    });\n    return Object.freeze({ services, themeStore, preferences, diagnostics, executor, rootId });\n  }, [services, themeStore, diagnostics, settings.executor, rootId]);\n  useEffect(() => () => core.executor.dispose(), [core]);\n\n  // Theme root. The Lynx engine drops custom properties in an inline style object (page config\n  // `enableCSSInlineVariables` is off and not exposed), so the first frame takes the stock palette of the initial\n  // scheme and the default metrics from theme.css classes; the inline copy below only serves engines that honour it.\n  // At mount every variable is then written with setProperty (custom palettes, overrides, layout), and each later\n  // theme change sends only what changed (no re-render).\n  const [initialVariables] = useState<G9CssVariables>(() => ({\n    ...toMetricCssVariables(),\n    ...toLayoutCssVariables(),\n    ...toCssVariables(themeStore.getSnapshot()),\n  }));\n  const [initialScheme] = useState(() => themeStore.getSnapshot().scheme);\n  const applied = useRef<G9CssVariables>({});\n  const [fallbackVariables, setFallbackVariables] = useState<G9CssVariables | null>(null);\n  useEffect(() => {\n    const apply = () => {\n      const next = { ...initialVariables, ...applied.current, ...toCssVariables(themeStore.getSnapshot()) };\n      const diff = changedVariables(applied.current, next);\n      applied.current = next;\n      if (!diff) return;\n      // Without the element API (a host that lacks it), re-render the root's style instead: still no child render.\n      if (!applyThemeVariables(rootId, diff)) setFallbackVariables(next);\n    };\n    apply();\n    return themeStore.subscribe(apply);\n  }, [themeStore, rootId, initialVariables]);\n\n  // Theme persistence (MAUI ChangeTheme wrote the AppTheme number, Init read it back).\n  useEffect(() => {\n    if (!persistTheme) return;\n    let alive = true;\n    const save = () => {\n      const value = THEME_MODES.indexOf(themeStore.getSnapshot().mode);\n      if (core.preferences.getInt(THEME_PREFERENCE_KEY, -1) !== value) {\n        void core.preferences.setInt(THEME_PREFERENCE_KEY, value);\n      }\n    };\n    let lastMode = themeStore.getSnapshot().mode;\n    const unsubscribe = themeStore.subscribe((theme) => {\n      if (theme.mode === lastMode) return;\n      lastMode = theme.mode;\n      save();\n    });\n    core.preferences.hydrate().then(\n      () => {\n        if (!alive) return;\n        const stored = THEME_MODES[core.preferences.getInt(THEME_PREFERENCE_KEY, -1)];\n        if (stored) themeStore.setMode(stored);\n      },\n      (error: unknown) =>\n        diagnostics.log({ level: 'warning', message: 'Theme restore failed.', source: 'G9Provider', error }),\n    );\n    return () => {\n      alive = false;\n      unsubscribe();\n    };\n  }, [persistTheme, themeStore, core, diagnostics]);\n\n  // Keyboard and window: one listener each for the whole tree.\n  const [keyboard, setKeyboard] = useState<G9KeyboardState>(HIDDEN_KEYBOARD);\n  useEffect(\n    () =>\n      addGlobalListener(\n        'keyboardstatuschanged',\n        (status: unknown, height: unknown, compatHeight: unknown) => {\n          setKeyboard(\n            status === 'on'\n              ? Object.freeze({ visible: true, height: finite(height), compatHeight: finite(compatHeight) })\n              : HIDDEN_KEYBOARD,\n          );\n        },\n        // A host without keyboard detection (windowless Lynxtron): the keyboard simply stays hidden.\n        (error) =>\n          diagnostics.log({\n            level: 'warning',\n            message: 'Keyboard events are unavailable on this host.',\n            source: 'G9Provider',\n            error,\n          }),\n      ),\n    [diagnostics],\n  );\n  const [windowState, setWindowState] = useState<G9WindowState>(initialWindow);\n  useEffect(\n    () =>\n      addGlobalListener('onWindowResize', (width: unknown, height: unknown) => {\n        setWindowState((current) => {\n          const next = {\n            width: typeof width === 'number' && width >= 0 ? width : current.width,\n            height: typeof height === 'number' && height >= 0 ? height : current.height,\n          };\n          return next.width === current.width && next.height === current.height ? current : Object.freeze(next);\n        });\n      }),\n    [],\n  );\n\n  // Safe-area insets from the host service.\n  const [insets, setInsets] = useState<G9SafeInsets>(() => services.host.getSafeInsets());\n  useEffect(() => {\n    setInsets(services.host.getSafeInsets());\n    return services.host.subscribeSafeInsets((next) => setInsets(next));\n  }, [services.host]);\n\n  // System back: the active host of this provider first, then exit.\n  const onBack = useStableCallback(() => {\n    const host = g9Hosts.active();\n    if (host && host.services === services && host.back.dispatch() === 'handled') return;\n    services.host.exit();\n  });\n  useEffect(() => addGlobalListener(settings.backEventName, onBack), [settings.backEventName, onBack]);\n\n  const rootStyle = fallbackVariables ?? initialVariables;\n  const directionClass = culture.direction === 'rtl' ? 'g9-dir-rtl' : 'g9-dir-ltr';\n  return (\n    <G9CoreContext.Provider value={core}>\n      <G9DiagnosticsContext.Provider value={diagnostics}>\n        <G9SettingsContext.Provider value={settings}>\n          <G9CultureContext.Provider value={cultureValue}>\n            <G9KeyboardContext.Provider value={keyboard}>\n              <G9WindowContext.Provider value={windowState}>\n                <G9InsetsContext.Provider value={insets}>\n                  <view\n                    id={rootId}\n                    className={`g9-provider g9-theme-${initialScheme} ${directionClass}${props.className ? ` ${props.className}` : ''}`}\n                    style={rootStyle}\n                  >\n                    {props.children}\n                  </view>\n                </G9InsetsContext.Provider>\n              </G9WindowContext.Provider>\n            </G9KeyboardContext.Provider>\n          </G9CultureContext.Provider>\n        </G9SettingsContext.Provider>\n      </G9DiagnosticsContext.Provider>\n    </G9CoreContext.Provider>\n  );\n}\n"],"names":["THEME_PREFERENCE_KEY","THEME_MODES","providerSequence","isCultureStore","value","isThemeStore","initialWindow","info","globalThis","ratio","Object","HIDDEN_KEYBOARD","finite","Number","G9Provider","props","_props_diagnostics","_props_culture","services","persistTheme","assertRequiredCapabilities","ownDiagnostics","useState","createDiagnostics","diagnostics","iconFonts","createIconFontRegistry","settings","useMemo","resolveSettings","cultureProp","ownCulture","createCultureStore","cultureStore","useEffect","culture","useSyncExternalStore","strings","createStrings","cultureValue","themeProp","ownTheme","createThemeStore","themeStore","options","undefined","executorStrings","useRef","rootId","core","_executorSettings_showError","preferences","createPreferences","error","failure","executorSettings","executor","createSafeExecutor","key","request","presenter","g9DefaultErrorPresenter","initialVariables","toMetricCssVariables","toLayoutCssVariables","toCssVariables","initialScheme","applied","fallbackVariables","setFallbackVariables","apply","next","diff","changedVariables","applyThemeVariables","alive","save","lastMode","unsubscribe","theme","stored","keyboard","setKeyboard","addGlobalListener","status","height","compatHeight","windowState","setWindowState","width","current","insets","setInsets","onBack","useStableCallback","host","g9Hosts","rootStyle","directionClass","G9CoreContext","G9DiagnosticsContext","G9SettingsContext","G9CultureContext","G9KeyboardContext","G9WindowContext","G9InsetsContext","view"],"mappings":"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"}

package/dist/provider/settings.d.ts

@@ -0,0 +1,99 @@
+import { type G9DiagnosticsReport, type G9ErrorPopupRequest, type G9GlyphSlotOverrides, type G9GlyphSlots, type G9IconFontRegistry, type G9ImageSource, type G9SafeExecutorOptions, type G9StringsOptions } from '@g9tm/lynxcontrols-foundation';
+import type { ReactNode } from '@lynx-js/react';
+import { type G9PopupSettings } from '../popup/types.js';
+import { type G9SheetSettings } from '../sheet/options.js';
+/** The global event the native host sends for a system back press (Android back, desktop Escape). */
+export declare const g9DefaultBackEventName = "g9:back";
+/** App-wide page-loading cover settings (MAUI `G9PageLoadingOverlay` statics + `G9PageBase` timing defaults). */
+export interface G9PageLoadingSettings {
+    /** Cover colour (MAUI `BackgroundColorOverride`). Default: the theme's `Primary` (`var(--g9-primary)`). */
+    readonly backgroundColor?: string;
+    /** Spinner colour (MAUI `SpinnerColorOverride`). Default: the theme's `OnPrimary`. */
+    readonly spinnerColor?: string;
+    /** Delay after "ready" before the cover animates out (MAUI `PageLoadingDismissDelayMs`). Default 369. */
+    readonly dismissDelayMs?: number;
+    /** Hard cap from appearing to dismissal (MAUI `PageLoadingSafetyTimeoutMs`). Default 5000. */
+    readonly safetyTimeoutMs?: number;
+}
+/**
+ * Renders a bitmap icon at a box size (MAUI `G9ImageFactory.Factory`): the seam for a caching image element. The default
+ * is a plain Lynx `<image>` (`aspectFill`), or `<svg content>` for an `{ svg }` source.
+ */
+export type G9ImageRenderer = (source: G9ImageSource, size: number) => ReactNode;
+/**
+ * The error presenter used when the app sets no `executor.showError`: `@g9tm/lynxcontrols/popup` installs the error
+ * popup here when it loads (so the provider does not depend on the popup module).
+ */
+export declare const g9DefaultErrorPresenter: {
+    current: ((request: G9ErrorPopupRequest) => void | PromiseLike<void>) | null;
+};
+/** Settings of the shared safe executor (MAUI `G9SafeCommand` statics). */
+export interface G9ExecutorSettings {
+    readonly showError?: (request: G9ErrorPopupRequest) => void | PromiseLike<void>;
+    readonly diagnosticsHandler?: (report: G9DiagnosticsReport) => void | PromiseLike<void>;
+    readonly diagnosticsAvailable?: () => boolean;
+    readonly defaults?: G9SafeExecutorOptions;
+}
+/**
+ * App-wide configuration (plan/specs/03 §6): what MAUI configured through static helpers. Later work packages add
+ * their families here (`sheets`, `popups`, `toasts`, `fields`).
+ */
+export interface G9Settings {
+    /** String resolution (MAUI `G9Strings.UseProvider` / `Override`): everything but the culture. */
+    readonly strings?: Omit<G9StringsOptions, 'culture'>;
+    /** Replacements for the controls' own icons (MAUI `G9Glyphs.*` setters). */
+    readonly glyphs?: G9GlyphSlotOverrides;
+    /** The app's icon fonts (MAUI `G9IconFonts.Register`); default an empty registry. */
+    readonly iconFonts?: G9IconFontRegistry;
+    /** Bitmap icon renderer (MAUI `G9ImageFactory.Factory`). Default: {@link G9ImageRenderer}'s plain `<image>`. */
+    readonly imageRenderer?: G9ImageRenderer;
+    /** Name of the global back event (default {@link g9DefaultBackEventName}). */
+    readonly backEventName?: string;
+    /** Page-loading cover defaults for every `G9Host`. */
+    readonly pageLoading?: G9PageLoadingSettings;
+    /** The shared safe executor's popup, diagnostics surface and option defaults. */
+    readonly executor?: G9ExecutorSettings;
+    /**
+     * Pauses the app's background work while a view that asks for it is active (MAUI
+     * `G9ContentViewBase.BackgroundWorkSuppressionFactory`). Returns the release function, or nothing.
+     */
+    readonly backgroundWorkSuppression?: () => (() => void) | null | undefined;
+    /** Outlined-field defaults (MAUI `G9OutlinedFieldSettings`, set through `G9OutlinedFieldBase.Configure`). */
+    readonly fields?: G9FieldSettings;
+    /** Bottom-sheet defaults (MAUI `G9BottomSheetHelper.Configure(G9BottomSheetSettings)`). */
+    readonly sheets?: G9SheetSettings;
+    /** Popup defaults (MAUI `G9PopupHelper.ConfigureG9PopupDefaults`), merged under per-call settings. */
+    readonly popups?: G9PopupSettings;
+}
+/** App-wide outlined-field settings (MAUI `G9OutlinedFieldSettings`). */
+export interface G9FieldSettings {
+    /**
+     * Whether a field holding a value (unfocused, no error) draws its outline and floated label in the primary colour.
+     * Default `true` (MAUI `HighlightFilledValue`); a field's own `filledValueHighlight` overrides it (ADR-0025).
+     */
+    readonly highlightFilledValue?: boolean;
+}
+/** {@link G9Settings} with every default filled in. */
+export interface G9ResolvedSettings {
+    readonly strings: Omit<G9StringsOptions, 'culture'>;
+    readonly glyphs: G9GlyphSlots;
+    readonly iconFonts: G9IconFontRegistry;
+    readonly imageRenderer: G9ImageRenderer | undefined;
+    readonly backEventName: string;
+    readonly pageLoading: Required<G9PageLoadingSettings>;
+    readonly executor: G9ExecutorSettings;
+    readonly backgroundWorkSuppression: G9Settings['backgroundWorkSuppression'];
+    readonly fields: Required<G9FieldSettings>;
+    readonly sheets: Required<G9SheetSettings>;
+    readonly popups: G9PopupSettings;
+}
+/** MAUI `G9PageBase.PageLoadingDismissDelayMs` default. */
+export declare const g9PageLoadingDismissDelayMs = 369;
+/** MAUI `G9PageBase.PageLoadingSafetyTimeoutMs` default. */
+export declare const g9PageLoadingSafetyTimeoutMs = 5000;
+/**
+ * Validates `settings` and fills the defaults. Invalid values throw a `G9Error` (`settings-invalid`, or the
+ * foundation code for a malformed glyph slot) at provider mount rather than at first use.
+ */
+export declare function resolveSettings(settings: G9Settings | undefined, fallbackIconFonts?: G9IconFontRegistry): G9ResolvedSettings;
+//# sourceMappingURL=settings.d.ts.map

package/dist/provider/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/provider/settings.ts"],"names":[],"mappings":"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"}

package/dist/provider/settings.jsx

@@ -0,0 +1,45 @@
+import { G9Error, createIconFontRegistry, resolveGlyphSlots } from "@g9tm/lynxcontrols-foundation";
+import { createDefaultPopupSettings, mergePopupSettings } from "../popup/types.jsx";
+import { resolveSheetSettings } from "../sheet/options.jsx";
+const g9DefaultBackEventName = 'g9:back';
+const g9DefaultErrorPresenter = {
+    current: null
+};
+const g9PageLoadingDismissDelayMs = 369;
+const g9PageLoadingSafetyTimeoutMs = 5000;
+function nonNegative(name, value, fallback) {
+    if (void 0 === value) return fallback;
+    if ('number' != typeof value || !Number.isFinite(value) || value < 0) throw new G9Error('settings-invalid', `${name} must be a finite number of milliseconds ≥ 0 (got ${String(value)}).`);
+    return value;
+}
+function resolveSettings(settings, fallbackIconFonts) {
+    var _s_backEventName, _s_pageLoading, _s_strings, _ref, _s_iconFonts, _loading_backgroundColor, _loading_spinnerColor, _s_executor, _ref1;
+    var _s_fields;
+    const s = null != settings ? settings : {};
+    const backEventName = null != (_s_backEventName = s.backEventName) ? _s_backEventName : g9DefaultBackEventName;
+    if ('string' != typeof backEventName || '' === backEventName.trim()) throw new G9Error('settings-invalid', 'backEventName must be a non-blank string.');
+    const loading = null != (_s_pageLoading = s.pageLoading) ? _s_pageLoading : {};
+    return Object.freeze({
+        strings: null != (_s_strings = s.strings) ? _s_strings : {},
+        glyphs: resolveGlyphSlots(s.glyphs),
+        iconFonts: null != (_ref = null != (_s_iconFonts = s.iconFonts) ? _s_iconFonts : fallbackIconFonts) ? _ref : createIconFontRegistry(),
+        imageRenderer: s.imageRenderer,
+        backEventName,
+        pageLoading: Object.freeze({
+            backgroundColor: null != (_loading_backgroundColor = loading.backgroundColor) ? _loading_backgroundColor : 'var(--g9-primary)',
+            spinnerColor: null != (_loading_spinnerColor = loading.spinnerColor) ? _loading_spinnerColor : 'var(--g9-on-primary)',
+            dismissDelayMs: nonNegative('pageLoading.dismissDelayMs', loading.dismissDelayMs, g9PageLoadingDismissDelayMs),
+            safetyTimeoutMs: nonNegative('pageLoading.safetyTimeoutMs', loading.safetyTimeoutMs, g9PageLoadingSafetyTimeoutMs)
+        }),
+        executor: null != (_s_executor = s.executor) ? _s_executor : {},
+        backgroundWorkSuppression: s.backgroundWorkSuppression,
+        fields: Object.freeze({
+            highlightFilledValue: null != (_ref1 = null == (_s_fields = s.fields) ? void 0 : _s_fields.highlightFilledValue) ? _ref1 : true
+        }),
+        sheets: resolveSheetSettings(s.sheets),
+        popups: Object.freeze(mergePopupSettings(s.popups, createDefaultPopupSettings()))
+    });
+}
+export { g9DefaultBackEventName, g9DefaultErrorPresenter, g9PageLoadingDismissDelayMs, g9PageLoadingSafetyTimeoutMs, resolveSettings };
+
+//# sourceMappingURL=settings.jsx.map

package/dist/provider/settings.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/settings.jsx","sources":["../../src/provider/settings.ts"],"sourcesContent":["import {\n  createIconFontRegistry,\n  type G9DiagnosticsReport,\n  G9Error,\n  type G9ErrorPopupRequest,\n  type G9GlyphSlotOverrides,\n  type G9GlyphSlots,\n  type G9IconFontRegistry,\n  type G9ImageSource,\n  type G9SafeExecutorOptions,\n  type G9StringsOptions,\n  resolveGlyphSlots,\n} from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\nimport { createDefaultPopupSettings, type G9PopupSettings, mergePopupSettings } from '../popup/types';\nimport { type G9SheetSettings, resolveSheetSettings } from '../sheet/options';\n\n/** The global event the native host sends for a system back press (Android back, desktop Escape). */\nexport const g9DefaultBackEventName = 'g9:back';\n\n/** App-wide page-loading cover settings (MAUI `G9PageLoadingOverlay` statics + `G9PageBase` timing defaults). */\nexport interface G9PageLoadingSettings {\n  /** Cover colour (MAUI `BackgroundColorOverride`). Default: the theme's `Primary` (`var(--g9-primary)`). */\n  readonly backgroundColor?: string;\n  /** Spinner colour (MAUI `SpinnerColorOverride`). Default: the theme's `OnPrimary`. */\n  readonly spinnerColor?: string;\n  /** Delay after \"ready\" before the cover animates out (MAUI `PageLoadingDismissDelayMs`). Default 369. */\n  readonly dismissDelayMs?: number;\n  /** Hard cap from appearing to dismissal (MAUI `PageLoadingSafetyTimeoutMs`). Default 5000. */\n  readonly safetyTimeoutMs?: number;\n}\n\n/**\n * Renders a bitmap icon at a box size (MAUI `G9ImageFactory.Factory`): the seam for a caching image element. The default\n * is a plain Lynx `<image>` (`aspectFill`), or `<svg content>` for an `{ svg }` source.\n */\nexport type G9ImageRenderer = (source: G9ImageSource, size: number) => ReactNode;\n\n/**\n * The error presenter used when the app sets no `executor.showError`: `@g9tm/lynxcontrols/popup` installs the error\n * popup here when it loads (so the provider does not depend on the popup module).\n */\nexport const g9DefaultErrorPresenter: {\n  current: ((request: G9ErrorPopupRequest) => void | PromiseLike<void>) | null;\n} = { current: null };\n\n/** Settings of the shared safe executor (MAUI `G9SafeCommand` statics). */\nexport interface G9ExecutorSettings {\n  readonly showError?: (request: G9ErrorPopupRequest) => void | PromiseLike<void>;\n  readonly diagnosticsHandler?: (report: G9DiagnosticsReport) => void | PromiseLike<void>;\n  readonly diagnosticsAvailable?: () => boolean;\n  readonly defaults?: G9SafeExecutorOptions;\n}\n\n/**\n * App-wide configuration (plan/specs/03 §6): what MAUI configured through static helpers. Later work packages add\n * their families here (`sheets`, `popups`, `toasts`, `fields`).\n */\nexport interface G9Settings {\n  /** String resolution (MAUI `G9Strings.UseProvider` / `Override`): everything but the culture. */\n  readonly strings?: Omit<G9StringsOptions, 'culture'>;\n  /** Replacements for the controls' own icons (MAUI `G9Glyphs.*` setters). */\n  readonly glyphs?: G9GlyphSlotOverrides;\n  /** The app's icon fonts (MAUI `G9IconFonts.Register`); default an empty registry. */\n  readonly iconFonts?: G9IconFontRegistry;\n  /** Bitmap icon renderer (MAUI `G9ImageFactory.Factory`). Default: {@link G9ImageRenderer}'s plain `<image>`. */\n  readonly imageRenderer?: G9ImageRenderer;\n  /** Name of the global back event (default {@link g9DefaultBackEventName}). */\n  readonly backEventName?: string;\n  /** Page-loading cover defaults for every `G9Host`. */\n  readonly pageLoading?: G9PageLoadingSettings;\n  /** The shared safe executor's popup, diagnostics surface and option defaults. */\n  readonly executor?: G9ExecutorSettings;\n  /**\n   * Pauses the app's background work while a view that asks for it is active (MAUI\n   * `G9ContentViewBase.BackgroundWorkSuppressionFactory`). Returns the release function, or nothing.\n   */\n  readonly backgroundWorkSuppression?: () => (() => void) | null | undefined;\n  /** Outlined-field defaults (MAUI `G9OutlinedFieldSettings`, set through `G9OutlinedFieldBase.Configure`). */\n  readonly fields?: G9FieldSettings;\n  /** Bottom-sheet defaults (MAUI `G9BottomSheetHelper.Configure(G9BottomSheetSettings)`). */\n  readonly sheets?: G9SheetSettings;\n  /** Popup defaults (MAUI `G9PopupHelper.ConfigureG9PopupDefaults`), merged under per-call settings. */\n  readonly popups?: G9PopupSettings;\n}\n\n/** App-wide outlined-field settings (MAUI `G9OutlinedFieldSettings`). */\nexport interface G9FieldSettings {\n  /**\n   * Whether a field holding a value (unfocused, no error) draws its outline and floated label in the primary colour.\n   * Default `true` (MAUI `HighlightFilledValue`); a field's own `filledValueHighlight` overrides it (ADR-0025).\n   */\n  readonly highlightFilledValue?: boolean;\n}\n\n/** {@link G9Settings} with every default filled in. */\nexport interface G9ResolvedSettings {\n  readonly strings: Omit<G9StringsOptions, 'culture'>;\n  readonly glyphs: G9GlyphSlots;\n  readonly iconFonts: G9IconFontRegistry;\n  readonly imageRenderer: G9ImageRenderer | undefined;\n  readonly backEventName: string;\n  readonly pageLoading: Required<G9PageLoadingSettings>;\n  readonly executor: G9ExecutorSettings;\n  readonly backgroundWorkSuppression: G9Settings['backgroundWorkSuppression'];\n  readonly fields: Required<G9FieldSettings>;\n  readonly sheets: Required<G9SheetSettings>;\n  readonly popups: G9PopupSettings;\n}\n\n/** MAUI `G9PageBase.PageLoadingDismissDelayMs` default. */\nexport const g9PageLoadingDismissDelayMs = 369;\n/** MAUI `G9PageBase.PageLoadingSafetyTimeoutMs` default. */\nexport const g9PageLoadingSafetyTimeoutMs = 5000;\n\nfunction nonNegative(name: string, value: number | undefined, fallback: number): number {\n  if (value === undefined) return fallback;\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {\n    throw new G9Error(\n      'settings-invalid',\n      `${name} must be a finite number of milliseconds ≥ 0 (got ${String(value)}).`,\n    );\n  }\n  return value;\n}\n\n/**\n * Validates `settings` and fills the defaults. Invalid values throw a `G9Error` (`settings-invalid`, or the\n * foundation code for a malformed glyph slot) at provider mount rather than at first use.\n */\nexport function resolveSettings(\n  settings: G9Settings | undefined,\n  fallbackIconFonts?: G9IconFontRegistry,\n): G9ResolvedSettings {\n  const s = settings ?? {};\n  const backEventName = s.backEventName ?? g9DefaultBackEventName;\n  if (typeof backEventName !== 'string' || backEventName.trim() === '') {\n    throw new G9Error('settings-invalid', 'backEventName must be a non-blank string.');\n  }\n  const loading = s.pageLoading ?? {};\n  return Object.freeze({\n    strings: s.strings ?? {},\n    glyphs: resolveGlyphSlots(s.glyphs),\n    iconFonts: s.iconFonts ?? fallbackIconFonts ?? createIconFontRegistry(),\n    imageRenderer: s.imageRenderer,\n    backEventName,\n    pageLoading: Object.freeze({\n      backgroundColor: loading.backgroundColor ?? 'var(--g9-primary)',\n      spinnerColor: loading.spinnerColor ?? 'var(--g9-on-primary)',\n      dismissDelayMs: nonNegative('pageLoading.dismissDelayMs', loading.dismissDelayMs, g9PageLoadingDismissDelayMs),\n      safetyTimeoutMs: nonNegative(\n        'pageLoading.safetyTimeoutMs',\n        loading.safetyTimeoutMs,\n        g9PageLoadingSafetyTimeoutMs,\n      ),\n    }),\n    executor: s.executor ?? {},\n    backgroundWorkSuppression: s.backgroundWorkSuppression,\n    fields: Object.freeze({ highlightFilledValue: s.fields?.highlightFilledValue ?? true }),\n    sheets: resolveSheetSettings(s.sheets),\n    popups: Object.freeze(mergePopupSettings(s.popups, createDefaultPopupSettings())),\n  });\n}\n"],"names":["g9DefaultBackEventName","g9DefaultErrorPresenter","g9PageLoadingDismissDelayMs","g9PageLoadingSafetyTimeoutMs","nonNegative","name","value","fallback","undefined","Number","G9Error","String","resolveSettings","settings","fallbackIconFonts","_s_backEventName","_s_pageLoading","_s_strings","_ref","_loading_backgroundColor","_loading_spinnerColor","_s_executor","_s_fields","s","backEventName","loading","Object","resolveGlyphSlots","createIconFontRegistry","resolveSheetSettings","mergePopupSettings","createDefaultPopupSettings"],"mappings":";;;AAkBO,MAAMA,yBAAyB;AAwB/B,MAAMC,0BAET;IAAE,SAAS;AAAK;AAmEb,MAAMC,8BAA8B;AAEpC,MAAMC,+BAA+B;AAE5C,SAASC,YAAYC,IAAY,EAAEC,KAAyB,EAAEC,QAAgB;IAC5E,IAAID,AAAUE,WAAVF,OAAqB,OAAOC;IAChC,IAAI,AAAiB,YAAjB,OAAOD,SAAsB,CAACG,OAAO,QAAQ,CAACH,UAAUA,QAAQ,GAClE,MAAM,IAAII,QACR,oBACA,GAAGL,KAAK,kDAAkD,EAAEM,OAAOL,OAAO,EAAE,CAAC;IAGjF,OAAOA;AACT;AAMO,SAASM,gBACdC,QAAgC,EAChCC,iBAAsC;QAGhBC,kBAINC,gBAELC,YAEEC,MAAAA,cAIQC,0BACHC,uBAQNC,aAAAA;QAEoCC;IAxBhD,MAAMC,IAAIV,QAAAA,WAAAA,WAAY,CAAC;IACvB,MAAMW,gBAAgB,QAAAT,CAAAA,mBAAAA,EAAE,aAAa,AAAD,IAAdA,mBAAmBf;IACzC,IAAI,AAAyB,YAAzB,OAAOwB,iBAA8BA,AAAyB,OAAzBA,cAAc,IAAI,IACzD,MAAM,IAAId,QAAQ,oBAAoB;IAExC,MAAMe,UAAU,QAAAT,CAAAA,iBAAAA,EAAE,WAAW,AAAD,IAAZA,iBAAiB,CAAC;IAClC,OAAOU,OAAO,MAAM,CAAC;QACnB,SAAS,QAAAT,CAAAA,aAAAA,EAAE,OAAO,AAAD,IAARA,aAAa,CAAC;QACvB,QAAQU,kBAAkBJ,EAAE,MAAM;QAClC,WAAW,QAAAL,CAAAA,OAAAA,QAAAA,CAAAA,eAAAA,EAAE,SAAS,AAAD,IAAVA,eAAeJ,iBAAgB,IAA/BI,OAAoCU;QAC/C,eAAeL,EAAE,aAAa;QAC9BC;QACA,aAAaE,OAAO,MAAM,CAAC;YACzB,iBAAiB,QAAAP,CAAAA,2BAAAA,QAAQ,eAAe,AAAD,IAAtBA,2BAA2B;YAC5C,cAAc,QAAAC,CAAAA,wBAAAA,QAAQ,YAAY,AAAD,IAAnBA,wBAAwB;YACtC,gBAAgBhB,YAAY,8BAA8BqB,QAAQ,cAAc,EAAEvB;YAClF,iBAAiBE,YACf,+BACAqB,QAAQ,eAAe,EACvBtB;QAEJ;QACA,UAAU,QAAAkB,CAAAA,cAAAA,EAAE,QAAQ,AAAD,IAATA,cAAc,CAAC;QACzB,2BAA2BE,EAAE,yBAAyB;QACtD,QAAQG,OAAO,MAAM,CAAC;YAAE,sBAAsB,QAAF,iBAAEJ,CAAAA,YAAAA,EAAE,MAAM,AAAD,IAAPA,KAAAA,IAAAA,UAAU,oBAAoB,AAAD,IAAC,QAAI;QAAK;QACrF,QAAQO,qBAAqBN,EAAE,MAAM;QACrC,QAAQG,OAAO,MAAM,CAACI,mBAAmBP,EAAE,MAAM,EAAEQ;IACrD;AACF"}

package/dist/provider/theme-css.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The stylesheet behind `theme.css`: the stock light and dark palettes as `.g9-theme-light` / `.g9-theme-dark`
+ * classes and the default metric and layout variables on `.g9-provider`.
+ *
+ * Why a stylesheet: the Lynx engine ignores custom properties written in an inline style object unless the page
+ * config `enableCSSInlineVariables` is on, which the ReactLynx toolchain does not expose (found in the Lynxtron window
+ * on Windows, 2026-10-05: inline `--x` unset, a class-declared `--x` and `setProperty({ '--x': … })` both inherit). So
+ * the provider's first frame takes its values from these classes, and the provider then writes every variable with
+ * `setProperty` (custom palettes, overrides, layout overrides, every later theme change).
+ */
+export declare function renderThemeStylesheet(): string;
+//# sourceMappingURL=theme-css.d.ts.map

package/dist/provider/theme-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-css.d.ts","sourceRoot":"","sources":["../../src/provider/theme-css.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C"}

package/dist/provider/theme-css.jsx

@@ -0,0 +1,19 @@
+import { cssVariablesToText, g9DarkPalette, g9LightPalette, toCssVariables, toLayoutCssVariables, toMetricCssVariables } from "@g9tm/lynxcontrols-foundation";
+function renderThemeStylesheet() {
+    return [
+        '/* Generated by renderThemeStylesheet (src/provider/theme-css.ts); `npm run gen:theme-css` rewrites it. */',
+        cssVariablesToText(toCssVariables({
+            palette: g9LightPalette
+        }), '.g9-theme-light'),
+        cssVariablesToText(toCssVariables({
+            palette: g9DarkPalette
+        }), '.g9-theme-dark'),
+        cssVariablesToText({
+            ...toMetricCssVariables(),
+            ...toLayoutCssVariables()
+        }, '.g9-provider')
+    ].join('\n');
+}
+export { renderThemeStylesheet };
+
+//# sourceMappingURL=theme-css.jsx.map

package/dist/provider/theme-css.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/theme-css.jsx","sources":["../../src/provider/theme-css.ts"],"sourcesContent":["import {\n  cssVariablesToText,\n  g9DarkPalette,\n  g9LightPalette,\n  toCssVariables,\n  toLayoutCssVariables,\n  toMetricCssVariables,\n} from '@g9tm/lynxcontrols-foundation';\n\n/**\n * The stylesheet behind `theme.css`: the stock light and dark palettes as `.g9-theme-light` / `.g9-theme-dark`\n * classes and the default metric and layout variables on `.g9-provider`.\n *\n * Why a stylesheet: the Lynx engine ignores custom properties written in an inline style object unless the page\n * config `enableCSSInlineVariables` is on, which the ReactLynx toolchain does not expose (found in the Lynxtron window\n * on Windows, 2026-10-05: inline `--x` unset, a class-declared `--x` and `setProperty({ '--x': … })` both inherit). So\n * the provider's first frame takes its values from these classes, and the provider then writes every variable with\n * `setProperty` (custom palettes, overrides, layout overrides, every later theme change).\n */\nexport function renderThemeStylesheet(): string {\n  return [\n    '/* Generated by renderThemeStylesheet (src/provider/theme-css.ts); `npm run gen:theme-css` rewrites it. */',\n    cssVariablesToText(toCssVariables({ palette: g9LightPalette }), '.g9-theme-light'),\n    cssVariablesToText(toCssVariables({ palette: g9DarkPalette }), '.g9-theme-dark'),\n    cssVariablesToText({ ...toMetricCssVariables(), ...toLayoutCssVariables() }, '.g9-provider'),\n  ].join('\\n');\n}\n"],"names":["renderThemeStylesheet","cssVariablesToText","toCssVariables","g9LightPalette","g9DarkPalette","toMetricCssVariables","toLayoutCssVariables"],"mappings":";AAmBO,SAASA;IACd,OAAO;QACL;QACAC,mBAAmBC,eAAe;YAAE,SAASC;QAAe,IAAI;QAChEF,mBAAmBC,eAAe;YAAE,SAASE;QAAc,IAAI;QAC/DH,mBAAmB;YAAE,GAAGI,sBAAsB;YAAE,GAAGC,sBAAsB;QAAC,GAAG;KAC9E,CAAC,IAAI,CAAC;AACT"}

package/dist/provider/theme-root.d.ts

@@ -0,0 +1,10 @@
+import type { G9CssVariables } from '@g9tm/lynxcontrols-foundation';
+/** The variables of `next` whose value differs from `previous`, or `null` when nothing changed. */
+export declare function changedVariables(previous: G9CssVariables, next: G9CssVariables): G9CssVariables | null;
+/**
+ * Sets CSS variables on the element with `id` through the Lynx element API (`lynx.getElementById(id).setProperty`),
+ * which re-themes descendants without a React render (plan/specs/02 §2). Returns `false` when this runtime has no
+ * such API or element, so the caller can fall back to re-rendering the root's style.
+ */
+export declare function applyThemeVariables(id: string, variables: G9CssVariables): boolean;
+//# sourceMappingURL=theme-root.d.ts.map

package/dist/provider/theme-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-root.d.ts","sourceRoot":"","sources":["../../src/provider/theme-root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI,CAWtG;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAKlF"}

package/dist/provider/theme-root.jsx

@@ -0,0 +1,24 @@
+function changedVariables(previous, next) {
+    const diff = {};
+    let changed = false;
+    for (const name of Object.keys(next)){
+        const value = next[name];
+        if (previous[name] !== value) {
+            diff[name] = value;
+            changed = true;
+        }
+    }
+    return changed ? diff : null;
+}
+function applyThemeVariables(id, variables) {
+    var _lynx_getElementById, _lynx;
+    const element = null == (_lynx_getElementById = (_lynx = lynx).getElementById) ? void 0 : _lynx_getElementById.call(_lynx, id);
+    if (!element || 'function' != typeof element.setProperty) return false;
+    element.setProperty({
+        ...variables
+    });
+    return true;
+}
+export { applyThemeVariables, changedVariables };
+
+//# sourceMappingURL=theme-root.jsx.map

package/dist/provider/theme-root.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/theme-root.jsx","sources":["../../src/provider/theme-root.ts"],"sourcesContent":["import type { G9CssVariables } from '@g9tm/lynxcontrols-foundation';\n\n/** The variables of `next` whose value differs from `previous`, or `null` when nothing changed. */\nexport function changedVariables(previous: G9CssVariables, next: G9CssVariables): G9CssVariables | null {\n  const diff: Record<string, string> = {};\n  let changed = false;\n  for (const name of Object.keys(next)) {\n    const value = next[name] as string;\n    if (previous[name] !== value) {\n      diff[name] = value;\n      changed = true;\n    }\n  }\n  return changed ? diff : null;\n}\n\ninterface ElementApi {\n  getElementById?: (id: string) => { setProperty?: (props: Record<string, string>) => void } | null | undefined;\n}\n\n/**\n * Sets CSS variables on the element with `id` through the Lynx element API (`lynx.getElementById(id).setProperty`),\n * which re-themes descendants without a React render (plan/specs/02 §2). Returns `false` when this runtime has no\n * such API or element, so the caller can fall back to re-rendering the root's style.\n */\nexport function applyThemeVariables(id: string, variables: G9CssVariables): boolean {\n  const element = (lynx as unknown as ElementApi).getElementById?.(id);\n  if (!element || typeof element.setProperty !== 'function') return false;\n  element.setProperty({ ...variables });\n  return true;\n}\n"],"names":["changedVariables","previous","next","diff","changed","name","Object","value","applyThemeVariables","id","variables","_lynx_getElementById","_lynx","element"],"mappings":"AAGO,SAASA,iBAAiBC,QAAwB,EAAEC,IAAoB;IAC7E,MAAMC,OAA+B,CAAC;IACtC,IAAIC,UAAU;IACd,KAAK,MAAMC,QAAQC,OAAO,IAAI,CAACJ,MAAO;QACpC,MAAMK,QAAQL,IAAI,CAACG,KAAK;QACxB,IAAIJ,QAAQ,CAACI,KAAK,KAAKE,OAAO;YAC5BJ,IAAI,CAACE,KAAK,GAAGE;YACbH,UAAU;QACZ;IACF;IACA,OAAOA,UAAUD,OAAO;AAC1B;AAWO,SAASK,oBAAoBC,EAAU,EAAEC,SAAyB;QACvDC,sBAACC;IAAjB,MAAMC,UAAU,QAAAF,CAAAA,uBAAAA,AAACC,CAAAA,QAAAA,IAAG,EAA4B,cAAc,AAAD,IAA7CD,KAAAA,IAAAA,qBAAAA,IAAAA,CAACC,OAAgDH;IACjE,IAAI,CAACI,WAAW,AAA+B,cAA/B,OAAOA,QAAQ,WAAW,EAAiB,OAAO;IAClEA,QAAQ,WAAW,CAAC;QAAE,GAAGH,SAAS;IAAC;IACnC,OAAO;AACT"}