@necto-react/helpers 2.1.0 → 2.4.0

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 D=new Set(["id"]);function P(e,t){let{allowLabelableProps:n=!1,allowLinkProps:i=!1,extraAllowedProps:a,allowedLabelableProps:E=new Set,allowedLinkProps:f=new Set}=t,u={};for(let o in e)Object.hasOwn(e,o)&&(D.has(o)||n&&E.has(o)||i&&f.has(o)||a?.has(o)||new RegExp(/^(data-.*)$/).test(o))&&(u[o]=e[o]);return u}function C(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 b=()=>C(/Android/i);function ie(e){return e.mozInputSource===0&&e.isTrusted?!0:b()&&e.pointerType?e.type==="click"&&e.buttons===1:e.detail===0&&!e.pointerType}var Z={},p=Object.create(null),c=e=>globalThis.process?.env||Z.env||globalThis.Deno?.env.toObject()||globalThis.__env__||(e?p:globalThis),r=new Proxy(p,{get(e,t){return c()[t]??p[t]},has(e,t){let n=c();return t in n||t in p},set(e,t,n){let i=c(!0);return i[t]=n,!0},deleteProperty(e,t){if(!t)return!1;let n=c(!0);return delete n[t],!0},ownKeys(){let e=c(!0);return Object.keys(e)}}),I=typeof process<"u"&&process.env&&process.env.NODE_ENV||"",_=[["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 N(){if(globalThis.process?.env)for(let e of _){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 S=N(),ae=S.name;function s(e){return e?e!=="false":!1}var m=globalThis.process?.platform||"",w=s(r.CI)||S.ci!==!1,L=s(globalThis.process?.stdout&&globalThis.process?.stdout.isTTY);var le=s(r.DEBUG),M=I==="test"||s(r.TEST),h=I==="production";var ce=s(r.MINIMAL)||w||M||!L,B=/^win/i.test(m),de=/^linux/i.test(m),ue=/^darwin/i.test(m),pe=!s(r.NO_COLOR)&&(s(r.FORCE_COLOR)||(L||B)&&r.TERM!=="dumb"||w),U=(globalThis.process?.versions?.node||"").replace(/^v/,"")||null,Ee=Number(U?.split(".")[0])||null,H=globalThis.process||Object.create(null),v={versions:{}},fe=new Proxy(H,{get(e,t){if(t==="env")return r;if(t in e)return e[t];if(t in v)return v[t]}}),x=globalThis.process?.release?.name==="node",k=!!globalThis.Bun||!!globalThis.process?.versions?.bun,F=!!globalThis.Deno,W=!!globalThis.fastly,V=!!globalThis.Netlify,Y=!!globalThis.EdgeRuntime,K=globalThis.navigator?.userAgent==="Cloudflare-Workers",G=[[V,"netlify"],[Y,"edge-light"],[K,"workerd"],[W,"fastly"],[F,"deno"],[k,"bun"],[x,"node"]];function j(){let e=G.find(t=>t[0]);if(e)return{name:e[1]}}var z=j(),me=z?.name||"";function X(e){if(!e)return;let t=!0;return n=>{let i={...n,preventDefault(){n.preventDefault()},isDefaultPrevented(){return n.isDefaultPrevented()},stopPropagation(){t&&h?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(i),t&&n.stopPropagation()}}function Se(e){let t=e;return Object.assign(t,{nativeEvent:e,isDefaultPrevented:()=>t.defaultPrevented,isPropagationStopped:()=>t.cancelBubble,persist:()=>{}}),t}var O=["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","menuitem","meta","meter","nav","noscript","object","ol","optgroup","option","output","p","param","picture","pre","progress","q","rb","rp","rt","rtc","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"];var y=O;var T=e=>e?.ownerDocument??document,A=e=>e&&"window"in e&&e.window===e?e:T(e).defaultView||window;var d=new Map,R=new Set;function J(e){if(!("propertyName"in e)||!e.target)return;let t=d.get(e.target);t||(t=new Set,d.set(e.target,t),e.target.addEventListener("transitioncancel",g,{once:!0})),t.add(e.propertyName)}function g(e){if(!("propertyName"in e)||!e.target)return;let t=d.get(e.target);if(t&&(t.delete(e.propertyName),t.size===0&&(e.target.removeEventListener("transitioncancel",g),d.delete(e.target)),d.size===0)){for(let n of R)n();R.clear()}}if(typeof window<"u"&&typeof document<"u"){let e=()=>{let t=document.body;t&&(t.addEventListener("transitionrun",J),t.addEventListener("transitionend",g))};document.readyState!=="loading"?e():document.addEventListener("DOMContentLoaded",e,{once:!0})}var Ae=y.reduce((e,t)=>{var n;return e[n=t,n.charAt(0).toUpperCase()+n.slice(1)]=t,e},{});var Q=new Set(["checkbox","radio","range","color","file","image","button","submit","reset"]),$={Tab:!0,Escape:!0};function _e(e,t,n){if(!n||!("target"in n)||!n.target)return!1;let i=T(n.target),a=A(n.target),E=typeof window<"u"?a.HTMLInputElement:HTMLInputElement,f=typeof window<"u"?a.HTMLTextAreaElement:HTMLTextAreaElement,u=typeof window<"u"?a.HTMLElement:HTMLElement,o=typeof window<"u"?a.KeyboardEvent:KeyboardEvent,l=i.activeElement;return e=e||l instanceof E&&!Q.has(l.type)||l instanceof f||l instanceof u&&l.isContentEditable,!(e&&t==="keyboard"&&n instanceof o&&!$[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.0",
   "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.0",
+    "@necto/platform": "1.4.0"
   },
   "scripts": {
-    "build": "tsup --minify"
+    "test": "vitest",
+    "build": "tsup ./src/index.ts --minify --format esm,cjs,iife --dts"
   }
 }