@cosmicdrift/kumiko-renderer 0.338.0 → 0.340.0

package/dist/i18n-defaults.js

@@ -23,6 +23,8 @@ export const kumikoDefaultTranslations = {
         "kumiko.actions.next": "Next",
         "kumiko.actions.back": "Back",
         "kumiko.actions.finish": "Finish",
+        "kumiko.boolean.no": "No",
+        "kumiko.boolean.yes": "Yes",
         "kumiko.wizard.step": "Step {current} of {total}",
         "kumiko.wizard.up-next": "Up next",
         "kumiko.wizard.step-with-title": "Step {current} of {total} · {title}",
@@ -76,6 +78,7 @@ export const kumikoDefaultTranslations = {
         "kumiko.list.count.other": "{count} entries",
         "kumiko.list.row-actions.more": "More actions",
         "kumiko.page-header.actions": "Page actions",
+        "kumiko.theme.auto": "Automatic theme",
         "kumiko.theme.dark": "Dark theme",
         "kumiko.theme.light": "Light theme",
         "kumiko.list.row.collapse": "Collapse {title}",
@@ -136,6 +139,9 @@ export const kumikoDefaultTranslations = {
         "kumiko.dialog.confirm": "Confirm",
         "kumiko.dialog.cancel": "Cancel",
         "kumiko.dialog.close": "Close",
+        "kumiko.lightbox.previous": "Previous image",
+        "kumiko.lightbox.next": "Next image",
+        "kumiko.lightbox.position": "{current} / {total}",
         "kumiko.drawer.discard.title": "Discard changes?",
         "kumiko.drawer.discard.body": "Your input in this form will be lost.",
         "kumiko.drawer.discard.confirm": "Discard",

package/dist/index.d.ts

@@ -70,7 +70,7 @@ export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTra
 export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
-export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.js";
+export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.js";
 export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
 export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.js";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.js";
@@ -78,5 +78,5 @@ export { buildWhatsAppShareUrl } from "./share-links.js";
 export { sortByAccessor } from "./sort-by-accessor.js";
 export type { LiveEvent, LiveEventSubscriber, LiveEventsProviderProps } from "./sse/live-events.js";
 export { LiveEventsProvider, useLiveEvents } from "./sse/live-events.js";
-export type { AppTokens, ColorTokens, CoreTokens, FontTokens, RadiusTokens, ShadowTokens, SpacingTokens, ThemeMode, Tokens, TokensApi, TokensProviderProps, } from "./tokens.js";
+export type { AppTokens, ColorTokens, CoreTokens, FontTokens, RadiusTokens, ShadowTokens, SpacingTokens, ThemeMode, ThemePreference, Tokens, TokensApi, TokensProviderProps, } from "./tokens.js";
 export { cssVarTokens, TokensProvider, useTokenController, useTokens } from "./tokens.js";

package/dist/primitives.d.ts

@@ -1069,15 +1069,27 @@ export type DrawerProps = {
     readonly children: ReactNode;
     readonly testId?: string;
 };
-/** Image lightbox — full-size preview on click. Web renders Radix overlay;
- *  trigger (thumbnail) and open state live in the app. */
-export type LightboxProps = {
-    readonly open: boolean;
-    readonly onOpenChange: (open: boolean) => void;
+export type LightboxImage = {
     readonly src: string;
     readonly alt: string;
+};
+type LightboxBaseProps = {
+    readonly open: boolean;
+    readonly onOpenChange: (open: boolean) => void;
     readonly testId?: string;
 };
+/** Image lightbox — full-size preview on click. Web renders Radix overlay;
+ *  trigger (thumbnail) and open state live in the app. Takes either one image
+ *  (`src`/`alt`) or a browsable set (`images` + controlled `index`);
+ *  navigation wraps around at both ends. */
+export type LightboxProps = LightboxBaseProps & ({
+    readonly src: string;
+    readonly alt: string;
+} | {
+    readonly images: readonly LightboxImage[];
+    readonly index: number;
+    readonly onIndexChange: (index: number) => void;
+});
 /** Source-badge for one cascade step (User / Tenant / System / …).
  *  Used inline next to a config value to indicate where it came from.
  *  Requires a LocaleProvider above it (labels run through useTranslation)

package/dist/tokens.d.ts

@@ -58,10 +58,19 @@ export interface AppTokens {
 }
 export type Tokens = CoreTokens & AppTokens;
 export type ThemeMode = "light" | "dark";
+/** "auto" follows the OS color scheme live; light/dark are explicit choices. */
+export type ThemePreference = ThemeMode | "auto";
 export type TokensApi = {
     readonly tokens: Tokens;
+    /** The scheme currently applied (resolved from the preference when it is "auto"). */
     readonly mode: ThemeMode;
+    /** Optional so hand-built TokensApi values (tests, custom providers) stay valid:
+     *  absent means a plain light/dark implementation, read as `mode`. */
+    readonly preference?: ThemePreference;
+    readonly setPreference?: (preference: ThemePreference) => void;
+    /** Explicit choice: leaves "auto". */
     readonly setMode: (mode: ThemeMode) => void;
+    /** Explicit flip of the resolved mode: leaves "auto". */
     readonly toggleMode: () => void;
 };
 export type TokensProviderProps = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.338.0",
+  "version": "0.340.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.338.0",
-    "@cosmicdrift/kumiko-headless": "0.338.0",
-    "@cosmicdrift/kumiko-types": "0.338.0",
+    "@cosmicdrift/kumiko-framework": "0.340.0",
+    "@cosmicdrift/kumiko-headless": "0.340.0",
+    "@cosmicdrift/kumiko-types": "0.340.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.338.0"
+    "@cosmicdrift/kumiko-locale-de": "0.340.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.339.0",
+    "type": "improvement",
+    "title": "Lightbox pages through multiple images",
+    "detail": "`LightboxProps` is now a union: the existing `src`/`alt` form is unchanged, and the new `images` + `index` + `onIndexChange` form renders previous/next buttons, a position counter and ArrowLeft/ArrowRight navigation with wrap-around when more than one image is given. The Apex lightbox collects every `.shot-frame img` on open and gains previous/next buttons; its CSP script hash changed. New i18n keys: `kumiko.lightbox.previous`, `kumiko.lightbox.next`, `kumiko.lightbox.position`."
+  },
   {
     "version": "0.338.0",
     "type": "fix",