@astryxdesign/core 0.7.7-canary.fc68123 → 0.7.7

package/src/hooks/useAnimator.ts

@@ -1,67 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-'use client';
-
-/**
- * @file useAnimator.ts
- * @input React (useState), the element ref the caller owns, the public
- *   animator factory (animator/createAnimator.ts) and useAttachment
- * @output Exports `useAnimator(ref)`: the public animator for the element
- *   behind `ref`
- * @position Public hook, exported from `@astryxdesign/core/hooks`. A thin
- *   wrapper over `createAnimator` with no behavior of its own.
- *
- * SYNC: When modified, update:
- * - /packages/core/src/hooks/useAnimator.test.tsx
- * - /packages/core/src/hooks/useAnimator.doc.mjs
- */
-
-import {useState, type RefObject} from 'react';
-import {
-  createAttachableAnimator,
-  type AnimatorHandle,
-} from '../animator/createAnimator';
-import {useAttachment} from './useAttachment';
-
-/**
- * Animates the element behind `ref` with the motion Core uses. Call
- * `animate`, `decay`, `set`, `get`, `getVelocity` or `stop` on the returned
- * animator from event handlers and effects. Pass the same `ref` to a gesture
- * hook to drag and animate one element.
- *
- * The hook makes the animator once, and animating never re-renders the
- * component. After each commit, the animator follows the element behind
- * `ref`, also a node that replaces it. An unmount stops running motion and
- * drops the values. A remount, or a node that replaces the element, starts
- * at rest. While no element is attached, every call does nothing, and
- * `animate` and `decay` resolve at once.
- *
- * @example
- * ```
- * const ref = useRef<HTMLDivElement>(null);
- * const animator = useAnimator(ref);
- * return (
- *   <div ref={ref} onClick={() => animator.animate({scale: 1.2})}>
- *     Card
- *   </div>
- * );
- * ```
- */
-export function useAnimator(
-  ref: RefObject<HTMLElement | null>,
-): AnimatorHandle {
-  const [{handle, attach}] = useState(() => {
-    const {animator, attach: attachElement} = createAttachableAnimator();
-    // The handle without `destroy`: the hook owns the element's lifetime.
-    const {destroy: _destroy, ...handle} = animator;
-    return {
-      handle,
-      attach: (element: HTMLElement) => {
-        attachElement(element);
-        return () => attachElement(null);
-      },
-    };
-  });
-  useAttachment(ref, attach, null);
-  return handle;
-}

package/src/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.ts

@@ -1,43 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
- * holding the English for the catalog keys named in packages/core/src/PowerSearch/PowerSearchBottomSheet.tsx.
- * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
- */
-
-const english: Readonly<Record<string, string>> = {
-  "@astryx.powersearch.allFiltersRemoved": "All filters removed",
-  "@astryx.powersearch.editableFiltersRemoved": "Editable filters removed",
-  "@astryx.powersearch.editor.apply": "Apply",
-  "@astryx.powersearch.editor.cancel": "Cancel",
-  "@astryx.powersearch.editor.operator": "Operator",
-  "@astryx.powersearch.sheet.addFilter": "Add filter",
-  "@astryx.powersearch.sheet.clearAll": "Clear all",
-  "@astryx.powersearch.sheet.clearAllCancel": "Keep filters",
-  "@astryx.powersearch.sheet.clearAllConfirm": "Clear filters",
-  "@astryx.powersearch.sheet.clearAllDescription": "This removes all editable filters from this search.",
-  "@astryx.powersearch.sheet.clearAllTitle": "Clear all filters?",
-  "@astryx.powersearch.sheet.done": "Done",
-  "@astryx.powersearch.sheet.editableFiltersClearedWithCount": "Editable filters removed. {resultCount}",
-  "@astryx.powersearch.sheet.fieldOperator": "{field} {operator}",
-  "@astryx.powersearch.sheet.filterUnavailable": "This filter is no longer available",
-  "@astryx.powersearch.sheet.filtersClearedWithCount": "All filters removed. {resultCount}",
-  "@astryx.powersearch.sheet.filtersTitle": "Filters",
-  "@astryx.powersearch.sheet.labelValue": "{label} {value}",
-  "@astryx.powersearch.sheet.noFilters": "No filters applied",
-  "@astryx.powersearch.sheet.noFiltersDescription": "Add a filter to narrow your results and find what you need faster.",
-  "@astryx.powersearch.sheet.noMatchingFields": "No filters match your search",
-  "@astryx.powersearch.sheet.noResults": "No results found",
-  "@astryx.powersearch.sheet.removeFilter": "Remove {field} filter",
-  "@astryx.powersearch.sheet.search": "Search",
-  "@astryx.powersearch.sheet.searchFields": "Search filters",
-  "@astryx.powersearch.sheet.searchFieldsPlaceholder": "Search filters…",
-  "@astryx.powersearch.sheet.searchResults": "Search results",
-  "@astryx.powersearch.sheet.tryDifferentSearch": "Try a different search.",
-  "@astryx.powersearch.sheet.ungroupedFields": "General",
-  "@astryx.tokenizer.tokenAdded": "Added {label}",
-  "@astryx.tokenizer.tokenRemoved": "Removed {label}"
-};
-
-export default english;

package/src/i18n/generated-english/PowerSearch/formatTokenValue.generated.ts

@@ -1,15 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
- * holding the English for the catalog keys named in packages/core/src/PowerSearch/formatTokenValue.ts.
- * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
- */
-
-const english: Readonly<Record<string, string>> = {
-  "@astryx.powersearch.valueEditor.dateRange": "date range",
-  "@astryx.powersearch.valueEditor.filtersCount": "{count, number} {count, plural, one {filter} other {filters}}",
-  "@astryx.powersearch.valueEditor.itemsCount": "{count, number} {count, plural, one {item} other {items}}"
-};
-
-export default english;

package/src/internal/indicatorPress.stylex.ts

@@ -1,24 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file indicatorPress.stylex.ts
- * @input Uses StyleX
- * @output Exports `indicatorPressScope`, the marker of a first-party
- *   indicator that paints its own press
- * @position Internal entry for Astryx's own replacement indicators;
- *   CheckboxInput reads it
- */
-
-import * as stylex from '@stylexjs/stylex';
-
-/**
- * Marks a first-party replacement indicator that paints its own press, for
- * a shape that CheckboxInput's rounded-square press layer would tint past,
- * such as a circle. CheckboxInput leaves that layer off over an indicator
- * with this marker.
- *
- * @internal Not public API: the touch press reaches the indicator through a
- * private property.
- */
-export const indicatorPressScope: ReturnType<typeof stylex.defineMarker> =
-  stylex.defineMarker();

package/src/motion/progress.ts

@@ -1,155 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file progress.ts
- * @input A spring, a normalized progress, an animator's presented velocities
- * @output Exports `progressCurve` (a spring's progress from 0 to 1 as a
- *   MotionCurve), `mapProgress` (one curve as a function of another),
- *   `mapRange` (the clamped linear map most companions use) and
- *   `presentedProgressVelocity` (the progress velocity that continues what
- *   an animator shows)
- * @position Shared by the motion building blocks that move several channels
- *   along one path and by companion motion (a
- *   scrim's dim following a sheet): one velocity unit, one curve mapping and
- *   one way to continue an interrupted motion
- *
- * A path is described by a normalized progress: 0 where it starts, 1 where
- * it rests, beyond either end on a spring's overshoot. Its velocity is in
- * progress per second; each channel's own velocity stays in the channel's
- * units per second.
- *
- * An interrupted motion continues from what is on screen: the
- * block reads the presented values and velocities from the animator at one
- * `now` (`get`, `getVelocity`), restarts a path from those values, and starts
- * its progress with the presented velocity projected on the path's tangent
- * at its start, v·t / (t·t), where t = d(values)/dp. Channels are weighted
- * into one unit first (px per unit of scale, say), so a scale and a
- * translation count alike.
- *
- * A companion follows a driving curve through `mapProgress`, most often
- * with `mapRange`: `mapProgress(sheetY, mapRange([closedY, openY], [0, dim]))`
- * dims a scrim as a sheet rises. Played on another animator, it stays in
- * lockstep only when it starts with its driver: pass the driver's start,
- * `scrim.play({opacity}, {at: start})` with `start = await handle.started`
- * (or one shared `at` for both calls); two calls from rest otherwise each
- * start at their own commit.
- *
- * SYNC: When modified, update /packages/core/src/motion/progress.test.ts and
- * /packages/core/src/motion/README.md.
- */
-
-import type {Animator, MotionCurve, MotionProperty} from './animator';
-import {
-  SETTLING_EPSILON,
-  solveSpring,
-  toSpring,
-  type SpringDescription,
-} from './spring';
-
-/** The step of the finite differences taken on a progress. */
-const STEP = 1e-4;
-
-/**
- * The progress of `spring` from 0 to 1, starting with `velocity` (progress
- * per second): exactly 1 once it settles within `epsilon`.
- */
-export function progressCurve(
-  spring: SpringDescription,
-  {
-    velocity = 0,
-    epsilon = SETTLING_EPSILON,
-  }: {velocity?: number; epsilon?: number} = {},
-): MotionCurve {
-  const curve = solveSpring(toSpring(spring), {from: 0, to: 1, velocity});
-  const duration = curve.settleTime(epsilon);
-  return {
-    duration,
-    at: t => (t >= duration ? 1 : curve.value(t)),
-    velocity: t => (t >= duration ? 0 : curve.velocity(t)),
-  };
-}
-
-/**
- * The curve of `f(driver(t))`, its velocity by the chain rule: a channel
- * following a path as its progress moves, or a companion following any
- * driving curve (a sheet's `y` mapped onto its scrim's opacity). The driver
- * is any MotionCurve, not only a progress from 0 to 1. A companion played on
- * another animator starts with its driver (`{at: start}`; see the file
- * header).
- */
-export function mapProgress(
-  driver: MotionCurve,
-  f: (value: number) => number,
-): MotionCurve {
-  return {
-    duration: driver.duration,
-    at: t => f(driver.at(t)),
-    velocity: t => {
-      const value = driver.at(t);
-      return (
-        ((f(value + STEP) - f(value - STEP)) / (2 * STEP)) * driver.velocity(t)
-      );
-    },
-  };
-}
-
-/**
- * The linear map from `input` to `output`, held at `output`'s ends outside
- * `input` unless `clamp` is false: what most companions are (a scrim's dim
- * along a sheet's travel, a parallax, a dismissal's fade). Either range may
- * run backward (`[openY, closedY]`).
- */
-export function mapRange(
-  input: readonly [number, number],
-  output: readonly [number, number],
-  {clamp = true}: {clamp?: boolean} = {},
-): (x: number) => number {
-  const [a, b] = input;
-  const [c, d] = output;
-  return x => {
-    let t = a === b ? (x < a ? 0 : 1) : (x - a) / (b - a);
-    if (clamp) {
-      t = Math.min(1, Math.max(0, t));
-    }
-    // Exact at both ends.
-    return t === 0 ? c : t === 1 ? d : c + (d - c) * t;
-  };
-}
-
-/**
- * One channel of a path: an animator property and its value at each
- * progress.
- */
-export interface ProgressChannel {
-  readonly property: MotionProperty;
-  /** The property's value at progress `p`. */
-  at(p: number): number;
-  /**
-   * What one unit of the property weighs in the projection, in a unit the
-   * channels share (px per unit of scale for a box `weight` px wide). 1 by
-   * default.
-   */
-  readonly weight?: number;
-}
-
-/**
- * The progress velocity, per second, that continues what `animator`
- * presents at `now` along a path that starts there: the presented velocity
- * projected on the path's tangent at progress 0, v·t / (t·t). 0 when the
- * path does not move any of its channels.
- */
-export function presentedProgressVelocity(
-  animator: Pick<Animator, 'getVelocity'>,
-  channels: ReadonlyArray<ProgressChannel>,
-  now?: number,
-): number {
-  let along = 0;
-  let squared = 0;
-  for (const channel of channels) {
-    const weight = channel.weight ?? 1;
-    const tangent = ((channel.at(STEP) - channel.at(0)) / STEP) * weight;
-    along += animator.getVelocity(channel.property, now) * weight * tangent;
-    squared += tangent * tangent;
-  }
-  return squared > 1e-12 ? along / squared : 0;
-}

package/src/motion/uikit/alert.ts

@@ -1,43 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file alert.ts
- * @input Nothing; data only
- * @output Exports `alertController`: how UIAlertController (`.alert`) tracks
- *   a finger across its actions
- * @position The alert domain of the UIKit constants table (motion/uikit);
- *   its springs are `springs.alertPresent` and `springs.alertDismiss`
- *
- * Every value was read from UIKit on the iOS 26.2 simulator. A host app
- * presented `UIAlertController(.alert)` with two and with three actions.
- * Real HID touches drove it, and the action views' highlight was sampled
- * every frame. Lengths are in pt (CSS px), durations in ms.
- *
- * Every leaf carries one or more `@source`; GUESS values also carry the
- * `@measure` task that will confirm or replace them. uikit.test.ts enforces
- * both.
- *
- * SYNC: When modified, update /packages/core/src/motion/MEASUREMENTS.md
- */
-
-export const alertController = {
-  actions: {
-    /**
-     * How long after touch-down the touched action highlights: none, it is
-     * highlighted in the touch-down frame (a tap and a 300 ms hold alike).
-     * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
-     *   iPhone 17 Pro, per-frame highlight of the action views under real HID
-     *   touches, Oct 23 2026
-     */
-    highlightOnsetMs: 0,
-    /**
-     * How far outside an action the finger may go and keep it highlighted:
-     * none. The highlight cleared 1 pt below the action, and a lift there ran
-     * nothing. UIButton keeps 70 pt; an alert action does not.
-     * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
-     *   iPhone 17 Pro, per-frame highlight of the action views under real HID
-     *   touches, Oct 23 2026
-     */
-    highlightExpansion: 0,
-  },
-} as const;

package/src/privateAttributes/pressGroupItem.stylex.ts

@@ -1,23 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-/**
- * @file privateAttributes/pressGroupItem.stylex.ts
- * @input Nothing: the private press-group-item attribute
- * @output pressGroupItemProps, which marks an action a group's tracker
- *   follows, and isTrackedByGroup, which reads the mark
- * @position Owner module of the private press-group-item attribute: the only
- *   file that writes its name. AlertDialog marks its actions, and the press
- *   controller (utils/pressFeedback.ts) leaves their press to the group's
- *   tracker. No package entry exports it.
- */
-
-const PRESS_GROUP_ITEM = 'data-astryx-press-group-item';
-
-/** Spread on each action that a group's tracker follows. */
-export const pressGroupItemProps: Readonly<Record<string, string>> = {
-  [PRESS_GROUP_ITEM]: '',
-};
-
-/** Whether a group's tracker paints the press on `element` or an ancestor. */
-export function isTrackedByGroup(element: Element): boolean {
-  return element.closest(`[${PRESS_GROUP_ITEM}]`) != null;
-}

package/src/utils/triggerFocus.ts

@@ -1,80 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file triggerFocus.ts
- * @input A focus event on a hover-layer trigger and its focusTrigger value
- * @output Whether that focus counts as focus on the trigger, and a gate that
- *   remembers it for the matching blur
- * @position Shared focus-trigger judgement for Tooltip and HoverCard
- */
-
-/** When focus on a trigger opens its layer. */
-export type TriggerFocusMode = 'auto' | 'always' | 'never';
-
-/** Whether `element` is in the tab order or naturally focusable. */
-export function isFocusableTrigger(element: HTMLElement): boolean {
-  if (element.hasAttribute('tabindex')) {
-    return element.tabIndex >= 0;
-  }
-  const focusableTags = ['A', 'BUTTON', 'INPUT', 'SELECT', 'TEXTAREA'];
-  if (focusableTags.includes(element.tagName)) {
-    return !(element as HTMLButtonElement).disabled;
-  }
-  return element.isContentEditable;
-}
-
-/**
- * Whether a focus event on a trigger (its `currentTarget`) counts as focus on
- * the trigger.
- *
- * Under `auto` it is decided when focus arrives, not when listeners attach: a
- * roving-tabindex member that was `tabindex="-1"` then can be the tab stop
- * now. A trigger that receives focus is focusable by definition, which covers
- * focusable elements this check does not list, such as a `<summary>` or an SVG
- * link. Focus inside the trigger counts only while the trigger is focusable
- * too, so a plain wrapper ignores its children's focus.
- */
-export function isFocusForTrigger(
-  event: Event,
-  mode: TriggerFocusMode,
-): boolean {
-  if (mode === 'always') {
-    return true;
-  }
-  if (mode === 'never') {
-    return false;
-  }
-  const trigger = event.currentTarget as HTMLElement | null;
-  return (
-    trigger != null && (event.target === trigger || isFocusableTrigger(trigger))
-  );
-}
-
-/** Remembers whether a trigger's current focus counted when it arrived. */
-export interface TriggerFocusGate {
-  /** On focusin: whether this focus opens the layer. */
-  focusIn(event: Event, mode: TriggerFocusMode): boolean;
-  /**
-   * On focusout: whether this blur closes the layer. A focus that counted
-   * closes on blur even if the trigger has since left the tab order.
-   */
-  focusOut(event: Event, mode: TriggerFocusMode): boolean;
-}
-
-/** A gate for one trigger; each hook keeps one for its lifetime. */
-export function createTriggerFocusGate(): TriggerFocusGate {
-  let isCounted = false;
-  return {
-    focusIn(event, mode) {
-      isCounted = isFocusForTrigger(event, mode);
-      return isCounted;
-    },
-    focusOut(event, mode) {
-      if (!isCounted && !isFocusForTrigger(event, mode)) {
-        return false;
-      }
-      isCounted = false;
-      return true;
-    },
-  };
-}