@pyreon/attrs 0.14.0 → 0.16.0

package/lib/index.d.ts

@@ -42,8 +42,32 @@ type Spread<A extends readonly [...any]> = A extends [infer L, ...infer R] ? Spr
 /** Recursively checks whether any element in the tuple is `any`. */
 type _HasAny<A> = A extends [infer L, ...infer R] ? (0 extends 1 & L ? true : _HasAny<R>) : false;
 type MergeTypes<A extends readonly [...any]> = _HasAny<A> extends true ? any : ExtractNullableKeys<Spread<A>>;
-/** Extracts the props type from a Pyreon component function. */
-type ExtractProps<TComponentOrTProps> = TComponentOrTProps extends ComponentFn<infer TProps> ? TProps : TComponentOrTProps;
+/**
+ * Extracts the props type from a Pyreon component function — or passes
+ * through the input unchanged when it's already a props type.
+ *
+ * Multi-overload aware: matches up to 4 call signatures and produces the
+ * UNION of their first-argument types. Iterator / List / Element are
+ * 3-overload primitives — without overload-aware extraction, wrapping
+ * them through `attrs()` silently downgraded their public prop surface
+ * to the LAST (loosest) overload. Mirrors vitus-labs PR #222.
+ *
+ * See `@pyreon/rocketstyle` `ExtractProps` for the canonical shape — kept
+ * in sync across the 4 copies in core / elements / attrs / rocketstyle.
+ */
+type ExtractProps<TComponentOrTProps> = TComponentOrTProps extends {
+  (props: infer P1, ...args: any): any;
+  (props: infer P2, ...args: any): any;
+  (props: infer P3, ...args: any): any;
+  (props: infer P4, ...args: any): any;
+} ? P1 | P2 | P3 | P4 : TComponentOrTProps extends {
+  (props: infer P1, ...args: any): any;
+  (props: infer P2, ...args: any): any;
+  (props: infer P3, ...args: any): any;
+} ? P1 | P2 | P3 : TComponentOrTProps extends {
+  (props: infer P1, ...args: any): any;
+  (props: infer P2, ...args: any): any;
+} ? P1 | P2 : TComponentOrTProps extends ComponentFn<infer TProps> ? TProps : TComponentOrTProps;
 //#endregion
 //#region src/types/config.d.ts
 /** A component that has been enhanced by attrs — identified by the `IS_ATTRS` marker. */

package/lib/index.js

@@ -29,14 +29,18 @@ const calculateChainOptions = (options) => (args) => {
 const createAttrsHOC = ({ attrs, priorityAttrs }) => {
 	const calculateAttrs = calculateChainOptions(attrs);
 	const calculatePriorityAttrs = calculateChainOptions(priorityAttrs);
+	const hasAttrs = (attrs?.length ?? 0) > 0;
+	const hasPriorityAttrs = (priorityAttrs?.length ?? 0) > 0;
+	const hasAnyChain = hasAttrs || hasPriorityAttrs;
 	const attrsHoc = (WrappedComponent) => {
 		const HOCComponent = (props) => {
 			const filteredProps = removeUndefinedProps(props);
-			const prioritizedAttrs = calculatePriorityAttrs([filteredProps]);
-			const finalAttrs = calculateAttrs([{
+			if (!hasAnyChain) return WrappedComponent(filteredProps);
+			const prioritizedAttrs = hasPriorityAttrs ? calculatePriorityAttrs([filteredProps]) : null;
+			const finalAttrs = hasAttrs ? calculateAttrs([prioritizedAttrs ? {
 				...prioritizedAttrs,
 				...filteredProps
-			}]);
+			} : filteredProps]) : null;
 			return WrappedComponent({
 				...prioritizedAttrs,
 				...finalAttrs,
@@ -69,6 +73,7 @@ const createStaticsEnhancers = ({ context, options }) => {
 
 //#endregion
 //#region src/attrs.ts
+const __DEV__$1 = process.env.NODE_ENV !== "production";
 const cloneAndEnhance = (defaultOpts, opts) => attrsComponent({
 	...defaultOpts,
 	...opts.name ? { name: opts.name } : void 0,
@@ -105,7 +110,7 @@ const attrsComponent = (options) => {
 	const hocsFuncs = [createAttrsHOC(options), ...calculateHocsFuncs(options.compose)];
 	const EnhancedComponent = (props) => {
 		const filteredProps = options.filterAttrs && options.filterAttrs.length > 0 ? omit(props, options.filterAttrs) : props;
-		return RenderComponent(process.env.NODE_ENV !== "production" ? {
+		return RenderComponent(__DEV__$1 ? {
 			...filteredProps,
 			"data-attrs": componentName
 		} : filteredProps);
@@ -142,8 +147,9 @@ const attrsComponent = (options) => {
 
 //#endregion
 //#region src/init.ts
+const __DEV__ = process.env.NODE_ENV !== "production";
 const attrs = ({ name, component }) => {
-	if (process.env.NODE_ENV !== "production") {
+	if (__DEV__) {
 		const errors = {};
 		if (!component) errors.component = "Parameter `component` is missing in params!";
 		if (!name) errors.name = "Parameter `name` is missing in params!";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/attrs",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Attrs HOC chaining for Pyreon components",
   "license": "MIT",
   "repository": {
@@ -10,6 +10,7 @@
   },
   "files": [
     "lib",
+    "!lib/**/*.map",
     "!lib/analysis",
     "README.md",
     "LICENSE",
@@ -40,14 +41,14 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@pyreon/typescript": "^0.14.0",
-    "@vitus-labs/tools-rolldown": "^1.15.3"
-  },
-  "peerDependencies": {
-    "@pyreon/core": "^0.14.0",
-    "@pyreon/ui-core": "^0.14.0"
+    "@pyreon/typescript": "^0.16.0",
+    "@vitus-labs/tools-rolldown": "^2.3.0"
   },
   "engines": {
     "node": ">= 22"
+  },
+  "dependencies": {
+    "@pyreon/core": "^0.16.0",
+    "@pyreon/ui-core": "^0.16.0"
   }
 }

package/src/attrs.ts

@@ -8,6 +8,12 @@ import { chainOptions } from './utils/chaining'
 import { calculateHocsFuncs } from './utils/compose'
 import { createStaticsEnhancers } from './utils/statics'
 
+// Dev-mode gate. `import.meta.env.DEV` is literal-replaced by Vite at build
+// time and tree-shakes to zero bytes in prod. The previous
+// `process.env.NODE_ENV !== 'production'` form was dead code in real Vite
+// browser bundles (Vite does not polyfill `process`).
+const __DEV__ = process.env.NODE_ENV !== 'production'
+
 /**
  * Clones the current configuration and merges new options, then creates a
  * fresh component. This makes the chaining API immutable — each `.attrs()`
@@ -61,10 +67,9 @@ const attrsComponent: InitAttrsComponent = (options) => {
 
     const filteredProps = needsFiltering ? omit(props, options.filterAttrs) : props
 
-    const finalProps =
-      process.env.NODE_ENV !== 'production'
-        ? { ...filteredProps, 'data-attrs': componentName }
-        : filteredProps
+    const finalProps = __DEV__
+      ? { ...filteredProps, 'data-attrs': componentName }
+      : filteredProps
 
     return RenderComponent(finalProps)
   }

package/src/env.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Minimal process type — just enough for `process.env.NODE_ENV` checks.
+ * Avoids requiring @types/node in consumers that import pyreon source
+ * via the `"bun"` export condition.
+ */
+declare var process: { env: { NODE_ENV?: string } }

package/src/hoc/attrsHoc.ts

@@ -25,21 +25,35 @@ const createAttrsHOC: AttrsStyleHOC = ({ attrs, priorityAttrs }) => {
   // Pre-build the chain reducers once (not per render).
   const calculateAttrs = calculateChainOptions(attrs)
   const calculatePriorityAttrs = calculateChainOptions(priorityAttrs)
+  // Most components never call .attrs() — short-circuit the merge work below
+  // so the no-chain mount path skips 2 reducer invocations + 3 object spreads.
+  // Mirrors vitus-labs's attrsHoc fast-path; React-side memoization
+  // (useMemo / useStableValue) is omitted because Pyreon components run once
+  // per mount, not on every render.
+  const hasAttrs = (attrs?.length ?? 0) > 0
+  const hasPriorityAttrs = (priorityAttrs?.length ?? 0) > 0
+  const hasAnyChain = hasAttrs || hasPriorityAttrs
 
   const attrsHoc = (WrappedComponent: ComponentFn<any>) => {
     const HOCComponent: ComponentFn<any> = (props) => {
       // Strip undefined values so they don't shadow defaults from attrs callbacks.
       const filteredProps = removeUndefinedProps(props)
 
+      // Fast path: no attrs configured — skip reducers + spreads entirely.
+      if (!hasAnyChain) return WrappedComponent(filteredProps)
+
       // 1. Resolve priority attrs (lowest precedence defaults).
-      const prioritizedAttrs = calculatePriorityAttrs([filteredProps])
+      const prioritizedAttrs = hasPriorityAttrs
+        ? calculatePriorityAttrs([filteredProps])
+        : null
       // 2. Resolve normal attrs — these see priority + explicit props as input.
-      const finalAttrs = calculateAttrs([
-        {
-          ...prioritizedAttrs,
-          ...filteredProps,
-        },
-      ])
+      const finalAttrs = hasAttrs
+        ? calculateAttrs([
+            prioritizedAttrs
+              ? { ...prioritizedAttrs, ...filteredProps }
+              : filteredProps,
+          ])
+        : null
 
       // 3. Merge: priority < normal attrs < explicit props (last wins).
       const finalProps = {

package/src/init.ts

@@ -3,6 +3,12 @@ import attrsComponent from './attrs'
 import type { InitAttrsComponent } from './types/InitAttrsComponent'
 import type { ElementType } from './types/utils'
 
+// Dev-mode gate. `import.meta.env.DEV` is literal-replaced by Vite at build
+// time and tree-shakes to zero bytes in prod. The previous
+// `process.env.NODE_ENV !== 'production'` form was dead code in real Vite
+// browser bundles (Vite does not polyfill `process`).
+const __DEV__ = process.env.NODE_ENV !== 'production'
+
 /**
  * Public entry point for creating an attrs-enhanced component.
  *
@@ -24,7 +30,7 @@ export type Attrs = <C extends ElementType>({
 
 const attrs: Attrs = ({ name, component }) => {
   // Validate required params in development — fail fast with clear errors.
-  if (process.env.NODE_ENV !== 'production') {
+  if (__DEV__) {
     type Errors = Partial<{
       component: string
       name: string

package/src/types/utils.ts

@@ -101,6 +101,37 @@ export type MergeTypes<A extends readonly [...any]> =
 
 // ─── ExtractProps ─────────────────────────────────────────────
 
-/** Extracts the props type from a Pyreon component function. */
-export type ExtractProps<TComponentOrTProps> =
-  TComponentOrTProps extends ComponentFn<infer TProps> ? TProps : TComponentOrTProps
+/**
+ * Extracts the props type from a Pyreon component function — or passes
+ * through the input unchanged when it's already a props type.
+ *
+ * Multi-overload aware: matches up to 4 call signatures and produces the
+ * UNION of their first-argument types. Iterator / List / Element are
+ * 3-overload primitives — without overload-aware extraction, wrapping
+ * them through `attrs()` silently downgraded their public prop surface
+ * to the LAST (loosest) overload. Mirrors vitus-labs PR #222.
+ *
+ * See `@pyreon/rocketstyle` `ExtractProps` for the canonical shape — kept
+ * in sync across the 4 copies in core / elements / attrs / rocketstyle.
+ */
+export type ExtractProps<TComponentOrTProps> = TComponentOrTProps extends {
+  (props: infer P1, ...args: any): any
+  (props: infer P2, ...args: any): any
+  (props: infer P3, ...args: any): any
+  (props: infer P4, ...args: any): any
+}
+  ? P1 | P2 | P3 | P4
+  : TComponentOrTProps extends {
+        (props: infer P1, ...args: any): any
+        (props: infer P2, ...args: any): any
+        (props: infer P3, ...args: any): any
+      }
+    ? P1 | P2 | P3
+    : TComponentOrTProps extends {
+          (props: infer P1, ...args: any): any
+          (props: infer P2, ...args: any): any
+        }
+      ? P1 | P2
+      : TComponentOrTProps extends ComponentFn<infer TProps>
+        ? TProps
+        : TComponentOrTProps

package/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/types/attrs.ts","../../src/types/utils.ts","../../src/types/config.ts","../../src/types/hoc.ts","../../src/types/AttrsComponent.ts","../../src/types/configuration.ts","../../src/types/InitAttrsComponent.ts","../../src/init.ts","../../src/isAttrsComponent.ts"],"mappings":"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"}

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["attrsHoc"],"sources":["../src/utils/attrs.ts","../src/hoc/attrsHoc.ts","../src/utils/chaining.ts","../src/utils/compose.ts","../src/utils/statics.ts","../src/attrs.ts","../src/init.ts","../src/isAttrsComponent.ts","../src/index.ts"],"sourcesContent":["import { isEmpty } from '@pyreon/ui-core'\n\n/**\n * Strips keys with `undefined` values from a props object.\n * This prevents undefined consumer props from overriding defaults\n * computed by `.attrs()` callbacks. Only explicitly set values\n * (including `null`) should override defaults.\n */\ntype RemoveUndefinedProps = <T extends Record<string, any>>(\n  props: T,\n) => { [I in keyof T as T[I] extends undefined ? never : I]: T[I] }\n\nexport const removeUndefinedProps = (<T extends Record<string, any>>(props: T) =>\n  Object.keys(props).reduce<Record<string, unknown>>((acc, key) => {\n    const currentValue = props[key]\n    if (currentValue !== undefined) acc[key] = currentValue\n    return acc\n  }, {})) as RemoveUndefinedProps\n\n/**\n * Reduces an array of option functions (from chained `.attrs()` calls)\n * into a single merged result. Each function is called with `args`\n * (typically the current props) and its return value is merged\n * left-to-right via Object.assign — so later `.attrs()` calls\n * override earlier ones.\n *\n * Returns a curried function: first call binds the chain, second\n * call provides the arguments and executes the reduction.\n */\ntype OptionFunc<A> = (...arg: A[]) => Record<string, unknown>\ntype CalculateChainOptions = <A>(\n  options?: OptionFunc<A>[],\n) => (args: A[]) => ReturnType<OptionFunc<A>>\n\nexport const calculateChainOptions: CalculateChainOptions = (options) => (args) => {\n  const result = {}\n  if (!options || isEmpty(options)) return result\n\n  return options.reduce((acc, item) => Object.assign(acc, item(...args)), {})\n}\n","import type { Configuration } from '../types/configuration'\nimport type { ComponentFn } from '../types/utils'\nimport { calculateChainOptions, removeUndefinedProps } from '../utils/attrs'\n\nexport type AttrsStyleHOC = ({\n  attrs,\n  priorityAttrs,\n}: Pick<Configuration, 'attrs' | 'priorityAttrs'>) => (\n  WrappedComponent: ComponentFn<any>,\n) => ComponentFn<any>\n\n/**\n * Creates the core HOC that computes default props from the `.attrs()` chain.\n *\n * This is always the outermost HOC in the compose chain, so it runs first.\n * It resolves both priority and normal attrs callbacks, then merges them\n * with the consumer's explicit props following this precedence:\n *\n *   priorityAttrs < normalAttrs < explicit props  (last wins)\n *\n * In Pyreon, components are plain functions — no forwardRef needed.\n * The ref flows as a normal prop through the chain.\n */\nconst createAttrsHOC: AttrsStyleHOC = ({ attrs, priorityAttrs }) => {\n  // Pre-build the chain reducers once (not per render).\n  const calculateAttrs = calculateChainOptions(attrs)\n  const calculatePriorityAttrs = calculateChainOptions(priorityAttrs)\n\n  const attrsHoc = (WrappedComponent: ComponentFn<any>) => {\n    const HOCComponent: ComponentFn<any> = (props) => {\n      // Strip undefined values so they don't shadow defaults from attrs callbacks.\n      const filteredProps = removeUndefinedProps(props)\n\n      // 1. Resolve priority attrs (lowest precedence defaults).\n      const prioritizedAttrs = calculatePriorityAttrs([filteredProps])\n      // 2. Resolve normal attrs — these see priority + explicit props as input.\n      const finalAttrs = calculateAttrs([\n        {\n          ...prioritizedAttrs,\n          ...filteredProps,\n        },\n      ])\n\n      // 3. Merge: priority < normal attrs < explicit props (last wins).\n      const finalProps = {\n        ...prioritizedAttrs,\n        ...finalAttrs,\n        ...filteredProps,\n      }\n\n      return WrappedComponent(finalProps)\n    }\n\n    return HOCComponent\n  }\n\n  return attrsHoc\n}\n\nexport default createAttrsHOC\n","type Func = (...args: any) => Record<string, unknown>\ntype Obj = Record<string, unknown>\n\n/**\n * Appends a new attrs option to the existing chain of option functions.\n *\n * The `.attrs()` API accepts either an object or a callback. This function\n * normalizes both forms into a function (objects are wrapped in `() => obj`)\n * and appends to the existing array. The array is cloned so each chained\n * component gets its own copy — maintaining immutability across the chain.\n */\ntype ChainOptions = (opts: Obj | Func | undefined, defaultOpts: Func[]) => Func[]\n\nexport const chainOptions: ChainOptions = (opts, defaultOpts = []) => {\n  const result = [...defaultOpts]\n\n  if (typeof opts === 'function') result.push(opts)\n  else if (typeof opts === 'object') result.push(() => opts)\n\n  return result\n}\n","/**\n * Extracts HOC functions from the `.compose()` configuration and reverses\n * them for correct application order. Setting a key to `null`, `undefined`,\n * or `false` removes a previously defined HOC — only actual functions are kept.\n *\n * The reversal is needed because `compose(a, b, c)(Component)` applies as\n * `a(b(c(Component)))`, so the last-defined HOC should wrap innermost.\n */\ntype CalculateHocsFuncs = (options: Record<string, any>) => ((arg: any) => any)[]\n\nexport const calculateHocsFuncs: CalculateHocsFuncs = (options = {}) =>\n  Object.values(options)\n    .filter((item) => typeof item === 'function')\n    .reverse()\n","import { isEmpty } from '@pyreon/ui-core'\n\n/**\n * Copies user-defined statics from `.statics()` into the component's\n * `meta` object. These are accessible at `Component.meta.myStatic`.\n */\ntype CreateStaticsEnhancers = (params: {\n  context: Record<string, any>\n  options: Record<string, any>\n}) => void\n\nexport const createStaticsEnhancers: CreateStaticsEnhancers = ({ context, options }) => {\n  if (!isEmpty(options)) {\n    Object.assign(context, options)\n  }\n}\n","import { compose, hoistNonReactStatics, omit, pick } from '@pyreon/ui-core'\nimport { attrsHoc } from './hoc'\nimport type { AttrsComponent as AttrsComponentType } from './types/AttrsComponent'\nimport type { Configuration, ExtendedConfiguration } from './types/configuration'\nimport type { InitAttrsComponent } from './types/InitAttrsComponent'\nimport { calculateChainOptions } from './utils/attrs'\nimport { chainOptions } from './utils/chaining'\nimport { calculateHocsFuncs } from './utils/compose'\nimport { createStaticsEnhancers } from './utils/statics'\n\n/**\n * Clones the current configuration and merges new options, then creates a\n * fresh component. This makes the chaining API immutable — each `.attrs()`\n * / `.config()` / `.statics()` call returns a brand-new component with an\n * updated configuration rather than mutating the existing one.\n */\ntype CloneAndEnhance = (\n  defaultOpts: Configuration,\n  opts: Partial<ExtendedConfiguration>,\n) => ReturnType<typeof attrsComponent>\n\nconst cloneAndEnhance: CloneAndEnhance = (defaultOpts, opts) =>\n  attrsComponent({\n    ...defaultOpts,\n    ...(opts.name ? { name: opts.name } : undefined),\n    ...(opts.component ? { component: opts.component } : undefined),\n    attrs: chainOptions(opts.attrs, defaultOpts.attrs),\n    filterAttrs: [...(defaultOpts.filterAttrs ?? []), ...(opts.filterAttrs ?? [])],\n    priorityAttrs: chainOptions(opts.priorityAttrs, defaultOpts.priorityAttrs),\n    statics: { ...defaultOpts.statics, ...opts.statics },\n    compose: { ...defaultOpts.compose, ...opts.compose },\n  } as Parameters<typeof attrsComponent>[0])\n\n/**\n * Core factory that builds an attrs-enhanced Pyreon component.\n *\n * Creates a plain ComponentFn that:\n * 1. Wraps the original with attrsHoc (default props) + user HOCs from `.compose()`.\n * 2. Filters out internal props listed in `filterAttrs`.\n * 3. Attaches `data-attrs` attribute in development for debugging.\n *\n * Then adds chaining methods (`.attrs()`, `.config()`, `.compose()`, `.statics()`)\n * as static properties — each calls `cloneAndEnhance` to produce a new component.\n *\n * In Pyreon, there is no forwardRef — ref flows as a normal prop.\n * Components are plain functions that run once per mount.\n */\nconst attrsComponent: InitAttrsComponent = (options) => {\n  const componentName = options.name ?? options.component.displayName ?? options.component.name\n\n  const RenderComponent = options.component\n\n  // Build the HOC chain: attrsHoc is always first (resolves default props),\n  // followed by user-composed HOCs in reverse order (outermost wraps first).\n  const hocsFuncs = [attrsHoc(options), ...calculateHocsFuncs(options.compose)]\n\n  // The inner component receives already-computed props from the HOC chain.\n  // It handles prop filtering and final rendering.\n  const EnhancedComponent = (props: Record<string, any>) => {\n    const needsFiltering = options.filterAttrs && options.filterAttrs.length > 0\n\n    const filteredProps = needsFiltering ? omit(props, options.filterAttrs) : props\n\n    const finalProps =\n      process.env.NODE_ENV !== 'production'\n        ? { ...filteredProps, 'data-attrs': componentName }\n        : filteredProps\n\n    return RenderComponent(finalProps)\n  }\n\n  // Apply the full HOC chain: compose(attrsHoc, ...userHocs)(EnhancedComponent)\n  const AttrsComponent: AttrsComponentType = compose(...hocsFuncs)(EnhancedComponent)\n\n  AttrsComponent.IS_ATTRS = true\n  AttrsComponent.displayName = componentName\n  AttrsComponent.meta = {}\n\n  // Copy static properties from the original component.\n  hoistNonReactStatics(AttrsComponent, options.component)\n\n  // Populate `component.meta` with user-defined statics from `.statics()`.\n  createStaticsEnhancers({\n    context: AttrsComponent.meta,\n    options: options.statics,\n  })\n\n  // ─── Chaining Methods ──────────────────────────────────\n  // Each method creates a new component via cloneAndEnhance.\n  // The original component is never mutated.\n  Object.assign(AttrsComponent, {\n    attrs: (attrs: any, { priority, filter }: any = {}) => {\n      const result: Record<string, any> = {}\n\n      if (filter) {\n        result.filterAttrs = filter\n      }\n\n      if (priority) {\n        result.priorityAttrs = attrs as ExtendedConfiguration['priorityAttrs']\n\n        return cloneAndEnhance(options, result)\n      }\n\n      result.attrs = attrs as ExtendedConfiguration['attrs']\n\n      return cloneAndEnhance(options, result)\n    },\n\n    config: (opts: any = {}) => {\n      const result = pick(opts)\n\n      return cloneAndEnhance(options, result)\n    },\n\n    compose: (opts: any) => cloneAndEnhance(options, { compose: opts }),\n\n    statics: (opts: any) => cloneAndEnhance(options, { statics: opts }),\n\n    getDefaultAttrs: (props: any) => calculateChainOptions(options.attrs)([props]),\n  })\n\n  return AttrsComponent\n}\n\nexport default attrsComponent\n","import { isEmpty } from '@pyreon/ui-core'\nimport attrsComponent from './attrs'\nimport type { InitAttrsComponent } from './types/InitAttrsComponent'\nimport type { ElementType } from './types/utils'\n\n/**\n * Public entry point for creating an attrs-enhanced component.\n *\n * ```tsx\n * const Button = attrs({ name: 'Button', component: Element })\n *   .attrs({ tag: 'button' })\n *   .attrs<{ primary?: boolean }>(({ primary }) => ({\n *     backgroundColor: primary ? 'blue' : 'gray',\n *   }))\n * ```\n */\nexport type Attrs = <C extends ElementType>({\n  name,\n  component,\n}: {\n  name: string\n  component: C\n}) => ReturnType<InitAttrsComponent<C>>\n\nconst attrs: Attrs = ({ name, component }) => {\n  // Validate required params in development — fail fast with clear errors.\n  if (process.env.NODE_ENV !== 'production') {\n    type Errors = Partial<{\n      component: string\n      name: string\n    }>\n\n    const errors: Errors = {}\n    if (!component) {\n      errors.component = 'Parameter `component` is missing in params!'\n    }\n\n    if (!name) {\n      errors.name = 'Parameter `name` is missing in params!'\n    }\n\n    if (!isEmpty(errors)) {\n      throw Error(JSON.stringify(errors))\n    }\n  }\n\n  // Bootstrap with empty configuration — all chains start from scratch.\n  return attrsComponent({\n    name,\n    component,\n    attrs: [],\n    priorityAttrs: [],\n    filterAttrs: [],\n    compose: {},\n    statics: {},\n  })\n}\n\nexport default attrs\n","export type IsAttrsComponent = <T>(component: T) => boolean\n\n/** Runtime type guard — checks if a component was created by `attrs()`. */\nconst isAttrsComponent: IsAttrsComponent = (component) => {\n  if (\n    component &&\n    (typeof component === 'object' || typeof component === 'function') &&\n    Object.hasOwn(component as object, 'IS_ATTRS')\n  ) {\n    return true\n  }\n\n  return false\n}\n\nexport default isAttrsComponent\n","import type { Attrs } from './init'\nimport attrs from './init'\nimport type { IsAttrsComponent } from './isAttrsComponent'\nimport isAttrsComponent from './isAttrsComponent'\nimport type { AttrsComponent } from './types/AttrsComponent'\nimport type { AttrsCb } from './types/attrs'\nimport type { AttrsComponentType, ConfigAttrs } from './types/config'\nimport type { ComposeParam, GenericHoc } from './types/hoc'\nimport type { ComponentFn, ElementType, TObj } from './types/utils'\n\nexport type {\n  Attrs,\n  AttrsCb,\n  AttrsComponent,\n  AttrsComponentType,\n  ComponentFn,\n  ComposeParam,\n  ConfigAttrs,\n  ElementType,\n  GenericHoc,\n  IsAttrsComponent,\n  TObj,\n}\n\nexport { attrs, isAttrsComponent }\nexport default attrs\n"],"mappings":"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"}