@almadar/ui 4.6.6 → 4.6.10

package/dist/runtime/index.js

@@ -1,5 +1,5 @@
 import * as React115 from 'react';
-import React115__default, { createContext, useContext, useRef, useEffect, useCallback, useMemo, Suspense, useState, useLayoutEffect, lazy, useId } from 'react';
+import React115__default, { createContext, useContext, useRef, useEffect, useCallback, useMemo, useState, Suspense, useLayoutEffect, lazy, useId } from 'react';
 import { EventBusContext, OrbitalProvider, VerificationProvider } from '@almadar/ui/providers';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { clsx } from 'clsx';
@@ -1048,6 +1048,109 @@ var init_verificationRegistry = __esm({
     exposeOnWindow();
   }
 });
+function refId(obj) {
+  if (obj === null || obj === void 0 || typeof obj !== "object") return null;
+  const existing = refIds.get(obj);
+  if (existing !== void 0) return existing;
+  const id = nextRefId++;
+  refIds.set(obj, id);
+  return id;
+}
+function slotEntriesInOrder(slot) {
+  if (!slot) return [];
+  const out = [];
+  for (const [sourceKey, entry] of Object.entries(slot)) {
+    if (entry.patterns.length > 0) {
+      out.push({ sourceKey, entry });
+    }
+  }
+  return out;
+}
+function SlotsProvider({ children }) {
+  const [slots, setSlots] = useState({});
+  const setSlotPatterns = useCallback((slot, patterns, source) => {
+    const sourceKey = source?.trait ?? DEFAULT_SOURCE_KEY;
+    const entityProp = patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.entity : void 0;
+    slotLog.debug("setSlotPatterns", {
+      slot,
+      sourceKey,
+      patternCount: patterns.length,
+      firstPatternType: patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.type : void 0,
+      entityRefId: refId(entityProp)
+    });
+    setSlots((prev) => {
+      const prevSlot = prev[slot] ?? {};
+      return {
+        ...prev,
+        [slot]: {
+          ...prevSlot,
+          [sourceKey]: { patterns, source }
+        }
+      };
+    });
+  }, []);
+  const clearSlot = useCallback((slot) => {
+    setSlots((prev) => {
+      const existing = prev[slot];
+      if (existing && Object.keys(existing).length === 0) {
+        return prev;
+      }
+      return { ...prev, [slot]: {} };
+    });
+  }, []);
+  const clearSlotForSource = useCallback((slot, sourceTrait) => {
+    setSlots((prev) => {
+      const existing = prev[slot];
+      if (!existing || !(sourceTrait in existing)) return prev;
+      const next = { ...existing };
+      delete next[sourceTrait];
+      return { ...prev, [slot]: next };
+    });
+  }, []);
+  const clearAllSlots = useCallback(() => {
+    setSlots({});
+  }, []);
+  const actionsRef = useRef({
+    setSlotPatterns,
+    clearSlot,
+    clearSlotForSource,
+    clearAllSlots
+  });
+  actionsRef.current = { setSlotPatterns, clearSlot, clearSlotForSource, clearAllSlots };
+  const [stableActions] = useState(() => ({
+    setSlotPatterns: (...args) => actionsRef.current.setSlotPatterns(...args),
+    clearSlot: (...args) => actionsRef.current.clearSlot(...args),
+    clearSlotForSource: (...args) => actionsRef.current.clearSlotForSource(...args),
+    clearAllSlots: () => actionsRef.current.clearAllSlots()
+  }));
+  return /* @__PURE__ */ jsx(SlotsActionsContext.Provider, { value: stableActions, children: /* @__PURE__ */ jsx(SlotsStateContext.Provider, { value: slots, children }) });
+}
+function useSlots() {
+  return useContext(SlotsStateContext);
+}
+function useSlotContent(slotName) {
+  const slots = useContext(SlotsStateContext);
+  return slots[slotName] || null;
+}
+function useSlotsActions() {
+  const actions = useContext(SlotsActionsContext);
+  if (!actions) {
+    throw new Error("useSlotsActions must be used within a SlotsProvider");
+  }
+  return actions;
+}
+var slotLog, refIds, nextRefId, DEFAULT_SOURCE_KEY, SlotsStateContext, SlotsActionsContext;
+var init_SlotsContext = __esm({
+  "runtime/ui/SlotsContext.tsx"() {
+    init_logger();
+    slotLog = createLogger("almadar:ui:slot-render");
+    refIds = /* @__PURE__ */ new WeakMap();
+    nextRefId = 1;
+    DEFAULT_SOURCE_KEY = "__default__";
+    SlotsStateContext = createContext({});
+    SlotsActionsContext = createContext(null);
+  }
+});
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -19762,20 +19865,21 @@ var init_InputGroup = __esm({
 
 // lib/debug.ts
 function isDebugEnabled() {
-  return DEBUG_ENABLED;
+  if (DEBUG_ENABLED) return true;
+  return typeof window !== "undefined" && window.__ALMADAR_DEBUG_VERIFY__ === true;
 }
 function debug(...args) {
-  if (DEBUG_ENABLED) {
+  if (isDebugEnabled()) {
     console.log("[DEBUG]", ...args);
   }
 }
 function debugGroup(label) {
-  if (DEBUG_ENABLED) {
+  if (isDebugEnabled()) {
     console.group(`[DEBUG] ${label}`);
   }
 }
 function debugGroupEnd() {
-  if (DEBUG_ENABLED) {
+  if (isDebugEnabled()) {
     console.groupEnd();
   }
 }
@@ -28288,7 +28392,14 @@ var init_Form = __esm({
       // Schema-based props
       entity,
       fields,
-      initialData = {},
+      // No `= {}` default: a fresh `{}` evaluated inline on every render
+      // would change the prop reference every tick and bust the useMemo
+      // cache below (`[entity, initialData]` deps), reigniting the
+      // setFormData useEffect on every keystroke and producing an
+      // infinite re-render loop with stuck form inputs. The memo and
+      // submit handler both handle `undefined` already via the
+      // `typeof initialData === 'object'` guard.
+      initialData,
       isLoading = false,
       error,
       submitLabel,
@@ -28315,9 +28426,11 @@ var init_Form = __esm({
       const isSchemaEntity = isOrbitalEntitySchema(entity);
       const resolvedEntity = isSchemaEntity ? entity : void 0;
       const entityName = typeof entity === "string" ? entity : resolvedEntity?.name;
-      const entityRowAsInitial = isPlainEntityRow(entity) ? entity : void 0;
-      const callerInitial = initialData !== null && typeof initialData === "object" && !Array.isArray(initialData) ? initialData : {};
-      const normalizedInitialData = entityRowAsInitial !== void 0 ? { ...entityRowAsInitial, ...callerInitial } : callerInitial;
+      const normalizedInitialData = React115__default.useMemo(() => {
+        const entityRowAsInitial = isPlainEntityRow(entity) ? entity : void 0;
+        const callerInitial = initialData !== null && typeof initialData === "object" && !Array.isArray(initialData) ? initialData : {};
+        return entityRowAsInitial !== void 0 ? { ...entityRowAsInitial, ...callerInitial } : callerInitial;
+      }, [entity, initialData]);
       const entityDerivedFields = React115__default.useMemo(() => {
         if (fields && fields.length > 0) return void 0;
         if (!resolvedEntity) return void 0;
@@ -28343,6 +28456,19 @@ var init_Form = __esm({
       const [collapsedSections, setCollapsedSections] = React115__default.useState(
         /* @__PURE__ */ new Set()
       );
+      const formMode = props.mode;
+      const mountedRef = React115__default.useRef(false);
+      if (!mountedRef.current) {
+        mountedRef.current = true;
+        debug("forms", "mount", {
+          mode: formMode,
+          submitEvent,
+          cancelEvent,
+          fieldNames: (fields ?? []).map((f3) => f3.name ?? f3.field).filter(Boolean),
+          initialDataKeys: Object.keys(normalizedInitialData),
+          initialData: normalizedInitialData
+        });
+      }
       const shouldShowCancel = showCancel ?? (fields && fields.length > 0);
       const evalContext = React115__default.useMemo(
         () => ({
@@ -28354,6 +28480,12 @@ var init_Form = __esm({
         [formData, externalContext]
       );
       React115__default.useEffect(() => {
+        debug("forms", "initialData-sync", {
+          mode: formMode,
+          normalizedInitialData,
+          prevFormData: formData,
+          willSet: Object.keys(normalizedInitialData).length > 0
+        });
         if (Object.keys(normalizedInitialData).length > 0) {
           setFormData(normalizedInitialData);
         }
@@ -28410,6 +28542,7 @@ var init_Form = __esm({
       );
       const handleChange = (name, value) => {
         const newFormData = { ...formData, [name]: value };
+        debug("forms", "field-change", { mode: formMode, name, value, prevFormData: formData, newFormData });
         setFormData(newFormData);
         eventBus.emit("UI:FIELD_CHANGED", {
           fieldId: name,
@@ -28448,11 +28581,18 @@ var init_Form = __esm({
       };
       const handleSubmit = (e) => {
         e.preventDefault();
+        debug("forms", "submit-enter", {
+          mode: formMode,
+          submitEvent,
+          formData,
+          normalizedInitialData
+        });
         const mergedData = {
           ...normalizedInitialData,
           ...formData
         };
         const payload = { data: mergedData };
+        debug("forms", "submit-emit", { mode: formMode, submitEvent: `UI:${submitEvent}`, payloadData: payload.data });
         eventBus.emit(`UI:${submitEvent}`, payload);
         if (onSubmit) {
           eventBus.emit(`UI:${onSubmit}`, payload);
@@ -37683,6 +37823,14 @@ function SlotContentRenderer({
   patternPath
 }) {
   const entityProp = content.props.entity;
+  if (content.pattern === "form-section") {
+    slotLog.debug("SlotContentRenderer:form-section-render", {
+      contentId: content.id,
+      sourceTrait: content.sourceTrait,
+      entityRefId: refId(entityProp),
+      entityIsObject: entityProp !== null && typeof entityProp === "object" && !Array.isArray(entityProp)
+    });
+  }
   if (typeof entityProp === "string" && entityProp.length > 0) {
     if (typeof process !== "undefined" && process.env && process.env.NODE_ENV !== "production") {
       throw new Error(
@@ -37826,6 +37974,7 @@ var init_UISlotRenderer = __esm({
     init_Box();
     init_Typography();
     init_useEventBus();
+    init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
     init_Skeleton();
@@ -37986,7 +38135,13 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
   const { entities } = useEntitySchema();
   const manager = useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
-    return new StateMachineManager(traitDefs);
+    const m = new StateMachineManager(traitDefs);
+    for (const binding of traitBindings) {
+      if (binding.config !== void 0) {
+        m.setTraitConfig(binding.trait.name, binding.config);
+      }
+    }
+    return m;
   }, [traitBindings]);
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
@@ -38632,90 +38787,16 @@ function useTrait(traitName) {
   const context = useTraitContext();
   return context.getTrait(traitName);
 }
-var DEFAULT_SOURCE_KEY = "__default__";
-function slotEntriesInOrder(slot) {
-  if (!slot) return [];
-  const out = [];
-  for (const [sourceKey, entry] of Object.entries(slot)) {
-    if (entry.patterns.length > 0) {
-      out.push({ sourceKey, entry });
-    }
-  }
-  return out;
-}
-var SlotsStateContext = createContext({});
-var SlotsActionsContext = createContext(null);
-function SlotsProvider({ children }) {
-  const [slots, setSlots] = useState({});
-  const setSlotPatterns = useCallback((slot, patterns, source) => {
-    const sourceKey = source?.trait ?? DEFAULT_SOURCE_KEY;
-    setSlots((prev) => {
-      const prevSlot = prev[slot] ?? {};
-      return {
-        ...prev,
-        [slot]: {
-          ...prevSlot,
-          [sourceKey]: { patterns, source }
-        }
-      };
-    });
-  }, []);
-  const clearSlot = useCallback((slot) => {
-    setSlots((prev) => {
-      const existing = prev[slot];
-      if (existing && Object.keys(existing).length === 0) {
-        return prev;
-      }
-      return { ...prev, [slot]: {} };
-    });
-  }, []);
-  const clearSlotForSource = useCallback((slot, sourceTrait) => {
-    setSlots((prev) => {
-      const existing = prev[slot];
-      if (!existing || !(sourceTrait in existing)) return prev;
-      const next = { ...existing };
-      delete next[sourceTrait];
-      return { ...prev, [slot]: next };
-    });
-  }, []);
-  const clearAllSlots = useCallback(() => {
-    setSlots({});
-  }, []);
-  const actionsRef = useRef({
-    setSlotPatterns,
-    clearSlot,
-    clearSlotForSource,
-    clearAllSlots
-  });
-  actionsRef.current = { setSlotPatterns, clearSlot, clearSlotForSource, clearAllSlots };
-  const [stableActions] = useState(() => ({
-    setSlotPatterns: (...args) => actionsRef.current.setSlotPatterns(...args),
-    clearSlot: (...args) => actionsRef.current.clearSlot(...args),
-    clearSlotForSource: (...args) => actionsRef.current.clearSlotForSource(...args),
-    clearAllSlots: () => actionsRef.current.clearAllSlots()
-  }));
-  return /* @__PURE__ */ jsx(SlotsActionsContext.Provider, { value: stableActions, children: /* @__PURE__ */ jsx(SlotsStateContext.Provider, { value: slots, children }) });
-}
-function useSlots() {
-  return useContext(SlotsStateContext);
-}
-function useSlotContent(slotName) {
-  const slots = useContext(SlotsStateContext);
-  return slots[slotName] || null;
-}
-function useSlotsActions() {
-  const actions = useContext(SlotsActionsContext);
-  if (!actions) {
-    throw new Error("useSlotsActions must be used within a SlotsProvider");
-  }
-  return actions;
-}
+
+// runtime/index.ts
+init_SlotsContext();
 
 // runtime/OrbPreview.tsx
 init_Box();
 init_Typography();
 init_UISlotRenderer();
 init_useEventBus();
+init_SlotsContext();
 init_EntitySchemaContext();
 
 // runtime/ServerBridge.tsx
@@ -38935,6 +39016,10 @@ function SlotBridge() {
   const slots = useSlots();
   const { render, clear } = useUISlots();
   useEffect(() => {
+    slotLog.debug("SlotBridge:effect-fired", {
+      slotCount: Object.keys(slots).length,
+      slots: Object.keys(slots)
+    });
     for (const [slotName, slotState] of Object.entries(slots)) {
       const entries = slotEntriesInOrder(slotState);
       if (entries.length === 0) {
@@ -38956,6 +39041,12 @@ function SlotBridge() {
         const only = children[0];
         const { type, children: nested, ...rest } = only;
         const lastEntry = entries[entries.length - 1];
+        slotLog.debug("SlotBridge:render-single", {
+          slot: slotName,
+          patternType: type,
+          entityRefId: refId(rest.entity),
+          sourceTrait: lastEntry.entry.source?.trait
+        });
         render({
           target: slotName,
           pattern: type,

package/dist/runtime/ui/SlotsContext.d.ts

@@ -20,6 +20,9 @@
  */
 import React from 'react';
 import type { PatternConfig, EventSource, ResolvedTrait } from '@almadar/core';
+declare const slotLog: import("../../lib").Logger;
+export declare function refId(obj: unknown): number | null;
+export { slotLog };
 /** A single pattern entry in a slot */
 export interface SlotPatternEntry {
     pattern: PatternConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.6.6",
+  "version": "4.6.10",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -121,7 +121,7 @@
     "@almadar/core": "^7.0.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/patterns": ">=2.17.1",
-    "@almadar/runtime": "^4.11.1",
+    "@almadar/runtime": "^5.3.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",