foldkit 0.81.1 → 0.82.0

package/dist/ui/virtualList/index.js

@@ -1,4 +1,4 @@
-import { Array, Effect, Match as M, Number, Option, Schema as S, Stream, pipe, } from 'effect';
+import { Array, Effect, Match as M, Number, Option, Queue, Schema as S, Stream, pipe, } from 'effect';
 import * as Command from '../../command/index.js';
 import { createLazy, html, } from '../../html/index.js';
 import { m } from '../../message/index.js';
@@ -15,14 +15,14 @@ const Measured = ts('Measured', { containerHeight: S.Number });
  * `Unmeasured` explicitly, typically by rendering a placeholder until the
  * first measurement arrives.
  */
-const Measurement = S.Union(Unmeasured, Measured);
+const Measurement = S.Union([Unmeasured, Measured]);
 const Idle = ts('Idle');
 const ScrollingToIndex = ts('ScrollingToIndex', {
     index: S.Number,
     version: S.Number,
 });
 /** State of a programmatic scroll initiated by `scrollToIndex`. */
-const PendingScroll = S.Union(Idle, ScrollingToIndex);
+const PendingScroll = S.Union([Idle, ScrollingToIndex]);
 /** Schema for the virtual list's state. Tracks scroll position, container
  *  measurement, and any in-flight programmatic scroll. */
 export const Model = S.Struct({
@@ -50,7 +50,7 @@ export const CompletedApplyScroll = m('CompletedApplyScroll', {
     version: S.Number,
 });
 /** Union of all messages the virtual list component can produce. */
-export const Message = S.Union(ScrolledContainer, MeasuredContainer, CompletedApplyScroll);
+export const Message = S.Union([ScrolledContainer, MeasuredContainer, CompletedApplyScroll]);
 /** Creates an initial virtual list model from a config. The container starts
  *  in `Unmeasured` state. The first `ResizeObserver` entry transitions it to
  *  `Measured`. */
@@ -204,11 +204,11 @@ export const visibleWindowVariable = (model, items, itemToRowHeightPx, overscan)
         const itemCount = items.length;
         const cumulativeOffsets = prefixSum(items, itemToRowHeightPx);
         const totalHeight = lastOrZero(cumulativeOffsets);
-        const firstVisibleIndex = pipe(cumulativeOffsets, Array.findFirstIndex(Number.greaterThan(model.scrollTop)), Option.match({
+        const firstVisibleIndex = pipe(cumulativeOffsets, Array.findFirstIndex(Number.isGreaterThan(model.scrollTop)), Option.match({
             onNone: () => itemCount,
             onSome: index => Math.max(0, index - 1),
         }));
-        const lastVisibleIndex = pipe(cumulativeOffsets, Array.findFirstIndex(Number.greaterThanOrEqualTo(model.scrollTop + containerHeight)), Option.getOrElse(() => itemCount));
+        const lastVisibleIndex = pipe(cumulativeOffsets, Array.findFirstIndex(Number.isGreaterThanOrEqualTo(model.scrollTop + containerHeight)), Option.getOrElse(() => itemCount));
         const startIndex = clampIndex(firstVisibleIndex - overscan, itemCount);
         const endIndex = clampIndex(lastVisibleIndex + overscan, itemCount);
         const topSpacerHeight = pipe(cumulativeOffsets, Array.get(startIndex), Option.getOrElse(() => 0));
@@ -223,7 +223,7 @@ export const visibleWindowVariable = (model, items, itemToRowHeightPx, overscan)
     },
 }));
 // SUBSCRIPTION
-const containerElement = (id) => Option.fromNullable(document.getElementById(id));
+const containerElement = (id) => Option.fromNullishOr(document.getElementById(id));
 /** Schema describing the subscription dependencies for container scroll and
  *  resize tracking. */
 export const SubscriptionDeps = S.Struct({
@@ -247,46 +247,49 @@ export const SubscriptionDeps = S.Struct({
 export const subscriptions = makeSubscriptions(SubscriptionDeps)({
     containerEvents: {
         modelToDependencies: model => ({ id: model.id }),
-        dependenciesToStream: ({ id }) => Stream.async(emit => {
-            let scrollListener = null;
-            let resizeObserver = null;
-            let observedElement = null;
-            let pendingFrame = null;
+        dependenciesToStream: ({ id }) => Stream.callback(queue => Effect.acquireRelease(Effect.sync(() => {
+            const state = {
+                scrollListener: null,
+                resizeObserver: null,
+                observedElement: null,
+                pendingFrame: null,
+            };
             const detach = () => {
-                if (resizeObserver !== null) {
-                    resizeObserver.disconnect();
-                    resizeObserver = null;
+                if (state.resizeObserver !== null) {
+                    state.resizeObserver.disconnect();
+                    state.resizeObserver = null;
                 }
-                if (observedElement !== null && scrollListener !== null) {
-                    observedElement.removeEventListener('scroll', scrollListener);
+                if (state.observedElement !== null &&
+                    state.scrollListener !== null) {
+                    state.observedElement.removeEventListener('scroll', state.scrollListener);
                 }
-                observedElement = null;
-                scrollListener = null;
+                state.observedElement = null;
+                state.scrollListener = null;
             };
             const attach = (element) => {
-                const listener = () => emit.single(ScrolledContainer({ scrollTop: element.scrollTop }));
+                const listener = () => Queue.offerUnsafe(queue, ScrolledContainer({ scrollTop: element.scrollTop }));
                 element.addEventListener('scroll', listener, { passive: true });
-                scrollListener = listener;
-                observedElement = element;
-                resizeObserver = new ResizeObserver(entries => {
+                state.scrollListener = listener;
+                state.observedElement = element;
+                state.resizeObserver = new ResizeObserver(entries => {
                     const lastEntry = Array.last(entries);
                     if (Option.isSome(lastEntry)) {
-                        emit.single(MeasuredContainer({
+                        Queue.offerUnsafe(queue, MeasuredContainer({
                             containerHeight: lastEntry.value.contentRect.height,
                         }));
                     }
                 });
-                resizeObserver.observe(element);
+                state.resizeObserver.observe(element);
             };
             const reconcile = () => {
                 const maybeElement = containerElement(id);
                 if (Option.isNone(maybeElement)) {
-                    if (observedElement !== null) {
+                    if (state.observedElement !== null) {
                         detach();
                     }
                     return;
                 }
-                if (observedElement === maybeElement.value) {
+                if (state.observedElement === maybeElement.value) {
                     return;
                 }
                 detach();
@@ -295,16 +298,17 @@ export const subscriptions = makeSubscriptions(SubscriptionDeps)({
             reconcile();
             // NOTE: observes the entire document subtree because the container
             // can be inserted/removed by any parent the consumer chooses (route
-            // changes, conditional renders, modal mounts), and the framework has
-            // no way to know that hierarchy in advance. Reconcile is gated by rAF
-            // and short-circuits when the cached observedElement is still in the
-            // DOM, so per-mutation cost stays low even with subtree: true.
+            // changes, conditional renders, modal mounts), and the framework
+            // has no way to know that hierarchy in advance. Reconcile is gated
+            // by rAF and short-circuits when the cached observedElement is
+            // still in the DOM, so per-mutation cost stays low even with
+            // subtree: true.
             const mutationObserver = new MutationObserver(() => {
-                if (pendingFrame !== null) {
+                if (state.pendingFrame !== null) {
                     return;
                 }
-                pendingFrame = requestAnimationFrame(() => {
-                    pendingFrame = null;
+                state.pendingFrame = requestAnimationFrame(() => {
+                    state.pendingFrame = null;
                     reconcile();
                 });
             });
@@ -312,14 +316,14 @@ export const subscriptions = makeSubscriptions(SubscriptionDeps)({
                 childList: true,
                 subtree: true,
             });
-            return Effect.sync(() => {
-                mutationObserver.disconnect();
-                if (pendingFrame !== null) {
-                    cancelAnimationFrame(pendingFrame);
-                }
-                detach();
-            });
-        }),
+            return { state, detach, mutationObserver };
+        }), ({ state, detach, mutationObserver }) => Effect.sync(() => {
+            mutationObserver.disconnect();
+            if (state.pendingFrame !== null) {
+                cancelAnimationFrame(state.pendingFrame);
+            }
+            detach();
+        })).pipe(Effect.flatMap(() => Effect.never))),
     },
 });
 // VIEW

package/dist/url/index.d.ts

@@ -1,22 +1,22 @@
 import { Option, Schema as S } from 'effect';
 /** Schema representing a parsed URL with protocol, host, port, pathname, search, and hash fields. */
 export declare const Url: S.Struct<{
-    protocol: typeof S.String;
-    host: typeof S.String;
-    port: S.OptionFromSelf<typeof S.String>;
-    pathname: typeof S.String;
-    search: S.OptionFromSelf<typeof S.String>;
-    hash: S.OptionFromSelf<typeof S.String>;
+    readonly protocol: S.String;
+    readonly host: S.String;
+    readonly port: S.Option<S.String>;
+    readonly pathname: S.String;
+    readonly search: S.Option<S.String>;
+    readonly hash: S.Option<S.String>;
 }>;
 export type Url = typeof Url.Type;
 /** Parses a URL string into a `Url`, returning `Option.None` if invalid. */
 export declare const fromString: (str: string) => Option.Option<{
     readonly search: Option.Option<string>;
+    readonly port: Option.Option<string>;
+    readonly hash: Option.Option<string>;
     readonly protocol: string;
     readonly host: string;
-    readonly port: Option.Option<string>;
     readonly pathname: string;
-    readonly hash: Option.Option<string>;
 }>;
 /** Serializes a `Url` back to a string. */
 export declare const toString: (url: Url) => string;

package/dist/url/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAe,MAAM,IAAI,CAAC,EAAU,MAAM,QAAQ,CAAA;AAIzE,qGAAqG;AACrG,eAAO,MAAM,GAAG;;;;;;;EAOd,CAAA;AACF,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,CAAA;AA+EjC,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM;;;;;;;EAAuC,CAAA;AAC7E,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,WAAqC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,MAAM,IAAI,CAAC,EAIZ,MAAM,QAAQ,CAAA;AAIf,qGAAqG;AACrG,eAAO,MAAM,GAAG;;;;;;;EAOd,CAAA;AACF,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,CAAA;AAwFjC,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM;;;;;;;EAAuC,CAAA;AAC7E,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,WAAqC,CAAA"}

package/dist/url/index.js

@@ -1,13 +1,13 @@
-import { Effect, Option, ParseResult, Schema as S, String } from 'effect';
+import { Effect, Option, Schema as S, SchemaIssue, SchemaTransformation, String, } from 'effect';
 import { OptionExt } from '../effectExtensions/index.js';
 /** Schema representing a parsed URL with protocol, host, port, pathname, search, and hash fields. */
 export const Url = S.Struct({
     protocol: S.String,
     host: S.String,
-    port: S.OptionFromSelf(S.String),
+    port: S.Option(S.String),
     pathname: S.String,
-    search: S.OptionFromSelf(S.String),
-    hash: S.OptionFromSelf(S.String),
+    search: S.Option(S.String),
+    hash: S.Option(S.String),
 });
 const LocationAndHref = S.Struct({
     href: S.String,
@@ -17,9 +17,8 @@ const LocationAndHref = S.Struct({
         port: S.String,
     }),
 });
-const LocationAndHrefFromString = S.transformOrFail(S.String, LocationAndHref, {
-    strict: true,
-    decode: (urlString, _options, ast) => Effect.try({
+const LocationAndHrefFromString = S.String.pipe(S.decodeTo(LocationAndHref, SchemaTransformation.transformOrFail({
+    decode: urlString => Effect.try({
         try: () => {
             const url = new URL(urlString);
             return {
@@ -31,15 +30,16 @@ const LocationAndHrefFromString = S.transformOrFail(S.String, LocationAndHref, {
                 },
             };
         },
-        catch: error => new ParseResult.Type(ast, urlString, `Invalid URL: ${error}`),
+        catch: () => new SchemaIssue.InvalidValue(Option.some(urlString), {
+            description: `Invalid URL: ${urlString}`,
+        }),
     }),
     encode: ({ href, location }) => {
         const portString = location.port ? `:${location.port}` : '';
-        return ParseResult.succeed(`${location.protocol}//${location.host}${portString}${href}`);
+        return Effect.succeed(`${location.protocol}//${location.host}${portString}${href}`);
     },
-});
-const UrlFromLocationAndHref = S.transform(LocationAndHref, Url, {
-    strict: true,
+})));
+const UrlFromLocationAndHref = LocationAndHref.pipe(S.decodeTo(Url, SchemaTransformation.transform({
     decode: ({ href, location }) => {
         const [pathAndQuery, hashPart] = String.split(href, '#');
         const [pathname, searchPart] = String.split(pathAndQuery, '?');
@@ -71,8 +71,8 @@ const UrlFromLocationAndHref = S.transform(LocationAndHref, Url, {
             },
         };
     },
-});
-const UrlFromString = S.compose(LocationAndHrefFromString, UrlFromLocationAndHref);
+})));
+const UrlFromString = LocationAndHrefFromString.pipe(S.decodeTo(UrlFromLocationAndHref));
 /** Parses a URL string into a `Url`, returning `Option.None` if invalid. */
 export const fromString = (str) => S.decodeOption(UrlFromString)(str);
 /** Serializes a `Url` back to a string. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "foldkit",
-  "version": "0.81.1",
-  "description": "A frontend framework for TypeScript, built on Effect, using The Elm Architecture",
+  "version": "0.82.0",
+  "description": "A TypeScript frontend framework, built on Effect and architected like Elm",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -47,6 +47,10 @@
       "types": "./dist/runtime/public.d.ts",
       "import": "./dist/runtime/public.js"
     },
+    "./hmr-protocol": {
+      "types": "./dist/runtime/hmrProtocolPublic.d.ts",
+      "import": "./dist/runtime/hmrProtocolPublic.js"
+    },
     "./fieldValidation": {
       "types": "./dist/fieldValidation/public.d.ts",
       "import": "./dist/fieldValidation/public.js"
@@ -180,13 +184,13 @@
     "dist"
   ],
   "peerDependencies": {
-    "@effect/platform-browser": "^0.74.0",
-    "effect": "^3.18.2"
+    "@effect/platform-browser": "4.0.0-beta.59",
+    "effect": "4.0.0-beta.59"
   },
   "devDependencies": {
-    "@effect/platform-browser": "^0.74.0",
-    "@effect/vitest": "^0.27.0",
-    "effect": "^3.19.19",
+    "@effect/platform-browser": "4.0.0-beta.59",
+    "@effect/vitest": "4.0.0-beta.59",
+    "effect": "4.0.0-beta.59",
     "happy-dom": "^18.0.1",
     "typescript": "^6.0.2",
     "vitest": "^3.2.4"