@t007/input 0.0.31 → 0.0.32

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import "@t007/utils";
-import { BaseProps, CheckboxInputAddon, DateInputAddon, FileInputAddon, SelectElementAddon } from "../react";
+import { t007InputElement, BaseProps, CheckboxInputAddon, DateInputAddon, FileInputAddon, SelectElementAddon } from "../react";
 
 interface BaseOptions extends Omit<BaseProps, "error"> {
   /** Visible label text. */
@@ -50,7 +50,7 @@ export interface FormManager {
   /** Toggle the filled state on a supported field.
    * @param input Supported form control.
    */
-  toggleFilled(input: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement): void;
+  toggleFilled(input: t007InputElement): void;
   /** Attach a fallback helper node.
    * @param field Field wrapper element.
    */
@@ -67,7 +67,10 @@ export interface FormManager {
    * @param options Field configuration.
    * @returns Created field element.
    */
-  field(options: FieldOptions): HTMLDivElement;
+  field(options: SelectFieldOptions): HTMLDivElement & { inputEl: HTMLSelectElement };
+  field(options: TextareaFieldOptions): HTMLDivElement & { inputEl: HTMLTextAreaElement };
+  field(options: PasswordFieldOptions | FileFieldOptions | CheckboxFieldOptions | DateFieldOptions | GenericFieldOptions): HTMLDivElement & { inputEl: HTMLInputElement };
+  field(options: FieldOptions): HTMLDivElement & { inputEl: t007InputElement };
   /** Validate a form and attach the proper hooks.
    * @param form Form element to validate.
    */
@@ -95,9 +98,9 @@ declare global {
     /** Public form manager singleton. */
     formManager: FormManager;
     /** Public field factory. */
-    field?: FormManager["field"];
+    field: FormManager["field"];
     /** Public form validation helper. */
-    handleFormValidation?: FormManager["handleFormValidation"];
+    handleFormValidation: FormManager["handleFormValidation"];
   }
   interface Window {
     field?: T007Namespace["field"];

package/dist/index.global.js

@@ -1,11 +1,11 @@
 "use strict";
 (() => {
-  // ../../../sia-reactor/dist/chunk-RI45W4O6.js
+  // ../../../sia-reactor/dist/chunk-243U74PP.js
   function createEl(tag, props, dataset, styles, el = tag ? document?.createElement(tag) : null) {
-    return assignEl(el, props, dataset, styles), el;
+    return assignEl(el, props, dataset, styles);
   }
   function assignEl(el, props, dataset, styles) {
-    if (!el) return;
+    if (!el) return null;
     if (props) {
       for (const k of Object.keys(props)) if (props[k] !== void 0) el[k] = props[k];
     }
@@ -15,50 +15,64 @@
     if (styles) {
       for (const k of Object.keys(styles)) if (styles[k] !== void 0) el.style[k] = styles[k];
     }
+    return el;
   }
 
-  // ../../../sia-reactor/dist/chunk-4PLMBUCP.js
+  // ../../../sia-reactor/dist/chunk-2ZYYYSZ4.js
+  var RTR_BATCH = "undefined" !== typeof window ? ("undefined" !== typeof queueMicrotask ? queueMicrotask : setTimeout).bind(window) : "undefined" !== typeof process && process.nextTick ? process.nextTick : setTimeout;
+  var RTR_LOG = console.log.bind(console, "[S.I.A Reactor]");
+  var NIL = Object.freeze({});
   var CTX = {
     /** Flag indicating whether the application is running in development mode. */
     isDevEnv: "undefined" !== typeof process ? process.env.NODE_ENV !== "production" : true,
-    /** Flag indicating whether a cascade is currently ongoing so reactors can allow all writes. */
-    isCascading: false,
+    /** Flag indicating whether an operation is bypassing checks so reactors can allow all writes. */
+    usingForce: false,
     /** Active `Autotracker` instance, override for automatic dependency collection on `Reactor` traps. */
-    autotracker: null
+    autotracker: null,
+    /** Extensible meta context for payloads and cross-cutting concerns. */
+    meta: null,
+    /** Default configuration for new `Reactor` instances and also fallback for utils that need and are called without these options. */
+    defaults: {
+      crossRealms: false,
+      smartCloning: false,
+      eventBubbling: true,
+      eventCapturing: "auto",
+      lineageTracing: false,
+      preserveContext: false,
+      equalityFunction: Object.is,
+      batchingFunction: RTR_BATCH
+    }
   };
-  var RTR_BATCH = "undefined" !== typeof window ? ("undefined" !== typeof queueMicrotask ? queueMicrotask : setTimeout).bind(window) : "undefined" !== typeof process && process.nextTick ? process.nextTick : setTimeout;
-  var RTR_LOG = console.log.bind(console, "[S.I.A Reactor]");
-  var NIL = Object.freeze({});
 
-  // ../utils/dist/chunk-4O76EZJ4.js
-  var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable='true'],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
+  // ../utils/dist/chunk-HGUYOV3P.js
+  var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
   var VIRTUAL_RESOURCE = /* @__PURE__ */ Symbol.for("T007_VIRTUAL_RESOURCE");
-  function loadResource(req, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
-    w.t007 ??= {}, w.t007._resourceCache ??= {};
+  function loadResource(req, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, win = window) {
+    win.t007 ??= {}, win.t007._resourceCache ??= {};
     if (req === VIRTUAL_RESOURCE || isSym(req)) return Promise.resolve();
     const src = req;
-    if (w.t007._resourceCache[src]) return w.t007._resourceCache[src];
-    const existing = type === "script" ? Array.prototype.find.call(w.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(w.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
-    if (existing) return w.t007._resourceCache[src] = Promise.resolve(existing);
-    w.t007._resourceCache[src] = new Promise((resolve, reject) => {
+    if (win.t007._resourceCache[src]) return win.t007._resourceCache[src];
+    const existing = type === "script" ? Array.prototype.find.call(win.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(win.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
+    if (existing) return win.t007._resourceCache[src] = Promise.resolve(existing);
+    win.t007._resourceCache[src] = new Promise((resolve, reject) => {
       (function tryLoad(remaining, el) {
         const onerror = () => {
           el?.remove?.();
           if (remaining > 1) {
             setTimeout(tryLoad, 1e3, remaining - 1);
-            console.warn(`Retrying ${type} load (${attempts - remaining + 1}): ${src}...`);
+            console.warn(`Retrying ${type} load for "${src}" (${attempts - remaining + 1})...`);
           } else {
-            delete w.t007._resourceCache[src];
-            reject(new Error(`${type} load failed after ${attempts} attempts: ${src}`));
+            delete win.t007._resourceCache[src];
+            reject(new Error(`${capitalize(type)} load failed for "${src}" after ${attempts - 1} attempts`));
           }
         };
         const url = retryKey && remaining < attempts ? `${src}${src.includes("?") ? "&" : "?"}_${retryKey}=${Date.now()}` : src;
-        if (type === "script") w.document.body.append(el = createEl("script", { src: url, type: module ? "module" : "text/javascript", crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
-        else if (type === "style") w.document.head.append(el = createEl("link", { rel: "stylesheet", href: url, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
+        if (type === "script") win.document.body.append(el = createEl("script", { src: url, type: module ? "module" : "text/javascript", crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
+        else if (type === "style") win.document.head.append(el = createEl("link", { rel: "stylesheet", href: url, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
         else reject(new Error(`Unsupported resource type: ${type}`));
       })(attempts);
     });
-    return w.t007._resourceCache[src];
+    return win.t007._resourceCache[src];
   }
   function isSym(val) {
     return "symbol" === typeof val;
@@ -69,6 +83,9 @@
   function isArr(obj) {
     return Array.isArray(obj);
   }
+  function capitalize(word = "") {
+    return word.replace(/^(\s*)([a-z])/i, (_, s, l) => s + l.toUpperCase());
+  }
   function cleanURL(url) {
     try {
       const u = new URL(url, window.location.href);
@@ -78,6 +95,7 @@
     }
   }
   function isSameURL(url1, url2) {
+    if (url1 === url2) return true;
     if (!isStr(url1) || !isStr(url2) || !url1 || !url2) return false;
     return cleanURL(url1) === cleanURL(url2);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t007/input",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "A lightweight, pure JS input system.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
@@ -21,7 +21,8 @@
   "types": "./dist/index.d.ts",
   "style": "./dist/index.css",
   "sideEffects": [
-    "*.css"
+    "**/*.css",
+    "**/*.scss"
   ],
   "exports": {
     ".": {
@@ -68,7 +69,7 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@t007/utils": "^0.0.33"
+    "@t007/utils": "^0.0.34"
   },
   "peerDependencies": {
     "react": "^18.0.0"