@jsenv/navi 0.16.51 → 0.16.52

package/dist/jsenv_navi.js

@@ -4570,54 +4570,6 @@ const isProps = (value) => {
   return value !== null && typeof value === "object";
 };
 
-/**
- * Creates a signal that stays synchronized with an external value,
- * only updating the signal when the value actually changes.
- *
- * This hook solves a common reactive UI pattern where:
- * 1. A signal controls a UI element (like an input field)
- * 2. The UI element can be modified by user interaction
- * 3. When the external "source of truth" changes, it should take precedence
- *
- * @param {any} value - The external value to sync with (the "source of truth")
- * @param {any} [initialValue] - Optional initial value for the signal (defaults to value)
- * @returns {Signal} A signal that tracks the external value but allows temporary local changes
- *
- * @example
- * const FileNameEditor = ({ file }) => {
- *   // Signal stays in sync with file.name, but allows user editing
- *   const nameSignal = useSignalSync(file.name);
- *
- *   return (
- *     <Editable
- *       valueSignal={nameSignal}  // User can edit this
- *       action={renameFileAction} // Saves changes
- *     />
- *   );
- * };
- *
- * // Scenario:
- * // 1. file.name = "doc.txt", nameSignal.value = "doc.txt"
- * // 2. User types "report" -> nameSignal.value = "report.txt"
- * // 3. External update: file.name = "shared-doc.txt"
- * // 4. Next render: nameSignal.value = "shared-doc.txt" (model wins!)
- *
- */
-
-const useSignalSync = (value, initialValue = value) => {
-  const signal = useSignal(initialValue);
-  const previousValueRef = useRef(value);
-
-  // Only update signal when external value actually changes
-  // This preserves user input between external changes
-  if (previousValueRef.current !== value) {
-    previousValueRef.current = value;
-    signal.value = value; // Model takes precedence
-  }
-
-  return signal;
-};
-
 const addIntoArray = (array, ...valuesToAdd) => {
   if (valuesToAdd.length === 1) {
     const [valueToAdd] = valuesToAdd;
@@ -4680,6 +4632,69 @@ const removeFromArray = (array, ...valuesToRemove) => {
   return hasRemovedValues ? arrayWithoutTheseValues : array;
 };
 
+const useArraySignalMembership = (arraySignal, id) => {
+  const array = arraySignal.value;
+  const found = array.includes(id);
+  return [
+    found,
+    (enabled) => {
+      if (enabled) {
+        arraySignal.value = addIntoArray(array, id);
+      } else {
+        arraySignal.value = removeFromArray(array, id);
+      }
+    },
+  ];
+};
+
+/**
+ * Creates a signal that stays synchronized with an external value,
+ * only updating the signal when the value actually changes.
+ *
+ * This hook solves a common reactive UI pattern where:
+ * 1. A signal controls a UI element (like an input field)
+ * 2. The UI element can be modified by user interaction
+ * 3. When the external "source of truth" changes, it should take precedence
+ *
+ * @param {any} value - The external value to sync with (the "source of truth")
+ * @param {any} [initialValue] - Optional initial value for the signal (defaults to value)
+ * @returns {Signal} A signal that tracks the external value but allows temporary local changes
+ *
+ * @example
+ * const FileNameEditor = ({ file }) => {
+ *   // Signal stays in sync with file.name, but allows user editing
+ *   const nameSignal = useSignalSync(file.name);
+ *
+ *   return (
+ *     <Editable
+ *       valueSignal={nameSignal}  // User can edit this
+ *       action={renameFileAction} // Saves changes
+ *     />
+ *   );
+ * };
+ *
+ * // Scenario:
+ * // 1. file.name = "doc.txt", nameSignal.value = "doc.txt"
+ * // 2. User types "report" -> nameSignal.value = "report.txt"
+ * // 3. External update: file.name = "shared-doc.txt"
+ * // 4. Next render: nameSignal.value = "shared-doc.txt" (model wins!)
+ *
+ */
+
+const useSignalSync = (value, initialValue = value) => {
+  const signal = useSignal(initialValue);
+  const previousValueRef = useRef(value);
+
+  // Only update signal when external value actually changes
+  // This preserves user input between external changes
+  if (previousValueRef.current !== value) {
+    previousValueRef.current = value;
+    signal.value = value; // Model takes precedence
+  }
+
+  return signal;
+};
+
 /**
  * Picks the best initial value from three options using a simple priority system.
  *
@@ -28509,5 +28524,5 @@ const UserSvg = () => jsx("svg", {
   })
 });
 
-export { ActionRenderer, ActiveKeyboardShortcuts, Address, BadgeCount, Box, Button, ButtonCopyToClipboard, Caption, CheckSvg, Checkbox, CheckboxList, Code, Col, Colgroup, ConstructionSvg, Details, DialogLayout, Editable, ErrorBoundaryContext, ExclamationSvg, EyeClosedSvg, EyeSvg, Form, Group, HeartSvg, HomeSvg, Icon, Image, Input, Label, Link, LinkAnchorSvg, LinkBlankTargetSvg, MessageBox, Paragraph, Radio, RadioList, Route, RouteLink, Routes, RowNumberCol, RowNumberTableCell, SINGLE_SPACE_CONSTRAINT, SVGMaskOverlay, SearchSvg, Select, SelectionContext, Separator, SettingsSvg, StarSvg, SummaryMarker, Svg, Tab, TabList, Table, TableCell, Tbody, Text, Thead, Title, Tr, UITransition, UserSvg, ViewportLayout, actionIntegratedVia, addCustomMessage, clearAllRoutes, compareTwoJsValues, createAction, createAvailableConstraint, createRequestCanceller, createSelectionKeyboardShortcuts, enableDebugActions, enableDebugOnDocumentLoading, forwardActionRequested, installCustomConstraintValidation, isCellSelected, isColumnSelected, isRowSelected, localStorageSignal, navBack, navForward, navTo, openCallout, rawUrlPart, reload, removeCustomMessage, requestAction, rerunActions, resource, setBaseUrl, setupRoutes, stateSignal, stopLoad, stringifyTableSelectionValue, updateActions, useActionData, useActionStatus, useCalloutClose, useCellsAndColumns, useConstraintValidityState, useDependenciesDiff, useDocumentResource, useDocumentState, useDocumentUrl, useEditionController, useFocusGroup, useKeyboardShortcuts, useMatchingRouteInfo, useNavState$1 as useNavState, useRouteStatus, useRunOnMount, useSelectableElement, useSelectionController, useSignalSync, useStateArray, useTitleLevel, useUrlSearchParam, valueInLocalStorage };
+export { ActionRenderer, ActiveKeyboardShortcuts, Address, BadgeCount, Box, Button, ButtonCopyToClipboard, Caption, CheckSvg, Checkbox, CheckboxList, Code, Col, Colgroup, ConstructionSvg, Details, DialogLayout, Editable, ErrorBoundaryContext, ExclamationSvg, EyeClosedSvg, EyeSvg, Form, Group, HeartSvg, HomeSvg, Icon, Image, Input, Label, Link, LinkAnchorSvg, LinkBlankTargetSvg, MessageBox, Paragraph, Radio, RadioList, Route, RouteLink, Routes, RowNumberCol, RowNumberTableCell, SINGLE_SPACE_CONSTRAINT, SVGMaskOverlay, SearchSvg, Select, SelectionContext, Separator, SettingsSvg, StarSvg, SummaryMarker, Svg, Tab, TabList, Table, TableCell, Tbody, Text, Thead, Title, Tr, UITransition, UserSvg, ViewportLayout, actionIntegratedVia, addCustomMessage, clearAllRoutes, compareTwoJsValues, createAction, createAvailableConstraint, createRequestCanceller, createSelectionKeyboardShortcuts, enableDebugActions, enableDebugOnDocumentLoading, forwardActionRequested, installCustomConstraintValidation, isCellSelected, isColumnSelected, isRowSelected, localStorageSignal, navBack, navForward, navTo, openCallout, rawUrlPart, reload, removeCustomMessage, requestAction, rerunActions, resource, setBaseUrl, setupRoutes, stateSignal, stopLoad, stringifyTableSelectionValue, updateActions, useActionData, useActionStatus, useArraySignalMembership, useCalloutClose, useCellsAndColumns, useConstraintValidityState, useDependenciesDiff, useDocumentResource, useDocumentState, useDocumentUrl, useEditionController, useFocusGroup, useKeyboardShortcuts, useMatchingRouteInfo, useNavState$1 as useNavState, useRouteStatus, useRunOnMount, useSelectableElement, useSelectionController, useSignalSync, useStateArray, useTitleLevel, useUrlSearchParam, valueInLocalStorage };
 //# sourceMappingURL=jsenv_navi.js.map