panelui-native 0.75.1 → 0.77.0

package/lib/typescript/src/primitives/controllable-state.d.ts

@@ -0,0 +1,33 @@
+import { type Dispatch, type SetStateAction } from 'react';
+export interface ControllableStateOptions<T> {
+    /** Accepted owner state. `undefined` selects uncontrolled ownership. */
+    value: T | undefined;
+    /** Initial state used only while uncontrolled. */
+    defaultValue: T;
+    /** Reports a distinct requested value exactly once per setter invocation. */
+    onChange?: (value: T) => void;
+    /** Reports accepted state changes, whether requested or externally reset. */
+    onSettled?: (value: T) => void;
+    /** Normalize defaults, controlled values, and requests through one boundary. */
+    normalize?: (value: T) => T;
+    /** Equality used for no-op requests and accepted settlement. */
+    isEqual?: (left: T, right: T) => boolean;
+    /** Stable semantic identity for controlled objects recreated by their owner. */
+    getValueKey?: (value: T) => unknown;
+}
+export interface ControllableStateResult<T> {
+    /** State accepted by the current owner; controlled requests never render optimistically. */
+    value: T;
+    setValue: Dispatch<SetStateAction<T>>;
+    isControlled: boolean;
+}
+/**
+ * Owner-driven controlled/uncontrolled state with an explicit settlement edge.
+ *
+ * Switching from controlled to uncontrolled retains the last accepted owner
+ * value instead of resurrecting a stale default. Switching into controlled
+ * mode adopts the prop immediately. `undefined` is the ownership sentinel and
+ * therefore cannot itself be a controlled value; use `null` for empty state.
+ */
+export declare function useControllableState<T>({ value: valueProp, defaultValue, onChange, onSettled, normalize, isEqual, getValueKey, }: ControllableStateOptions<T>): ControllableStateResult<T>;
+//# sourceMappingURL=controllable-state.d.ts.map

package/lib/typescript/src/primitives/controllable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllable-state.d.ts","sourceRoot":"","sources":["../../../../src/primitives/controllable-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAKf,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,wEAAwE;IACxE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,CAAC,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5B,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IACzC,gFAAgF;IAChF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,4FAA4F;IAC5F,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAoB,EACpB,OAAkB,EAClB,WAAW,GACZ,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CA0D1D"}

package/lib/typescript/src/primitives/finite-chart.d.ts

@@ -0,0 +1,5 @@
+/** Returns a number only when it is safe to use in chart arithmetic. */
+export declare function finiteChartNumber(value: unknown): number | undefined;
+/** Accepts an explicit domain only when both ends are finite. */
+export declare function finiteChartDomain(domain: readonly [number, number] | undefined): [number, number] | undefined;
+//# sourceMappingURL=finite-chart.d.ts.map

package/lib/typescript/src/primitives/finite-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finite-chart.d.ts","sourceRoot":"","sources":["../../../../src/primitives/finite-chart.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC5C,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAK9B"}

package/lib/typescript/src/primitives/glass.d.ts

@@ -0,0 +1,43 @@
+import { type ViewProps } from 'react-native';
+/** How the material treats what is behind it. */
+export type GlassVariant = 'regular' | 'clear';
+/**
+ * Corner radius in points — one number for all four, or a top and a bottom.
+ *
+ * The two-sided form is for a surface with an edge that is not a real edge: a
+ * sheet docked to the bottom of the screen rounds its top and leaves its
+ * bottom square, because the screen edge is where it ends.
+ */
+export type GlassRadius = number | {
+    top?: number;
+    bottom?: number;
+};
+/**
+ * True when the real material can be drawn — for a caller that wants to know
+ * before it commits to a look. It says nothing about Reduce Transparency, which
+ * is a live preference and belongs to the hook.
+ */
+export declare const hasGlass: boolean;
+export interface GlassProps extends ViewProps {
+    /**
+     * How much of what is behind shows through. `regular` is the everyday
+     * material; `clear` is thinner, for something over its own artwork.
+     */
+    variant?: GlassVariant;
+    /** Tints the material. Takes a colour, not a token name. */
+    tint?: string;
+    /**
+     * Corner radius in points. The material rounds itself to this, so give it
+     * the same shape the container is drawn with — clipping a square material
+     * to a rounded parent throws away the lit edge that makes it read as glass.
+     */
+    radius?: GlassRadius;
+    /** Applied only when the material cannot be drawn. Give it a real surface. */
+    fallbackClassName?: string;
+    className?: string;
+}
+export declare function Glass({ variant, tint, radius, fallbackClassName, className, children, style, ...props }: GlassProps): import("react").JSX.Element;
+export declare namespace Glass {
+    var displayName: string;
+}
+//# sourceMappingURL=glass.d.ts.map

package/lib/typescript/src/primitives/glass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass.d.ts","sourceRoot":"","sources":["../../../../src/primitives/glass.tsx"],"names":[],"mappings":"AA6CA,OAAO,EAA8C,KAAK,SAAS,EAAkB,MAAM,cAAc,CAAC;AAI1G,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAkDrE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SAAqB,CAAC;AAE3C,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,OAAmB,EACnB,IAAI,EACJ,MAAM,EACN,iBAA6B,EAC7B,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,+BAwBZ;yBAjCe,KAAK"}

package/lib/typescript/src/primitives/scrim.d.ts

@@ -2,6 +2,13 @@ import { type ViewProps } from 'react-native';
 type BlurTint = 'light' | 'dark' | 'default' | 'systemMaterial';
 /** True when a real blur can be drawn — for a caller that wants to know. */
 export declare const hasBlur: boolean;
+/**
+ * Whether the device asks for Reduce Transparency: `true`, `false`, or `null`
+ * while the platform has not answered yet. Exported because every material in
+ * the library has to respect the same preference, and two copies of this would
+ * be two answers.
+ */
+export declare function useReduceTransparency(): boolean | null;
 export interface ScrimProps extends Omit<ViewProps, 'children'> {
     /** Frost the backdrop instead of dimming it. Falls back to a dim if it can't. */
     blur?: boolean;

package/lib/typescript/src/primitives/scrim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrim.d.ts","sourceRoot":"","sources":["../../../../src/primitives/scrim.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnF,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAwBhE,4EAA4E;AAC5E,eAAO,MAAM,OAAO,SAAoB,CAAC;AAkGzC,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC7D,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAY,EACZ,SAAc,EACd,IAAgB,EAChB,YAA4B,EAC5B,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,+BA+CZ;yBAtDe,KAAK"}
+{"version":3,"file":"scrim.d.ts","sourceRoot":"","sources":["../../../../src/primitives/scrim.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnF,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAwBhE,4EAA4E;AAC5E,eAAO,MAAM,OAAO,SAAoB,CAAC;AAqEzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,mBAapC;AAgBD,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC7D,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAY,EACZ,SAAc,EACd,IAAgB,EAChB,YAA4B,EAC5B,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,+BA+CZ;yBAtDe,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panelui-native",
-  "version": "0.75.1",
+  "version": "0.77.0",
   "description": "High-performance React Native UI components for Expo. Semantic design tokens, powered by Uniwind (Tailwind v4) and Reanimated.",
   "main": "./lib/module/index.js",
   "module": "./lib/module/index.js",
@@ -90,7 +90,8 @@
     "clean": "rm -rf lib",
     "verify:package": "node scripts/verify-package.mjs",
     "generate:subpaths": "node scripts/generate-subpath-exports.mjs --write",
-    "check:subpaths": "node scripts/generate-subpath-exports.mjs"
+    "check:subpaths": "node scripts/generate-subpath-exports.mjs",
+    "benchmark:components": "node --experimental-strip-types scripts/benchmark-component-scale.mjs"
   },
   "keywords": [
     "react-native",
@@ -132,6 +133,7 @@
     "expo-blur": ">=13.0.0",
     "expo-clipboard": ">=7.0.0",
     "expo-file-system": ">=17.0.0",
+    "expo-glass-effect": ">=57.0.0",
     "expo-haptics": ">=13.0.0",
     "expo-linear-gradient": ">=13.0.0",
     "expo-location": ">=18.0.0",
@@ -186,6 +188,9 @@
     "expo-file-system": {
       "optional": true
     },
+    "expo-glass-effect": {
+      "optional": true
+    },
     "expo-haptics": {
       "optional": true
     },

package/src/components/ai-input/ai-input-growth.ts

@@ -0,0 +1,65 @@
+/**
+ * How tall the composer's field is allowed to be.
+ *
+ * Separated from the component because it is the one piece of AI Input with a
+ * right answer that can be checked without a device: a composer that opens at
+ * the wrong height, or grows past where it was told to stop, is a bug nobody
+ * notices until the send button is off the bottom of the screen.
+ *
+ * ## Bounds, not a measured height
+ *
+ * The obvious way to grow a field is to measure its content and set a height
+ * from it. That is a loop with a different answer on each platform — the
+ * measurement reports the text's height on one and the clipped height of the
+ * box we just set on another, where the field can then never grow at all.
+ *
+ * So nothing is measured. The field is given a floor and a ceiling and left to
+ * size itself between them, which is the layout engine's job and which it does
+ * without telling anybody. Past the ceiling a multiline field scrolls its own
+ * content, and that is the whole mechanism.
+ */
+
+/** Type size and the leading it is given, per `size`. */
+export const AI_INPUT_METRICS = {
+  sm: { fontSize: 15, lineHeight: 20, padding: 10 },
+  md: { fontSize: 16, lineHeight: 22, padding: 12 },
+  lg: { fontSize: 17, lineHeight: 24, padding: 14 },
+} as const;
+
+export type AIInputSize = keyof typeof AI_INPUT_METRICS;
+
+export interface GrowthMetrics {
+  lineHeight: number;
+  padding: number;
+}
+
+/** The box a whole number of lines asks for: the lines, plus both paddings. */
+export function heightForLines(metrics: GrowthMetrics, lines: number): number {
+  return lines * metrics.lineHeight + metrics.padding * 2;
+}
+
+export interface GrowthBounds {
+  minHeight: number;
+  maxHeight: number;
+}
+
+/**
+ * The floor and ceiling a field grows between.
+ *
+ * At least one line, so an empty composer is the size of an empty composer.
+ * Never below the floor, so a `maxRows` under `minRows` — a caller
+ * contradicting itself — resolves to the height that was asked for outright
+ * rather than to one shorter than the field was told to open at.
+ */
+export function growthBounds(
+  metrics: GrowthMetrics,
+  minRows: number,
+  maxRows: number
+): GrowthBounds {
+  const floor = Math.max(1, Math.floor(minRows) || 1);
+  const ceiling = Math.max(floor, Math.floor(maxRows) || floor);
+  return {
+    minHeight: heightForLines(metrics, floor),
+    maxHeight: heightForLines(metrics, ceiling),
+  };
+}