@floegence/floe-webapp-core 0.36.74 → 0.36.75

package/dist/index.js

@@ -1,6 +1,6 @@
 import { FloeProvider as r } from "./app/FloeProvider.js";
 import { applyTheme as i, builtInThemes as s, getSystemTheme as n, mergeThemeTokenMaps as a, resolveThemeTokenOverrides as m, resolveThemeTokens as p, syncThemeTokenOverrides as l } from "./styles/themes/index.js";
-import { floeColorTokenCategories as d, floeDesignTokens as g, floeFontFamilyTokens as T, floeMotionTokens as u, floeRadiusTokens as x, floeSharedCssVariables as c, floeSpacingTokens as C, floeThemeColorVariables as y, floeTypographyTokens as v, getFloeColorTokenValue as F } from "./styles/tokens.js";
+import { floeColorTokenCategories as d, floeDesignTokens as g, floeFontFamilyTokens as c, floeMotionTokens as x, floeRadiusTokens as T, floeSharedCssVariables as u, floeSpacingTokens as C, floeThemeColorVariables as y, floeTypographyTokens as v, getFloeColorTokenValue as F } from "./styles/tokens.js";
 import { CommandProvider as h, createCommandService as P, useCommand as R } from "./context/CommandContext.js";
 import { ComponentRegistryProvider as I, createComponentRegistry as S, hasComponentRegistryContext as b, useComponentContextFactory as O, useComponentRegistry as A, useOptionalComponentRegistry as E } from "./context/ComponentRegistry.js";
 import { DEFAULT_FLOE_CONFIG as B, FloeConfigProvider as N, useFloeConfig as _, useResolvedFloeConfig as w } from "./context/FloeConfigContext.js";
@@ -11,25 +11,26 @@ import { LayoutProvider as X, createLayoutService as Z, useLayout as $ } from ".
 import { NotificationContainer as oe, NotificationProvider as re, createNotificationService as te, useNotification as ie } from "./context/NotificationContext.js";
 import { ThemeProvider as ne, createThemeService as ae, useTheme as me } from "./context/ThemeContext.js";
 import { ViewActivationProvider as le, useViewActivation as fe } from "./context/ViewActivationContext.js";
-import { WidgetRegistryProvider as ge, createWidgetRegistry as Te, useWidgetRegistry as ue } from "./context/WidgetRegistry.js";
-import { WidgetStateProvider as ce, useCurrentWidgetId as Ce, useWidgetState as ye, useWidgetStateContext as ve } from "./context/WidgetStateContext.js";
+import { WidgetRegistryProvider as ge, createWidgetRegistry as ce, useWidgetRegistry as xe } from "./context/WidgetRegistry.js";
+import { WidgetStateProvider as ue, useCurrentWidgetId as Ce, useWidgetState as ye, useWidgetStateContext as ve } from "./context/WidgetStateContext.js";
 import { applyDragDelta as ke, applyResizeDelta as he, getGridCellSize as Pe, pixelDeltaToGridDelta as Re, positionToGridArea as De, snapToGrid as Ie } from "./utils/gridLayout.js";
 import { checkCollision as be, constrainPosition as Oe, findFreePosition as Ae, hasCollision as Ee, sameGridPosition as Le } from "./utils/gridCollision.js";
 import { cn as Ne } from "./utils/cn.js";
 import { createSimpleContext as we } from "./context/createSimpleContext.js";
-import { deferAfterPaint as We, deferNonBlocking as Me } from "./utils/defer.js";
-import { duration as Ke, easing as ze, fadeIn as He, listContainer as Ue, listItem as Qe, panelResize as Ye, popIn as je, scaleIn as qe, sidebarVariants as Je, slideInFromBottom as Xe, slideInFromLeft as Ze, slideInFromRight as $e, slideInFromTop as eo, springConfig as oo } from "./utils/animations.js";
-import { formatKeybind as to, isMacLikePlatform as io, isPrimaryModKeyPressed as so, matchKeybind as no, parseKeybind as ao } from "./utils/keybind.js";
-import { isTypingElement as po, shouldIgnoreHotkeys as lo } from "./utils/dom.js";
-import { lockBodyStyle as go } from "./utils/bodyStyleLock.js";
-import { registerCommandContributions as uo, useCommandContributions as xo } from "./hooks/useCommandContributions.js";
-import { useDebounce as Co } from "./hooks/useDebounce.js";
-import { useDeckDrag as vo } from "./hooks/useDeckDrag.js";
-import { useFileBrowserDropTarget as ko, useFileBrowserItemDrag as ho } from "./hooks/useFileBrowserDrag.js";
-import { useKeybind as Ro } from "./hooks/useKeybind.js";
-import { useMediaQuery as Io } from "./hooks/useMediaQuery.js";
-import { usePersisted as bo } from "./hooks/usePersisted.js";
-import { useResizeObserver as Ao } from "./hooks/useResizeObserver.js";
+import { createUIFirstSelection as We } from "./utils/uiFirstSelection.js";
+import { deferAfterPaint as Ve, deferNonBlocking as Ke } from "./utils/defer.js";
+import { duration as He, easing as Ue, fadeIn as Qe, listContainer as Ye, listItem as je, panelResize as qe, popIn as Je, scaleIn as Xe, sidebarVariants as Ze, slideInFromBottom as $e, slideInFromLeft as eo, slideInFromRight as oo, slideInFromTop as ro, springConfig as to } from "./utils/animations.js";
+import { formatKeybind as so, isMacLikePlatform as no, isPrimaryModKeyPressed as ao, matchKeybind as mo, parseKeybind as po } from "./utils/keybind.js";
+import { isTypingElement as fo, shouldIgnoreHotkeys as go } from "./utils/dom.js";
+import { lockBodyStyle as xo } from "./utils/bodyStyleLock.js";
+import { registerCommandContributions as uo, useCommandContributions as Co } from "./hooks/useCommandContributions.js";
+import { useDebounce as vo } from "./hooks/useDebounce.js";
+import { useDeckDrag as ko } from "./hooks/useDeckDrag.js";
+import { useFileBrowserDropTarget as Po, useFileBrowserItemDrag as Ro } from "./hooks/useFileBrowserDrag.js";
+import { useKeybind as Io } from "./hooks/useKeybind.js";
+import { useMediaQuery as bo } from "./hooks/useMediaQuery.js";
+import { usePersisted as Ao } from "./hooks/usePersisted.js";
+import { useResizeObserver as Lo } from "./hooks/useResizeObserver.js";
 export {
   h as CommandProvider,
   I as ComponentRegistryProvider,
@@ -46,7 +47,7 @@ export {
   ne as ThemeProvider,
   le as ViewActivationProvider,
   ge as WidgetRegistryProvider,
-  ce as WidgetStateProvider,
+  ue as WidgetStateProvider,
   ke as applyDragDelta,
   he as applyResizeDelta,
   i as applyTheme,
@@ -61,80 +62,81 @@ export {
   te as createNotificationService,
   we as createSimpleContext,
   ae as createThemeService,
-  Te as createWidgetRegistry,
-  We as deferAfterPaint,
-  Me as deferNonBlocking,
-  Ke as duration,
-  ze as easing,
-  He as fadeIn,
+  We as createUIFirstSelection,
+  ce as createWidgetRegistry,
+  Ve as deferAfterPaint,
+  Ke as deferNonBlocking,
+  He as duration,
+  Ue as easing,
+  Qe as fadeIn,
   Ae as findFreePosition,
   d as floeColorTokenCategories,
   g as floeDesignTokens,
-  T as floeFontFamilyTokens,
-  u as floeMotionTokens,
-  x as floeRadiusTokens,
-  c as floeSharedCssVariables,
+  c as floeFontFamilyTokens,
+  x as floeMotionTokens,
+  T as floeRadiusTokens,
+  u as floeSharedCssVariables,
   C as floeSpacingTokens,
   y as floeThemeColorVariables,
   v as floeTypographyTokens,
-  to as formatKeybind,
+  so as formatKeybind,
   F as getFloeColorTokenValue,
   Pe as getGridCellSize,
   n as getSystemTheme,
   Ee as hasCollision,
   b as hasComponentRegistryContext,
   j as hasFileBrowserDragContext,
-  io as isMacLikePlatform,
-  so as isPrimaryModKeyPressed,
-  po as isTypingElement,
-  Ue as listContainer,
-  Qe as listItem,
-  go as lockBodyStyle,
-  no as matchKeybind,
+  no as isMacLikePlatform,
+  ao as isPrimaryModKeyPressed,
+  fo as isTypingElement,
+  Ye as listContainer,
+  je as listItem,
+  xo as lockBodyStyle,
+  mo as matchKeybind,
   a as mergeThemeTokenMaps,
-  Ye as panelResize,
-  ao as parseKeybind,
+  qe as panelResize,
+  po as parseKeybind,
   Re as pixelDeltaToGridDelta,
-  je as popIn,
+  Je as popIn,
   De as positionToGridArea,
   uo as registerCommandContributions,
   m as resolveThemeTokenOverrides,
   p as resolveThemeTokens,
   Le as sameGridPosition,
-  qe as scaleIn,
-  lo as shouldIgnoreHotkeys,
-  Je as sidebarVariants,
-  Xe as slideInFromBottom,
-  Ze as slideInFromLeft,
-  $e as slideInFromRight,
-  eo as slideInFromTop,
+  Xe as scaleIn,
+  go as shouldIgnoreHotkeys,
+  Ze as sidebarVariants,
+  $e as slideInFromBottom,
+  eo as slideInFromLeft,
+  oo as slideInFromRight,
+  ro as slideInFromTop,
   Ie as snapToGrid,
-  oo as springConfig,
+  to as springConfig,
   U as startHotInteraction,
   l as syncThemeTokenOverrides,
   R as useCommand,
-  xo as useCommandContributions,
+  Co as useCommandContributions,
   O as useComponentContextFactory,
   A as useComponentRegistry,
   Ce as useCurrentWidgetId,
-  Co as useDebounce,
+  vo as useDebounce,
   V as useDeck,
-  vo as useDeckDrag,
+  ko as useDeckDrag,
   q as useFileBrowserDrag,
-  ko as useFileBrowserDropTarget,
-  ho as useFileBrowserItemDrag,
+  Po as useFileBrowserDropTarget,
+  Ro as useFileBrowserItemDrag,
   _ as useFloeConfig,
-  Ro as useKeybind,
+  Io as useKeybind,
   $ as useLayout,
-  Io as useMediaQuery,
+  bo as useMediaQuery,
   ie as useNotification,
   E as useOptionalComponentRegistry,
-  bo as usePersisted,
-  Ao as useResizeObserver,
+  Ao as usePersisted,
+  Lo as useResizeObserver,
   w as useResolvedFloeConfig,
   me as useTheme,
   fe as useViewActivation,
-  ue as useWidgetRegistry,
+  xe as useWidgetRegistry,
   ye as useWidgetState,
   ve as useWidgetStateContext
 };

package/dist/utils/index.d.ts

@@ -7,3 +7,4 @@ export * from './dom';
 export * from './gridCollision';
 export * from './gridLayout';
 export * from './hotInteraction';
+export * from './uiFirstSelection';

package/dist/utils/uiFirstSelection.d.ts

@@ -0,0 +1,29 @@
+import { type Accessor } from 'solid-js';
+export type UIFirstSelectionPhase = 'requested' | 'intent_presented' | 'commit_started' | 'committed' | 'content_presented' | 'cancelled';
+export interface UIFirstSelectionEvent<T, M = undefined> {
+    phase: UIFirstSelectionPhase;
+    value: T;
+    metadata: M | undefined;
+    transactionId: number;
+    startedAt: number;
+    timestamp: number;
+    elapsedMs: number;
+}
+export interface CreateUIFirstSelectionOptions<T, M = undefined> {
+    committed: Accessor<T>;
+    commit: (value: T, metadata: M | undefined) => void;
+    equals?: (left: T, right: T) => boolean;
+    onEvent?: (event: UIFirstSelectionEvent<T, M>) => void;
+    scheduleAfterPaint?: (callback: () => void) => void;
+}
+export interface UIFirstSelectionController<T, M = undefined> {
+    visual: Accessor<T>;
+    committed: Accessor<T>;
+    pending: Accessor<boolean>;
+    preview: (value: T) => void;
+    resetPreview: () => void;
+    request: (value: T, metadata?: M) => void;
+    commitNow: (value: T, metadata?: M) => void;
+    cancel: () => void;
+}
+export declare function createUIFirstSelection<T, M = undefined>(options: CreateUIFirstSelectionOptions<T, M>): UIFirstSelectionController<T, M>;

package/dist/utils/uiFirstSelection.js

@@ -0,0 +1,66 @@
+import { createSignal as w, untrack as q, createEffect as h, onCleanup as x } from "solid-js";
+import { deferAfterPaint as I } from "./defer.js";
+function g() {
+  return typeof performance < "u" && typeof performance.now == "function" ? performance.now() : Date.now();
+}
+function E(n) {
+  const f = n.equals ?? Object.is, o = n.scheduleAfterPaint ?? I, [v, i] = w(q(n.committed), { equals: f }), [A, d] = w(!1);
+  let r = null, u = 1, c = !1, m = !1;
+  const s = (e, t) => {
+    const a = g();
+    n.onEvent?.({
+      phase: e,
+      value: t.value,
+      metadata: t.metadata,
+      transactionId: t.id,
+      startedAt: t.startedAt,
+      timestamp: a,
+      elapsedMs: Math.max(0, a - t.startedAt)
+    });
+  }, l = (e) => {
+    const t = r;
+    r = null, m = !1, d(!1), t && s("cancelled", t), e && !c && i(() => n.committed());
+  }, P = (e, t) => {
+    if (c) return;
+    if (r && l(!1), m = !1, i(() => e), f(e, n.committed())) {
+      d(!1);
+      return;
+    }
+    const a = {
+      id: u,
+      value: e,
+      metadata: t,
+      startedAt: g(),
+      committing: !1
+    };
+    u += 1, r = a, d(!0), s("requested", a), o(() => {
+      c || r !== a || (s("intent_presented", a), s("commit_started", a), a.committing = !0, n.commit(a.value, a.metadata), a.committing = !1, !(c || r !== a) && (s("committed", a), o(() => {
+        c || r !== a || (s("content_presented", a), r = null, d(!1), i(() => n.committed()));
+      })));
+    });
+  }, p = (e, t) => {
+    c || (l(!1), m = !1, i(() => e), f(e, n.committed()) || n.commit(e, t), i(() => n.committed()));
+  };
+  return h(() => {
+    const e = n.committed(), t = r;
+    t && t.committing && f(e, t.value) || (t && !f(e, t.value) && l(!1), (!r || !f(e, r.value)) && (m = !1, i(() => e)));
+  }), x(() => {
+    c = !0, l(!1);
+  }), {
+    visual: v,
+    committed: n.committed,
+    pending: A,
+    preview: (e) => {
+      c || r || (m = !0, i(() => e));
+    },
+    resetPreview: () => {
+      c || !m || r || (m = !1, i(() => n.committed()));
+    },
+    request: P,
+    commitNow: p,
+    cancel: () => l(!0)
+  };
+}
+export {
+  E as createUIFirstSelection
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/floe-webapp-core",
-  "version": "0.36.74",
+  "version": "0.36.75",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",