@astryxdesign/core 0.7.7-canary.fc68123 → 0.7.7

package/src/motion/animator.ts

@@ -4,12 +4,11 @@
  * @file animator.ts
  * @input An element, target values, and a spring, momentum curves (coast.ts)
  *   or any closed-form curve
- * @output Exports `createMotionAnimator`, a compositor animator for
- *   translate, rotate, scale and opacity, and its option, handle and
- *   transition types. It reads presentation values and velocities from the
- *   analytic curves. It retargets with the velocity kept, freezes in place on
- *   `stop`, and gives completion promises, a shared clock, and UIKit's
- *   Reduced Motion substitution.
+ * @output Exports `createAnimator`: a compositor animator for translate,
+ *   rotate, scale and opacity, with presentation values and velocities read
+ *   from the analytic curves, velocity-preserving retargeting, freeze-in-place
+ *   `stop`, completion promises, a shared clock, and UIKit's Reduced Motion
+ *   substitution; plus its option, handle and transition types
  * @position Motion foundation (DOM). Internal to core: components use it for
  *   every touch-presentation animation; not exported from the package entry
  *
@@ -245,18 +244,18 @@ export interface AnimateOptions {
   crossfadeAs?: 'entrance' | 'exit';
   /**
    * When the call's animations start. By default a call from rest starts
-   * when the browser commits it. A call that continues motion on screen (a
-   * retarget) starts now, from the value on screen. A curve whose tail
-   * already shows as at rest counts as rest. Ignored with `at`.
+   * when the browser commits it, and a call that continues motion on screen
+   * (a retarget) starts now, from the value on screen. Ignored with `at`.
    * - `'commit'`: a call that continues motion also starts when the browser
-   *   commits it. The browser dates it, as it dates a call from rest.
-   * - `'presented'`: a call from rest leaves its element at rest. Its
-   *   animations are created two frames later, once the frame with the
-   *   element at rest has been presented. They then start at their commit,
-   *   so a busy UI process delays the motion instead of skipping into it.
-   *   Any other change to the animator before then creates the animations
-   *   first, in call order. A call that continues motion on screen starts
-   *   now, as by default.
+   *   commits it, dated by the browser rather than by the main thread, as a
+   *   call from rest is.
+   * - `'presented'`: a call from rest leaves its element at rest and creates
+   *   its animations two frames later, once the frame that carries the
+   *   element at rest has been presented; they then start at their commit. A
+   *   busy UI process delays the motion instead of skipping into it, for two
+   *   frames more before an idle start. Any other change to the animator
+   *   before then creates the animations first, in call order. A call that
+   *   continues motion on screen (a retarget) starts now, as by default.
    */
   start?: 'commit' | 'presented';
   /**
@@ -298,7 +297,7 @@ export interface MotionCurve {
 }
 
 /**
- * Options of `createMotionAnimator`.
+ * Options of `createAnimator`.
  */
 /** How `set` puts values in place. */
 export interface SetOptions {
@@ -653,18 +652,6 @@ const SAMPLE_TOLERANCE: Record<MotionProperty, number> = {
 /** Keyframes start on this grid (ms) and are split where the curve needs it. */
 const SAMPLE_GRID_MS = 1000 / 30;
 
-/**
- * A curve within this many sample tolerances of its target can show as at
- * rest. A call on it then starts as one from rest does, at the browser's start.
- */
-const REST_DISTANCE_TOLERANCES = 2;
-
-/**
- * A curve shows as at rest only while it moves at most one `SAMPLE_TOLERANCE`
- * a frame at this rate.
- */
-const REST_FRAMES_PER_SECOND = 60;
-
 /** A curve that has not settled by then (an undamped spring) snaps. */
 const MAX_DURATION_MS = 30_000;
 
@@ -816,7 +803,7 @@ export function animatorFor(
   const key = options.pseudoElement ?? '';
   let animator = byPseudo.get(key);
   if (animator == null) {
-    animator = createMotionAnimator(element, options);
+    animator = createAnimator(element, options);
     byPseudo.set(key, animator);
   }
   return animator;
@@ -933,7 +920,7 @@ const REDUCED_TRANSITION: SpringTransition = {
  *
  * @example
  * ```
- * const animator = createMotionAnimator(sheet);
+ * const animator = createAnimator(sheet);
  * // finger lifts at 1200 px/s heading for the detent at 0 (a component
  * // passes the spring of its motion role):
  * animator.animate({y: 0}, {spring: {response: 0.45, dampingRatio: 0.9}, velocity: {y: 1200}});
@@ -942,7 +929,7 @@ const REDUCED_TRANSITION: SpringTransition = {
  * animator.stop(['y']);
  * ```
  */
-export function createMotionAnimator(
+export function createAnimator(
   element: HTMLElement | null,
   options: AnimatorOptions = {},
 ): Animator {
@@ -1178,22 +1165,6 @@ export function createMotionAnimator(
     return curveAt(property, time);
   };
 
-  /**
-   * Whether a curve's tail already shows as at rest at `time`. Under a
-   * starved main thread the browser commits a call late. A call that starts
-   * at its own time then skips that far into its curve. One that starts at
-   * the commit holds an element that hardly moves.
-   */
-  const showsAtRest = (
-    property: MotionProperty,
-    segment: Segment,
-    time: number,
-  ): boolean =>
-    Math.abs(valueAt(property, time) - segment.target) <=
-      REST_DISTANCE_TOLERANCES * SAMPLE_TOLERANCE[property] &&
-    Math.abs(velocityAt(property, time)) <=
-      SAMPLE_TOLERANCE[property] * REST_FRAMES_PER_SECOND;
-
   const velocityAt = (property: MotionProperty, time: number): number => {
     const held = segments.get(property);
     if (held != null && isHeld(held)) {
@@ -2062,10 +2033,10 @@ export function createMotionAnimator(
   // -- starting from rest ---------------------------------------------------
 
   /**
-   * A call starts from rest when nothing on the channels it drives moves on
-   * screen and nothing pins its clock (`at`). A curve still waiting for its
-   * first frame counts as rest, as does one whose tail already shows as at
-   * rest. Returns its start group, or null for an explicit start.
+   * A call starts from rest when nothing on the channels it drives is moving
+   * (a curve still waiting for its first frame counts as rest) and nothing
+   * pins its clock (`at`). Returns its start group, or null for an explicit
+   * start.
    */
   const beginGroup = (
     time: number,
@@ -2099,12 +2070,10 @@ export function createMotionAnimator(
       }
       return null;
     }
-    // A call that continues motion starts now, unless it asks for the
-    // browser's start (`commit`). `presented` asks only for a call from rest.
-    // A curve that still moves is not at rest, so a call on it starts now,
-    // from the value and velocity on screen. A tail that shows as at rest
-    // counts as rest, so a call on it waits, under `presented` for its two
-    // frames.
+    // A call that continues motion starts now unless it asks for the
+    // browser's start (`commit`). `presented` asks only for a call from rest:
+    // an element still moving is not at rest, so a retarget starts now, from
+    // the value and velocity on screen (spec:AST-094 FR6).
     for (const channel of start === 'commit' ? [] : channels) {
       for (const property of CHANNELS[channel]) {
         const segment = segments.get(property);
@@ -2115,8 +2084,7 @@ export function createMotionAnimator(
           time < endOf(property, segment) &&
           (segment.group == null ||
             segment.group.resolved ||
-            shownSince(property, segment) != null) &&
-          !showsAtRest(property, segment, time)
+            shownSince(property, segment) != null)
         ) {
           return null;
         }

package/src/utils/dateParser.ts

@@ -32,11 +32,6 @@ export function isLocaleDayFirst(locale: Locale = 'en'): boolean {
   return dayIndex < monthIndex;
 }
 
-// Built at run time: a Unicode property escape in a literal fails a source
-// build whose Babel lacks the Unicode data.
-const LETTER_FREE = new RegExp('^[^\\p{L}]+$', 'u');
-const YEAR_FIRST = new RegExp('^\\d{4}[^\\p{L}\\d]', 'u');
-
 /**
  * Parses user input into a PlainDate.
  *
@@ -143,17 +138,6 @@ export function parseDateInput(
   if (/^\d+$/.test(trimmed)) {
     return null;
   }
-  // In a day-first locale, letter-free text that no form above matched is not
-  // a date. Native `Date` reads `a/b/c` month first. It also takes a year of
-  // one to three digits. So "12/01/2" gives a wrong date. A four-digit year
-  // written first is not ambiguous.
-  if (
-    isLocaleDayFirst(locale) &&
-    LETTER_FREE.test(trimmed) &&
-    !YEAR_FIRST.test(trimmed)
-  ) {
-    return null;
-  }
 
   const parsed = new Date(trimmed);
   if (!isNaN(parsed.getTime())) {

package/src/utils/focusReturn.ts

@@ -151,33 +151,3 @@ export function focusForLastInput(
   }
   element.focus({...options, focusVisible: false});
 }
-
-/**
- * Prepares the focus return for an open surface that may be removed while
- * open (rendered only while open, or removed with its view). Removing a
- * `<dialog>` runs no close and no browser focus return. Call this while the
- * surface is mounted: it reads the frame that hosts the surface now, because a
- * removed frame's document has no window. Call the returned function from the
- * effect cleanup with the opener.
- *
- * Once the commit has finished, focus moves to the opener only when the
- * surface really left the document (StrictMode's simulated unmount keeps it),
- * the opener is still on the page, and the removal lost focus, both in the
- * surface's document and in the document that hosts its frame. A control the
- * user pressed outside the surface, or outside its frame, keeps its focus.
- */
-export function prepareFocusReturnOnRemoval(
-  surface: Element,
-): (opener: Element | null) => void {
-  const host = surface.ownerDocument.defaultView?.frameElement ?? null;
-  return opener => {
-    queueMicrotask(() => {
-      if (surface.isConnected || opener == null || !opener.isConnected) {
-        return;
-      }
-      if (isFocusLost(surface) && (host == null || isFocusLost(host))) {
-        focusForLastInput(opener as HTMLElement);
-      }
-    });
-  };
-}

package/src/utils/interactionOverlay.stylex.ts

@@ -15,9 +15,8 @@
  * SYNC: When modified, update pressFeedback.ts, pressGesture.ts (the fade
  * clock), hooks/usePressFeedback.doc.mjs, the components that paint the touch
  * press off an ancestor scope or a pseudo-element (Switch, Tab,
- * CheckboxInput, RadioListItem, ClickableCard, SelectableCard, Thumbnail),
- * Button (a tracked action sizes its `:active` image to zero) and
- * scripts/build-css.test.mjs.
+ * CheckboxInput, RadioListItem, ClickableCard, SelectableCard, Thumbnail)
+ * and scripts/build-css.test.mjs.
  */
 
 // Every surface that paints a press uses one of these styles, so a change to

package/src/utils/pressFeedback.ts

@@ -2,8 +2,8 @@
 
 /**
  * @file pressFeedback.ts
- * @input The press state machine (pressGesture.ts), the menu-press and
- *   press-group markers and the document's pointer, keyboard, scroll and
+ * @input The press state machine (pressGesture.ts), the menu-press marker
+ *   (hooks/menuPressMarker.ts) and the document's pointer, keyboard, scroll and
  *   visibility events
  * @output PRESSABLE_ATTRIBUTE, PRESSED_ATTRIBUTE, pressableProps and
  *   installPressFeedback
@@ -46,7 +46,6 @@ import {isCoarsePointer, watchCoarsePointer} from './coarsePointer';
 import {subscribeInput} from './inputStream';
 import {TOUCH_QUERY} from './touchPresentation';
 import {holdsPressThroughDrag} from '../privateAttributes/pressHoldsDrag.stylex';
-import {isTrackedByGroup} from '../privateAttributes/pressGroupItem.stylex';
 
 /**
  * The marker the controller finds with `closest()`. Every Astryx component
@@ -326,9 +325,8 @@ function stylesheetDroppedActive(): boolean {
 
 /**
  * The surface a mouse button's or the Space key's press paints, if any: the
- * innermost marked surface, outside a menu and off a tracked action. A key's
- * press paints only a focused element that is itself the surface, as
- * `:active` does.
+ * innermost marked surface, outside a menu. A key's press paints only a
+ * focused element that is itself the surface, as `:active` does.
  */
 function buttonSurfaceAt(
   target: EventTarget | null,
@@ -338,10 +336,6 @@ function buttonSurfaceAt(
   if (element == null || element.closest(MENU_PRESS_ROOT) != null) {
     return null;
   }
-  // A group's tracker follows pointers only, so a key's press stays here.
-  if (pointerId != null && isTrackedByGroup(element)) {
-    return null;
-  }
   if (pointerId == null && element !== target) {
     return null;
   }
@@ -420,9 +414,7 @@ function onPointerDown(event: PointerEvent): void {
   const braking = element != null && scrollerIsBraking(element);
   lastTouchAt = Date.now();
   lastTouchTarget = event.target instanceof Node ? event.target : null;
-  // A group's tracker paints a tracked action, so two writers would erase each
-  // other's paint. The touch still counts for the brake above.
-  if (element == null || braking || isTrackedByGroup(element)) {
+  if (element == null || braking) {
     return;
   }
   takeOver(button, element);
@@ -568,11 +560,6 @@ function activatesOnSpace(target: EventTarget | null): boolean {
   );
 }
 
-/** A tracked action takes no `:active` paint, so a key's press paints here. */
-function isTrackedAction(target: EventTarget | null): boolean {
-  return target instanceof Element && isTrackedByGroup(target);
-}
-
 /**
  * Space went down on a focused button that is itself a pressable surface.
  * Heard in the BUBBLE phase, after the page's own handlers, so a press the
@@ -586,7 +573,7 @@ function onKeyDown(event: KeyboardEvent): void {
     event.isComposing ||
     event.defaultPrevented ||
     !activatesOnSpace(event.target) ||
-    !(stylesheetDroppedActive() || isTrackedAction(event.target))
+    !stylesheetDroppedActive()
   ) {
     return;
   }

package/dist/PowerSearch/PowerSearchBottomSheet.d.ts

@@ -1,100 +0,0 @@
-/**
- * @file PowerSearchBottomSheet.tsx
- * @input The field's InternalConfig, filters, onChange, the field typeahead
- *   source, and the sheet options PowerSearch forwards; BottomSheet,
- *   Button, EmptyState, Heading, Icon, IconButton, Indicator, List,
- *   RadioList, Text, TextInput, PowerSearchValueEditor, the internal sheet
- *   confirmation and search-drag owners, i18n
- * @output Exports PowerSearchBottomSheet — the touch surface of
- *   `PowerSearch experimental.presentation="bottom-sheet"`: a Filters sheet
- *   with editable rows and trailing remove actions, Add filter in its fixed
- *   header and Clear all / Done in its fixed footer, an Add filter sheet with
- *   grouped field rows or the content search with inline suggestions, and a
- *   value step that stages field → operator → value and confirms from its
- *   footer
- * @position Internal presentation surface of PowerSearch. Loaded on demand by
- *   PowerSearch.tsx so the popover presentation never carries it. The
- *   trigger lives in PowerSearch.tsx.
- *
- * The three steps are sibling standalone BottomSheets that stack: each step
- * opens above the sheet that led to it, which stays open beneath as a covered
- * sheet, so no sheet needs a Back action. A dismissal closes only the top
- * sheet and reveals the step beneath; dismissing the bottom sheet ends the
- * flow. A list value's Tokenizer opens its own sheet above the value step, as
- * the top sheet of the stack.
- *
- * The sheets pad their own content (`padding={0}` on BottomSheet). The
- * Filters and Add filter sheets keep their header and footer fixed around a
- * scroll viewport that reaches the sheet edge; its content publishes the
- * padding as container padding so `edge="bleed"` lists run edge to edge with
- * row text on the header's inset. The sheets are pinned tall: the field list
- * resizes as it is searched and the editor changes with the operator, and
- * only a fully expanded tall sheet gives mobile-keyboard accommodation.
- *
- * SYNC: When modified, update:
- * - /packages/core/src/PowerSearch/PowerSearch.tsx (the trigger and the lazy host)
- * - /docs/specs/components/PowerSearch/PowerSearch.spec.md (FR10–FR21, AR4–AR6, PR5)
- */
-import React, { type RefObject } from 'react';
-import type { SearchSource } from '../Typeahead/types.js';
-import type { buildRelativeDateOptions, PowerSearchValueEditor } from './PowerSearchValueEditor.js';
-import type { NestedEditor } from './PowerSearchEditPopover.js';
-import type { InternalConfig } from './useInternalConfig.js';
-import type { PowerSearchChangeType, PowerSearchComponents, PowerSearchConfig, PowerSearchFilter, PowerSearchItem } from './types.js';
-/**
- * The popover presentation's editors, which the value step reuses. They come
- * from PowerSearch.tsx, whose module graph already loads them for the popover
- * presentation. Imported here, they and every component they reach would join
- * this lazily imported graph, whose modules must import Core directly and
- * never through a barrel.
- */
-export interface PowerSearchSheetEditors {
-    NestedEditor: typeof NestedEditor;
-    PowerSearchValueEditor: typeof PowerSearchValueEditor;
-    buildRelativeDateOptions: typeof buildRelativeDateOptions;
-}
-export interface PowerSearchBottomSheetProps {
-    /** Whether the flow is open; the trigger in PowerSearch.tsx owns it. */
-    isOpen: boolean;
-    onOpenChange: (isOpen: boolean) => void;
-    /**
-     * The trigger: where focus returns when the flow closes, whichever step
-     * closed it and however it opened (a tap on a token included).
-     */
-    finalFocusRef: RefObject<HTMLElement | null>;
-    /**
-     * The field's formatted result count, announced from inside the open
-     * sheet's dialog when it changes while the flow is open. `useAnnounce`
-     * routes a message by where its caller is, so the owner above the sheets
-     * cannot reach the dialog's region.
-     */
-    resultCountText?: string | null;
-    config: InternalConfig;
-    /** The caller's config, handed to Editor overrides as they expect it. */
-    configProp: PowerSearchConfig;
-    filters: ReadonlyArray<PowerSearchFilter>;
-    onChange: (filters: ReadonlyArray<PowerSearchFilter>, changeType: PowerSearchChangeType, index: number) => void;
-    /** The field typeahead source; the content search lists its suggestions. */
-    searchSource: SearchSource<PowerSearchItem>;
-    /** Placeholder of the content search. */
-    placeholder: string;
-    isReadOnly: boolean;
-    isDisabled: boolean;
-    hasClear: boolean;
-    maxOperatorMenuItems?: number;
-    maxSearchResults: number;
-    /** The caller's confirm label; the step picks a default per mode. */
-    saveButtonLabel?: string;
-    components?: PowerSearchComponents;
-    editors: PowerSearchSheetEditors;
-}
-/**
- * The sheet flow of PowerSearch's touch presentation: Filters, Add filter,
- * and the value step, as standalone sheets that stack, each open beneath the
- * step it led to.
- */
-export declare function PowerSearchBottomSheet({ isOpen, onOpenChange, finalFocusRef, resultCountText, config, configProp, filters, onChange, searchSource, placeholder, isReadOnly, isDisabled, hasClear, maxOperatorMenuItems, maxSearchResults, saveButtonLabel: saveButtonLabelFromProps, components: componentOverrides, editors, }: PowerSearchBottomSheetProps): React.JSX.Element;
-export declare namespace PowerSearchBottomSheet {
-    var displayName: string;
-}
-//# sourceMappingURL=PowerSearchBottomSheet.d.ts.map

package/dist/PowerSearch/PowerSearchBottomSheet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PowerSearchBottomSheet.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/PowerSearchBottomSheet.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,EASZ,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAoBf,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAkCrD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAe3D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAIV,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EAEjB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAajB;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;CAC3D;AAED,MAAM,WAAW,2BAA2B;IAC1C,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,aAAa,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,yEAAyE;IACzE,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,EAAE,CACR,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,KACV,IAAI,CAAC;IACV,4EAA4E;IAC5E,YAAY,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IAC5C,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAymBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,YAAY,EACZ,aAAa,EACb,eAAe,EACf,MAAM,EACN,UAAU,EACV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAAE,wBAAwB,EACzC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GACR,EAAE,2BAA2B,qBAqoD7B;yBAxpDe,sBAAsB"}