@necto-react/types 2.0.0 → 2.3.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/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties } from 'react';
+import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties, HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ReactNode, SyntheticEvent, FocusEvent, ForwardedRef } from 'react';
 
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
@@ -8,21 +8,135 @@ import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperti
  *
  */
 
-interface FocusableElement extends Element, HTMLOrSVGElement {
+
+
+/**
+ * Props for DOM elements that may require an id.
+ */
+interface DOMProps {
+  /** The unique id for the DOM element. */
+  id?: string | undefined;
 }
-interface DOMAttributes<T = FocusableElement> extends AriaAttributes, DOMAttributes$1<T> {
-    onMouseLeave: (event: any) => void;
-    onMouseEnter: (event: any) => void;
-    onTouchStart: () => void;
-    onPointerLeave: (event: any) => void;
-    onPointerEnter: (event: any) => void;
-    id?: string | undefined;
-    role?: AriaRole | undefined;
-    tabIndex?: number | undefined;
-    style?: CSSProperties | undefined;
-    className?: string | undefined;
+
+/**
+ * Props for focusable DOM elements, extending basic DOM props.
+ */
+interface FocusableDOMProps extends DOMProps {
+  /**
+   * Whether the element should be excluded from the tab order.
+   */
+  excludeFromTabOrder?: boolean;
 }
 
+/**
+ * Standard DOM attributes for focusable elements, including ARIA and React DOM attributes.
+ *
+ * @template T The element type, defaults to FocusableElement.
+ */
+interface DOMAttributes<T = FocusableElement>
+  extends AriaAttributes,
+    DOMAttributes$1<T> {
+  /** The unique id for the DOM element. */
+  id?: string | undefined;
+
+  /** The ARIA role for the element. */
+  role?: AriaRole | undefined;
+
+  /** The tab index of the element. */
+  tabIndex?: number | undefined;
+
+  /** Inline CSS styles for the element. */
+  style?: CSSProperties | undefined;
+
+  /** The CSS class name for the element. */
+  className?: string | undefined;
+}
+
+/**
+ * Props for anchor/link elements.
+ */
+interface LinkDOMProps {
+  /** The URL to link to. */
+  href?: string | undefined;
+
+  /** The language of the linked resource. */
+  hrefLang?: string;
+
+  /** The browsing context for the link. */
+  target?: HTMLAttributeAnchorTarget;
+
+  /** The relationship of the linked resource. */
+  rel?: string;
+
+  /** Prompts the user to save the linked URL instead of navigating to it. */
+  download?: boolean | string;
+
+  /** Space-separated list of URLs to notify when the user follows the hyperlink. */
+  ping?: string;
+
+  /** Referrer policy for the link. */
+  referrerPolicy?: HTMLAttributeReferrerPolicy;
+
+  /** Additional router options (type depends on router implementation). */
+  routerOptions?: unknown;
+}
+
+/**
+ * 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.
+ *
+ */
+
+
+
+interface StyleRenderProps<T> {
+  /** The CSS [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className) for the element. A function may be provided to compute the class based on component state. */
+  className?:
+    | string
+    | ((values: T & { defaultClassName: string | undefined }) => string);
+
+  /** The inline [style](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/style) for the element. A function may be provided to compute the style based on component state. */
+  style?:
+    | CSSProperties
+    | ((
+        values: T & { defaultStyle: CSSProperties }
+      ) => CSSProperties | undefined);
+}
+
+interface RenderProps<T> extends StyleRenderProps<T> {
+  /** The children of the component. A function may be provided to alter the children based on component state. */
+  children?:
+    | ReactNode
+    | ((values: T | { defaultChildren: ReactNode | undefined }) => ReactNode);
+}
+
+/**
+ * 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.
+ *
+ */
+
+/**
+ * Flags indicating disabled states for different interaction types.
+ */
+type DisabledFlags = {
+  /** Whether the element is generally disabled. */
+  general?: boolean;
+
+  /** Whether the element is disabled for form interactions. */
+  form?: boolean;
+
+  /** Whether the element is disabled for user interactions (e.g., pointer, keyboard). */
+  interactions?: boolean;
+
+  /** Custom disabled flags for additional types of interactions. */
+  [key: string]: boolean | undefined;
+};
+
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
  *
@@ -30,10 +144,82 @@ interface DOMAttributes<T = FocusableElement> extends AriaAttributes, DOMAttribu
  * LICENSE file in the root directory of this source tree.
  *
  */
+
+
+
+/**
+ * Extended SyntheticEvent with custom propagation control methods.
+ *
+ * @template T The type of the original SyntheticEvent.
+ */
+type BaseEvent<T extends SyntheticEvent> = T & {
+  /**
+   * Use continuePropagation instead.
+   * @deprecated
+   */
+  stopPropagation(): void;
+
+  /**
+   * Continues propagation for the event.
+   */
+  continuePropagation(): void;
+};
+
+/**
+ * Event handlers for hover interactions.
+ */
 interface HoverEvent {
-    onHoverStart?: (event: HoverEvent) => void;
-    onHoverEnd?: (event: HoverEvent) => void;
-    onHoverChange?: (isHovering: boolean) => void;
+  /** Called when a hover interaction starts. */
+  onHoverStart?: (event: HoverEvent) => void;
+
+  /** Called when a hover interaction ends. */
+  onHoverEnd?: (event: HoverEvent) => void;
+
+  /** Called when the hover state changes. */
+  onHoverChange?: (isHovering: boolean) => void;
 }
 
-export type { DOMAttributes, FocusableElement, HoverEvent };
+/**
+ * Event handlers for focus interactions.
+ */
+interface FocusEvents<Target = Element> {
+  /** Called when the element receives focus. */
+  onFocus?: (e: FocusEvent<Target>) => void;
+
+  /** Called when the element loses focus. */
+  onBlur?: (e: FocusEvent<Target>) => void;
+
+  /** Called when the focus state changes. */
+  onFocusChange?: (isFocused: boolean) => void;
+}
+
+/**
+ * Event handlers for keyboard interactions.
+ */
+interface KeyboardEvents {
+  /** Called when a key is pressed down. */
+  onKeyDown?: (e: KeyboardEvent) => void;
+
+  /** Called when a key is released. */
+  onKeyUp?: (e: KeyboardEvent) => void;
+}
+
+/**
+ * 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 SlottedContextValue<T, E = never> =
+  | (T & {
+      slots?: Record<string | symbol, T>;
+      ref?: E extends never ? never : ForwardedRef<E>;
+    })
+  | null
+  | undefined;
+
+export type { BaseEvent, DOMAttributes, DOMProps, DisabledFlags, FocusEvents, FocusableDOMProps, HoverEvent, KeyboardEvents, LinkDOMProps, RenderProps, SlottedContextValue, StyleRenderProps };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties } from 'react';
+import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperties, HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy, ReactNode, SyntheticEvent, FocusEvent, ForwardedRef } from 'react';
 
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
@@ -8,21 +8,135 @@ import { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaRole, CSSProperti
  *
  */
 
-interface FocusableElement extends Element, HTMLOrSVGElement {
+
+
+/**
+ * Props for DOM elements that may require an id.
+ */
+interface DOMProps {
+  /** The unique id for the DOM element. */
+  id?: string | undefined;
 }
-interface DOMAttributes<T = FocusableElement> extends AriaAttributes, DOMAttributes$1<T> {
-    onMouseLeave: (event: any) => void;
-    onMouseEnter: (event: any) => void;
-    onTouchStart: () => void;
-    onPointerLeave: (event: any) => void;
-    onPointerEnter: (event: any) => void;
-    id?: string | undefined;
-    role?: AriaRole | undefined;
-    tabIndex?: number | undefined;
-    style?: CSSProperties | undefined;
-    className?: string | undefined;
+
+/**
+ * Props for focusable DOM elements, extending basic DOM props.
+ */
+interface FocusableDOMProps extends DOMProps {
+  /**
+   * Whether the element should be excluded from the tab order.
+   */
+  excludeFromTabOrder?: boolean;
 }
 
+/**
+ * Standard DOM attributes for focusable elements, including ARIA and React DOM attributes.
+ *
+ * @template T The element type, defaults to FocusableElement.
+ */
+interface DOMAttributes<T = FocusableElement>
+  extends AriaAttributes,
+    DOMAttributes$1<T> {
+  /** The unique id for the DOM element. */
+  id?: string | undefined;
+
+  /** The ARIA role for the element. */
+  role?: AriaRole | undefined;
+
+  /** The tab index of the element. */
+  tabIndex?: number | undefined;
+
+  /** Inline CSS styles for the element. */
+  style?: CSSProperties | undefined;
+
+  /** The CSS class name for the element. */
+  className?: string | undefined;
+}
+
+/**
+ * Props for anchor/link elements.
+ */
+interface LinkDOMProps {
+  /** The URL to link to. */
+  href?: string | undefined;
+
+  /** The language of the linked resource. */
+  hrefLang?: string;
+
+  /** The browsing context for the link. */
+  target?: HTMLAttributeAnchorTarget;
+
+  /** The relationship of the linked resource. */
+  rel?: string;
+
+  /** Prompts the user to save the linked URL instead of navigating to it. */
+  download?: boolean | string;
+
+  /** Space-separated list of URLs to notify when the user follows the hyperlink. */
+  ping?: string;
+
+  /** Referrer policy for the link. */
+  referrerPolicy?: HTMLAttributeReferrerPolicy;
+
+  /** Additional router options (type depends on router implementation). */
+  routerOptions?: unknown;
+}
+
+/**
+ * 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.
+ *
+ */
+
+
+
+interface StyleRenderProps<T> {
+  /** The CSS [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className) for the element. A function may be provided to compute the class based on component state. */
+  className?:
+    | string
+    | ((values: T & { defaultClassName: string | undefined }) => string);
+
+  /** The inline [style](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/style) for the element. A function may be provided to compute the style based on component state. */
+  style?:
+    | CSSProperties
+    | ((
+        values: T & { defaultStyle: CSSProperties }
+      ) => CSSProperties | undefined);
+}
+
+interface RenderProps<T> extends StyleRenderProps<T> {
+  /** The children of the component. A function may be provided to alter the children based on component state. */
+  children?:
+    | ReactNode
+    | ((values: T | { defaultChildren: ReactNode | undefined }) => ReactNode);
+}
+
+/**
+ * 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.
+ *
+ */
+
+/**
+ * Flags indicating disabled states for different interaction types.
+ */
+type DisabledFlags = {
+  /** Whether the element is generally disabled. */
+  general?: boolean;
+
+  /** Whether the element is disabled for form interactions. */
+  form?: boolean;
+
+  /** Whether the element is disabled for user interactions (e.g., pointer, keyboard). */
+  interactions?: boolean;
+
+  /** Custom disabled flags for additional types of interactions. */
+  [key: string]: boolean | undefined;
+};
+
 /**
  * Copyright (c) Corinvo, LLC. and affiliates.
  *
@@ -30,10 +144,82 @@ interface DOMAttributes<T = FocusableElement> extends AriaAttributes, DOMAttribu
  * LICENSE file in the root directory of this source tree.
  *
  */
+
+
+
+/**
+ * Extended SyntheticEvent with custom propagation control methods.
+ *
+ * @template T The type of the original SyntheticEvent.
+ */
+type BaseEvent<T extends SyntheticEvent> = T & {
+  /**
+   * Use continuePropagation instead.
+   * @deprecated
+   */
+  stopPropagation(): void;
+
+  /**
+   * Continues propagation for the event.
+   */
+  continuePropagation(): void;
+};
+
+/**
+ * Event handlers for hover interactions.
+ */
 interface HoverEvent {
-    onHoverStart?: (event: HoverEvent) => void;
-    onHoverEnd?: (event: HoverEvent) => void;
-    onHoverChange?: (isHovering: boolean) => void;
+  /** Called when a hover interaction starts. */
+  onHoverStart?: (event: HoverEvent) => void;
+
+  /** Called when a hover interaction ends. */
+  onHoverEnd?: (event: HoverEvent) => void;
+
+  /** Called when the hover state changes. */
+  onHoverChange?: (isHovering: boolean) => void;
 }
 
-export type { DOMAttributes, FocusableElement, HoverEvent };
+/**
+ * Event handlers for focus interactions.
+ */
+interface FocusEvents<Target = Element> {
+  /** Called when the element receives focus. */
+  onFocus?: (e: FocusEvent<Target>) => void;
+
+  /** Called when the element loses focus. */
+  onBlur?: (e: FocusEvent<Target>) => void;
+
+  /** Called when the focus state changes. */
+  onFocusChange?: (isFocused: boolean) => void;
+}
+
+/**
+ * Event handlers for keyboard interactions.
+ */
+interface KeyboardEvents {
+  /** Called when a key is pressed down. */
+  onKeyDown?: (e: KeyboardEvent) => void;
+
+  /** Called when a key is released. */
+  onKeyUp?: (e: KeyboardEvent) => void;
+}
+
+/**
+ * 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 SlottedContextValue<T, E = never> =
+  | (T & {
+      slots?: Record<string | symbol, T>;
+      ref?: E extends never ? never : ForwardedRef<E>;
+    })
+  | null
+  | undefined;
+
+export type { BaseEvent, DOMAttributes, DOMProps, DisabledFlags, FocusEvents, FocusableDOMProps, HoverEvent, KeyboardEvents, LinkDOMProps, RenderProps, SlottedContextValue, StyleRenderProps };

package/dist/index.js

@@ -1 +1 @@
-"use strict";var m=Object.defineProperty;var t=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var b=(r,o,p,f)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of x(o))!a.call(r,e)&&e!==p&&m(r,e,{get:()=>o[e],enumerable:!(f=t(o,e))||f.enumerable});return r};var c=r=>b(m({},"__esModule",{value:!0}),r);var d={};module.exports=c(d);
+"use strict";var r=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var s=(e,o,m,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let p of x(o))!y.call(e,p)&&p!==m&&r(e,p,{get:()=>o[p],enumerable:!(t=f(o,p))||t.enumerable});return e};var n=e=>s(r({},"__esModule",{value:!0}),e);var a={};module.exports=n(a);

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@necto-react/types",
-  "version": "2.0.0",
+  "version": "2.3.0",
   "description": "",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
   "author": "Corinvo OSS Team",
   "license": "MIT",
   "devDependencies": {

package/.turbo/turbo-build.log

@@ -1,20 +0,0 @@
-
-
-> @necto-react/types@1.0.0 build /Users/botiszabo/Developer/necto/node-kit/packages/necto-react-types
-> tsup --minify
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.4.0
-CLI Using tsup config: /Users/botiszabo/Developer/necto/node-kit/packages/necto-react-types/tsup.config.ts
-CLI Target: esnext
-CJS Build start
-ESM Build start
-ESM dist/index.mjs 0 B
-ESM ⚡️ Build success in 21ms
-CJS dist/index.js 397.00 B
-CJS ⚡️ Build success in 25ms
-DTS Build start
-DTS ⚡️ Build success in 827ms
-DTS dist/index.d.ts  1.20 KB
-DTS dist/index.d.mts 1.20 KB

package/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @necto-react/types
-
-## 2.0.0
-
-### Major Changes
-
-- fixed packages

package/jsr.json

@@ -1,18 +0,0 @@
-{
-  "name": "@necto-react/types",
-  "version": "1.0.0",
-  "description": "Necto's library for providing typing interfaces and definitions for React applications.",
-  "exports": {
-    ".": {
-      "types": "dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "license": "MIT",
-  "author": "Corinvo OSS Team"
-}

package/src/dom.ts

@@ -1,30 +0,0 @@
-/**
- * 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.
- *
- */
-
-import {
-  AriaRole,
-  CSSProperties,
-  AriaAttributes,
-  DOMAttributes as ReactDOMAttributes,
-} from "react";
-
-export interface FocusableElement extends Element, HTMLOrSVGElement {};
-
-export interface DOMAttributes<T = FocusableElement> extends AriaAttributes, ReactDOMAttributes<T> {
-  onMouseLeave: (event: any) => void;
-  onMouseEnter: (event: any) => void;
-  onTouchStart: () => void;
-  onPointerLeave: (event: any) => void;
-  onPointerEnter: (event: any) => void;
-
-  id?: string | undefined,
-  role?: AriaRole | undefined,
-  tabIndex?: number | undefined,
-  style?: CSSProperties | undefined,
-  className?: string | undefined
-};

package/src/events.ts

@@ -1,13 +0,0 @@
-/**
- * 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.
- *
- */
-
-export interface HoverEvent {
-  onHoverStart?: (event: HoverEvent) => void,
-  onHoverEnd?: (event: HoverEvent) => void,
-  onHoverChange?: (isHovering: boolean) => void
-}

package/src/index.ts

@@ -1,10 +0,0 @@
-/**
- * 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.
- *
- */
-
-export * from './dom';
-export * from './events';

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "jsx": "react-jsx",
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "isolatedModules": true,
-    "noEmit": false,
-    "skipLibCheck": true
-  },
-  "include": [
-    "src"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/tsup.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig([
-  {
-    entry: ['src/index.ts'],
-    format: ['cjs', 'esm'],
-    dts: true,
-    sourcemap: false,
-  },
-]);