@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/popup/types.jsx

@@ -0,0 +1,218 @@
+import { g9Token } from "@g9tm/lynxcontrols-foundation";
+const G9PopupType = {
+    Information: 'information',
+    Success: 'success',
+    Warning: 'warning',
+    Error: 'error',
+    Custom: 'custom'
+};
+const G9PopupAnimationType = {
+    None: 'none',
+    FadeIn: 'fadeIn',
+    SlideUp: 'slideUp',
+    Bounce: 'bounce',
+    ZoomIn: 'zoomIn',
+    DropIn: 'dropIn'
+};
+const G9PopupAnimationEasing = {
+    Linear: 'linear',
+    SinIn: 'sinIn',
+    SinOut: 'sinOut',
+    SinInOut: 'sinInOut',
+    CubicOut: 'cubicOut',
+    BounceOut: 'bounceOut'
+};
+const G9PopupFooterButtonLayout = {
+    Row: 'row',
+    Stacked: 'stacked'
+};
+const G9PopupAutoSizeMode = {
+    Both: 'both',
+    Height: 'height',
+    Width: 'width',
+    None: 'none'
+};
+const G9PopupOverlayMode = {
+    Transparent: 'transparent',
+    Blur: 'blur',
+    None: 'none'
+};
+const G9PopupBlurIntensity = {
+    None: 'none',
+    Light: 'light',
+    ExtraLight: 'extraLight',
+    Dark: 'dark',
+    ExtraDark: 'extraDark'
+};
+const G9PopupRelativePosition = {
+    AlignTop: 'alignTop',
+    AlignBottom: 'alignBottom',
+    AlignLeft: 'alignLeft',
+    AlignRight: 'alignRight',
+    AlignTopLeft: 'alignTopLeft',
+    AlignTopRight: 'alignTopRight',
+    AlignBottomLeft: 'alignBottomLeft',
+    AlignBottomRight: 'alignBottomRight',
+    AlignToLeftOf: 'alignToLeftOf',
+    AlignToRightOf: 'alignToRightOf',
+    AlignToTopOf: 'alignToTopOf',
+    AlignToBottomOf: 'alignToBottomOf'
+};
+const G9PopupResultAction = {
+    Close: 'close',
+    DoNothing: 'doNothing',
+    ShowNext: 'showNext'
+};
+const g9PopupResult = Object.freeze({
+    close: (afterClose)=>({
+            action: 'close',
+            nextPopup: null,
+            afterClose: null != afterClose ? afterClose : null
+        }),
+    noAction: ()=>({
+            action: 'doNothing',
+            nextPopup: null,
+            afterClose: null
+        }),
+    showNext: (descriptor)=>({
+            action: 'showNext',
+            nextPopup: descriptor,
+            afterClose: null
+        })
+});
+function closePopupButton(text) {
+    return {
+        text,
+        isPrimary: true
+    };
+}
+function createDefaultPopupSettings() {
+    return {
+        closeOnBackgroundClick: false,
+        closeOnBackButton: true,
+        animationDuration: 240,
+        animation: 'slideUp',
+        animationEasing: 'sinOut',
+        overlayMode: 'transparent',
+        autoCloseDuration: 0,
+        showHeader: true,
+        showFooter: true,
+        showCloseButton: false,
+        footerButtonLayout: 'row',
+        autoSizeMode: 'height',
+        padding: [
+            20,
+            16,
+            20,
+            12
+        ],
+        cornerRadius: 16,
+        overlayOpacity: 0.45
+    };
+}
+function mergePopupSettings(settings, defaults) {
+    const out = {
+        ...defaults
+    };
+    for (const [k, v] of Object.entries(null != settings ? settings : {}))if (null != v) out[k] = v;
+    return out;
+}
+function resolvePopupSettings(descriptor, defaults) {
+    var _ref, _ref1, _ref2;
+    var _descriptor_settings;
+    const merged = mergePopupSettings(descriptor.settings, defaults);
+    const animation = null != (_ref = null != (_ref1 = null != (_ref2 = null == (_descriptor_settings = descriptor.settings) ? void 0 : _descriptor_settings.animation) ? _ref2 : descriptor.animation) ? _ref1 : defaults.animation) ? _ref : 'slideUp';
+    return {
+        ...merged,
+        animation
+    };
+}
+function presetPopup(type, message, title, buttons, settings, animation = null) {
+    return {
+        type,
+        title: null != title ? title : null,
+        message,
+        content: null,
+        buttons: null != buttons ? buttons : [],
+        settings: null != settings ? settings : null,
+        animation
+    };
+}
+function customPopup(content, title, buttons, settings, animation = null, type = 'custom') {
+    return {
+        type,
+        title: null != title ? title : null,
+        message: null,
+        content,
+        buttons: null != buttons ? buttons : [],
+        settings: null != settings ? settings : null,
+        animation
+    };
+}
+const ACCENT = {
+    information: [
+        'Info',
+        'OnInfo'
+    ],
+    success: [
+        'Success',
+        'OnSuccess'
+    ],
+    warning: [
+        'Warning',
+        'OnWarning'
+    ],
+    error: [
+        'Error',
+        'OnError'
+    ],
+    custom: [
+        'Info',
+        'OnInfo'
+    ]
+};
+function createPopupVisualProfile(descriptor, settings, glyphs, semantic) {
+    var _settings_iconOverride, _settings_cardBackgroundColor, _settings_borderColor, _settings_titleColor, _settings_messageColor, _settings_overlayColor, _settings_overlayOpacity, _settings_width, _settings_height, _settings_cornerRadius, _settings_padding, _ref, _settings_animation, _settings_animationDuration;
+    const [accent, onAccent] = ACCENT[descriptor.type];
+    const icon = null != (_settings_iconOverride = settings.iconOverride) ? _settings_iconOverride : 'success' === descriptor.type ? glyphs.success : 'warning' === descriptor.type ? glyphs.warning : 'error' === descriptor.type ? glyphs.error : glyphs.info;
+    const kind = 'custom' === descriptor.type ? 'information' : descriptor.type;
+    return {
+        iconColor: g9Token(accent),
+        cardBackground: null != (_settings_cardBackgroundColor = settings.cardBackgroundColor) ? _settings_cardBackgroundColor : g9Token('Surface'),
+        borderColor: null != (_settings_borderColor = settings.borderColor) ? _settings_borderColor : g9Token('Surface'),
+        titleColor: null != (_settings_titleColor = settings.titleColor) ? _settings_titleColor : g9Token(accent),
+        messageColor: null != (_settings_messageColor = settings.messageColor) ? _settings_messageColor : g9Token('OnSurface'),
+        buttonBackground: g9Token(accent),
+        buttonTextColor: g9Token(onAccent),
+        overlayColor: null != (_settings_overlayColor = settings.overlayColor) ? _settings_overlayColor : g9Token('Scrim'),
+        overlayOpacity: null != (_settings_overlayOpacity = settings.overlayOpacity) ? _settings_overlayOpacity : 0.45,
+        width: null != (_settings_width = settings.width) ? _settings_width : null,
+        height: null != (_settings_height = settings.height) ? _settings_height : null,
+        cornerRadius: null != (_settings_cornerRadius = settings.cornerRadius) ? _settings_cornerRadius : 16,
+        padding: null != (_settings_padding = settings.padding) ? _settings_padding : [
+            20,
+            16,
+            20,
+            12
+        ],
+        icon,
+        animation: null != (_ref = null != (_settings_animation = settings.animation) ? _settings_animation : descriptor.animation) ? _ref : 'slideUp',
+        animationDuration: null != (_settings_animationDuration = settings.animationDuration) ? _settings_animationDuration : 300,
+        semanticIconDescription: semantic(kind)
+    };
+}
+function popupScrimOpacity(mode, opacity, blur) {
+    if ('none' === mode) return 0;
+    if ('blur' !== mode) return opacity;
+    const extra = {
+        none: 0,
+        light: 0.05,
+        extraLight: 0.1,
+        dark: 0.15,
+        extraDark: 0.2
+    }[blur];
+    return Math.min(1, opacity + extra);
+}
+export { G9PopupAnimationEasing, G9PopupAnimationType, G9PopupAutoSizeMode, G9PopupBlurIntensity, G9PopupFooterButtonLayout, G9PopupOverlayMode, G9PopupRelativePosition, G9PopupResultAction, G9PopupType, closePopupButton, createDefaultPopupSettings, createPopupVisualProfile, customPopup, g9PopupResult, mergePopupSettings, popupScrimOpacity, presetPopup, resolvePopupSettings };
+
+//# sourceMappingURL=types.jsx.map

package/dist/popup/types.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup/types.jsx","sources":["../../src/popup/types.ts"],"sourcesContent":["import type { G9ImageSource } from '@g9tm/lynxcontrols-foundation';\nimport { type G9ColorToken, g9Token } from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\nimport type { G9IconInput } from '../icon/icon';\n\n// Popup data types (MAUI `G9PopupType`, `G9PopupButton`, `G9PopupResult`, `G9PopupDescriptor`, `G9PopupSettings`,\n// `G9PopupVisualProfile` and the G9PopupView enums).\n\n/** Popup kind (MAUI `G9PopupType`): the accent, icon and semantics. */\nexport const G9PopupType = {\n  Information: 'information',\n  Success: 'success',\n  Warning: 'warning',\n  Error: 'error',\n  Custom: 'custom',\n} as const;\nexport type G9PopupType = (typeof G9PopupType)[keyof typeof G9PopupType];\n\n/** Card motion (MAUI `G9PopupAnimationType`). */\nexport const G9PopupAnimationType = {\n  None: 'none',\n  FadeIn: 'fadeIn',\n  SlideUp: 'slideUp',\n  Bounce: 'bounce',\n  ZoomIn: 'zoomIn',\n  DropIn: 'dropIn',\n} as const;\nexport type G9PopupAnimationType = (typeof G9PopupAnimationType)[keyof typeof G9PopupAnimationType];\n\n/** Easing of the card motion (MAUI `G9PopupViewAnimationEasing`). */\nexport const G9PopupAnimationEasing = {\n  Linear: 'linear',\n  SinIn: 'sinIn',\n  SinOut: 'sinOut',\n  SinInOut: 'sinInOut',\n  CubicOut: 'cubicOut',\n  BounceOut: 'bounceOut',\n} as const;\nexport type G9PopupAnimationEasing = (typeof G9PopupAnimationEasing)[keyof typeof G9PopupAnimationEasing];\n\n/** Footer arrangement (MAUI `G9PopupFooterButtonLayout`). */\nexport const G9PopupFooterButtonLayout = { Row: 'row', Stacked: 'stacked' } as const;\nexport type G9PopupFooterButtonLayout = (typeof G9PopupFooterButtonLayout)[keyof typeof G9PopupFooterButtonLayout];\n\n/** Card sizing (MAUI `G9PopupViewAutoSizeMode`). */\nexport const G9PopupAutoSizeMode = { Both: 'both', Height: 'height', Width: 'width', None: 'none' } as const;\nexport type G9PopupAutoSizeMode = (typeof G9PopupAutoSizeMode)[keyof typeof G9PopupAutoSizeMode];\n\n/** Scrim (MAUI `G9PopupViewOverlayMode`); `'none'` = non-modal (taps pass through to the page). */\nexport const G9PopupOverlayMode = { Transparent: 'transparent', Blur: 'blur', None: 'none' } as const;\nexport type G9PopupOverlayMode = (typeof G9PopupOverlayMode)[keyof typeof G9PopupOverlayMode];\n\n/** Blur strength (MAUI `G9PopupViewBlurIntensity`); G9 has no blur: it darkens the scrim (MAUI's fallback). */\nexport const G9PopupBlurIntensity = {\n  None: 'none',\n  Light: 'light',\n  ExtraLight: 'extraLight',\n  Dark: 'dark',\n  ExtraDark: 'extraDark',\n} as const;\nexport type G9PopupBlurIntensity = (typeof G9PopupBlurIntensity)[keyof typeof G9PopupBlurIntensity];\n\n/** Card placement against an anchor (MAUI `G9PopupViewRelativePosition`). */\nexport const G9PopupRelativePosition = {\n  AlignTop: 'alignTop',\n  AlignBottom: 'alignBottom',\n  AlignLeft: 'alignLeft',\n  AlignRight: 'alignRight',\n  AlignTopLeft: 'alignTopLeft',\n  AlignTopRight: 'alignTopRight',\n  AlignBottomLeft: 'alignBottomLeft',\n  AlignBottomRight: 'alignBottomRight',\n  AlignToLeftOf: 'alignToLeftOf',\n  AlignToRightOf: 'alignToRightOf',\n  AlignToTopOf: 'alignToTopOf',\n  AlignToBottomOf: 'alignToBottomOf',\n} as const;\nexport type G9PopupRelativePosition = (typeof G9PopupRelativePosition)[keyof typeof G9PopupRelativePosition];\n\n/** What happens after a button callback (MAUI `G9PopupResultAction`). */\nexport const G9PopupResultAction = { Close: 'close', DoNothing: 'doNothing', ShowNext: 'showNext' } as const;\nexport type G9PopupResultAction = (typeof G9PopupResultAction)[keyof typeof G9PopupResultAction];\n\n/** A button callback's answer (MAUI `G9PopupResult`). */\nexport interface G9PopupResult {\n  readonly action: G9PopupResultAction;\n  /** With `showNext`: the popup shown right after this one closes. */\n  readonly nextPopup: G9PopupDescriptor | null;\n  /** Runs after the close motion; the queue does not wait for it (a popup it requests shows at once). */\n  readonly afterClose: (() => unknown) | null;\n}\n\n/** Builders of {@link G9PopupResult} (MAUI `G9PopupResult.Close/NoAction/ShowNext`). */\nexport const g9PopupResult = Object.freeze({\n  close: (afterClose?: (() => unknown) | null): G9PopupResult => ({\n    action: 'close',\n    nextPopup: null,\n    afterClose: afterClose ?? null,\n  }),\n  noAction: (): G9PopupResult => ({ action: 'doNothing', nextPopup: null, afterClose: null }),\n  showNext: (descriptor: G9PopupDescriptor): G9PopupResult => ({\n    action: 'showNext',\n    nextPopup: descriptor,\n    afterClose: null,\n  }),\n});\n\n/** Abort state handed to a callback; `aborted` turns true when the popup was dismissed while it ran. */\nexport interface G9PopupCallbackContext {\n  readonly aborted: boolean;\n}\n\n/** A footer button (MAUI `G9PopupButton`). */\nexport interface G9PopupButton {\n  readonly text: string;\n  /** Runs once per tap (the footer gate); returning nothing closes the popup. */\n  readonly callback?: // biome-ignore lint/suspicious/noConfusingVoidType: a callback may return nothing (= close)\n  ((context: G9PopupCallbackContext) => G9PopupResult | void | Promise<G9PopupResult | void>) | null;\n  /** Filled accent button; false = outline. Default true (MAUI). */\n  readonly isPrimary?: boolean;\n  readonly icon?: G9IconInput;\n  readonly iconImage?: G9ImageSource | null;\n  readonly textColor?: string | null;\n  readonly backgroundColor?: string | null;\n  /** Test/automation id (MAUI `AutomationId`). */\n  readonly testId?: string | null;\n}\n\n/** A plain close button (MAUI `G9PopupButton.CloseButton(text)`). */\nexport function closePopupButton(text: string): G9PopupButton {\n  return { text, isPrimary: true };\n}\n\n/** Per-popup settings; every field optional, merged over the app defaults (MAUI `G9PopupSettings`). */\nexport interface G9PopupSettings {\n  readonly closeOnBackgroundClick?: boolean;\n  readonly closeOnBackButton?: boolean;\n  readonly animationDuration?: number;\n  readonly animation?: G9PopupAnimationType;\n  readonly animationEasing?: G9PopupAnimationEasing;\n  readonly autoSizeMode?: G9PopupAutoSizeMode;\n  readonly overlayMode?: G9PopupOverlayMode;\n  /** Close after this many ms (0 = never). */\n  readonly autoCloseDuration?: number;\n  readonly showHeader?: boolean;\n  readonly showFooter?: boolean;\n  readonly footerButtonLayout?: G9PopupFooterButtonLayout;\n  /** × in the header corner. */\n  readonly showCloseButton?: boolean;\n  readonly width?: number | null;\n  readonly height?: number | null;\n  /** `[left, top, right, bottom]` (physical, like MAUI `Thickness`). */\n  readonly padding?: readonly [number, number, number, number];\n  readonly cornerRadius?: number;\n  readonly overlayOpacity?: number;\n  readonly overlayColor?: string | null;\n  readonly cardBackgroundColor?: string | null;\n  readonly borderColor?: string | null;\n  readonly titleColor?: string | null;\n  readonly messageColor?: string | null;\n  readonly iconOverride?: G9IconInput;\n  readonly blurIntensity?: G9PopupBlurIntensity;\n}\n\n/** The library defaults (MAUI `G9PopupSettings.CreateDefault`). */\nexport function createDefaultPopupSettings(): Required<\n  Omit<\n    G9PopupSettings,\n    | 'width'\n    | 'height'\n    | 'overlayColor'\n    | 'cardBackgroundColor'\n    | 'borderColor'\n    | 'titleColor'\n    | 'messageColor'\n    | 'iconOverride'\n    | 'blurIntensity'\n  >\n> &\n  G9PopupSettings {\n  return {\n    closeOnBackgroundClick: false,\n    closeOnBackButton: true,\n    animationDuration: 240,\n    animation: 'slideUp',\n    animationEasing: 'sinOut',\n    overlayMode: 'transparent',\n    autoCloseDuration: 0,\n    showHeader: true,\n    showFooter: true,\n    showCloseButton: false,\n    footerButtonLayout: 'row',\n    autoSizeMode: 'height',\n    padding: [20, 16, 20, 12],\n    cornerRadius: 16,\n    overlayOpacity: 0.45,\n  };\n}\n\n/** Field by field, `settings` wins over `defaults` (MAUI `WithDefaults`). */\nexport function mergePopupSettings(\n  settings: G9PopupSettings | null | undefined,\n  defaults: G9PopupSettings,\n): G9PopupSettings {\n  const out: Record<string, unknown> = { ...defaults };\n  for (const [k, v] of Object.entries(settings ?? {})) if (v !== undefined && v !== null) out[k] = v;\n  return out as G9PopupSettings;\n}\n\n/**\n * The effective settings of a popup (MAUI `ResolveSettings`): per-call settings over the app defaults; the motion is\n * the per-call setting, else the descriptor's, else the app default (MAUI ignored a configured default animation\n * because every helper passed SlideUp explicitly; here it applies).\n */\nexport function resolvePopupSettings(descriptor: G9PopupDescriptor, defaults: G9PopupSettings): G9PopupSettings {\n  const merged = mergePopupSettings(descriptor.settings, defaults);\n  const animation = descriptor.settings?.animation ?? descriptor.animation ?? defaults.animation ?? 'slideUp';\n  return { ...merged, animation };\n}\n\n/** Popup body: a message or any content (MAUI `CustomView`). */\nexport interface G9PopupDescriptor {\n  readonly type: G9PopupType;\n  readonly title: string | null;\n  readonly message: string | null;\n  /** Custom body (built once per show; a factory is called when the card mounts). */\n  readonly content: ReactNode | (() => ReactNode) | null;\n  readonly buttons: ReadonlyArray<G9PopupButton>;\n  readonly settings: G9PopupSettings | null;\n  /** Motion of this popup; `null` = the settings' (per call, then app default). */\n  readonly animation: G9PopupAnimationType | null;\n}\n\n/** A preset popup (MAUI `G9PopupDescriptor.ForPreset`). */\nexport function presetPopup(\n  type: G9PopupType,\n  message: string,\n  title?: string | null,\n  buttons?: ReadonlyArray<G9PopupButton> | null,\n  settings?: G9PopupSettings | null,\n  animation: G9PopupAnimationType | null = null,\n): G9PopupDescriptor {\n  return {\n    type,\n    title: title ?? null,\n    message,\n    content: null,\n    buttons: buttons ?? [],\n    settings: settings ?? null,\n    animation,\n  };\n}\n\n/** A custom-content popup (MAUI `G9PopupDescriptor.ForCustom`). */\nexport function customPopup(\n  content: ReactNode | (() => ReactNode),\n  title?: string | null,\n  buttons?: ReadonlyArray<G9PopupButton> | null,\n  settings?: G9PopupSettings | null,\n  animation: G9PopupAnimationType | null = null,\n  type: G9PopupType = 'custom',\n): G9PopupDescriptor {\n  return {\n    type,\n    title: title ?? null,\n    message: null,\n    content,\n    buttons: buttons ?? [],\n    settings: settings ?? null,\n    animation,\n  };\n}\n\n/** Resolved look of one popup (MAUI `G9PopupVisualProfile`). */\nexport interface G9PopupVisualProfile {\n  readonly iconColor: string;\n  readonly cardBackground: string;\n  readonly borderColor: string;\n  readonly titleColor: string;\n  readonly messageColor: string;\n  readonly buttonBackground: string;\n  readonly buttonTextColor: string;\n  readonly overlayColor: string;\n  readonly overlayOpacity: number;\n  readonly width: number | null;\n  readonly height: number | null;\n  readonly cornerRadius: number;\n  readonly padding: readonly [number, number, number, number];\n  readonly icon: G9IconInput;\n  readonly animation: G9PopupAnimationType;\n  readonly animationDuration: number;\n  /** Localizable accessibility name of the type (`'Information'`, …). */\n  readonly semanticIconDescription: string;\n}\n\nconst ACCENT: Record<G9PopupType, [G9ColorToken, G9ColorToken]> = {\n  information: ['Info', 'OnInfo'],\n  success: ['Success', 'OnSuccess'],\n  warning: ['Warning', 'OnWarning'],\n  error: ['Error', 'OnError'],\n  custom: ['Info', 'OnInfo'],\n};\n\n/**\n * Resolves a popup's look (MAUI `G9PopupVisualProfile.Create`): each type takes its own semantic accent (never\n * Primary) for icon, title and the filled button, the button text takes the matching `On*` token, the scrim is the\n * `Scrim` token at `overlayOpacity`. Settings override colours, icon, size, radius, padding and motion.\n */\nexport function createPopupVisualProfile(\n  descriptor: G9PopupDescriptor,\n  settings: G9PopupSettings,\n  glyphs: {\n    readonly info: G9IconInput;\n    readonly success: G9IconInput;\n    readonly warning: G9IconInput;\n    readonly error: G9IconInput;\n  },\n  semantic: (type: 'information' | 'success' | 'warning' | 'error') => string,\n): G9PopupVisualProfile {\n  const [accent, onAccent] = ACCENT[descriptor.type];\n  const icon =\n    settings.iconOverride ??\n    (descriptor.type === 'success'\n      ? glyphs.success\n      : descriptor.type === 'warning'\n        ? glyphs.warning\n        : descriptor.type === 'error'\n          ? glyphs.error\n          : glyphs.info);\n  const kind = descriptor.type === 'custom' ? 'information' : descriptor.type;\n  return {\n    iconColor: g9Token(accent),\n    cardBackground: settings.cardBackgroundColor ?? g9Token('Surface'),\n    borderColor: settings.borderColor ?? g9Token('Surface'),\n    titleColor: settings.titleColor ?? g9Token(accent),\n    messageColor: settings.messageColor ?? g9Token('OnSurface'),\n    buttonBackground: g9Token(accent),\n    buttonTextColor: g9Token(onAccent),\n    overlayColor: settings.overlayColor ?? g9Token('Scrim'),\n    overlayOpacity: settings.overlayOpacity ?? 0.45,\n    width: settings.width ?? null,\n    height: settings.height ?? null,\n    cornerRadius: settings.cornerRadius ?? 16,\n    padding: settings.padding ?? [20, 16, 20, 12],\n    icon,\n    animation: settings.animation ?? descriptor.animation ?? 'slideUp',\n    animationDuration: settings.animationDuration ?? 300,\n    semanticIconDescription: semantic(kind),\n  };\n}\n\n/** The scrim opacity of a mode (MAUI `Blur` fallback: a darker scrim by intensity; `none` = no scrim). */\nexport function popupScrimOpacity(mode: G9PopupOverlayMode, opacity: number, blur: G9PopupBlurIntensity): number {\n  if (mode === 'none') return 0;\n  if (mode !== 'blur') return opacity;\n  const extra = { none: 0, light: 0.05, extraLight: 0.1, dark: 0.15, extraDark: 0.2 }[blur];\n  return Math.min(1, opacity + extra);\n}\n"],"names":["G9PopupType","G9PopupAnimationType","G9PopupAnimationEasing","G9PopupFooterButtonLayout","G9PopupAutoSizeMode","G9PopupOverlayMode","G9PopupBlurIntensity","G9PopupRelativePosition","G9PopupResultAction","g9PopupResult","Object","afterClose","descriptor","closePopupButton","text","createDefaultPopupSettings","mergePopupSettings","settings","defaults","out","k","v","resolvePopupSettings","_ref","merged","animation","presetPopup","type","message","title","buttons","customPopup","content","ACCENT","createPopupVisualProfile","glyphs","semantic","_settings_iconOverride","_settings_cardBackgroundColor","_settings_borderColor","_settings_titleColor","_settings_messageColor","_settings_overlayColor","_settings_overlayOpacity","_settings_width","_settings_height","_settings_cornerRadius","_settings_padding","_settings_animationDuration","accent","onAccent","icon","kind","g9Token","popupScrimOpacity","mode","opacity","blur","extra","Math"],"mappings":"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"}

package/dist/provider/contexts.d.ts

@@ -0,0 +1,41 @@
+import type { G9Capabilities, G9Culture, G9CultureStore, G9Diagnostics, G9Preferences, G9SafeExecutor, G9SafeInsets, G9Strings, G9ThemeStore } from '@g9tm/lynxcontrols-foundation';
+import type { G9ResolvedSettings } from './settings.js';
+/** What `useG9Culture` and `useG9Strings` read: the snapshot and the strings built for it. */
+export interface G9CultureContextValue {
+    readonly culture: G9Culture;
+    readonly strings: G9Strings;
+    readonly store: G9CultureStore;
+}
+/** Soft-keyboard state (plan/specs/02 §4 `keyboardstatuschanged`). Heights are in the units the platform reports. */
+export interface G9KeyboardState {
+    /** `true` between a `'on'` and the next `'off'`. */
+    readonly visible: boolean;
+    /** Keyboard height; `0` while hidden. */
+    readonly height: number;
+    /** The platform's compatibility height (Lynx `compatHeight`); `0` while hidden or when not reported. */
+    readonly compatHeight: number;
+}
+/** Window size in logical pixels (MAUI `G9ScreenHelper.WidthInDip` / `HeightInDip`). */
+export interface G9WindowState {
+    readonly width: number;
+    readonly height: number;
+}
+/** Everything a provider shares that never changes identity while it is mounted. */
+export interface G9ProviderCore {
+    readonly services: G9Capabilities;
+    readonly themeStore: G9ThemeStore;
+    readonly preferences: G9Preferences;
+    readonly diagnostics: G9Diagnostics;
+    readonly executor: G9SafeExecutor;
+    /** Id of the provider's root `<view>` (the element carrying the theme variables). */
+    readonly rootId: string;
+}
+export declare const G9CoreContext: import("react").Context<G9ProviderCore | null>;
+export declare const G9CultureContext: import("react").Context<G9CultureContextValue | null>;
+export declare const G9SettingsContext: import("react").Context<G9ResolvedSettings | null>;
+export declare const G9KeyboardContext: import("react").Context<G9KeyboardState | null>;
+export declare const G9WindowContext: import("react").Context<G9WindowState | null>;
+export declare const G9InsetsContext: import("react").Context<G9SafeInsets | null>;
+/** The provider's diagnostics hub, or `null` outside a provider (base hooks fall back to `console`). */
+export declare const G9DiagnosticsContext: import("react").Context<G9Diagnostics | null>;
+//# sourceMappingURL=contexts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/provider/contexts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EACT,YAAY,EACb,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,qHAAqH;AACrH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,aAAa,gDAA6C,CAAC;AACxE,eAAO,MAAM,gBAAgB,uDAAoD,CAAC;AAClF,eAAO,MAAM,iBAAiB,oDAAiD,CAAC;AAChF,eAAO,MAAM,iBAAiB,iDAA8C,CAAC;AAC7E,eAAO,MAAM,eAAe,+CAA4C,CAAC;AACzE,eAAO,MAAM,eAAe,8CAA2C,CAAC;AACxE,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,+CAA4C,CAAC"}

package/dist/provider/contexts.jsx

@@ -0,0 +1,11 @@
+import { createContext } from "@lynx-js/react";
+const G9CoreContext = createContext(null);
+const G9CultureContext = createContext(null);
+const G9SettingsContext = createContext(null);
+const G9KeyboardContext = createContext(null);
+const G9WindowContext = createContext(null);
+const G9InsetsContext = createContext(null);
+const G9DiagnosticsContext = createContext(null);
+export { G9CoreContext, G9CultureContext, G9DiagnosticsContext, G9InsetsContext, G9KeyboardContext, G9SettingsContext, G9WindowContext };
+
+//# sourceMappingURL=contexts.jsx.map

package/dist/provider/contexts.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/contexts.jsx","sources":["../../src/provider/contexts.ts"],"sourcesContent":["// React contexts behind G9Provider. One context per kind of change, so a consumer re-renders only for what it reads:\n// the theme store and services never change identity, culture changes re-render culture readers, keyboard and window\n// changes re-render only their readers (plan/specs/01 §5).\n\nimport type {\n  G9Capabilities,\n  G9Culture,\n  G9CultureStore,\n  G9Diagnostics,\n  G9Preferences,\n  G9SafeExecutor,\n  G9SafeInsets,\n  G9Strings,\n  G9ThemeStore,\n} from '@g9tm/lynxcontrols-foundation';\nimport { createContext } from '@lynx-js/react';\nimport type { G9ResolvedSettings } from './settings';\n\n/** What `useG9Culture` and `useG9Strings` read: the snapshot and the strings built for it. */\nexport interface G9CultureContextValue {\n  readonly culture: G9Culture;\n  readonly strings: G9Strings;\n  readonly store: G9CultureStore;\n}\n\n/** Soft-keyboard state (plan/specs/02 §4 `keyboardstatuschanged`). Heights are in the units the platform reports. */\nexport interface G9KeyboardState {\n  /** `true` between a `'on'` and the next `'off'`. */\n  readonly visible: boolean;\n  /** Keyboard height; `0` while hidden. */\n  readonly height: number;\n  /** The platform's compatibility height (Lynx `compatHeight`); `0` while hidden or when not reported. */\n  readonly compatHeight: number;\n}\n\n/** Window size in logical pixels (MAUI `G9ScreenHelper.WidthInDip` / `HeightInDip`). */\nexport interface G9WindowState {\n  readonly width: number;\n  readonly height: number;\n}\n\n/** Everything a provider shares that never changes identity while it is mounted. */\nexport interface G9ProviderCore {\n  readonly services: G9Capabilities;\n  readonly themeStore: G9ThemeStore;\n  readonly preferences: G9Preferences;\n  readonly diagnostics: G9Diagnostics;\n  readonly executor: G9SafeExecutor;\n  /** Id of the provider's root `<view>` (the element carrying the theme variables). */\n  readonly rootId: string;\n}\n\nexport const G9CoreContext = createContext<G9ProviderCore | null>(null);\nexport const G9CultureContext = createContext<G9CultureContextValue | null>(null);\nexport const G9SettingsContext = createContext<G9ResolvedSettings | null>(null);\nexport const G9KeyboardContext = createContext<G9KeyboardState | null>(null);\nexport const G9WindowContext = createContext<G9WindowState | null>(null);\nexport const G9InsetsContext = createContext<G9SafeInsets | null>(null);\n/** The provider's diagnostics hub, or `null` outside a provider (base hooks fall back to `console`). */\nexport const G9DiagnosticsContext = createContext<G9Diagnostics | null>(null);\n"],"names":["G9CoreContext","createContext","G9CultureContext","G9SettingsContext","G9KeyboardContext","G9WindowContext","G9InsetsContext","G9DiagnosticsContext"],"mappings":";AAoDO,MAAMA,gBAAgBC,cAAqC;AAC3D,MAAMC,mBAAmBD,cAA4C;AACrE,MAAME,oBAAoBF,cAAyC;AACnE,MAAMG,oBAAoBH,cAAsC;AAChE,MAAMI,kBAAkBJ,cAAoC;AAC5D,MAAMK,kBAAkBL,cAAmC;AAE3D,MAAMM,uBAAuBN,cAAoC"}

package/dist/provider/global-events.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adds a global event listener; returns the function that removes exactly it. A host that cannot provide the event
+ * does not take the app down: the Lynx core enables keyboard detection through a native module when a
+ * `keyboardstatuschanged` listener is added, and a windowless Lynxtron has no such module (it throws). Then
+ * `onUnavailable` is told and the event simply never arrives.
+ */
+export declare function addGlobalListener<TArgs extends unknown[]>(name: string, listener: (...args: TArgs) => void, onUnavailable?: (error: unknown) => void): () => void;
+//# sourceMappingURL=global-events.d.ts.map

package/dist/provider/global-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-events.d.ts","sourceRoot":"","sources":["../../src/provider/global-events.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,OAAO,EAAE,EACvD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAClC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACvC,MAAM,IAAI,CAUZ"}

package/dist/provider/global-events.jsx

@@ -0,0 +1,17 @@
+function emitter() {
+    return lynx.getJSModule('GlobalEventEmitter');
+}
+function addGlobalListener(name, listener, onUnavailable) {
+    const target = emitter();
+    const handler = listener;
+    try {
+        target.addListener(name, handler);
+    } catch (error) {
+        null == onUnavailable || onUnavailable(error);
+        return ()=>{};
+    }
+    return ()=>target.removeListener(name, handler);
+}
+export { addGlobalListener };
+
+//# sourceMappingURL=global-events.jsx.map

package/dist/provider/global-events.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/global-events.jsx","sources":["../../src/provider/global-events.ts"],"sourcesContent":["// Lynx global events (plan/specs/02 §4): `keyboardstatuschanged`, `onWindowResize`, and the host's back event arrive\n// through the `GlobalEventEmitter` JS module on the background thread.\n\ninterface GlobalEventEmitter {\n  addListener(name: string, listener: (...args: never[]) => void): void;\n  removeListener(name: string, listener: (...args: never[]) => void): void;\n}\n\nfunction emitter(): GlobalEventEmitter {\n  return lynx.getJSModule('GlobalEventEmitter') as unknown as GlobalEventEmitter;\n}\n\n/**\n * Adds a global event listener; returns the function that removes exactly it. A host that cannot provide the event\n * does not take the app down: the Lynx core enables keyboard detection through a native module when a\n * `keyboardstatuschanged` listener is added, and a windowless Lynxtron has no such module (it throws). Then\n * `onUnavailable` is told and the event simply never arrives.\n */\nexport function addGlobalListener<TArgs extends unknown[]>(\n  name: string,\n  listener: (...args: TArgs) => void,\n  onUnavailable?: (error: unknown) => void,\n): () => void {\n  const target = emitter();\n  const handler = listener as unknown as (...args: never[]) => void;\n  try {\n    target.addListener(name, handler);\n  } catch (error) {\n    onUnavailable?.(error);\n    return () => {};\n  }\n  return () => target.removeListener(name, handler);\n}\n"],"names":["emitter","lynx","addGlobalListener","name","listener","onUnavailable","target","handler","error"],"mappings":"AAQA,SAASA;IACP,OAAOC,KAAK,WAAW,CAAC;AAC1B;AAQO,SAASC,kBACdC,IAAY,EACZC,QAAkC,EAClCC,aAAwC;IAExC,MAAMC,SAASN;IACf,MAAMO,UAAUH;IAChB,IAAI;QACFE,OAAO,WAAW,CAACH,MAAMI;IAC3B,EAAE,OAAOC,OAAO;QACdH,QAAAA,iBAAAA,cAAgBG;QAChB,OAAO,KAAO;IAChB;IACA,OAAO,IAAMF,OAAO,cAAc,CAACH,MAAMI;AAC3C"}

package/dist/provider/hooks.d.ts

@@ -0,0 +1,49 @@
+import { type G9Capabilities, type G9CapabilityName, type G9Culture, type G9CultureStore, type G9Diagnostics, type G9Direction, type G9Preferences, type G9ResolvedTheme, type G9SafeExecutor, type G9SafeInsets, type G9Strings, type G9ThemeStore } from '@g9tm/lynxcontrols-foundation';
+import { type G9KeyboardState, type G9ProviderCore, type G9WindowState } from './contexts.js';
+import type { G9ResolvedSettings } from './settings.js';
+/** The provider's shared core (services, stores, executor). Throws `provider-missing` outside a provider. */
+export declare function useG9Core(): G9ProviderCore;
+/** The active culture (MAUI `G9Culture.CurrentCulture`). Re-renders when it changes. */
+export declare function useG9Culture(): G9Culture;
+/** The culture's layout direction; every G9 component root sets it explicitly (plan/specs/02 §2). */
+export declare function useG9Direction(): G9Direction;
+/** The strings of the active culture (MAUI `G9Strings`). Re-renders when culture or string settings change. */
+export declare function useG9Strings(): G9Strings;
+/** The culture store, to switch culture (MAUI `G9Culture.Configure` / `SetCulture`). Does not re-render. */
+export declare function useG9CultureStore(): G9CultureStore;
+/**
+ * The resolved theme (scheme and palette). Only components that call this re-render on a theme change; everything
+ * else follows through CSS variables.
+ */
+export declare function useG9Theme(): G9ResolvedTheme;
+/** The theme store, to switch mode or palettes (MAUI `G9Theme.ChangeTheme`). Does not re-render. */
+export declare function useG9ThemeStore(): G9ThemeStore;
+/** The app-wide settings with defaults filled in. */
+export declare function useG9Settings(): G9ResolvedSettings;
+/**
+ * A service the component cannot work without (MAUI `G9ServiceProvider.GetService<T>`).
+ * @throws {G9CapabilityMissingError} naming it when the app did not supply it.
+ */
+export declare function useG9Service<K extends G9CapabilityName>(name: K): NonNullable<G9Capabilities[K]>;
+/** An optional service, or `undefined` (MAUI `GetServiceNullable<T>`): features hide themselves without it. */
+export declare function useG9OptionalService<K extends G9CapabilityName>(name: K): G9Capabilities[K] | undefined;
+/** Whether the app supplied the capability. */
+export declare function useG9Capability(name: G9CapabilityName): boolean;
+/** The provider's diagnostics hub. */
+export declare function useG9Diagnostics(): G9Diagnostics;
+/** The provider's preferences (namespace `g9controls.`). */
+export declare function useG9Preferences(): G9Preferences;
+/** The provider's shared safe executor (MAUI `G9SafeCommand`): one throttle/concurrency table per app. */
+export declare function useG9Executor(): G9SafeExecutor;
+/** Soft-keyboard state `{ visible, height, compatHeight }`; re-renders only its readers. */
+export declare function useG9Keyboard(): G9KeyboardState;
+/** Window size and the MAUI `G9ScreenHelper.CanFit` test. */
+export interface G9WindowInfo extends G9WindowState {
+    /** `true` when the window is at least `width` logical pixels wide. */
+    canFit(width: number): boolean;
+}
+/** The window size (MAUI `G9ScreenHelper`); re-renders on `onWindowResize`. */
+export declare function useG9Window(): G9WindowInfo;
+/** The platform safe-area insets from the host service; re-renders when they change. */
+export declare function useG9SafeInsets(): G9SafeInsets;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/provider/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EAGlB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,cAAc,EAGnB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAYrD,6GAA6G;AAC7G,wBAAgB,SAAS,IAAI,cAAc,CAE1C;AAED,wFAAwF;AACxF,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,+GAA+G;AAC/G,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,4GAA4G;AAC5G,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAG5C;AAED,oGAAoG;AACpG,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,qDAAqD;AACrD,wBAAgB,aAAa,IAAI,kBAAkB,CAElD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAEhG;AAED,+GAA+G;AAC/G,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAGvG;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE/D;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,0GAA0G;AAC1G,wBAAgB,aAAa,IAAI,cAAc,CAE9C;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI,YAAY,CAG1C;AAED,wFAAwF;AACxF,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}

package/dist/provider/hooks.jsx

@@ -0,0 +1,72 @@
+import { G9Error, hasCapability, requireCapability } from "@g9tm/lynxcontrols-foundation";
+import { useContext, useSyncExternalStore } from "@lynx-js/react";
+import { G9CoreContext, G9CultureContext, G9InsetsContext, G9KeyboardContext, G9SettingsContext, G9WindowContext } from "./contexts.jsx";
+function missing(hook) {
+    return new G9Error('provider-missing', `${hook} must be used inside <G9Provider>.`);
+}
+function useRequired(context, hook) {
+    const value = useContext(context);
+    if (null === value) throw missing(hook);
+    return value;
+}
+function useG9Core() {
+    return useRequired(G9CoreContext, 'useG9Core');
+}
+function useG9Culture() {
+    return useRequired(G9CultureContext, 'useG9Culture').culture;
+}
+function useG9Direction() {
+    return useRequired(G9CultureContext, 'useG9Direction').culture.direction;
+}
+function useG9Strings() {
+    return useRequired(G9CultureContext, 'useG9Strings').strings;
+}
+function useG9CultureStore() {
+    return useRequired(G9CultureContext, 'useG9CultureStore').store;
+}
+function useG9Theme() {
+    const store = useRequired(G9CoreContext, 'useG9Theme').themeStore;
+    return useSyncExternalStore(store.subscribe, store.getSnapshot);
+}
+function useG9ThemeStore() {
+    return useRequired(G9CoreContext, 'useG9ThemeStore').themeStore;
+}
+function useG9Settings() {
+    return useRequired(G9SettingsContext, 'useG9Settings');
+}
+function useG9Service(name) {
+    return requireCapability(useG9Core().services, name);
+}
+function useG9OptionalService(name) {
+    const services = useG9Core().services;
+    return hasCapability(services, name) ? services[name] : void 0;
+}
+function useG9Capability(name) {
+    return hasCapability(useG9Core().services, name);
+}
+function useG9Diagnostics() {
+    return useG9Core().diagnostics;
+}
+function useG9Preferences() {
+    return useG9Core().preferences;
+}
+function useG9Executor() {
+    return useG9Core().executor;
+}
+function useG9Keyboard() {
+    return useRequired(G9KeyboardContext, 'useG9Keyboard');
+}
+function useG9Window() {
+    const window = useRequired(G9WindowContext, 'useG9Window');
+    return {
+        width: window.width,
+        height: window.height,
+        canFit: (width)=>window.width >= width
+    };
+}
+function useG9SafeInsets() {
+    return useRequired(G9InsetsContext, 'useG9SafeInsets');
+}
+export { useG9Capability, useG9Core, useG9Culture, useG9CultureStore, useG9Diagnostics, useG9Direction, useG9Executor, useG9Keyboard, useG9OptionalService, useG9Preferences, useG9SafeInsets, useG9Service, useG9Settings, useG9Strings, useG9Theme, useG9ThemeStore, useG9Window };
+
+//# sourceMappingURL=hooks.jsx.map

package/dist/provider/hooks.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider/hooks.jsx","sources":["../../src/provider/hooks.ts"],"sourcesContent":["import {\n  type G9Capabilities,\n  type G9CapabilityName,\n  type G9Culture,\n  type G9CultureStore,\n  type G9Diagnostics,\n  type G9Direction,\n  G9Error,\n  type G9Preferences,\n  type G9ResolvedTheme,\n  type G9SafeExecutor,\n  type G9SafeInsets,\n  type G9Strings,\n  type G9ThemeStore,\n  hasCapability,\n  requireCapability,\n} from '@g9tm/lynxcontrols-foundation';\nimport { type Context, useContext, useSyncExternalStore } from '@lynx-js/react';\nimport {\n  G9CoreContext,\n  G9CultureContext,\n  G9InsetsContext,\n  G9KeyboardContext,\n  type G9KeyboardState,\n  type G9ProviderCore,\n  G9SettingsContext,\n  G9WindowContext,\n  type G9WindowState,\n} from './contexts';\nimport type { G9ResolvedSettings } from './settings';\n\nfunction missing(hook: string): G9Error {\n  return new G9Error('provider-missing', `${hook} must be used inside <G9Provider>.`);\n}\n\nfunction useRequired<T>(context: Context<T | null>, hook: string): T {\n  const value = useContext(context);\n  if (value === null) throw missing(hook);\n  return value;\n}\n\n/** The provider's shared core (services, stores, executor). Throws `provider-missing` outside a provider. */\nexport function useG9Core(): G9ProviderCore {\n  return useRequired(G9CoreContext, 'useG9Core');\n}\n\n/** The active culture (MAUI `G9Culture.CurrentCulture`). Re-renders when it changes. */\nexport function useG9Culture(): G9Culture {\n  return useRequired(G9CultureContext, 'useG9Culture').culture;\n}\n\n/** The culture's layout direction; every G9 component root sets it explicitly (plan/specs/02 §2). */\nexport function useG9Direction(): G9Direction {\n  return useRequired(G9CultureContext, 'useG9Direction').culture.direction;\n}\n\n/** The strings of the active culture (MAUI `G9Strings`). Re-renders when culture or string settings change. */\nexport function useG9Strings(): G9Strings {\n  return useRequired(G9CultureContext, 'useG9Strings').strings;\n}\n\n/** The culture store, to switch culture (MAUI `G9Culture.Configure` / `SetCulture`). Does not re-render. */\nexport function useG9CultureStore(): G9CultureStore {\n  return useRequired(G9CultureContext, 'useG9CultureStore').store;\n}\n\n/**\n * The resolved theme (scheme and palette). Only components that call this re-render on a theme change; everything\n * else follows through CSS variables.\n */\nexport function useG9Theme(): G9ResolvedTheme {\n  const store = useRequired(G9CoreContext, 'useG9Theme').themeStore;\n  return useSyncExternalStore(store.subscribe, store.getSnapshot);\n}\n\n/** The theme store, to switch mode or palettes (MAUI `G9Theme.ChangeTheme`). Does not re-render. */\nexport function useG9ThemeStore(): G9ThemeStore {\n  return useRequired(G9CoreContext, 'useG9ThemeStore').themeStore;\n}\n\n/** The app-wide settings with defaults filled in. */\nexport function useG9Settings(): G9ResolvedSettings {\n  return useRequired(G9SettingsContext, 'useG9Settings');\n}\n\n/**\n * A service the component cannot work without (MAUI `G9ServiceProvider.GetService<T>`).\n * @throws {G9CapabilityMissingError} naming it when the app did not supply it.\n */\nexport function useG9Service<K extends G9CapabilityName>(name: K): NonNullable<G9Capabilities[K]> {\n  return requireCapability(useG9Core().services, name);\n}\n\n/** An optional service, or `undefined` (MAUI `GetServiceNullable<T>`): features hide themselves without it. */\nexport function useG9OptionalService<K extends G9CapabilityName>(name: K): G9Capabilities[K] | undefined {\n  const services = useG9Core().services;\n  return hasCapability(services, name) ? services[name] : undefined;\n}\n\n/** Whether the app supplied the capability. */\nexport function useG9Capability(name: G9CapabilityName): boolean {\n  return hasCapability(useG9Core().services, name);\n}\n\n/** The provider's diagnostics hub. */\nexport function useG9Diagnostics(): G9Diagnostics {\n  return useG9Core().diagnostics;\n}\n\n/** The provider's preferences (namespace `g9controls.`). */\nexport function useG9Preferences(): G9Preferences {\n  return useG9Core().preferences;\n}\n\n/** The provider's shared safe executor (MAUI `G9SafeCommand`): one throttle/concurrency table per app. */\nexport function useG9Executor(): G9SafeExecutor {\n  return useG9Core().executor;\n}\n\n/** Soft-keyboard state `{ visible, height, compatHeight }`; re-renders only its readers. */\nexport function useG9Keyboard(): G9KeyboardState {\n  return useRequired(G9KeyboardContext, 'useG9Keyboard');\n}\n\n/** Window size and the MAUI `G9ScreenHelper.CanFit` test. */\nexport interface G9WindowInfo extends G9WindowState {\n  /** `true` when the window is at least `width` logical pixels wide. */\n  canFit(width: number): boolean;\n}\n\n/** The window size (MAUI `G9ScreenHelper`); re-renders on `onWindowResize`. */\nexport function useG9Window(): G9WindowInfo {\n  const window = useRequired(G9WindowContext, 'useG9Window');\n  return { width: window.width, height: window.height, canFit: (width) => window.width >= width };\n}\n\n/** The platform safe-area insets from the host service; re-renders when they change. */\nexport function useG9SafeInsets(): G9SafeInsets {\n  return useRequired(G9InsetsContext, 'useG9SafeInsets');\n}\n"],"names":["missing","hook","G9Error","useRequired","context","value","useContext","useG9Core","G9CoreContext","useG9Culture","G9CultureContext","useG9Direction","useG9Strings","useG9CultureStore","useG9Theme","store","useSyncExternalStore","useG9ThemeStore","useG9Settings","G9SettingsContext","useG9Service","name","requireCapability","useG9OptionalService","services","hasCapability","undefined","useG9Capability","useG9Diagnostics","useG9Preferences","useG9Executor","useG9Keyboard","G9KeyboardContext","useG9Window","window","G9WindowContext","width","useG9SafeInsets","G9InsetsContext"],"mappings":";;;AA+BA,SAASA,QAAQC,IAAY;IAC3B,OAAO,IAAIC,QAAQ,oBAAoB,GAAGD,KAAK,kCAAkC,CAAC;AACpF;AAEA,SAASE,YAAeC,OAA0B,EAAEH,IAAY;IAC9D,MAAMI,QAAQC,WAAWF;IACzB,IAAIC,AAAU,SAAVA,OAAgB,MAAML,QAAQC;IAClC,OAAOI;AACT;AAGO,SAASE;IACd,OAAOJ,YAAYK,eAAe;AACpC;AAGO,SAASC;IACd,OAAON,YAAYO,kBAAkB,gBAAgB,OAAO;AAC9D;AAGO,SAASC;IACd,OAAOR,YAAYO,kBAAkB,kBAAkB,OAAO,CAAC,SAAS;AAC1E;AAGO,SAASE;IACd,OAAOT,YAAYO,kBAAkB,gBAAgB,OAAO;AAC9D;AAGO,SAASG;IACd,OAAOV,YAAYO,kBAAkB,qBAAqB,KAAK;AACjE;AAMO,SAASI;IACd,MAAMC,QAAQZ,YAAYK,eAAe,cAAc,UAAU;IACjE,OAAOQ,qBAAqBD,MAAM,SAAS,EAAEA,MAAM,WAAW;AAChE;AAGO,SAASE;IACd,OAAOd,YAAYK,eAAe,mBAAmB,UAAU;AACjE;AAGO,SAASU;IACd,OAAOf,YAAYgB,mBAAmB;AACxC;AAMO,SAASC,aAAyCC,IAAO;IAC9D,OAAOC,kBAAkBf,YAAY,QAAQ,EAAEc;AACjD;AAGO,SAASE,qBAAiDF,IAAO;IACtE,MAAMG,WAAWjB,YAAY,QAAQ;IACrC,OAAOkB,cAAcD,UAAUH,QAAQG,QAAQ,CAACH,KAAK,GAAGK;AAC1D;AAGO,SAASC,gBAAgBN,IAAsB;IACpD,OAAOI,cAAclB,YAAY,QAAQ,EAAEc;AAC7C;AAGO,SAASO;IACd,OAAOrB,YAAY,WAAW;AAChC;AAGO,SAASsB;IACd,OAAOtB,YAAY,WAAW;AAChC;AAGO,SAASuB;IACd,OAAOvB,YAAY,QAAQ;AAC7B;AAGO,SAASwB;IACd,OAAO5B,YAAY6B,mBAAmB;AACxC;AASO,SAASC;IACd,MAAMC,SAAS/B,YAAYgC,iBAAiB;IAC5C,OAAO;QAAE,OAAOD,OAAO,KAAK;QAAE,QAAQA,OAAO,MAAM;QAAE,QAAQ,CAACE,QAAUF,OAAO,KAAK,IAAIE;IAAM;AAChG;AAGO,SAASC;IACd,OAAOlC,YAAYmC,iBAAiB;AACtC"}

package/dist/provider/index.d.ts

@@ -0,0 +1,5 @@
+export type { G9CultureContextValue, G9KeyboardState, G9ProviderCore, G9WindowState } from './contexts.js';
+export { type G9WindowInfo, useG9Capability, useG9Core, useG9Culture, useG9CultureStore, useG9Diagnostics, useG9Direction, useG9Executor, useG9Keyboard, useG9OptionalService, useG9Preferences, useG9SafeInsets, useG9Service, useG9Settings, useG9Strings, useG9Theme, useG9ThemeStore, useG9Window, } from './hooks.js';
+export { G9Provider, type G9ProviderProps } from './provider.js';
+export { type G9ExecutorSettings, type G9FieldSettings, type G9ImageRenderer, type G9PageLoadingSettings, type G9ResolvedSettings, type G9Settings, g9DefaultBackEventName, g9PageLoadingDismissDelayMs, g9PageLoadingSafetyTimeoutMs, resolveSettings, } from './settings.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/provider/index.jsx

@@ -0,0 +1,3 @@
+export { useG9Capability, useG9Core, useG9Culture, useG9CultureStore, useG9Diagnostics, useG9Direction, useG9Executor, useG9Keyboard, useG9OptionalService, useG9Preferences, useG9SafeInsets, useG9Service, useG9Settings, useG9Strings, useG9Theme, useG9ThemeStore, useG9Window } from "./hooks.jsx";
+export { G9Provider } from "./provider.jsx";
+export { g9DefaultBackEventName, g9PageLoadingDismissDelayMs, g9PageLoadingSafetyTimeoutMs, resolveSettings } from "./settings.jsx";

package/dist/provider/provider.css

@@ -0,0 +1,18 @@
+.g9-provider {
+  flex-direction: column;
+  flex: 1;
+  width: 100%;
+  height: 100%;
+  display: flex;
+}
+
+.g9-dir-ltr {
+  direction: ltr;
+}
+
+.g9-dir-rtl {
+  direction: rtl;
+}
+
+
+/*# sourceMappingURL=provider.css.map */

package/dist/provider/provider.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["webpack://./src/provider/provider.css"],"names":[],"mappings":"AACA;EAAE,sBAAsB;EACtB,OAAO;EACP,WAAW;EACX,YAAY;EACZ,aAAa;AACf;;AAIA;EADE,cAAc;AAChB;;AAIA;EADE,cAAc;AAChB","sourcesContent":["/* G9Provider root: fills the LynxView and carries the theme variables (set inline / with setProperty). */\n.g9-provider {\n  display: flex;\n  flex-direction: column;\n  flex: 1;\n  width: 100%;\n  height: 100%;\n}\n\n/* direction does not inherit in Lynx (plan/specs/02 §2): every G9 root sets it; these are the provider's. */\n.g9-dir-ltr {\n  direction: ltr;\n}\n\n.g9-dir-rtl {\n  direction: rtl;\n}\n"],"sourceRoot":""}

package/dist/provider/provider.d.ts

@@ -0,0 +1,51 @@
+import { type G9Capabilities, type G9ColorScheme, type G9Culture, type G9CultureStore, type G9Diagnostics, type G9ThemeOptions, type G9ThemeStore } from '@g9tm/lynxcontrols-foundation';
+import { type ReactNode } from '@lynx-js/react';
+import { type G9Settings } from './settings.js';
+import './provider.css';
+import './theme.css';
+/** Props of {@link G9Provider}. */
+export interface G9ProviderProps {
+    /**
+     * The app's platform services (plan/specs/01 §8). `clock`, `preferences` and `host` are required: a missing one
+     * throws `G9CapabilityMissingError` naming it when the provider mounts. Pass a stable object.
+     */
+    readonly services: Partial<G9Capabilities>;
+    /**
+     * The culture: a store the app drives (`createCultureStore`), or a culture value / locale tag the provider keeps in
+     * its own store (a new value switches it). Default `'en'`.
+     */
+    readonly culture?: G9CultureStore | G9Culture | string;
+    /**
+     * The theme: a store the app drives (`createThemeStore`), or options for the provider's own store (changes to
+     * `mode`, `systemScheme`, `palettes`, `overrides` are applied to it). Default: system mode, stock palettes.
+     */
+    readonly theme?: G9ThemeStore | G9ThemeOptions;
+    /** The platform's current colour scheme (MAUI `RequestedThemeChanged`); followed while the mode is `'system'`. */
+    readonly systemScheme?: G9ColorScheme;
+    /**
+     * Save the theme mode in preferences and restore it at mount (MAUI `G9Theme.ChangeTheme` / `Init`, key
+     * `g9controls.theme`, values 0 system, 1 light, 2 dark). Default `true`.
+     */
+    readonly persistTheme?: boolean;
+    /** App-wide settings (plan/specs/03 §6). Validated at mount and on change. */
+    readonly settings?: G9Settings;
+    /** The diagnostics hub. Default: a hub the provider creates. */
+    readonly diagnostics?: G9Diagnostics;
+    readonly className?: string;
+    readonly children?: ReactNode;
+}
+/**
+ * The root every G9 component lives in (plan/specs/01 §5, MAUI `G9Theme`/`G9Culture`/`G9Strings` statics,
+ * `G9ServiceProvider`, `G9ScreenHelper`, `G9KeyboardHelper`): culture and strings, the theme as CSS variables on one
+ * root `<view>`, settings, services and capabilities, the diagnostics hub, the shared safe executor, keyboard, window
+ * and safe-area state, and the dispatch of the system back event to the active `G9Host`. Mount it once per LynxView.
+ *
+ * - A theme change updates the root's CSS variables with `setProperty`: nothing re-renders except `useG9Theme`
+ *   readers. A culture change re-renders culture readers.
+ * - One `keyboardstatuschanged` and one `onWindowResize` listener for the whole tree.
+ * - The back event (`settings.backEventName`, default `g9:back`) goes to the active host's back stack; when nothing
+ *   handles it, `services.host.exit()` runs (desktop hosts send the same event for Escape).
+ * - Unmounting removes every listener, subscription and timer it created.
+ */
+export declare function G9Provider(props: G9ProviderProps): ReactNode;
+//# sourceMappingURL=provider.d.ts.map

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"}