@flemo/core 2.1.0 → 2.2.1

package/dist/transition/partTransition/partTransition.d.ts

@@ -1,2 +1,19 @@
+import { BaseTransition, Transition } from '../typing';
 import { PartTransition, PartTransitionName } from './typing';
 export declare const partTransitionMap: Map<PartTransitionName, PartTransition>;
+/**
+ * A registered part, with the clock the CURRENT flight gives it.
+ *
+ * Every reader of a part's timing goes through here, because the compiled CSS
+ * does: the rule a part actually runs carries the resolved clock (see
+ * resolvePartClock and the pair pass in compileTransitionStyles), so a reader
+ * that resolved the authored variants instead would disagree with the glass.
+ * That disagreement is not cosmetic — the choreography span decides how long
+ * the whole flight stays open, and the layer pin decides what stays promoted
+ * across the COMPLETED flip.
+ *
+ * `transition` is null only where there is no flight to inherit from, which is
+ * a part mounted outside any screen. It then reads exactly what it authored,
+ * matching the by-name rule that is the only one such a part selects.
+ */
+export declare const resolvePartDefinition: (name: string | null, transition: Pick<Transition, "variants"> | null) => Pick<BaseTransition, "initial" | "variants"> | undefined;

package/dist/transition/partTransition/resolvePartClock.d.ts

@@ -0,0 +1,41 @@
+import { BaseTransition, Transition } from '../typing';
+import { PartTransition } from './typing';
+/**
+ * A part's variant table with its clock filled in from the screen transition
+ * carrying the flight.
+ *
+ * A `<Part>` declares a POSE: what the piece of chrome looks like on each side
+ * of a hand-over. How long it takes to get there is not its own question — it
+ * is the flight's, and the flight already answered it. Authoring the length a
+ * second time is how the two drift apart, and an omitted length was worse than
+ * drift: it resolved to zero and the part SNAPPED while the screen carrying it
+ * took three quarters of a second.
+ *
+ * This is the rule `resolveDecoratorClock` already applies to decorators, for
+ * the same reason and by the same mapping: the SAME VARIANT KEY. A part's
+ * PUSHING-false sits with the screen's PUSHING-false, so a preset whose push
+ * and pop differ (material runs 0.35s and 0.25s) gives its parts the same
+ * asymmetry without the author restating it.
+ *
+ * WHERE IT DIFFERS from a decorator, and why this could not simply reuse it: a
+ * decorator is reached through `transition.decoratorName`, so it belongs to one
+ * transition and can be resolved once. A part is referenced by NAME and may
+ * appear under any transition in the Router, so the pair is resolved per
+ * transition and the compiled rule carries a `data-flemo-transition` term to
+ * select the right one. A part mounted outside any screen has no transition to
+ * inherit from and keeps what it authored.
+ *
+ * `transition` is null where there is no flight to inherit from — the by-name
+ * pass, and a part mounted outside any screen. It then normalizes rather than
+ * inherits: every variant comes back with a clock, so nothing downstream has to
+ * carry the optional shape. That normalization is the reason PartVariantValue's
+ * looseness stops here, exactly as DecoratorVariantValue's does.
+ *
+ * Resolution is COMPILE TIME and produces a literal. It must never become a
+ * `var()` in `animation-duration`: timing that depended on custom properties
+ * lost WebKit's accelerated playback and collapsed to a 2-frame snap under
+ * main-thread starvation (device-bisected 2026-08-13, see
+ * compileTransitionStyles.ts).
+ */
+export declare const resolvePartClock: (transition: Pick<Transition, "variants"> | null, part: Pick<PartTransition, "initial" | "variants">) => Pick<BaseTransition, "initial" | "variants">;
+export default resolvePartClock;

package/dist/transition/partTransition/typing.d.ts

@@ -1,4 +1,9 @@
-import { BaseTransition, SwipeAnimate } from '../typing';
+import { AnimationOptions, TransitionTarget } from '../cssTypes';
+import { BaseTransition, SwipeAnimate, TransitionVariant } from '../typing';
+export type PartVariantValue = {
+    value: TransitionTarget;
+    options?: AnimationOptions;
+};
 export interface RegisterPartTransition {
 }
 export type PartTransitionName = RegisterPartTransition[keyof RegisterPartTransition] | (string & {});
@@ -19,6 +24,7 @@ export type PartTransitionOptions = {
         active: boolean;
     }) => void;
 };
-export interface PartTransition extends Omit<BaseTransition, "name">, PartTransitionOptions {
+export interface PartTransition extends Omit<BaseTransition, "name" | "variants">, PartTransitionOptions {
     name: PartTransitionName;
+    variants: Record<TransitionVariant, PartVariantValue>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flemo/core",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Framework-agnostic primitives for flemo: history, navigation, transitions, task manager.",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",

package/dist/core/engine/__tests__/diagnosticRegistry.test.d.ts

@@ -1,10 +0,0 @@
-declare global {
-    interface ImportMeta {
-        glob(pattern: string, options: {
-            query: string;
-            import: string;
-            eager: true;
-        }): Record<string, string>;
-    }
-}
-export {};

package/dist/core/engine/diagnosticFlags.d.ts

@@ -1,16 +0,0 @@
-export declare const readImageHoldFlag: () => "on" | "off" | null;
-export declare const morphTraceArmed: () => boolean;
-export declare const readSettleGateFlag: () => boolean;
-export declare const readArrivalHoldFlag: () => boolean;
-export declare const readDesktopReleaseFlipFlag: () => boolean;
-export declare const readCreepHeadFlag: () => boolean;
-export declare const readDeferReleaseCommitFlag: () => boolean;
-export declare const readDesktopHeadFlag: () => boolean;
-export declare const readPrerasterFlag: () => boolean;
-export declare const readRestLayerPromotionFlag: () => boolean;
-export declare const readImageOffloadOverride: () => "on" | "off" | null;
-export declare const readBlinkGovernedOverride: () => "on" | "off" | null;
-export declare const residentScreenLayers: () => boolean;
-export declare const resetResidentLayersForTesting: () => void;
-export declare const shallowFreeze: () => boolean;
-export declare const resetShallowFreezeForTesting: () => void;

package/dist/core/engine/diagnosticRegistry.d.ts

@@ -1,38 +0,0 @@
-/**
- * What kind of thing a flag is — which decides how a report should read it.
- *
- * - `production-state`: written by the library itself (a learned ledger). Never
- *   set by hand; the KEY STRINGS are frozen, since users' devices carry
- *   persisted values.
- * - `production-default-with-override`: the library computes a default and the
- *   key overrides it both ways, for field debugging.
- * - `opt-in-diagnostic`: default OFF. A measurement instrument that ships so a
- *   device session can be probed without a custom build.
- */
-export type DiagnosticFlagKind = "production-state" | "production-default-with-override" | "opt-in-diagnostic";
-export interface DiagnosticFlag {
-    readonly key: string;
-    readonly storage: "session" | "local";
-    readonly kind: DiagnosticFlagKind;
-    /** Accepted values, for a report or a panel to offer. */
-    readonly values: string;
-    /** The default when the key is unset. */
-    readonly fallback: string;
-    readonly effect: string;
-}
-/** Every `flemo:*` key the library reads today. */
-export declare const DIAGNOSTIC_FLAGS: readonly DiagnosticFlag[];
-export interface RetiredDiagnosticFlag {
-    readonly key: string;
-    readonly storage: "session" | "local";
-    /** What it used to do, and when it stopped doing it. */
-    readonly retiredWith: string;
-}
-/**
- * Keys the library once read and no longer does. Declared so a report can say
- * "this is set, and it does nothing" — residue that is merely unknown reads as
- * a lead worth chasing, and one such key once burned a multi-day investigation.
- *
- * Values persisted on users' devices are never read again.
- */
-export declare const RETIRED_DIAGNOSTIC_FLAGS: readonly RetiredDiagnosticFlag[];

package/dist/core/engine/imageRevealHold.d.ts

@@ -1,2 +0,0 @@
-export declare function beginImageRevealHold(scope: Element | null, backstopMs: number, unpaintedOnly?: boolean): () => void;
-export default beginImageRevealHold;

package/dist/morph/morphAnimations.d.ts

@@ -1,2 +0,0 @@
-export declare function preserveDescendantAnimations(root: Element, move: () => void): void;
-export default preserveDescendantAnimations;