@multiplatform.one/theme 7.34.4 → 7.35.0

package/types/theme/transitionProps.d.ts

@@ -1,3 +1,4 @@
+import type { MotionRole } from "./motion";
 import type { TransitionProp } from "tamagui";
 /**
  * Spreadable `transition` for a part that rides the animation knob.
@@ -8,7 +9,8 @@ import type { TransitionProp } from "tamagui";
  * knob flips to any other stop (MPO-327). On web the key therefore stays, and
  * an undefined value paints no CSS transition. The native twin differs.
  */
-export declare function transitionProps(transition: TransitionProp | undefined): {
+export declare function transitionProps(role: MotionRole | TransitionProp | undefined, extra?: readonly string[]): {
     transition?: TransitionProp;
+    animateOnly?: string[];
 };
 //# sourceMappingURL=transitionProps.d.ts.map

package/types/theme/transitionProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitionProps.d.ts","sourceRoot":"","sources":["../../src/theme/transitionProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG;IACvE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,CAEA"}
+{"version":3,"file":"transitionProps.d.ts","sourceRoot":"","sources":["../../src/theme/transitionProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,EAC7C,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B;IACD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAWA"}

package/types/theme/transitionProps.native.d.ts

@@ -1,3 +1,4 @@
+import type { MotionRole } from "./motion";
 import type { TransitionProp } from "tamagui";
 /**
  * Native twin of `transitionProps.ts`.
@@ -7,7 +8,8 @@ import type { TransitionProp } from "tamagui";
  * animation `none` would put motion on every part that is meant to be still.
  * Native keeps omitting it until the driver has an instant token to pass.
  */
-export declare function transitionProps(transition: TransitionProp | undefined): {
+export declare function transitionProps(role: MotionRole | TransitionProp | undefined, extra?: readonly string[]): {
     transition?: TransitionProp;
+    animateOnly?: string[];
 };
 //# sourceMappingURL=transitionProps.native.d.ts.map

package/types/theme/transitionProps.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitionProps.native.d.ts","sourceRoot":"","sources":["../../src/theme/transitionProps.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG;IACvE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,CAEA"}
+{"version":3,"file":"transitionProps.native.d.ts","sourceRoot":"","sources":["../../src/theme/transitionProps.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,EAC7C,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B;IACD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAUA"}

package/types/theme/usePresetSwitch.d.ts

@@ -0,0 +1,10 @@
+export interface PresetSwitch {
+    /** The provider's active preset; "default" when none is stored. */
+    presetName: string;
+    /** Switch the active preset without recording anyone's choice. */
+    applyPreset(name: string): void;
+    /** Switch and record it as this user's choice (no user = this device's signed-out choice). */
+    choosePreset(name: string, userId?: string | null): void;
+}
+export declare function usePresetSwitch(): PresetSwitch;
+//# sourceMappingURL=usePresetSwitch.d.ts.map

package/types/theme/usePresetSwitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePresetSwitch.d.ts","sourceRoot":"","sources":["../../src/theme/usePresetSwitch.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8FAA8F;IAC9F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAqC9C"}

package/types/theme/usePresetSwitch.native.d.ts

@@ -0,0 +1,10 @@
+export interface PresetSwitch {
+    /** The provider's active preset; "default" when none is stored. */
+    presetName: string;
+    /** Switch the active preset without recording anyone's choice. */
+    applyPreset(name: string): void;
+    /** Switch and record it as this user's choice (no user = this device's signed-out choice). */
+    choosePreset(name: string, userId?: string | null): void;
+}
+export declare function usePresetSwitch(): PresetSwitch;
+//# sourceMappingURL=usePresetSwitch.native.d.ts.map

package/types/theme/usePresetSwitch.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePresetSwitch.native.d.ts","sourceRoot":"","sources":["../../src/theme/usePresetSwitch.native.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8FAA8F;IAC9F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAa9C"}

package/types/theme/useResolvedKnobs.d.ts

@@ -6,16 +6,17 @@ export interface UseResolvedKnobsOptions {
     intent?: string;
     component?: string;
     override?: KnobPropsOverride;
-    /** Override the size from knobs */
+    /**
+     * The control size token (Tamagui's own `size`, "$3"). Clamped to the
+     * nearest `<Surface size>` ceiling (LC-78); omitted = the Surface's token,
+     * else `$true`.
+     */
     size?: SizeTokens;
     /**
-     * Density-compact override (layout gaps only — does not step size).
-     * When set, wins over `knobs.density`:
-     * `true` forces compact density; `false` forces comfortable.
-     * Then re-clamped to the parent Surface ceiling (LC-68).
-     * When omitted, the density knob / Surface controls compact vs comfortable.
+     * Whether an ancestor already paints a surface box. Omitted = the nearest
+     * `<Surface painted>`; overlay frames pass `false` because they float.
      */
-    compact?: boolean;
+    painted?: boolean;
 }
 export declare const solidButtonIntents: Set<string>;
 /**
@@ -32,12 +33,11 @@ export declare const solidPaletteThemes: Set<string>;
  *   1. Base knobs from nearest <Preset> context
  *   2. Merge intent-level overrides (if intent provided or from context)
  *   3. Merge intent+component overrides (if both provided)
- *   4. Apply size override if provided
- *   5. Clamp size/density to Surface context (step-down only, LC-68)
- *   6. Apply density (space only; compact option wins when provided)
- *   7. Re-clamp to Surface ceiling (compact option cannot exceed parent)
- *   8. OS reduced-motion forces animation="none"
- *   9. Call resolveKnobs(mergedKnobs, override, scheme) — override merges last
+ *   4. Size token: the `size` option clamped to the Surface ceiling (LC-78);
+ *      `painted` from the option, else the Surface
+ *   5. OS reduced-motion forces animation="none"
+ *   6. Call resolveKnobs(mergedKnobs, override, scheme, { touch, sizeToken, painted })
+ *      — override merges last
  */
 export declare function useResolvedKnobs(options?: UseResolvedKnobsOptions): ResolvedKnobs;
 //# sourceMappingURL=useResolvedKnobs.d.ts.map

package/types/theme/useResolvedKnobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResolvedKnobs.d.ts","sourceRoot":"","sources":["../../src/theme/useResolvedKnobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,SAAS,CAAC;AAIxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAWlE,eAAO,MAAM,aAAa,wCAAqC,CAAC;AAEhE,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAyDD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,mCAAmC;IACnC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAYD,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,aAAsB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAuGjF"}
+{"version":3,"file":"useResolvedKnobs.d.ts","sourceRoot":"","sources":["../../src/theme/useResolvedKnobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,SAAS,CAAC;AAIxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAMlE,eAAO,MAAM,aAAa,wCAAqC,CAAC;AAEhE,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AA4BD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,aAAsB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAgFjF"}

package/types/theme/useSchemePreference.d.ts

@@ -0,0 +1,8 @@
+import type { ThemeScheme } from "./useTheme";
+export interface SchemePreference {
+    setting: ThemeScheme;
+    value: "light" | "dark";
+    set(scheme: ThemeScheme): void;
+}
+export declare function useSchemePreference(): SchemePreference;
+//# sourceMappingURL=useSchemePreference.d.ts.map

package/types/theme/useSchemePreference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchemePreference.d.ts","sourceRoot":"","sources":["../../src/theme/useSchemePreference.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAaD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAStD"}

package/types/theme/useSchemePreference.native.d.ts

@@ -0,0 +1,8 @@
+import type { ThemeScheme } from "./useTheme";
+export interface SchemePreference {
+    setting: ThemeScheme;
+    value: "light" | "dark";
+    set(scheme: ThemeScheme): void;
+}
+export declare function useSchemePreference(): SchemePreference;
+//# sourceMappingURL=useSchemePreference.native.d.ts.map

package/types/theme/useSchemePreference.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchemePreference.native.d.ts","sourceRoot":"","sources":["../../src/theme/useSchemePreference.native.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAGD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAkBtD"}

package/types/theme/useTheme.d.ts

@@ -12,7 +12,7 @@ export type ThemeScheme = "system" | "dark" | "light";
  *   Knobs,                              // resolved knobs
  *   (knobs?: Partial<Knobs>) => void,   // merge partial knob updates
  *   boolean,                            // true if initialized from cookie
- *   (presetName: string) => void,       // switch preset (resets overrides)
+ *   (presetName: string, options?: { userId?: string | null }) => void,       // switch preset; options record a choice
  *   string | undefined,                 // active preset name
  * ]
  * ```
@@ -25,7 +25,9 @@ export declare function useTheme(): [
     Knobs,
     (knobs?: Partial<Knobs>) => void,
     boolean,
-    (presetName: string) => void,
+    (presetName: string, options?: {
+        userId?: string | null;
+    }) => void,
     string | undefined
 ];
 //# sourceMappingURL=useTheme.d.ts.map

package/types/theme/useTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,SAAS,CAAC;AAOnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAMtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,KAAK;IACL,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;IAChC,OAAO;IACP,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI;IAC5B,MAAM,GAAG,SAAS;CACnB,CAiKA"}
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,SAAS,CAAC;AAQnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAMtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,KAAK;IACL,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;IAChC,OAAO;IACP,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI;IAClE,MAAM,GAAG,SAAS;CACnB,CAkKA"}

package/types/theme/useTheme.native.d.ts

@@ -1,10 +1,19 @@
 import { type Knobs } from "./knobs";
 export type ThemeScheme = "system" | "dark" | "light";
+/**
+ * Same tuple as the web hook. State lives in the shared preset store
+ * (`presetStore.ts`), persisted to `@multiplatform.one/store` storage under
+ * `mp.preset` / `mp.ov`, so every caller and the ThemeProvider see one preset
+ * and it survives a relaunch. The fourth element switches presets; supplying
+ * options also records the user's (or signed-out device's) choice.
+ */
 export declare function useTheme(): [
     Knobs,
     (knobs?: Partial<Knobs>) => void,
     boolean,
-    (presetName: string) => void,
+    (presetName: string, options?: {
+        userId?: string | null;
+    }) => void,
     string | undefined
 ];
 //# sourceMappingURL=useTheme.native.d.ts.map

package/types/theme/useTheme.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.native.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.native.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,SAAS,CAAC;AAOnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAMtD,wBAAgB,QAAQ,IAAI;IAC1B,KAAK;IACL,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;IAChC,OAAO;IACP,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI;IAC5B,MAAM,GAAG,SAAS;CACnB,CA4BA"}
+{"version":3,"file":"useTheme.native.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.native.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,SAAS,CAAC;AAcnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAMtD;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,KAAK;IACL,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;IAChC,OAAO;IACP,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI;IAClE,MAAM,GAAG,SAAS;CACnB,CAsCA"}