foldkit 0.70.0 → 0.72.0

package/dist/ui/toast/update.js

@@ -0,0 +1,203 @@
+import { Array, Duration, Effect, Match as M, Number, Option, } from 'effect';
+import * as Command from '../../command';
+import { OptionExt } from '../../effectExtensions';
+import { evo } from '../../struct';
+import * as Task from '../../task';
+import { Hid as AnimationHid, Showed as AnimationShowed, init as animationInit, } from '../animation/schema';
+import { defaultLeaveCommand as animationDefaultLeaveCommand, update as animationUpdate, } from '../animation/update';
+import { DEFAULT_DURATION, Dismissed, DismissedAll, ElapsedDuration, GotAnimationMessage, makeAdded, makeEntry, makeMessage, makeModel, } from './schema';
+/** 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
+ *  payload. */
+export const DismissAfter = Command.define('DismissAfter', ElapsedDuration);
+const DEFAULT_VARIANT = 'Info';
+/** Factory that binds Toast's runtime (update fn, helpers, commands) to a
+ *  specific payload schema. Called by `make` in index.ts; inner helpers close
+ *  over the payload-specific Entry / Model / Added types so generics don't
+ *  have to propagate through every helper signature.
+ *
+ *  @internal Consumers should use `Ui.Toast.make(PayloadSchema)`. This is
+ *  only exported so `index.ts` can wire the view into the bound runtime. */
+export const makeRuntime = (payloadSchema) => {
+    const EntrySchema = makeEntry(payloadSchema);
+    const ModelSchema = makeModel(payloadSchema);
+    const MessageSchema = makeMessage(payloadSchema);
+    const Added = makeAdded(payloadSchema);
+    const withUpdateReturn = M.withReturnType();
+    const updateEntry = (model, entryId, f) => evo(model, {
+        entries: Array.map(entry => (entry.id === entryId ? f(entry) : entry)),
+    });
+    const removeEntry = (model, entryId) => evo(model, {
+        entries: Array.filter(({ id }) => id !== entryId),
+    });
+    const isEntryLeaving = (entry) => {
+        const { transitionState } = entry.animation;
+        return (transitionState === 'LeaveStart' || transitionState === 'LeaveAnimating');
+    };
+    const scheduleDismiss = (entryId, version, duration) => DismissAfter(Task.delay(duration).pipe(Effect.as(ElapsedDuration({ entryId, version }))));
+    const rescheduleDismissCommands = (entry) => {
+        if (isEntryLeaving(entry) || entry.isHovered) {
+            return [];
+        }
+        else {
+            return Option.match(entry.maybeDuration, {
+                onNone: () => [],
+                onSome: duration => [
+                    scheduleDismiss(entry.id, entry.pendingDismissVersion, duration),
+                ],
+            });
+        }
+    };
+    const delegateToEntryAnimation = (model, entryId, animationMessage) => {
+        const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
+        return Option.match(maybeEntry, {
+            onNone: () => [model, []],
+            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 nextEntry = evo(entry, {
+                    animation: () => nextAnimation,
+                });
+                return Option.match(maybeOutMessage, {
+                    onNone: () => [
+                        updateEntry(model, entryId, () => nextEntry),
+                        mappedCommands,
+                    ],
+                    onSome: M.type().pipe(withUpdateReturn, M.tagsExhaustive({
+                        StartedLeaveAnimating: () => [
+                            updateEntry(model, entryId, () => nextEntry),
+                            [
+                                ...mappedCommands,
+                                Command.mapEffect(animationDefaultLeaveCommand(nextAnimation), Effect.map(toMessage)),
+                            ],
+                        ],
+                        TransitionedOut: () => [
+                            removeEntry(model, entryId),
+                            mappedCommands,
+                        ],
+                    })),
+                });
+            },
+        });
+    };
+    const createEntry = (model, input) => {
+        const entryId = `${model.id}-entry-${model.nextEntryKey}`;
+        const duration = input.duration === undefined
+            ? model.defaultDuration
+            : Duration.decode(input.duration);
+        const maybeDuration = OptionExt.when(!input.sticky, duration);
+        return {
+            id: entryId,
+            variant: input.variant ?? DEFAULT_VARIANT,
+            animation: animationInit({ id: entryId, isShowing: false }),
+            maybeDuration,
+            pendingDismissVersion: 0,
+            isHovered: false,
+            payload: input.payload,
+        };
+    };
+    /** Creates an initial toast container model from a config. Starts empty. */
+    const init = (config) => ({
+        id: config.id,
+        defaultDuration: config.defaultDuration === undefined
+            ? DEFAULT_DURATION
+            : Duration.decode(config.defaultDuration),
+        entries: [],
+        nextEntryKey: 0,
+    });
+    /** Processes a toast message and returns the next model and commands. */
+    const update = (model, message) => M.value(message).pipe(withUpdateReturn, M.tagsExhaustive({
+        Added: ({ entry }) => {
+            const modelWithEntry = evo(model, {
+                entries: entries => Array.append(entries, entry),
+                nextEntryKey: Number.increment,
+            });
+            const [modelAfterShow, showCommands] = delegateToEntryAnimation(modelWithEntry, entry.id, AnimationShowed());
+            const postShowEntry = Array.findFirst(modelAfterShow.entries, ({ id }) => id === entry.id);
+            const dismissCommands = Option.match(postShowEntry, {
+                onNone: () => [],
+                onSome: rescheduleDismissCommands,
+            });
+            return [modelAfterShow, [...showCommands, ...dismissCommands]];
+        },
+        Dismissed: ({ entryId }) => {
+            const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
+            return Option.match(maybeEntry, {
+                onNone: () => [model, []],
+                onSome: entry => {
+                    if (isEntryLeaving(entry)) {
+                        return [model, []];
+                    }
+                    else {
+                        return delegateToEntryAnimation(model, entryId, AnimationHid());
+                    }
+                },
+            });
+        },
+        DismissedAll: () => Array.reduce(model.entries, [model, []], ([currentModel, currentCommands], entry) => {
+            if (isEntryLeaving(entry)) {
+                return [currentModel, currentCommands];
+            }
+            const [nextModel, nextCommands] = delegateToEntryAnimation(currentModel, entry.id, AnimationHid());
+            return [nextModel, [...currentCommands, ...nextCommands]];
+        }),
+        ElapsedDuration: ({ entryId, version }) => {
+            const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
+            return Option.match(maybeEntry, {
+                onNone: () => [model, []],
+                onSome: entry => {
+                    const isStale = version !== entry.pendingDismissVersion;
+                    if (isStale || isEntryLeaving(entry)) {
+                        return [model, []];
+                    }
+                    else {
+                        return delegateToEntryAnimation(model, entryId, AnimationHid());
+                    }
+                },
+            });
+        },
+        HoveredEntry: ({ entryId }) => [
+            updateEntry(model, entryId, entry => evo(entry, {
+                isHovered: () => true,
+                pendingDismissVersion: Number.increment,
+            })),
+            [],
+        ],
+        LeftEntry: ({ entryId }) => {
+            const maybeEntry = Array.findFirst(model.entries, ({ id }) => id === entryId);
+            return Option.match(maybeEntry, {
+                onNone: () => [model, []],
+                onSome: entry => {
+                    const nextEntry = evo(entry, {
+                        isHovered: () => false,
+                        pendingDismissVersion: Number.increment,
+                    });
+                    return [
+                        updateEntry(model, entryId, () => nextEntry),
+                        rescheduleDismissCommands(nextEntry),
+                    ];
+                },
+            });
+        },
+        GotAnimationMessage: ({ entryId, message: animationMessage }) => delegateToEntryAnimation(model, entryId, animationMessage),
+    }));
+    /** Adds a new toast entry. */
+    const show = (model, input) => update(model, Added({ entry: createEntry(model, input) }));
+    /** Begins dismissing a specific entry. */
+    const dismiss = (model, entryId) => update(model, Dismissed({ entryId }));
+    /** Begins dismissing every currently-visible entry. */
+    const dismissAll = (model) => update(model, DismissedAll());
+    return {
+        Entry: EntrySchema,
+        Model: ModelSchema,
+        Message: MessageSchema,
+        Added,
+        init,
+        update,
+        show,
+        dismiss,
+        dismissAll,
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.70.0",
+  "version": "0.72.0",
   "description": "A frontend framework for TypeScript, built on Effect, using The Elm Architecture",
   "type": "module",
   "main": "./dist/index.js",
@@ -79,6 +79,10 @@
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.js"
     },
+    "./ui/animation": {
+      "types": "./dist/ui/animation/public.d.ts",
+      "import": "./dist/ui/animation/public.js"
+    },
     "./ui/button": {
       "types": "./dist/ui/button/public.d.ts",
       "import": "./dist/ui/button/public.js"
@@ -143,14 +147,14 @@
       "types": "./dist/ui/tabs/public.d.ts",
       "import": "./dist/ui/tabs/public.js"
     },
+    "./ui/toast": {
+      "types": "./dist/ui/toast/public.d.ts",
+      "import": "./dist/ui/toast/public.js"
+    },
     "./ui/tooltip": {
       "types": "./dist/ui/tooltip/public.d.ts",
       "import": "./dist/ui/tooltip/public.js"
     },
-    "./ui/transition": {
-      "types": "./dist/ui/transition/public.d.ts",
-      "import": "./dist/ui/transition/public.js"
-    },
     "./url": {
       "types": "./dist/url/public.d.ts",
       "import": "./dist/url/public.js"

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/transition/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,OAAO,EAGb,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,GAAG,EACH,OAAO,EACP,KAAK,EACL,UAAU,EACV,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,IAAI,EACL,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,EACP,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,GAAG,EACH,IAAI,EACJ,OAAO,EACP,KAAK,EACL,UAAU,EACV,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,eAAe,GAChB,CAAA;AAED,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAA;AAIxE,4DAA4D;AAC5D,MAAM,MAAM,UAAU,CAAC,OAAO,IAAI,QAAQ,CAAC;IACzC,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,IAAI,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;2EAEuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,EAAE,QAAQ,UAAU,CAAC,OAAO,CAAC,KAAG,IA+F3D,CAAA;AAED;;yDAEyD;AACzD,eAAO,MAAM,IAAI,GAAI,OAAO,EAC1B,cAAc,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,KAC3D,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,KAAK,IAAI,CAaxC,CAAA"}

package/dist/ui/transition/public.d.ts

@@ -1,3 +0,0 @@
-export { init, update, view, lazy, defaultLeaveCommand, Model, Message, OutMessage, Showed, Hid, AdvancedTransitionFrame, EndedTransition, StartedLeaveAnimating, TransitionedOut, TransitionState, RequestFrame, WaitForTransitions, } from './index';
-export type { InitConfig, ViewConfig } from './index';
-//# sourceMappingURL=public.d.ts.map

package/dist/ui/transition/public.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/ui/transition/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,mBAAmB,EACnB,KAAK,EACL,OAAO,EACP,UAAU,EACV,MAAM,EACN,GAAG,EACH,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}

package/dist/ui/transition/public.js

@@ -1 +0,0 @@
-export { init, update, view, lazy, defaultLeaveCommand, Model, Message, OutMessage, Showed, Hid, AdvancedTransitionFrame, EndedTransition, StartedLeaveAnimating, TransitionedOut, TransitionState, RequestFrame, WaitForTransitions, } from './index';

package/dist/ui/transition/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/ui/transition/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAMpC,8GAA8G;AAC9G,eAAO,MAAM,eAAe,qFAM3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAIzD,mHAAmH;AACnH,eAAO,MAAM,KAAK;;;;EAIhB,CAAA;AAEF,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAIrC,mGAAmG;AACnG,eAAO,MAAM,MAAM,2DAAc,CAAA;AACjC,kGAAkG;AAClG,eAAO,MAAM,GAAG,wDAAW,CAAA;AAC3B,oGAAoG;AACpG,eAAO,MAAM,uBAAuB,4EAA+B,CAAA;AACnE,yFAAyF;AACzF,eAAO,MAAM,eAAe,oEAAuB,CAAA;AAEnD,kEAAkE;AAClE,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,KAAK,CAC3B;IACE,OAAO,MAAM;IACb,OAAO,GAAG;IACV,OAAO,uBAAuB;IAC9B,OAAO,eAAe;CACvB,CAC+D,CAAA;AAClE,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AACvC,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,CAAA;AAIjC,uRAAuR;AACvR,eAAO,MAAM,qBAAqB,0EAA6B,CAAA;AAC/D,iIAAiI;AACjI,eAAO,MAAM,eAAe,oEAAuB,CAAA;AAEnD,eAAO,MAAM,UAAU,yJAAkD,CAAA;AACzE,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAI/C,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAC,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,IAAI,GAAI,QAAQ,UAAU,KAAG,KAIxC,CAAA"}

package/dist/ui/transition/schema.js

@@ -1,35 +0,0 @@
-import { Schema as S } from 'effect';
-import { m } from '../../message';
-// TRANSITION STATE
-/** Schema for the transition animation state, tracking enter/leave phases for CSS transition coordination. */
-export const TransitionState = S.Literal('Idle', 'EnterStart', 'EnterAnimating', 'LeaveStart', 'LeaveAnimating');
-// MODEL
-/** Schema for the transition component's state, tracking its unique ID, visibility intent, and animation phase. */
-export const Model = S.Struct({
-    id: S.String,
-    isShowing: S.Boolean,
-    transitionState: TransitionState,
-});
-// MESSAGE
-/** Sent when the transition should enter (become visible). Starts the enter animation sequence. */
-export const Showed = m('Showed');
-/** Sent when the transition should leave (become hidden). Starts the leave animation sequence. */
-export const Hid = m('Hid');
-/** Sent internally when a double-rAF completes, advancing the transition to its animating phase. */
-export const AdvancedTransitionFrame = m('AdvancedTransitionFrame');
-/** Sent internally when all CSS transitions on the transition element have completed. */
-export const EndedTransition = m('EndedTransition');
-/** Union of all messages the transition component can produce. */
-export const Message = S.Union(Showed, Hid, AdvancedTransitionFrame, EndedTransition);
-// OUT MESSAGE
-/** Sent to the parent when the leave transition advances to LeaveAnimating. The parent is responsible for providing the command that detects when the leave animation completes (e.g. WaitForTransitions or a racing command). Use `defaultLeaveCommand` for the standard behavior. */
-export const StartedLeaveAnimating = m('StartedLeaveAnimating');
-/** Sent to the parent when the leave animation completes. The parent can use this to unmount content or update its own state. */
-export const TransitionedOut = m('TransitionedOut');
-export const OutMessage = S.Union(StartedLeaveAnimating, TransitionedOut);
-/** Creates an initial transition model from a config. Defaults to hidden. */
-export const init = (config) => ({
-    id: config.id,
-    isShowing: config.isShowing ?? false,
-    transitionState: 'Idle',
-});

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

@@ -1 +0,0 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/ui/transition/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEnD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAGxC,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,UAAU,CAAA;AAMjB,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK;IACL,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAC1B,CAAA;AAGD,+EAA+E;AAC/E,eAAO,MAAM,YAAY;;EAGxB,CAAA;AACD,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB;;EAG9B,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,YAiFvD,CAAA;AAED,6NAA6N;AAC7N,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAKvE,CAAA"}