foldkit 0.100.1 → 0.102.0

package/dist/ui/toast/update.d.ts

@@ -89,6 +89,9 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         entryId: S.String;
         message: S.Union<[import("../../schema/index.js").CallableTaggedStruct<"Showed", {}>, import("../../schema/index.js").CallableTaggedStruct<"Hid", {}>, import("../../schema/index.js").CallableTaggedStruct<"AdvancedAnimationFrame", {}>, import("../../schema/index.js").CallableTaggedStruct<"EndedAnimation", {}>]>;
     }>]>;
+    readonly OutMessage: S.Union<readonly [import("../../schema/index.js").CallableTaggedStruct<"DismissedToast", {
+        payload: S.Codec<A, I, never, never>;
+    }>]>;
     readonly Added: import("../../schema/index.js").CallableTaggedStruct<"Added", {
         entry: S.Struct<{
             readonly id: S.String;
@@ -104,12 +107,15 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
             readonly payload: S.Codec<A, I, never, never>;
         }>;
     }>;
+    readonly DismissedToast: import("../../schema/index.js").CallableTaggedStruct<"DismissedToast", {
+        payload: S.Codec<A, I, never, never>;
+    }>;
     readonly init: (config: InitConfig) => {
         readonly id: string;
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -127,7 +133,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -170,7 +176,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly _tag: "Added";
         readonly entry: {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -186,7 +192,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -232,7 +238,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
             readonly _tag: "Added";
             readonly entry: {
                 readonly id: string;
-                readonly variant: "Success" | "Error" | "Info" | "Warning";
+                readonly variant: "Error" | "Success" | "Info" | "Warning";
                 readonly animation: {
                     readonly id: string;
                     readonly isShowing: boolean;
@@ -244,13 +250,16 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
                 readonly payload: A;
             };
         }, never, never>;
-    }>[]];
+    }>[], Option.Option<{
+        readonly _tag: "DismissedToast";
+        readonly payload: A;
+    }>];
     readonly show: (model: {
         readonly id: string;
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -267,7 +276,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -313,7 +322,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
             readonly _tag: "Added";
             readonly entry: {
                 readonly id: string;
-                readonly variant: "Success" | "Error" | "Info" | "Warning";
+                readonly variant: "Error" | "Success" | "Info" | "Warning";
                 readonly animation: {
                     readonly id: string;
                     readonly isShowing: boolean;
@@ -325,13 +334,16 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
                 readonly payload: A;
             };
         }, never, never>;
-    }>[]];
+    }>[], Option.Option<{
+        readonly _tag: "DismissedToast";
+        readonly payload: A;
+    }>];
     readonly dismiss: (model: {
         readonly id: string;
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -348,7 +360,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -394,7 +406,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
             readonly _tag: "Added";
             readonly entry: {
                 readonly id: string;
-                readonly variant: "Success" | "Error" | "Info" | "Warning";
+                readonly variant: "Error" | "Success" | "Info" | "Warning";
                 readonly animation: {
                     readonly id: string;
                     readonly isShowing: boolean;
@@ -406,13 +418,16 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
                 readonly payload: A;
             };
         }, never, never>;
-    }>[]];
+    }>[], Option.Option<{
+        readonly _tag: "DismissedToast";
+        readonly payload: A;
+    }>];
     readonly dismissAll: (model: {
         readonly id: string;
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -429,7 +444,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
         readonly defaultDuration: Duration.Duration;
         readonly entries: readonly {
             readonly id: string;
-            readonly variant: "Success" | "Error" | "Info" | "Warning";
+            readonly variant: "Error" | "Success" | "Info" | "Warning";
             readonly animation: {
                 readonly id: string;
                 readonly isShowing: boolean;
@@ -475,7 +490,7 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
             readonly _tag: "Added";
             readonly entry: {
                 readonly id: string;
-                readonly variant: "Success" | "Error" | "Info" | "Warning";
+                readonly variant: "Error" | "Success" | "Info" | "Warning";
                 readonly animation: {
                     readonly id: string;
                     readonly isShowing: boolean;
@@ -487,6 +502,9 @@ export declare const makeRuntime: <A, I>(payloadSchema: S.Codec<A, I>) => {
                 readonly payload: A;
             };
         }, never, never>;
-    }>[]];
+    }>[], Option.Option<{
+        readonly _tag: "DismissedToast";
+        readonly payload: A;
+    }>];
 };
 //# sourceMappingURL=update.d.ts.map

package/dist/ui/toast/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/ui/toast/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,MAAM,EAGN,MAAM,EACN,MAAM,IAAI,CAAC,EACZ,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAcjD,OAAO,EAML,KAAK,UAAU,EACf,KAAK,OAAO,EAKb,MAAM,aAAa,CAAA;AAIpB;;oDAEoD;AACpD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC;IAClC,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAC,CAAA;AAEF;;;eAGe;AACf,eAAO,MAAM,YAAY;;;;;;;;iBAUxB,CAAA;AAID;;;;;;4EAM4E;AAC5E,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAqItC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmIG,SAAS,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAIP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB/C,CAAA"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/ui/toast/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,MAAM,EAGN,MAAM,EACN,MAAM,IAAI,CAAC,EACZ,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAcjD,OAAO,EAML,KAAK,UAAU,EACf,KAAK,OAAO,EAOb,MAAM,aAAa,CAAA;AAIpB;;oDAEoD;AACpD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC;IAClC,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAC,CAAA;AAEF;;;eAGe;AACf,eAAO,MAAM,YAAY;;;;;;;;iBAUxB,CAAA;AAID;;;;;;4EAM4E;AAC5E,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6ItC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+IG,SAAS,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAIP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/C,CAAA"}

package/dist/ui/toast/update.js

@@ -4,7 +4,7 @@ import { OptionExt } from '../../effectExtensions/index.js';
 import { evo } from '../../struct/index.js';
 import { Hid as AnimationHid, Showed as AnimationShowed, init as animationInit, } from '../animation/schema.js';
 import { defaultLeaveCommand as animationDefaultLeaveCommand, update as animationUpdate, } from '../animation/update.js';
-import { DEFAULT_DURATION, Dismissed, DismissedAll, ElapsedDuration, GotAnimationMessage, makeAdded, makeEntry, makeMessage, makeModel, } from './schema.js';
+import { DEFAULT_DURATION, Dismissed, DismissedAll, ElapsedDuration, GotAnimationMessage, makeAdded, makeDismissedToast, makeEntry, makeMessage, makeModel, makeOutMessage, } from './schema.js';
 /** Schedules an auto-dismiss timer for an entry. The result Message carries a
  *  version so stale timers (from hover or manual dismiss) are discarded in
  *  the update function. Static. The Command definition doesn't depend on
@@ -26,7 +26,9 @@ export const makeRuntime = (payloadSchema) => {
     const EntrySchema = makeEntry(payloadSchema);
     const ModelSchema = makeModel(payloadSchema);
     const MessageSchema = makeMessage(payloadSchema);
+    const OutMessageSchema = makeOutMessage(payloadSchema);
     const Added = makeAdded(payloadSchema);
+    const DismissedToast = makeDismissedToast(payloadSchema);
     const withUpdateReturn = M.withReturnType();
     const updateEntry = (model, entryId, f) => evo(model, {
         entries: Array.map(entry => (entry.id === entryId ? f(entry) : entry)),
@@ -55,11 +57,11 @@ export const makeRuntime = (payloadSchema) => {
     const delegateToEntryAnimation = (model, entryId, animationMessage) => {
         const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
         return Option.match(maybeEntry, {
-            onNone: () => [model, []],
+            onNone: () => [model, [], Option.none()],
             onSome: entry => {
                 const [nextAnimation, animationCommands, maybeOutMessage] = animationUpdate(entry.animation, animationMessage);
                 const toMessage = (message) => GotAnimationMessage({ entryId, message });
-                const mappedCommands = animationCommands.map(Command.mapEffect(Effect.map(toMessage)));
+                const mappedCommands = Command.mapMessages(animationCommands, toMessage);
                 const nextEntry = evo(entry, {
                     animation: () => nextAnimation,
                 });
@@ -67,18 +69,21 @@ export const makeRuntime = (payloadSchema) => {
                     onNone: () => [
                         updateEntry(model, entryId, () => nextEntry),
                         mappedCommands,
+                        Option.none(),
                     ],
                     onSome: M.type().pipe(withUpdateReturn, M.tagsExhaustive({
                         StartedLeaveAnimating: () => [
                             updateEntry(model, entryId, () => nextEntry),
                             [
                                 ...mappedCommands,
-                                Command.mapEffect(animationDefaultLeaveCommand(nextAnimation), Effect.map(toMessage)),
+                                Command.mapMessage(animationDefaultLeaveCommand(nextAnimation), toMessage),
                             ],
+                            Option.none(),
                         ],
                         TransitionedOut: () => [
                             removeEntry(model, entryId),
                             mappedCommands,
+                            Option.some(DismissedToast({ payload: entry.payload })),
                         ],
                     })),
                 });
@@ -110,7 +115,9 @@ export const makeRuntime = (payloadSchema) => {
         entries: [],
         nextEntryKey: 0,
     });
-    /** Processes a toast message and returns the next model and commands. */
+    /** Processes a toast message and returns the next model, commands, and
+     *  an optional `DismissedToast` OutMessage emitted once an entry has
+     *  finished its leave animation. */
     const update = (model, message) => M.value(message).pipe(withUpdateReturn, M.tagsExhaustive({
         Added: ({ entry }) => {
             const modelWithEntry = evo(model, {
@@ -123,15 +130,19 @@ export const makeRuntime = (payloadSchema) => {
                 onNone: () => [],
                 onSome: rescheduleDismissCommands,
             });
-            return [modelAfterShow, [...showCommands, ...dismissCommands]];
+            return [
+                modelAfterShow,
+                [...showCommands, ...dismissCommands],
+                Option.none(),
+            ];
         },
         Dismissed: ({ entryId }) => {
             const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
             return Option.match(maybeEntry, {
-                onNone: () => [model, []],
+                onNone: () => [model, [], Option.none()],
                 onSome: entry => {
                     if (isEntryLeaving(entry)) {
-                        return [model, []];
+                        return [model, [], Option.none()];
                     }
                     else {
                         return delegateToEntryAnimation(model, entryId, AnimationHid());
@@ -139,21 +150,25 @@ export const makeRuntime = (payloadSchema) => {
                 },
             });
         },
-        DismissedAll: () => Array.reduce(model.entries, [model, []], ([currentModel, currentCommands], entry) => {
+        DismissedAll: () => Array.reduce(model.entries, [model, [], Option.none()], ([currentModel, currentCommands, currentOut], entry) => {
             if (isEntryLeaving(entry)) {
-                return [currentModel, currentCommands];
+                return [currentModel, currentCommands, currentOut];
             }
             const [nextModel, nextCommands] = delegateToEntryAnimation(currentModel, entry.id, AnimationHid());
-            return [nextModel, [...currentCommands, ...nextCommands]];
+            return [
+                nextModel,
+                [...currentCommands, ...nextCommands],
+                currentOut,
+            ];
         }),
         ElapsedDuration: ({ entryId, version }) => {
             const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
             return Option.match(maybeEntry, {
-                onNone: () => [model, []],
+                onNone: () => [model, [], Option.none()],
                 onSome: entry => {
                     const isStale = version !== entry.pendingDismissVersion;
                     if (isStale || isEntryLeaving(entry)) {
-                        return [model, []];
+                        return [model, [], Option.none()];
                     }
                     else {
                         return delegateToEntryAnimation(model, entryId, AnimationHid());
@@ -167,11 +182,12 @@ export const makeRuntime = (payloadSchema) => {
                 pendingDismissVersion: Number.increment,
             })),
             [],
+            Option.none(),
         ],
         LeftEntry: ({ entryId }) => {
             const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
             return Option.match(maybeEntry, {
-                onNone: () => [model, []],
+                onNone: () => [model, [], Option.none()],
                 onSome: entry => {
                     const nextEntry = evo(entry, {
                         isHovered: () => false,
@@ -180,6 +196,7 @@ export const makeRuntime = (payloadSchema) => {
                     return [
                         updateEntry(model, entryId, () => nextEntry),
                         rescheduleDismissCommands(nextEntry),
+                        Option.none(),
                     ];
                 },
             });
@@ -196,7 +213,9 @@ export const makeRuntime = (payloadSchema) => {
         Entry: EntrySchema,
         Model: ModelSchema,
         Message: MessageSchema,
+        OutMessage: OutMessageSchema,
         Added,
+        DismissedToast,
         init,
         update,
         show,

package/dist/ui/tooltip/index.d.ts

@@ -1,9 +1,10 @@
-import { Duration, Effect, Schema as S } from 'effect';
+import { Duration, Effect, Option, Schema as S } from 'effect';
 import * as Command from '../../command/index.js';
-import { type Attribute, type Html } from '../../html/index.js';
+import { type ChildAttribute, type Html } from '../../html/index.js';
 import * as Mount from '../../mount/index.js';
+import type { Reflect } from '../../submodel/submodel.js';
 import { AnchorConfig } from '../anchor.js';
-/** Schema for the tooltip component's state. `isOpen` is visibility; `isHovered` tracks pointer on trigger; `isFocused` tracks tooltip-affirming focus on the trigger (focus arriving without a preceding mouse press — keyboard, touch, or pen; mouse-click-induced focus is excluded since it doesn't affirm the user wants the tooltip visible); `isDismissed` suppresses re-opening after the user dismissed the tooltip (via Escape or left-click) until they disengage (leave or blur). `showDelay` is the hover-to-show duration. `maybeLastPointerType` records the most recent pointer type that pressed the trigger, so a mouse-click-induced focus can be distinguished from other focus. */
+/** Schema for the tooltip component's state. `isOpen` is visibility; `isHovered` tracks pointer on trigger; `isFocused` tracks tooltip-affirming focus on the trigger (focus arriving without a preceding mouse press, like keyboard, touch, or pen; mouse-click-induced focus is excluded since it doesn't affirm the user wants the tooltip visible); `isDismissed` suppresses re-opening after the user dismissed the tooltip (via Escape or left-click) until they disengage (leave or blur). `showDelay` is the hover-to-show duration. `maybeLastPointerType` records the most recent pointer type that pressed the trigger, so a mouse-click-induced focus can be distinguished from other focus. */
 export declare const Model: S.Struct<{
     readonly id: S.String;
     readonly isOpen: S.Boolean;
@@ -15,30 +16,26 @@ export declare const Model: S.Struct<{
     readonly maybeLastPointerType: S.Option<S.String>;
 }>;
 export type Model = typeof Model.Type;
-/** Sent when the pointer enters the tooltip trigger. Starts the show-delay timer. */
+/** Sent when the pointer enters the tooltip trigger. */
 export declare const EnteredTrigger: import("../../schema/index.js").CallableTaggedStruct<"EnteredTrigger", {}>;
-/** Sent when the pointer leaves the tooltip trigger. Cancels any pending show-delay and hides the tooltip unless focus is active. */
+/** Sent when the pointer leaves the tooltip trigger. */
 export declare const LeftTrigger: import("../../schema/index.js").CallableTaggedStruct<"LeftTrigger", {}>;
-/** Sent when focus enters the trigger. Shows the tooltip immediately unless the focus was caused by a mouse press, in which case the hover-delay path handles it instead. */
+/** Sent when focus enters the trigger. */
 export declare const FocusedTrigger: import("../../schema/index.js").CallableTaggedStruct<"FocusedTrigger", {}>;
-/** Sent when focus leaves the trigger. Hides the tooltip unless hover is active. */
+/** Sent when focus leaves the trigger. */
 export declare const BlurredTrigger: import("../../schema/index.js").CallableTaggedStruct<"BlurredTrigger", {}>;
-/** Sent when Escape is pressed while the tooltip is visible. Hides the tooltip and flags `isDismissed` so hover and focus do not re-open it until the user disengages (leaves or blurs the trigger). */
+/** Sent when Escape is pressed while the tooltip is visible. */
 export declare const PressedEscape: import("../../schema/index.js").CallableTaggedStruct<"PressedEscape", {}>;
-/** Sent when a pointer presses the trigger. Records the pointer type so a following focus event from the same mouse click can be suppressed, and a left-click on an open tooltip dismisses it (the user is clicking the button for its action, not to keep the tooltip visible). */
+/** Sent when a pointer presses the trigger. */
 export declare const PressedPointerOnTrigger: import("../../schema/index.js").CallableTaggedStruct<"PressedPointerOnTrigger", {
     pointerType: S.String;
     button: S.Number;
 }>;
-/** Sent when the show-delay timer fires. Carries a generation number that is compared against the current pending version to discard stale timers. */
+/** Sent when the show-delay timer fires. */
 export declare const ElapsedShowDelay: import("../../schema/index.js").CallableTaggedStruct<"ElapsedShowDelay", {
     version: S.Number;
 }>;
-/** Signals that the show-delay has changed (e.g. in response to a user preference, input-method change, or reduced-motion setting). Does not affect the current open/closed state; the new delay applies to the next hover. Typically dispatched via the `setShowDelay` helper. */
-export declare const ChangedShowDelay: import("../../schema/index.js").CallableTaggedStruct<"ChangedShowDelay", {
-    showDelay: S.DurationFromMillis;
-}>;
-/** Sent when the tooltip panel mounts and Floating UI has positioned it. Update no-ops; the side effect is the act of positioning, surfaced for DevTools observability. */
+/** Sent when the tooltip panel mounts and Floating UI has positioned it. */
 export declare const CompletedAnchorTooltip: import("../../schema/index.js").CallableTaggedStruct<"CompletedAnchorTooltip", {}>;
 /** Union of all messages the tooltip component can produce. */
 export declare const Message: S.Union<[
@@ -49,7 +46,6 @@ export declare const Message: S.Union<[
     typeof PressedEscape,
     typeof PressedPointerOnTrigger,
     typeof ElapsedShowDelay,
-    typeof ChangedShowDelay,
     typeof CompletedAnchorTooltip
 ]>;
 export type EnteredTrigger = typeof EnteredTrigger.Type;
@@ -59,15 +55,25 @@ export type BlurredTrigger = typeof BlurredTrigger.Type;
 export type PressedEscape = typeof PressedEscape.Type;
 export type PressedPointerOnTrigger = typeof PressedPointerOnTrigger.Type;
 export type Message = typeof Message.Type;
-/** Configuration for creating a tooltip model with `init`. `showDelay` controls how long the pointer must hover before the tooltip appears (default 500ms). Accepts any `Duration.Input` — a bare number is interpreted as milliseconds. Keyboard focus shows the tooltip immediately regardless of this value. */
+/** Emitted once the tooltip transitions to visible (`isOpen` becomes true).
+ *  Consumers typically use this for analytics, instrumentation, or to
+ *  coordinate with other transient UI. */
+export declare const Shown: import("../../schema/index.js").CallableTaggedStruct<"Shown", {}>;
+/** Emitted once the tooltip transitions to hidden (`isOpen` becomes false). */
+export declare const Hidden: import("../../schema/index.js").CallableTaggedStruct<"Hidden", {}>;
+/** Union of out-messages the tooltip component can produce. */
+export declare const OutMessage: S.Union<readonly [import("../../schema/index.js").CallableTaggedStruct<"Shown", {}>, import("../../schema/index.js").CallableTaggedStruct<"Hidden", {}>]>;
+export type Shown = typeof Shown.Type;
+export type Hidden = typeof Hidden.Type;
+export type OutMessage = typeof OutMessage.Type;
+/** Configuration for creating a tooltip model with `init`. */
 export type InitConfig = Readonly<{
     id: string;
     showDelay?: Duration.Input;
 }>;
 /** Creates an initial tooltip model from a config. Defaults to hidden. */
 export declare const init: (config: InitConfig) => Model;
-type UpdateReturn = readonly [Model, ReadonlyArray<Command.Command<Message>>];
-/** Waits for the tooltip's show delay before emitting `ElapsedShowDelay`. The version is echoed back so a stale timer is ignored when the user leaves before the delay fires. */
+/** Waits for the tooltip's show delay before emitting `ElapsedShowDelay`. */
 export declare const ShowAfterDelay: Command.CommandDefinitionWithArgs<"ShowAfterDelay", {
     delay: S.DurationFromMillis;
     version: S.Number;
@@ -75,9 +81,7 @@ export declare const ShowAfterDelay: Command.CommandDefinitionWithArgs<"ShowAfte
     readonly _tag: "ElapsedShowDelay";
     readonly version: number;
 }, never, never>>;
-/** The anchor-positioning Mount this Tooltip renders on its panel. Exposed so
- *  Scene tests can call `Scene.Mount.resolve(AnchorTooltip, CompletedAnchorTooltip())`
- *  to acknowledge the mount produced by the rendered panel. */
+/** The anchor-positioning Mount this Tooltip renders on its panel. */
 export declare const AnchorTooltip: Mount.MountDefinitionWithArgs<"AnchorTooltip", {
     buttonId: S.String;
     anchor: S.Struct<{
@@ -90,29 +94,77 @@ export declare const AnchorTooltip: Mount.MountDefinitionWithArgs<"AnchorTooltip
 }, {
     readonly _tag: "CompletedAnchorTooltip";
 }>;
-/** Processes a tooltip message and returns the next model and commands. */
+type UpdateReturn = readonly [
+    Model,
+    ReadonlyArray<Command.Command<Message>>,
+    Option.Option<OutMessage>
+];
+/** Processes a tooltip message and returns the next model, commands, and
+ *  an optional OutMessage. `Shown`/`Hidden` fire only on `isOpen`
+ *  transitions, so consumers don't get spurious events for messages that
+ *  only update hover/focus/delay state without changing visibility. */
 export declare const update: (model: Model, message: Message) => UpdateReturn;
-/** Programmatically updates the tooltip's hover show-delay. Use this in response to user preference changes, input-method switches, or reduced-motion settings. The new delay applies to the next hover; any pending timer is unaffected (its stale version will discard harmlessly when it fires). */
-export declare const setShowDelay: (model: Model, showDelay: Duration.Input) => readonly [Model, ReadonlyArray<Command.Command<Message>>];
-/** Configuration for rendering a tooltip with `view`. */
-export type ViewConfig<ParentMessage> = Readonly<{
-    model: Model;
-    toParentMessage: (message: EnteredTrigger | LeftTrigger | FocusedTrigger | BlurredTrigger | PressedEscape | PressedPointerOnTrigger | typeof CompletedAnchorTooltip.Type) => ParentMessage;
+/** Reflects an externally-sourced hover show-delay onto the model without
+ *  emitting an OutMessage. Use to mirror an external config value (a user
+ *  preference, a restored setting) onto the tooltip. */
+export declare const reflectShowDelay: Reflect<Model, Duration.Input>;
+/** Render-time payload published to the consumer's `toView`.
+ *
+ *  - `trigger`: attribute bundle for the trigger element. Carries the
+ *    hover/focus/keyboard handlers + ARIA `aria-describedby` linking to
+ *    the panel.
+ *  - `panel`: attribute bundle for the panel element. Carries the
+ *    `role="tooltip"`, the anchor Mount that positions the panel via
+ *    Floating UI, and a `data-open` attribute when visible.
+ *  - `isVisible`: derived state. The consumer decides whether to render
+ *    the panel conditionally on this. */
+export type RenderInfo = Readonly<{
+    trigger: ReadonlyArray<ChildAttribute>;
+    panel: ReadonlyArray<ChildAttribute>;
+    isVisible: boolean;
+}>;
+/** Per-render view inputs passed to `view` via `h.submodel`'s `viewInputs` field. */
+export type ViewInputs = Readonly<{
     anchor: AnchorConfig;
-    triggerContent: Html;
-    triggerClassName?: string;
-    triggerAttributes?: ReadonlyArray<Attribute<ParentMessage>>;
-    content: Html;
-    panelClassName?: string;
-    panelAttributes?: ReadonlyArray<Attribute<ParentMessage>>;
+    toView: (render: RenderInfo) => Html;
     isDisabled?: boolean;
-    className?: string;
-    attributes?: ReadonlyArray<Attribute<ParentMessage>>;
 }>;
-/** Renders a headless tooltip with an anchored non-interactive panel. Shows on hover (after delay) or focus (from keyboard, touch, or pen; mouse-click focus is excluded); hides on leave, blur, Escape, or left-click of the trigger. Uses `role="tooltip"` and links the trigger via `aria-describedby`. */
-export declare const view: <ParentMessage>(config: ViewConfig<ParentMessage>) => Html;
-/** Creates a memoized tooltip view. Static config is captured in a closure;
- *  only `model` and `toParentMessage` are compared per render via `createLazy`. */
-export declare const lazy: <ParentMessage>(staticConfig: Omit<ViewConfig<ParentMessage>, "model" | "toParentMessage">) => ((model: Model, toParentMessage: ViewConfig<ParentMessage>["toParentMessage"]) => Html);
+/** Renders a headless tooltip with an anchored non-interactive panel.
+ *  Shows on hover (after delay) or focus (from keyboard, touch, or pen;
+ *  mouse-click focus is excluded); hides on leave, blur, Escape, or
+ *  left-click of the trigger. */
+export declare const view: import("../../html/submodel.js").SubmodelView<{
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isHovered: boolean;
+    readonly isFocused: boolean;
+    readonly isDismissed: boolean;
+    readonly showDelay: Duration.Duration;
+    readonly pendingShowVersion: number;
+    readonly maybeLastPointerType: Option.Option<string>;
+}, {
+    readonly _tag: "EnteredTrigger";
+} | {
+    readonly _tag: "LeftTrigger";
+} | {
+    readonly _tag: "FocusedTrigger";
+} | {
+    readonly _tag: "BlurredTrigger";
+} | {
+    readonly _tag: "PressedEscape";
+} | {
+    readonly _tag: "PressedPointerOnTrigger";
+    readonly pointerType: string;
+    readonly button: number;
+} | {
+    readonly _tag: "ElapsedShowDelay";
+    readonly version: number;
+} | {
+    readonly _tag: "CompletedAnchorTooltip";
+}, Readonly<{
+    anchor: AnchorConfig;
+    toView: (render: RenderInfo) => Html;
+    isDisabled?: boolean;
+}>>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/tooltip/index.d.ts.map

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