@necto-react/helpers 2.1.0 → 2.4.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Necto
+Copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,22 @@
+<div align="center">
+  <a href="https://necto.dev">
+    <img alt="Necto Logo" src="https://avatars.githubusercontent.com/u/158605331?s=100&v=4">
+  <a>
+    
+  <h2>Necto - React Helpers Library</h2>
+
+  <p>Necto's library for providing global helpers for React applications.</p>
+
+  <a aria-label="Corinvo" href="https://corinvo.github.io">
+    <img src="https://img.shields.io/badge/Made%20by-Corinvo-black.svg?style=for-the-badge&color=black">
+  </a>
+  <a href="https://www.npmjs.com/package/@necto-react/helpers">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@necto-react/helpers.svg?style=for-the-badge">
+  </a>
+  <a aria-label="License" href="https://jsr.io/@necto-react/helpers">
+    <img src="https://jsr.io/badges/@necto-react/helpers?style=for-the-badge">
+  </a>
+  <a aria-label="License" href="https://github.com/nectoutil/NodeKit/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-97CA25.svg?style=for-the-badge">
+  </a>
+</div>

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var s=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var y=(t,n)=>{for(var e in n)s(t,e,{get:n[e],enumerable:!0})},p=(t,n,e,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of f(n))!m.call(t,o)&&o!==e&&s(t,o,{get:()=>n[o],enumerable:!(a=u(n,o))||a.enumerable});return t};var T=t=>p(s({},"__esModule",{value:!0}),t);var M={};y(M,{isKeyboardFocusEvent:()=>w});module.exports=T(M);var i=require("@necto/dom"),b=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),v={Tab:!0,Escape:!0};function w(t,n,e){if(!e||!("target"in e)||!e.target)return!1;let a=(0,i.getOwnerDocument)(e.target),o=(0,i.getOwnerWindow)(e.target),E=typeof window<"u"?o.HTMLInputElement:HTMLInputElement,l=typeof window<"u"?o.HTMLTextAreaElement:HTMLTextAreaElement,d=typeof window<"u"?o.HTMLElement:HTMLElement,c=typeof window<"u"?o.KeyboardEvent:KeyboardEvent,r=a.activeElement;return t=t||r instanceof E&&!b.has(r.type)||r instanceof l||r instanceof d&&r.isContentEditable,!(t&&n==="keyboard"&&e instanceof c&&!v[e.key])}0&&(module.exports={isKeyboardFocusEvent});
+"use strict";var c=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var b=(e,t)=>{for(var n in t)c(e,n,{get:t[n],enumerable:!0})},w=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of y(t))!P.call(e,o)&&o!==n&&c(e,o,{get:()=>t[o],enumerable:!(a=v(t,o))||a.enumerable});return e};var T=e=>w(c({},"__esModule",{value:!0}),e);var L={};b(L,{createEventHandler:()=>m,createSyntheticEvent:()=>x,filterDOMProps:()=>d,isKeyboardFocusEvent:()=>D,isVirtualClick:()=>g});module.exports=T(L);var M=new Set(["id"]);function d(e,t){let{allowLabelableProps:n=!1,allowLinkProps:a=!1,extraAllowedProps:o,allowedLabelableProps:l=new Set,allowedLinkProps:u=new Set}=t,s={};for(let r in e)Object.hasOwn(e,r)&&(M.has(r)||n&&l.has(r)||a&&u.has(r)||o?.has(r)||new RegExp(/^(data-.*)$/).test(r))&&(s[r]=e[r]);return s}var f=require("@necto/platform");function g(e){return e.mozInputSource===0&&e.isTrusted?!0:(0,f.isAndroid)()&&e.pointerType?e.type==="click"&&e.buttons===1:e.detail===0&&!e.pointerType}var E=require("std-env");function m(e){if(!e)return;let t=!0;return n=>{let a={...n,preventDefault(){n.preventDefault()},isDefaultPrevented(){return n.isDefaultPrevented()},stopPropagation(){t&&E.isProduction?console.error("stopPropagation is now the default behavior for events in Necto. You can use continuePropagation() to revert this behavior."):t=!0},continuePropagation(){t=!1},isPropagationStopped(){return t}};e(a),t&&n.stopPropagation()}}function x(e){let t=e;return Object.assign(t,{nativeEvent:e,isDefaultPrevented:()=>t.defaultPrevented,isPropagationStopped:()=>t.cancelBubble,persist:()=>{}}),t}var p=require("@necto/dom"),H=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),O={Tab:!0,Escape:!0};function D(e,t,n){if(!n||!("target"in n)||!n.target)return!1;let a=(0,p.getOwnerDocument)(n.target),o=(0,p.getOwnerWindow)(n.target),l=typeof window<"u"?o.HTMLInputElement:HTMLInputElement,u=typeof window<"u"?o.HTMLTextAreaElement:HTMLTextAreaElement,s=typeof window<"u"?o.HTMLElement:HTMLElement,r=typeof window<"u"?o.KeyboardEvent:KeyboardEvent,i=a.activeElement;return e=e||i instanceof l&&!H.has(i.type)||i instanceof u||i instanceof s&&i.isContentEditable,!(e&&t==="keyboard"&&n instanceof r&&!O[n.key])}0&&(module.exports={createEventHandler,createSyntheticEvent,filterDOMProps,isKeyboardFocusEvent,isVirtualClick});

package/dist/index.d.cts

@@ -1,5 +1,160 @@
+import { LinkDOMProps, BaseEvent } from '@necto-react/types';
+import { SyntheticEvent } from 'react';
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Options for filtering DOM props.
+ */
+interface FilterOptions {
+    /** Whether to allow labelable props (e.g., htmlFor, aria-label). */
+    allowLabelableProps?: boolean;
+    /** Whether to allow link-related props (e.g., href, target). */
+    allowLinkProps?: boolean;
+    /** Extra prop names to allow through the filter. */
+    extraAllowedProps?: Set<string>;
+    /** Custom set of allowed labelable prop names. */
+    allowedLabelableProps?: Set<string>;
+    /** Custom set of allowed link-related prop names. */
+    allowedLinkProps?: Set<string>;
+}
+/**
+ * Props allowed for DOM filtering, including link props and id.
+ */
+interface FilterDOMProps extends LinkDOMProps {
+    /** The id attribute for the element. */
+    id?: string;
+}
+/**
+ * Return type for filtered DOM props.
+ */
+interface FilterDOMReturn {
+    /** The id attribute for the element. */
+    id?: string;
+}
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
+
+/**
+ * Filters a props object to include only allowed DOM props based on the provided options.
+ *
+ * @param {FilterDOMProps} props - The props object to filter.
+ * @param {FilterOptions} options - Options to control which props are allowed.
+ * @returns {FilterDOMReturn} An object containing only the allowed DOM props.
+ */
+declare function filterDOMProps(props: FilterDOMProps, options: FilterOptions): FilterDOMReturn;
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
+declare function isVirtualClick(event: MouseEvent | PointerEvent): boolean;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Type for the event handler function returned by createEventHandler.
+ *
+ * @template T The type of the SyntheticEvent.
+ */
+type EventHandler<T extends SyntheticEvent> = (e: T) => void;
+/**
+ * Type for the handler function passed to createEventHandler.
+ *
+ * @template T The type of the SyntheticEvent.
+ */
+type BaseEventHandler<T extends SyntheticEvent> = (e: BaseEvent<T>) => void;
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
+
+/**
+ * Creates an event handler that wraps a BaseEventHandler, providing custom propagation control.
+ *
+ * @template T The type of the SyntheticEvent.
+ * @param {BaseEventHandler<T>} [handler] - The handler function to invoke with the extended event.
+ * @returns {EventHandler<T> | undefined} A standard event handler or undefined if no handler is provided.
+ */
+declare function createEventHandler<T extends SyntheticEvent>(handler?: BaseEventHandler<T>): EventHandler<T> | undefined;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Creates a synthetic React event from a native DOM event.
+ * This is used to maintain compatibility with React's event system.
+ *
+ * @param nativeEvent - The original native DOM event.
+ * @returns The synthetic React event.
+ */
+declare function createSyntheticEvent<T extends SyntheticEvent>(nativeEvent: Event): T;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * Portions of this code are based on the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
 type Modality = 'keyboard' | 'pointer' | 'virtual';
 type HandlerEvent = PointerEvent | MouseEvent | KeyboardEvent | FocusEvent | null;
 declare function isKeyboardFocusEvent(isTextInput: boolean, modality: Modality, e: HandlerEvent): boolean;
 
-export { type HandlerEvent, type Modality, isKeyboardFocusEvent };
+export { type FilterDOMProps, type FilterDOMReturn, type FilterOptions, type HandlerEvent, type Modality, createEventHandler, createSyntheticEvent, filterDOMProps, isKeyboardFocusEvent, isVirtualClick };

package/dist/index.d.ts

@@ -1,17 +1,146 @@
+import { LinkDOMProps, BaseEvent } from '@necto-react/types';
+import { SyntheticEvent } from 'react';
+
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * Portions of this code are based on the React Aria Spectrum library by Adobe,
+ */
+
+/**
+ * Options for filtering DOM props.
+ */
+interface FilterOptions {
+    /** Whether to allow labelable props (e.g., htmlFor, aria-label). */
+    allowLabelableProps?: boolean;
+    /** Whether to allow link-related props (e.g., href, target). */
+    allowLinkProps?: boolean;
+    /** Extra prop names to allow through the filter. */
+    extraAllowedProps?: Set<string>;
+    /** Custom set of allowed labelable prop names. */
+    allowedLabelableProps?: Set<string>;
+    /** Custom set of allowed link-related prop names. */
+    allowedLinkProps?: Set<string>;
+}
+/**
+ * Props allowed for DOM filtering, including link props and id.
+ */
+interface FilterDOMProps extends LinkDOMProps {
+    /** The id attribute for the element. */
+    id?: string;
+}
+/**
+ * Return type for filtered DOM props.
+ */
+interface FilterDOMReturn {
+    /** The id attribute for the element. */
+    id?: string;
+}
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
+
+/**
+ * Filters a props object to include only allowed DOM props based on the provided options.
+ *
+ * @param {FilterDOMProps} props - The props object to filter.
+ * @param {FilterOptions} options - Options to control which props are allowed.
+ * @returns {FilterDOMReturn} An object containing only the allowed DOM props.
+ */
+declare function filterDOMProps(props: FilterDOMProps, options: FilterOptions): FilterDOMReturn;
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
  * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
  * See: https://github.com/adobe/react-spectrum
  *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
  * Modifications have been made to adapt the code for use in this project.
  */
 declare function isVirtualClick(event: MouseEvent | PointerEvent): boolean;
 
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Type for the event handler function returned by createEventHandler.
+ *
+ * @template T The type of the SyntheticEvent.
+ */
+type EventHandler<T extends SyntheticEvent> = (e: T) => void;
+/**
+ * Type for the handler function passed to createEventHandler.
+ *
+ * @template T The type of the SyntheticEvent.
+ */
+type BaseEventHandler<T extends SyntheticEvent> = (e: BaseEvent<T>) => void;
+
+/**
+ * Portions of this file are based on code from the React Aria Spectrum library by Adobe,
+ * licensed under the Apache License, Version 2.0.
+ * Copyright (c) Adobe. All rights reserved.
+ * See: https://github.com/adobe/react-spectrum
+ *
+ * Modifications copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+ *
+ * This file contains code licensed under:
+ * - The MIT License (see LICENSE in the root directory) for Corinvo modifications.
+ * - The Apache License, Version 2.0 for portions from Adobe.
+ *
+ * Modifications have been made to adapt the code for use in this project.
+ */
+
+/**
+ * Creates an event handler that wraps a BaseEventHandler, providing custom propagation control.
+ *
+ * @template T The type of the SyntheticEvent.
+ * @param {BaseEventHandler<T>} [handler] - The handler function to invoke with the extended event.
+ * @returns {EventHandler<T> | undefined} A standard event handler or undefined if no handler is provided.
+ */
+declare function createEventHandler<T extends SyntheticEvent>(handler?: BaseEventHandler<T>): EventHandler<T> | undefined;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Creates a synthetic React event from a native DOM event.
+ * This is used to maintain compatibility with React's event system.
+ *
+ * @param nativeEvent - The original native DOM event.
+ * @returns The synthetic React event.
+ */
+declare function createSyntheticEvent<T extends SyntheticEvent>(nativeEvent: Event): T;
+
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
  *
@@ -28,4 +157,4 @@ type Modality = 'keyboard' | 'pointer' | 'virtual';
 type HandlerEvent = PointerEvent | MouseEvent | KeyboardEvent | FocusEvent | null;
 declare function isKeyboardFocusEvent(isTextInput: boolean, modality: Modality, e: HandlerEvent): boolean;
 
-export { type HandlerEvent, type Modality, isKeyboardFocusEvent, isVirtualClick };
+export { type FilterDOMProps, type FilterDOMReturn, type FilterOptions, type HandlerEvent, type Modality, createEventHandler, createSyntheticEvent, filterDOMProps, isKeyboardFocusEvent, isVirtualClick };

package/dist/index.global.js

@@ -1 +1 @@
-"use strict";(()=>{function w(t){return typeof window>"u"||window.navigator==null?!1:window.navigator.userAgentData?.brands.some(r=>t.test(r.brand))||t.test(window.navigator.userAgent)}var i=function(){return w(/Android/i)};function g(t){return t.mozInputSource===0&&t.isTrusted?!0:i()&&t.pointerType?t.type==="click"&&t.buttons===1:t.detail===0&&!t.pointerType}var a=t=>t?.ownerDocument??document,s=t=>t&&"window"in t&&t.window===t?t:a(t).defaultView||window;var E=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),p={Tab:!0,Escape:!0};function M(t,r,e){if(!e||!("target"in e)||!e.target)return!1;let u=a(e.target),o=s(e.target),d=typeof window<"u"?o.HTMLInputElement:HTMLInputElement,c=typeof window<"u"?o.HTMLTextAreaElement:HTMLTextAreaElement,l=typeof window<"u"?o.HTMLElement:HTMLElement,f=typeof window<"u"?o.KeyboardEvent:KeyboardEvent,n=u.activeElement;return t=t||n instanceof d&&!E.has(n.type)||n instanceof c||n instanceof l&&n.isContentEditable,!(t&&r==="keyboard"&&e instanceof f&&!p[e.key])}})();
+"use strict";(()=>{var Ee=new Set(["id"]);function ce(e,t){let{allowLabelableProps:n=!1,allowLinkProps:a=!1,extraAllowedProps:i,allowedLabelableProps:f=new Set,allowedLinkProps:T=new Set}=t,d={};for(let o in e)Object.hasOwn(e,o)&&(Ee.has(o)||n&&f.has(o)||a&&T.has(o)||i?.has(o)||new RegExp(/^(data-.*)$/).test(o))&&(d[o]=e[o]);return d}function de(e){return typeof window>"u"||window.navigator==null?!1:window.navigator.userAgentData?.brands.some(t=>e.test(t.brand))||e.test(window.navigator.userAgent)}var R=()=>de(/Android/i);function je(e){return e.mozInputSource===0&&e.isTrusted?!0:R()&&e.pointerType?e.type==="click"&&e.buttons===1:e.detail===0&&!e.pointerType}var Pe={},u=Object.create(null),E=e=>globalThis.process?.env||Pe.env||globalThis.Deno?.env.toObject()||globalThis.__env__||(e?u:globalThis),r=new Proxy(u,{get(e,t){return E()[t]??u[t]},has(e,t){let n=E();return t in n||t in u},set(e,t,n){let a=E(!0);return a[t]=n,!0},deleteProperty(e,t){if(!t)return!1;let n=E(!0);return delete n[t],!0},ownKeys(){let e=E(!0);return Object.keys(e)}}),L=typeof process<"u"&&process.env&&process.env.NODE_ENV||"",ue=[["APPVEYOR"],["AWS_AMPLIFY","AWS_APP_ID",{ci:!0}],["AZURE_PIPELINES","SYSTEM_TEAMFOUNDATIONCOLLECTIONURI"],["AZURE_STATIC","INPUT_AZURE_STATIC_WEB_APPS_API_TOKEN"],["APPCIRCLE","AC_APPCIRCLE"],["BAMBOO","bamboo_planKey"],["BITBUCKET","BITBUCKET_COMMIT"],["BITRISE","BITRISE_IO"],["BUDDY","BUDDY_WORKSPACE_ID"],["BUILDKITE"],["CIRCLE","CIRCLECI"],["CIRRUS","CIRRUS_CI"],["CLOUDFLARE_PAGES","CF_PAGES",{ci:!0}],["CLOUDFLARE_WORKERS","WORKERS_CI",{ci:!0}],["CODEBUILD","CODEBUILD_BUILD_ARN"],["CODEFRESH","CF_BUILD_ID"],["DRONE"],["DRONE","DRONE_BUILD_EVENT"],["DSARI"],["GITHUB_ACTIONS"],["GITLAB","GITLAB_CI"],["GITLAB","CI_MERGE_REQUEST_ID"],["GOCD","GO_PIPELINE_LABEL"],["LAYERCI"],["HUDSON","HUDSON_URL"],["JENKINS","JENKINS_URL"],["MAGNUM"],["NETLIFY"],["NETLIFY","NETLIFY_LOCAL",{ci:!1}],["NEVERCODE"],["RENDER"],["SAIL","SAILCI"],["SEMAPHORE"],["SCREWDRIVER"],["SHIPPABLE"],["SOLANO","TDDIUM"],["STRIDER"],["TEAMCITY","TEAMCITY_VERSION"],["TRAVIS"],["VERCEL","NOW_BUILDER"],["VERCEL","VERCEL",{ci:!1}],["VERCEL","VERCEL_ENV",{ci:!1}],["APPCENTER","APPCENTER_BUILD_ID"],["CODESANDBOX","CODESANDBOX_SSE",{ci:!1}],["CODESANDBOX","CODESANDBOX_HOST",{ci:!1}],["STACKBLITZ"],["STORMKIT"],["CLEAVR"],["ZEABUR"],["CODESPHERE","CODESPHERE_APP_ID",{ci:!0}],["RAILWAY","RAILWAY_PROJECT_ID"],["RAILWAY","RAILWAY_SERVICE_ID"],["DENO-DEPLOY","DENO_DEPLOYMENT_ID"],["FIREBASE_APP_HOSTING","FIREBASE_APP_HOSTING",{ci:!0}]];function pe(){if(globalThis.process?.env)for(let e of ue){let t=e[1]||e[0];if(globalThis.process?.env[t])return{name:e[0].toLowerCase(),...e[2]}}return globalThis.process?.env?.SHELL==="/bin/jsh"&&globalThis.process?.versions?.webcontainer?{name:"stackblitz",ci:!1}:{name:"",ci:!1}}var _=pe(),Ze=_.name;function s(e){return e?e!=="false":!1}var m=globalThis.process?.platform||"",O=s(r.CI)||_.ci!==!1,C=s(globalThis.process?.stdout&&globalThis.process?.stdout.isTTY);var Xe=s(r.DEBUG),fe=L==="test"||s(r.TEST),g=L==="production";var ze=s(r.MINIMAL)||O||fe||!C,Te=/^win/i.test(m),qe=/^linux/i.test(m),Je=/^darwin/i.test(m),$e=!s(r.NO_COLOR)&&(s(r.FORCE_COLOR)||(C||Te)&&r.TERM!=="dumb"||O),me=(globalThis.process?.versions?.node||"").replace(/^v/,"")||null,et=Number(me?.split(".")[0])||null,Ae=globalThis.process||Object.create(null),S={versions:{}},tt=new Proxy(Ae,{get(e,t){if(t==="env")return r;if(t in e)return e[t];if(t in S)return S[t]}}),ve=globalThis.process?.release?.name==="node",Ie=!!globalThis.Bun||!!globalThis.process?.versions?.bun,Re=!!globalThis.Deno,Se=!!globalThis.fastly,Le=!!globalThis.Netlify,_e=!!globalThis.EdgeRuntime,Oe=globalThis.navigator?.userAgent==="Cloudflare-Workers",Ce=[[Le,"netlify"],[_e,"edge-light"],[Oe,"workerd"],[Se,"fastly"],[Re,"deno"],[Ie,"bun"],[ve,"node"]];function ge(){let e=Ce.find(t=>t[0]);if(e)return{name:e[1]}}var be=ge(),nt=be?.name||"";function De(e){if(!e)return;let t=!0;return n=>{let a={...n,preventDefault(){n.preventDefault()},isDefaultPrevented(){return n.isDefaultPrevented()},stopPropagation(){t&&g?console.error("stopPropagation is now the default behavior for events in Necto. You can use continuePropagation() to revert this behavior."):t=!0},continuePropagation(){t=!1},isPropagationStopped(){return t}};e(a),t&&n.stopPropagation()}}function lt(e){let t=e;return Object.assign(t,{nativeEvent:e,isDefaultPrevented:()=>t.defaultPrevented,isPropagationStopped:()=>t.cancelBubble,persist:()=>{}}),t}var Ne=Object.defineProperty,p=(e,t)=>{for(var n in t)Ne(e,n,{get:t[n],enumerable:!0})},A={};p(A,{HTML_TAGS:()=>P,PRIMITIVE_TAGS:()=>b,default:()=>he});var b=["a","button","div","form","h2","h3","img","input","label","li","nav","ol","p","select","span","svg","ul"],P=["a","abbr","address","area","article","aside","audio","b","base","bdi","bdo","blockquote","body","br","button","canvas","caption","cite","code","col","colgroup","data","datalist","dd","del","details","dfn","dialog","div","dl","dt","em","embed","fieldset","figcaption","figure","footer","form","h1","h2","h3","h4","h5","h6","head","header","hgroup","hr","html","i","iframe","img","input","ins","kbd","label","legend","li","link","main","map","mark","math","menu","meta","meter","nav","noscript","object","ol","optgroup","option","output","p","picture","pre","progress","q","rp","rt","ruby","s","samp","script","search","section","select","slot","small","source","span","strong","style","sub","summary","sup","svg","table","tbody","td","template","textarea","tfoot","th","thead","time","title","tr","track","u","ul","var","video","wbr"],he={PRIMITIVE_TAGS:b,HTML_TAGS:P},we={};p(we,{NUMERIC_DIGITS:()=>D,default:()=>ye});var D=["1","2","3","4","5","6","7","8","9","0"],ye={NUMERIC_DIGITS:D},Me={};p(Me,{AMPERSAND:()=>G,ASTERISK:()=>K,BACKSLASH:()=>J,BOM:()=>N,CARRIAGE_RETURN:()=>y,COLON:()=>j,COMMA:()=>k,COMMERCIAL_AT:()=>z,DOT:()=>Y,DOUBLE_QUOTE:()=>B,EXCLAMATION:()=>U,GRAVE_ACCENT:()=>ee,GREATER_THAN:()=>Z,LEFT_CURLY_BRACKET:()=>te,LEFT_SQUARE_BRACKET:()=>q,LINE_FEED:()=>w,MINUS:()=>W,PERCENT:()=>x,PLUS:()=>V,QUESTION:()=>X,RIGHT_CURLY_BRACKET:()=>oe,RIGHT_SQUARE_BRACKET:()=>$,SHARP:()=>H,SINGLE_QUOTE:()=>F,SMALLER_THAN:()=>Q,SPACE:()=>M,TAB:()=>h,VERTICAL_LINE:()=>ne,default:()=>Ue});var N=65279,h=9,w=10,y=13,M=32,U=33,B=34,H=35,x=37,G=38,F=39,K=42,V=43,k=44,W=45,Y=46,j=58,Q=60,Z=62,X=63,z=64,q=91,J=92,$=93,ee=96,te=123,ne=124,oe=125,Ue={BOM:N,TAB:h,LINE_FEED:w,CARRIAGE_RETURN:y,SPACE:M,EXCLAMATION:U,DOUBLE_QUOTE:B,SHARP:H,PERCENT:x,AMPERSAND:G,SINGLE_QUOTE:F,ASTERISK:K,PLUS:V,COMMA:k,MINUS:W,DOT:Y,COLON:j,SMALLER_THAN:Q,GREATER_THAN:Z,QUESTION:X,COMMERCIAL_AT:z,LEFT_SQUARE_BRACKET:q,BACKSLASH:J,RIGHT_SQUARE_BRACKET:$,GRAVE_ACCENT:ee,LEFT_CURLY_BRACKET:te,VERTICAL_LINE:ne,RIGHT_CURLY_BRACKET:oe},Be={};p(Be,{CAPITALIZED:()=>re,LOWERCASE:()=>ae,VOWELS:()=>se,default:()=>He});var re=["A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"],ae=["a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z"],se=["A","E","I","O","U","a","e","i","o","u"],He={CAPITALIZED:re,LOWERCASE:ae,VOWELS:se};var v=e=>e?.ownerDocument??document,le=e=>e&&"window"in e&&e.window===e?e:v(e).defaultView||window;var c=new Map,ie=new Set;function xe(e){if(!("propertyName"in e)||!e.target)return;let t=c.get(e.target);t||(t=new Set,c.set(e.target,t),e.target.addEventListener("transitioncancel",I,{once:!0})),t.add(e.propertyName)}function I(e){if(!("propertyName"in e)||!e.target)return;let t=c.get(e.target);if(t&&(t.delete(e.propertyName),t.size===0&&(e.target.removeEventListener("transitioncancel",I),c.delete(e.target)),c.size===0)){for(let n of ie)n();ie.clear()}}if(typeof window<"u"&&typeof document<"u"){let e=()=>{let t=document.body;t&&(t.addEventListener("transitionrun",xe),t.addEventListener("transitionend",I))};document.readyState!=="loading"?e():document.addEventListener("DOMContentLoaded",e,{once:!0})}var pt=A.HTML_TAGS.reduce((e,t)=>{var n;return e[n=t,n.charAt(0).toUpperCase()+n.slice(1)]=t,e},{});var Ge=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),Fe={Tab:!0,Escape:!0};function At(e,t,n){if(!n||!("target"in n)||!n.target)return!1;let a=v(n.target),i=le(n.target),f=typeof window<"u"?i.HTMLInputElement:HTMLInputElement,T=typeof window<"u"?i.HTMLTextAreaElement:HTMLTextAreaElement,d=typeof window<"u"?i.HTMLElement:HTMLElement,o=typeof window<"u"?i.KeyboardEvent:KeyboardEvent,l=a.activeElement;return e=e||l instanceof f&&!Ge.has(l.type)||l instanceof T||l instanceof d&&l.isContentEditable,!(e&&t==="keyboard"&&n instanceof o&&!Fe[n.key])}})();

package/dist/index.js

@@ -1 +1 @@
-import{isAndroid as E}from"@necto/platform";function y(e){return e.mozInputSource===0&&e.isTrusted?!0:E()&&e.pointerType?e.type==="click"&&e.buttons===1:e.detail===0&&!e.pointerType}import{getOwnerDocument as d,getOwnerWindow as c}from"@necto/dom";var p=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),f={Tab:!0,Escape:!0};function M(e,r,t){if(!t||!("target"in t)||!t.target)return!1;let a=d(t.target),o=c(t.target),i=typeof window<"u"?o.HTMLInputElement:HTMLInputElement,s=typeof window<"u"?o.HTMLTextAreaElement:HTMLTextAreaElement,l=typeof window<"u"?o.HTMLElement:HTMLElement,u=typeof window<"u"?o.KeyboardEvent:KeyboardEvent,n=a.activeElement;return e=e||n instanceof i&&!p.has(n.type)||n instanceof s||n instanceof l&&n.isContentEditable,!(e&&r==="keyboard"&&t instanceof u&&!f[t.key])}export{M as isKeyboardFocusEvent,y as isVirtualClick};
+var u=new Set(["id"]);function c(e,t){let{allowLabelableProps:n=!1,allowLinkProps:a=!1,extraAllowedProps:r,allowedLabelableProps:p=new Set,allowedLinkProps:l=new Set}=t,s={};for(let o in e)Object.hasOwn(e,o)&&(u.has(o)||n&&p.has(o)||a&&l.has(o)||r?.has(o)||new RegExp(/^(data-.*)$/).test(o))&&(s[o]=e[o]);return s}import{isAndroid as d}from"@necto/platform";function g(e){return e.mozInputSource===0&&e.isTrusted?!0:d()&&e.pointerType?e.type==="click"&&e.buttons===1:e.detail===0&&!e.pointerType}import{isProduction as f}from"std-env";function E(e){if(!e)return;let t=!0;return n=>{let a={...n,preventDefault(){n.preventDefault()},isDefaultPrevented(){return n.isDefaultPrevented()},stopPropagation(){t&&f?console.error("stopPropagation is now the default behavior for events in Necto. You can use continuePropagation() to revert this behavior."):t=!0},continuePropagation(){t=!1},isPropagationStopped(){return t}};e(a),t&&n.stopPropagation()}}function S(e){let t=e;return Object.assign(t,{nativeEvent:e,isDefaultPrevented:()=>t.defaultPrevented,isPropagationStopped:()=>t.cancelBubble,persist:()=>{}}),t}import{getOwnerDocument as m,getOwnerWindow as v}from"@necto/dom";var y=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),P={Tab:!0,Escape:!0};function F(e,t,n){if(!n||!("target"in n)||!n.target)return!1;let a=m(n.target),r=v(n.target),p=typeof window<"u"?r.HTMLInputElement:HTMLInputElement,l=typeof window<"u"?r.HTMLTextAreaElement:HTMLTextAreaElement,s=typeof window<"u"?r.HTMLElement:HTMLElement,o=typeof window<"u"?r.KeyboardEvent:KeyboardEvent,i=a.activeElement;return e=e||i instanceof p&&!y.has(i.type)||i instanceof l||i instanceof s&&i.isContentEditable,!(e&&t==="keyboard"&&n instanceof o&&!P[n.key])}export{E as createEventHandler,S as createSyntheticEvent,c as filterDOMProps,F as isKeyboardFocusEvent,g as isVirtualClick};

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@necto-react/helpers",
-  "version": "2.1.0",
+  "version": "2.4.1",
   "description": "Necto's library for providing global helpers React applications",
   "type": "module",
   "files": [
     "dist",
     "README.md"
   ],
-  "types": "dist/index.d.ts",
+  "types": "./dist/index.d.ts",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "author": "Corinvo OSS Team",
   "license": "MIT",
   "devDependencies": {
+    "@types/node": "^22.14.1",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "tsup": "^8.4.0"
   },
   "peerDependencies": {
@@ -20,10 +25,13 @@
     "react-dom": "^19.1.0"
   },
   "dependencies": {
-    "@necto/platform": "1.1.0",
-    "@necto/dom": "1.1.0"
+    "std-env": "^3.9.0",
+    "@necto-react/types": "2.3.0",
+    "@necto/dom": "1.4.1",
+    "@necto/platform": "1.4.0"
   },
   "scripts": {
-    "build": "tsup --minify"
+    "test": "vitest",
+    "build": "tsup ./src/index.ts --minify --format esm,cjs,iife --dts"
   }
 }