@multiplatform.one/theme 6.0.4 → 6.3.0

package/types/theme/recipes.d.ts

@@ -0,0 +1,200 @@
+import type { ColorTokens, TransitionProp } from "tamagui";
+import type { Knobs } from "./knobs";
+export interface ControlStateProps {
+    borderRadius?: string;
+    borderWidth?: number;
+    backgroundColor?: string;
+    padding?: string;
+    /** Focus-visible ring (DG-A11Y-01); always ≥2 via `ensureFocusVisibleRing`. */
+    outlineWidth?: number;
+    outlineStyle?: "solid" | "none";
+    outlineColor?: string;
+    outlineOffset?: number;
+}
+export interface TextStateProps {
+    color?: string;
+    fontFamily?: string;
+    fontWeight?: string;
+    fontSize?: string;
+}
+export interface ElevationStateProps {
+    /** Size token on web ("$1"); numeric tokens.size value on native (RN-safe). */
+    elevation?: string | number;
+}
+/** Text-bearing control chrome (Button, Chip, Input.Box): muted fill/border, no opacity. */
+export interface DisabledSurfaceProps {
+    backgroundColor?: string;
+    borderColor?: string;
+    cursor?: "not-allowed";
+}
+/** Text-free control chrome (switch track, checkbox box, radio ring, stars): opacity dim. */
+export interface DisabledChromeProps {
+    opacity?: number;
+    cursor?: "not-allowed";
+}
+/** Label/value text and glyphs riding inside disabled surface chrome (stays ≥ AA). */
+export interface DisabledTextProps {
+    color?: string;
+}
+/** Whole field assembly (FieldLayout wrapper / standalone control frame). */
+export interface DisabledAssemblyProps {
+    opacity?: number;
+}
+/**
+ * Resolved disabled treatment (LC-40 DISABLED-VISIBLE / DG-ST-05). A control
+ * rendered disabled MUST be visually distinguishable from its enabled twin
+ * under BOTH `disabledStyle` values. Fragments by anatomy — spread whole,
+ * never cherry-pick, and only when `disabled` (read-only is a different
+ * state and never dims):
+ *
+ * - `surfaceKnobProps` — chrome that CONTAINS text (Button, Chip, Input.Box):
+ *   fill/border wash to the muted tier without opacity so the inner
+ *   label/value text (via `textKnobProps`, `$color11`) keeps ≥ 4.5:1.
+ * - `selectedSurfaceKnobProps` — a SELECTED segment inside disabled
+ *   text-bearing chrome (ToggleGroup / segmented controls): one wash step
+ *   stronger than `surfaceKnobProps` so which option is chosen stays
+ *   visible while disabled (Axiom 6) — components drop their live active
+ *   fill when disabled (the `active` variant beats the wash), so the
+ *   recipe owns the selected tier under BOTH disabledStyle values.
+ * - `chromeKnobProps` — chrome with no text of its own (switch track,
+ *   checkbox box, radio ring, slider, rating stars): opacity dim.
+ * - `assemblyKnobProps` — the whole assembly; populated only under
+ *   `dimWhole` (FieldLayout wrapper; standalone controls spread it after
+ *   their surface fragment since they are their own assembly).
+ */
+export interface DisabledRecipe {
+    surfaceKnobProps: DisabledSurfaceProps;
+    selectedSurfaceKnobProps: DisabledSurfaceProps;
+    chromeKnobProps: DisabledChromeProps;
+    textKnobProps: DisabledTextProps;
+    assemblyKnobProps: DisabledAssemblyProps;
+    /** Effective `disabledStyle` knob value ("keepLabel" | "dimWhole"). */
+    style: string;
+}
+/**
+ * A recipe groups state-specific knob props by concern (control, text, elevation).
+ * Each value is the actual props object to assign to hoverStyle, pressStyle, etc.
+ */
+export interface KnobRecipe<T> {
+    hoverKnobProps: T | undefined;
+    pressKnobProps: T | undefined;
+    focusKnobProps: T | undefined;
+    focusVisibleKnobProps: T | undefined;
+}
+/**
+ * Corner smoothing carrier (Axiom 15 OPTICS): radius-bearing fragments gain
+ * `className: "mp-corner-smooth"` when `cornerSmoothing: "smooth"` (web
+ * only) — the mounted stylesheet in `cornerSmoothing.ts` resolves it to
+ * `corner-shape: squircle`, a Chromium 139+ progressive enhancement other
+ * engines ignore. Absent at `round` and on native.
+ */
+export interface CornerSmoothingCarrier {
+    className?: string;
+}
+export interface KnobProps {
+    borderRadius: {
+        borderRadius: string;
+        borderColor: string;
+        borderWidth: number;
+    } & CornerSmoothingCarrier;
+    borderRadiusOuter: {
+        borderRadius: string;
+    } & CornerSmoothingCarrier;
+    /**
+     * Axiom 1 child-clip cap for padded containers (Card/Panel/DialogContent):
+     * the radius token while it fits, or the padding px once it would exceed
+     * the container's own inset. Spread after the radius-bearing fragment.
+     */
+    containerRadius: {
+        borderRadius: string | number;
+    } & CornerSmoothingCarrier;
+    /** Size token on web ("$1"); numeric tokens.size value on native (RN-safe). */
+    elevation: string | number | undefined;
+    surface: {
+        backgroundColor: string;
+        borderColor: string;
+        borderWidth: number;
+    };
+    /** Content tier (Bento content card): padded frame, no border, no shadow. Radius carries the container cap. */
+    cardSurface: {
+        backgroundColor: string;
+        borderRadius: string | number;
+        padding: string;
+    } & CornerSmoothingCarrier;
+    /** Elevated/overlay tier (popovers, dropdowns): border + elevation. */
+    elevatedSurface: {
+        backgroundColor: string;
+        borderColor: string;
+        borderWidth: number;
+        borderRadius: string;
+        elevation: string | number | undefined;
+    } & CornerSmoothingCarrier;
+    /** Feature/marketing tier (auth, hero cards): big radius + ultra-soft wide shadow. */
+    featureSurface: {
+        backgroundColor: string;
+        borderRadius: string;
+        padding: string;
+        shadowColor: string;
+        shadowOffset: {
+            width: number;
+            height: number;
+        };
+        shadowOpacity: number;
+        shadowRadius: number;
+    } & CornerSmoothingCarrier;
+    inputSurface: {
+        borderWidth: number;
+    };
+    panelPadding: {
+        padding: string;
+    };
+    gap: {
+        gap: string;
+    };
+    gapLg: {
+        gap: string;
+    };
+    sizeToken: string;
+    heading: {
+        fontFamily: string;
+        fontWeight: string;
+    };
+    /** color is set only for solid semantic-intent Buttons (error/warning/success). */
+    body: {
+        fontFamily: string;
+        fontWeight: string;
+        color?: ColorTokens;
+    };
+    textWeight: {
+        fontWeight: string;
+    };
+    transition: TransitionProp | undefined;
+    outlined: boolean;
+    pointy: boolean;
+    textAccent: string;
+    textAccentColor: string;
+    inputBackground: string;
+    space: string;
+    size: string;
+    /** Effective density mode after compact override resolution. */
+    density: string;
+    /** House decision knobs — pass-through for consumers (forms/tables). */
+    fieldLabelPlacement: string;
+    requiredMarking: string;
+    tableZebra: string;
+    bulkBarPlacement: string;
+    selectAllScope: string;
+    timestampStyle: string;
+    disabledStyle: string;
+    formAutofocus: string;
+}
+export interface ResolvedKnobs {
+    knobProps: KnobProps;
+    control: KnobRecipe<ControlStateProps>;
+    text: KnobRecipe<TextStateProps>;
+    elevation: KnobRecipe<ElevationStateProps>;
+    /** LC-40: resolved disabled treatment (named to avoid `disabled` prop clashes). */
+    disabledState: DisabledRecipe;
+}
+export type KnobPropsOverride = (knobProps: KnobProps, knobs: Knobs) => Partial<KnobProps>;
+//# sourceMappingURL=recipes.d.ts.map

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

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

package/types/theme/resolveKnobs.d.ts

@@ -0,0 +1,22 @@
+import type { Knobs } from "./knobs";
+import type { KnobPropsOverride, ResolvedKnobs } from "./recipes";
+/** Step size down one level for compact density. */
+export declare const compactSizeMap: Record<Knobs["size"], Knobs["size"]>;
+/** Step space down one level for compact density. */
+export declare const compactSpaceMap: Record<Knobs["space"], Knobs["space"]>;
+/**
+ * Apply density mode to knobs before token resolution.
+ *
+ * - `density: "compact"` steps size + space down one level.
+ * - `compactOverride` wins over the density knob when provided:
+ *   `true` forces compact stepping; `false` forces comfortable (no step).
+ */
+export declare function applyDensity(knobs: Knobs, compactOverride?: boolean): Knobs;
+/**
+ * Cap a container's radius at its own padding (Axiom 1 CLIP: "my children's
+ * pixel clips first → cap at padding"). Returns the radius token untouched
+ * while it fits, or the padding px number once the token would exceed it.
+ */
+export declare function capContainerRadius(borderRadius: Knobs["borderRadius"], space: Knobs["space"]): string | number;
+export declare function resolveKnobs(knobs: Knobs, override?: KnobPropsOverride): ResolvedKnobs;
+//# sourceMappingURL=resolveKnobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveKnobs.d.ts","sourceRoot":"","sources":["../../src/theme/resolveKnobs.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAmB,KAAK,EAAc,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAKV,iBAAiB,EAEjB,aAAa,EAEd,MAAM,WAAW,CAAC;AAInB,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAI/D,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAIlE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,OAAO,GAAG,KAAK,CAW3E;AAsED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,EACnC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GACpB,MAAM,GAAG,MAAM,CAIjB;AAgLD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,aAAa,CA0JtF"}

package/types/theme/shared.d.ts

@@ -0,0 +1,40 @@
+import { type CreateTamaguiProps, createTamagui } from "tamagui";
+import type { Knobs } from "./knobs";
+import type { Preset } from "./preset.types";
+export declare function registerPreset(name: string, preset: Preset): void;
+/**
+ * Look up a registered preset by name.
+ *
+ * A requested-but-unregistered name is a silent bug otherwise: callers just
+ * fall back to the default preset, so e.g. `preset:material` renders
+ * byte-identical to `default` with no signal. Warn ONCE per unknown name
+ * (empty string and the implicit "default" are legitimate no-ops and stay
+ * quiet) so a typo'd or unregistered preset is loud instead of invisible.
+ */
+export declare function getPreset(name: string): Preset | undefined;
+export declare function getPresetNames(): string[];
+export declare function clearPresets(): void;
+/**
+ * Resolve a `Preset` from a registered preset name, merging knob overrides
+ * on top of the base preset's knobs.
+ *
+ * If the preset name is not found, falls back to a default preset shape
+ * using `defaultKnobs`.
+ */
+export declare function resolveThemeFromPreset(presetName: string, overrides: Partial<Knobs>): Preset;
+export type ThemeConfig<T extends CreateTamaguiProps = CreateTamaguiProps> = {
+    tamagui: ReturnType<typeof createTamagui<T>>;
+    presets?: Record<string, Preset>;
+    defaultPreset?: string;
+    /**
+     * User-facing color theme names extracted from the raw themes object
+     * (e.g. `["blue", "green", "purple", ...]`). Computed at config creation
+     * time so consumers don't need to introspect the Tamagui config.
+     */
+    themeColors: string[];
+};
+export declare function createThemeConfig<T extends CreateTamaguiProps>(tamagui: T, options?: {
+    presets?: Record<string, Preset>;
+    defaultPreset?: string;
+}): ThemeConfig<T>;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/theme/shared.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAS7C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa1D;AAED,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAY5F;AAID,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,IAAI;IAC3E,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAoCF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAC5D,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,WAAW,CAAC,CAAC,CAAC,CA2BhB"}

package/types/theme/theme.d.ts

@@ -0,0 +1,19 @@
+import { type CreateTamaguiProps, type TamaguiProviderProps } from "tamagui";
+import type { PropsWithChildren } from "react";
+/**
+ * Animate a DOM mutation (typically a theme/scheme switch) using the View
+ * Transitions API where available, falling back to a temporary class-gated
+ * CSS transition on `<html>`.
+ *
+ * Both paths derive their duration from the `--mp-transition` CSS variable,
+ * which KnobBridge keeps in sync with the animation knob.
+ */
+export declare function startThemeTransition(apply: () => void): void;
+export interface ThemeProviderProps<T extends CreateTamaguiProps = CreateTamaguiProps> extends PropsWithChildren<Omit<TamaguiProviderProps, "config" | "defaultTheme">> {
+    config?: {
+        tamagui: ReturnType<typeof import("tamagui").createTamagui<T>>;
+    };
+    systemTheme?: "light" | "dark";
+}
+export declare function ThemeProvider<T extends CreateTamaguiProps>({ children, config, systemTheme, ...tamaguiProps }: ThemeProviderProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/theme/theme.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAmB,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAO/C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAkB5D;AAMD,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,CACjD,SAAQ,iBAAiB,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAC;IAChF,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,UAAU,CAAC,cAAc,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;KAChE,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAChC;AAMD,wBAAgB,aAAa,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAC1D,QAAQ,EACR,MAAM,EACN,WAAqB,EACrB,GAAG,YAAY,EAChB,EAAE,kBAAkB,CAAC,CAAC,CAAC,2CAiFvB"}

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

@@ -0,0 +1,10 @@
+import { type CreateTamaguiProps, type TamaguiProviderProps } from "tamagui";
+import type { PropsWithChildren } from "react";
+export interface ThemeProviderProps<T extends CreateTamaguiProps = CreateTamaguiProps> extends PropsWithChildren<Omit<TamaguiProviderProps, "config" | "defaultTheme">> {
+    config?: {
+        tamagui: ReturnType<typeof import("tamagui").createTamagui<T>>;
+    };
+    systemTheme?: "light" | "dark";
+}
+export declare function ThemeProvider<T extends CreateTamaguiProps>({ children, config, systemTheme, ...tamaguiProps }: ThemeProviderProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=theme.native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.native.d.ts","sourceRoot":"","sources":["../../src/theme/theme.native.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAmB,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAS/C,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,CACjD,SAAQ,iBAAiB,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAC;IAChF,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,UAAU,CAAC,cAAc,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;KAChE,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAChC;AAMD,wBAAgB,aAAa,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAC1D,QAAQ,EACR,MAAM,EACN,WAAqB,EACrB,GAAG,YAAY,EAChB,EAAE,kBAAkB,CAAC,CAAC,CAAC,2CAevB"}

package/types/theme/useColorScale.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns the current theme's 12 color values read from CSS custom
+ * properties (--color1 … --color12). Returns null on the server or
+ * when the variables aren't available.
+ */
+export declare function useColorScale(): string[] | null;
+//# sourceMappingURL=useColorScale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useColorScale.d.ts","sourceRoot":"","sources":["../../src/theme/useColorScale.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,GAAG,IAAI,CAQ/C"}

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

@@ -0,0 +1,6 @@
+/**
+ * Native stub — CSS custom properties aren't available on native.
+ * The readability floor will use step-based heuristics instead.
+ */
+export declare function useColorScale(): string[] | null;
+//# sourceMappingURL=useColorScale.native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useColorScale.native.d.ts","sourceRoot":"","sources":["../../src/theme/useColorScale.native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,GAAG,IAAI,CAE/C"}

package/types/theme/useResolvedKnobs.d.ts

@@ -0,0 +1,32 @@
+import type { SizeTokens } from "tamagui";
+import type { KnobPropsOverride, ResolvedKnobs } from "./recipes";
+export declare const IntentContext: import("react").Context<string | null>;
+export declare function useIntentContext(): string | null;
+export interface UseResolvedKnobsOptions {
+    intent?: string;
+    component?: string;
+    override?: KnobPropsOverride;
+    /** Override the size from knobs */
+    size?: SizeTokens;
+    /**
+     * Compact sizing override. When set, wins over `knobs.density`:
+     * `true` forces compact stepping; `false` forces comfortable.
+     * When omitted, the density knob controls compact vs comfortable.
+     */
+    compact?: boolean;
+}
+export declare const solidButtonIntents: Set<string>;
+/**
+ * Resolve knobs → { knobProps }.
+ *
+ * Resolution order:
+ *   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. Apply density (knobs.density, or compact option which wins)
+ *   6. OS reduced-motion forces animation="none"
+ *   7. Call resolveKnobs(mergedKnobs, override) — override merges last
+ */
+export declare function useResolvedKnobs(options?: UseResolvedKnobsOptions): ResolvedKnobs;
+//# sourceMappingURL=useResolvedKnobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedKnobs.d.ts","sourceRoot":"","sources":["../../src/theme/useResolvedKnobs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAKlE,eAAO,MAAM,aAAa,wCAAqC,CAAC;AAEhE,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AA0BD,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;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,aAAa,CA6EjF"}

package/types/theme/useTheme.d.ts

@@ -0,0 +1,31 @@
+import { type Knobs } from "./knobs";
+export type ThemeScheme = "system" | "dark" | "light";
+/**
+ * Hook that returns the current knob values (merged from preset base + cookie
+ * overrides), a setter to persist partial knob changes, a boolean indicating
+ * whether the initial state came from a persisted cookie, a setter to switch
+ * the active preset, and the active preset name.
+ *
+ * Return type:
+ * ```
+ * [
+ *   Knobs,                              // resolved knobs
+ *   (knobs?: Partial<Knobs>) => void,   // merge partial knob updates
+ *   boolean,                            // true if initialized from cookie
+ *   (presetName: string) => void,       // switch preset (resets overrides)
+ *   string | undefined,                 // active preset name
+ * ]
+ * ```
+ *
+ * On SSR the preset name is read from `mp.preset` cookie, looked up in the
+ * preset registry, and its base knobs are merged with `mp.ov.*` overrides.
+ * This produces the same resolved knobs on the server as on the client.
+ */
+export declare function useTheme(): [
+    Knobs,
+    (knobs?: Partial<Knobs>) => void,
+    boolean,
+    (presetName: string) => void,
+    string | undefined
+];
+//# sourceMappingURL=useTheme.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import { type Knobs } from "./knobs";
+export type ThemeScheme = "system" | "dark" | "light";
+export declare function useTheme(): [
+    Knobs,
+    (knobs?: Partial<Knobs>) => void,
+    boolean,
+    (presetName: string) => void,
+    string | undefined
+];
+//# sourceMappingURL=useTheme.native.d.ts.map

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

@@ -0,0 +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"}

package/CHANGELOG.md

@@ -1,46 +0,0 @@
-# @multiplatform.one/theme
-
-## 6.0.4
-
-### Patch Changes
-
-- @multiplatform.one/platform@6.0.4
-- @multiplatform.one/store@6.0.4
-
-## 6.0.3
-
-### Patch Changes
-
-- @multiplatform.one/platform@6.0.3
-- @multiplatform.one/store@6.0.3
-
-## 6.0.2
-
-### Patch Changes
-
-- @multiplatform.one/platform@6.0.2
-- @multiplatform.one/store@6.0.2
-
-## 6.0.1
-
-### Patch Changes
-
-- @multiplatform.one/platform@6.0.1
-- @multiplatform.one/store@6.0.1
-
-## 6.0.0
-
-### Major Changes
-
-- Unified 6.0.0 release: realign all public `@multiplatform.one/*` packages onto a single, matching version line (changesets `fixed` group). Highlights:
-  - **web3 split** into standalone `@multiplatform.one/connectkit` and `@multiplatform.one/gpg` packages; `web3` now depends on them instead of bundling ConnectKit.
-  - **Sign-In With GPG** screen added to the ConnectKit modal.
-  - **Native workspace web-resolution fix** + platform-split wrappers (rich-text / `TextEditor`, forms `Barcode`) so web-only libraries stay out of the native Hermes bundle.
-
-  From this release on, these packages are versioned together.
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/platform@6.0.0
-  - @multiplatform.one/store@6.0.0

package/src/theme/__snapshots__/resolveKnobs.spec.ts.snap

@@ -1,69 +0,0 @@
-// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
-
-exports[`resolveKnobs > matches snapshot for defaultKnobs 1`] = `
-{
-  "control": {
-    "focusKnobProps": undefined,
-    "focusVisibleKnobProps": undefined,
-    "hoverKnobProps": undefined,
-    "pressKnobProps": undefined,
-  },
-  "elevation": {
-    "focusKnobProps": undefined,
-    "focusVisibleKnobProps": undefined,
-    "hoverKnobProps": undefined,
-    "pressKnobProps": undefined,
-  },
-  "knobProps": {
-    "body": {
-      "fontFamily": "$body",
-      "fontWeight": "400",
-    },
-    "borderRadius": {
-      "borderRadius": "$4",
-      "borderWidth": 0.5,
-    },
-    "borderRadiusOuter": {
-      "borderRadius": "$3",
-    },
-    "elevation": undefined,
-    "gap": {
-      "gap": "$3",
-    },
-    "gapLg": {
-      "gap": "$4",
-    },
-    "heading": {
-      "fontFamily": "$heading",
-      "fontWeight": "400",
-    },
-    "inputBackground": "$color6",
-    "inputSurface": {
-      "borderWidth": 0.5,
-    },
-    "outlined": false,
-    "panelPadding": {
-      "padding": "$3",
-    },
-    "pointy": false,
-    "size": "medium",
-    "sizeToken": "$4",
-    "space": "medium",
-    "surface": {
-      "borderWidth": 0.5,
-    },
-    "textAccent": "high",
-    "textAccentColor": "$color",
-    "textWeight": {
-      "fontWeight": "400",
-    },
-    "transition": "quick",
-  },
-  "text": {
-    "focusKnobProps": undefined,
-    "focusVisibleKnobProps": undefined,
-    "hoverKnobProps": undefined,
-    "pressKnobProps": undefined,
-  },
-}
-`;

package/src/theme/pokemonScreen.spec.ts

@@ -1,109 +0,0 @@
-/**
- * Task Group 5.1 — Pokemon screen source-code analysis tests.
- *
- * These tests verify that the refactored Pokemon files follow the
- * Tamagui-native Card pattern and contain zero hardcoded styling values.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { describe, expect, it } from "vitest";
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-const root = path.resolve(__dirname, "../../../..");
-
-function readSource(relativePath: string): string {
-  return fs.readFileSync(path.resolve(root, relativePath), "utf-8");
-}
-
-/**
- * Returns all non-comment, non-import lines from a source file.
- * Strips single-line comments and block comments for cleaner matching.
- */
-function codeLines(source: string): string[] {
-  return source
-    .replace(/\/\*[\s\S]*?\*\//g, "") // strip block comments
-    .split("\n")
-    .map((l) => l.replace(/\/\/.*$/, "").trim()) // strip line comments
-    .filter((l) => l.length > 0 && !l.startsWith("import ") && !l.startsWith("export type"));
-}
-
-// ---------------------------------------------------------------------------
-// Pokemon source files under test
-// ---------------------------------------------------------------------------
-
-const pokemonFiles = [
-  "features/pokemon/screen.tsx",
-  "features/pokemon/detail.tsx",
-  "features/pokemon/components/PokemonCard.tsx",
-  "features/pokemon/components/MoveList.tsx",
-  "features/pokemon/components/AbilityList.tsx",
-  "features/pokemon/components/TypeList.tsx",
-  "features/pokemon/components/PokemonStats.tsx",
-  "public/frappe-ui/src/FrappeImageView.tsx",
-];
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe("Pokemon screen — Card rendering with native Tamagui props", () => {
-  it("screen.tsx uses Card with elevation, borderWidth, and Card.Background/Card.Footer", () => {
-    const src = readSource("features/pokemon/screen.tsx");
-    expect(src).toContain("<Card");
-    expect(src).toMatch(/elevation/);
-    expect(src).toMatch(/borderWidth/);
-    expect(src).toContain("Card.Background");
-    expect(src).toContain("Card.Footer");
-  });
-
-  it("screen.tsx uses ToggleGroup for view switcher instead of manual Button toggles", () => {
-    const src = readSource("features/pokemon/screen.tsx");
-    expect(src).toContain("ToggleGroup");
-  });
-
-  it("FrappeImageView.tsx uses Card with elevation, borderWidth, and sizeToken", () => {
-    const src = readSource("public/frappe-ui/src/FrappeImageView.tsx");
-    expect(src).toContain("<Card");
-    expect(src).toMatch(/elevation/);
-    expect(src).toMatch(/borderWidth/);
-    expect(src).toContain("sizeToken");
-  });
-});
-
-describe("Pokemon screen — no hardcoded styling values", () => {
-  for (const filePath of pokemonFiles) {
-    it(`${filePath} has no hardcoded borderRadius, padding, gap, or elevation overrides`, () => {
-      const src = readSource(filePath);
-      const lines = codeLines(src);
-
-      for (const line of lines) {
-        // Skip lines that are prop definitions on Card/etc (elevate, bordered are fine)
-        // Skip lines that are Tamagui token references like "$3", "$4"
-        // We're looking for raw numeric values assigned to styling props
-
-        // No hardcoded borderRadius with raw numbers (e.g. borderRadius={12})
-        expect(line).not.toMatch(/borderRadius[=:{]\s*\d+(?!\s*\})/);
-
-        // No manual elevation={number} (should use `elevate` boolean instead)
-        // Allow elevation on Progress.Indicator or as Tamagui token strings
-        if (!line.includes("Progress")) {
-          expect(line).not.toMatch(/elevation[=:{]\s*\d+/);
-        }
-
-        // No spreading of borderRadiusProps (Card handles via size)
-        expect(line).not.toMatch(/\.\.\.themeProps\.borderRadiusProps/);
-
-        // No spreading of elevationProps (Card handles via elevate)
-        expect(line).not.toMatch(/\.\.\.themeProps\.elevationProps/);
-      }
-    });
-  }
-
-  it("screen.tsx uses sizeToken on Card components", () => {
-    const src = readSource("features/pokemon/screen.tsx");
-    expect(src).toContain("sizeToken");
-  });
-});