anentrypoint-design 0.0.363 → 0.0.365

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anentrypoint-design",
-  "version": "0.0.363",
+  "version": "0.0.365",
   "description": "247420 design system SDK — webjsx + modified ripple-ui, single-file ESM bundle for reproducible use of the AnEntrypoint design.",
   "type": "module",
   "main": "./dist/247420.js",

package/src/components/editor-primitives.js

@@ -990,3 +990,29 @@ export function formatBatchOutcome({ succeeded = 0, total = 0, failedNames = [],
     const more = failedNames.length > maxNames ? ` and ${failedNames.length - maxNames} more` : '';
     return `${succeeded}/${total} succeeded; failed: ${shown}${more}`;
 }
+
+// runBatchSequential — pure async orchestration companion to
+// BatchProgressLabel/formatBatchOutcome: runs `items` through `fn` one at a
+// time (never in parallel, matching docstudio's rate-limited bulk-action
+// runner), never aborting on a single item's failure. `onProgress({done,
+// total})` fires after each item settles so a host can drive
+// BatchProgressLabel live; the final `{succeeded, total, failedNames}`
+// return shape feeds formatBatchOutcome directly. `fn` receives (item, index)
+// and may reject/throw — a rejection is recorded as a failure keyed by
+// `item.name != null ? item.name : String(item)`, never re-thrown.
+export async function runBatchSequential(items = [], fn, onProgress) {
+    const total = items.length;
+    let succeeded = 0;
+    const failedNames = [];
+    for (let i = 0; i < total; i += 1) {
+        const item = items[i];
+        try {
+            await fn(item, i);
+            succeeded += 1;
+        } catch (err) {
+            failedNames.push(item && item.name != null ? item.name : String(item));
+        }
+        if (onProgress) onProgress({ done: i + 1, total });
+    }
+    return { succeeded, total, failedNames };
+}

package/src/components/form-primitives.js

@@ -182,3 +182,21 @@ export function useFormValidation(schema = {}) {
     };
     return { errors, validate, validateField };
 }
+
+// focusFirstInvalidField — after a `useFormValidation().validate()` call
+// reports errors, moves keyboard focus to the first invalid field in
+// `order` (schema key order, matching docstudio's requireFields, which
+// validates fields in a fixed order and focuses only the first failure
+// rather than dumping all errors on screen with no navigational aid).
+// `getEl(name)` resolves a field name to its live DOM node (host owns the
+// lookup — a ref map, `querySelector`, etc.); a name with no resolvable
+// element is skipped rather than throwing. No-op if no name in `order` has
+// an error.
+export function focusFirstInvalidField(errors, order, getEl) {
+    for (const name of order) {
+        if (!errors[name]) continue;
+        const el = getEl(name);
+        if (el && typeof el.focus === 'function') { el.focus(); return name; }
+    }
+    return null;
+}

package/src/components.js

@@ -72,7 +72,7 @@ export {
 export { ThemeToggle } from './components/theme-toggle.js';
 
 export {
-    Checkbox, Radio, RadioGroup, Toggle, Field, useFormValidation
+    Checkbox, Radio, RadioGroup, Toggle, Field, useFormValidation, focusFirstInvalidField
 } from './components/form-primitives.js';
 
 export {
@@ -97,7 +97,7 @@ export {
     useMediaQuery,
     BP_SM, BP_MD, BP_LG, BP_XL,
     InfoRow, InfoSection, DiagnosticsPanel,
-    BatchProgressLabel, formatBatchOutcome
+    BatchProgressLabel, formatBatchOutcome, runBatchSequential
 } from './components/editor-primitives.js';
 
 export {