@zag-js/types 0.36.3 → 0.37.0

package/dist/index.d.mts

@@ -1158,6 +1158,9 @@ type NormalizeProps<T extends PropTypes> = {
 };
 declare function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T>;
 
+type StrictKeys<K extends (keyof T)[], T> = K extends (keyof T)[] ? [keyof T] extends [K[number]] ? unknown : `Missing required keys: ${Exclude<keyof T, K[number]>}` : never;
+declare const createProps: <T extends Record<never, never>>() => <K extends (keyof T)[]>(props: K & StrictKeys<K, T>) => (keyof T)[];
+
 type RequiredBy<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>;
 type Direction = "ltr" | "rtl";
 type Orientation = "horizontal" | "vertical";
@@ -1193,22 +1196,6 @@ interface CommonProperties {
      */
     getRootNode?: () => ShadowRoot | Document | Node;
 }
-interface RootProperties {
-    /**
-     * The owner document of the machine.
-     */
-    doc?: Document;
-    /**
-     * The root node of the machine. Useful for shadow DOM.
-     */
-    rootNode?: ShadowRoot;
-    /**
-     * The related target when the element is blurred.
-     * Used as a polyfill for `e.relatedTarget`
-     */
-    pointerdownNode?: HTMLElement | null;
-}
-type Context<T> = T & RootProperties;
 type Style = JSX.CSSProperties;
 
-export { type CommonProperties, type Context, type Direction, type DirectionProperty, JSX, type LocaleProperties, type MaybeElement, type NormalizeProps, type Orientation, type OrientationProperty, type PropTypes, type RequiredBy, type RootProperties, type Style, createNormalizer };
+export { type CommonProperties, type Direction, type DirectionProperty, JSX, type LocaleProperties, type MaybeElement, type NormalizeProps, type Orientation, type OrientationProperty, type PropTypes, type RequiredBy, type Style, createNormalizer, createProps };

package/dist/index.d.ts

@@ -1158,6 +1158,9 @@ type NormalizeProps<T extends PropTypes> = {
 };
 declare function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T>;
 
+type StrictKeys<K extends (keyof T)[], T> = K extends (keyof T)[] ? [keyof T] extends [K[number]] ? unknown : `Missing required keys: ${Exclude<keyof T, K[number]>}` : never;
+declare const createProps: <T extends Record<never, never>>() => <K extends (keyof T)[]>(props: K & StrictKeys<K, T>) => (keyof T)[];
+
 type RequiredBy<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>;
 type Direction = "ltr" | "rtl";
 type Orientation = "horizontal" | "vertical";
@@ -1193,22 +1196,6 @@ interface CommonProperties {
      */
     getRootNode?: () => ShadowRoot | Document | Node;
 }
-interface RootProperties {
-    /**
-     * The owner document of the machine.
-     */
-    doc?: Document;
-    /**
-     * The root node of the machine. Useful for shadow DOM.
-     */
-    rootNode?: ShadowRoot;
-    /**
-     * The related target when the element is blurred.
-     * Used as a polyfill for `e.relatedTarget`
-     */
-    pointerdownNode?: HTMLElement | null;
-}
-type Context<T> = T & RootProperties;
 type Style = JSX.CSSProperties;
 
-export { type CommonProperties, type Context, type Direction, type DirectionProperty, JSX, type LocaleProperties, type MaybeElement, type NormalizeProps, type Orientation, type OrientationProperty, type PropTypes, type RequiredBy, type RootProperties, type Style, createNormalizer };
+export { type CommonProperties, type Direction, type DirectionProperty, JSX, type LocaleProperties, type MaybeElement, type NormalizeProps, type Orientation, type OrientationProperty, type PropTypes, type RequiredBy, type Style, createNormalizer, createProps };

package/dist/index.js

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  createNormalizer: () => createNormalizer
+  createNormalizer: () => createNormalizer,
+  createProps: () => createProps
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -32,8 +33,12 @@ function createNormalizer(fn) {
     }
   });
 }
+
+// src/create-props.ts
+var createProps = () => (props) => Array.from(new Set(props));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createNormalizer
+  createNormalizer,
+  createProps
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/prop-types.ts"],"sourcesContent":["import type { JSX } from \"./jsx\"\n\nexport type RequiredBy<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>\n\nexport type Direction = \"ltr\" | \"rtl\"\n\nexport type Orientation = \"horizontal\" | \"vertical\"\n\nexport type MaybeElement<T extends HTMLElement = HTMLElement> = T | null\n\nexport interface OrientationProperty {\n  /**\n   * The orientation of the element.\n   * @default \"horizontal\"\n   */\n  orientation?: Orientation\n}\n\nexport interface DirectionProperty {\n  /**\n   * The document's text/writing direction.\n   * @default \"ltr\"\n   */\n  dir?: \"ltr\" | \"rtl\"\n}\n\nexport interface LocaleProperties extends DirectionProperty {\n  /**\n   * The current locale. Based on the BCP 47 definition.\n   * @default \"en-US\"\n   */\n  locale?: string\n}\n\nexport interface CommonProperties {\n  /**\n   * The unique identifier of the machine.\n   */\n  id: string\n  /**\n   * A root node to correctly resolve document in custom environments. E.x.: Iframes, Electron.\n   */\n  getRootNode?: () => ShadowRoot | Document | Node\n}\n\nexport interface RootProperties {\n  /**\n   * The owner document of the machine.\n   */\n  doc?: Document\n  /**\n   * The root node of the machine. Useful for shadow DOM.\n   */\n  rootNode?: ShadowRoot\n  /**\n   * The related target when the element is blurred.\n   * Used as a polyfill for `e.relatedTarget`\n   */\n  pointerdownNode?: HTMLElement | null\n}\n\nexport type Context<T> = T & RootProperties\n\nexport type Style = JSX.CSSProperties\n\nexport * from \"./prop-types\"\nexport type { JSX }\n","import type { JSX } from \"./jsx\"\n\ntype Dict<T = any> = Record<string, T>\n\ntype Booleanish = boolean | \"true\" | \"false\"\n\ntype DataAttr = {\n  \"data-selected\"?: Booleanish\n  \"data-expanded\"?: Booleanish\n  \"data-highlighted\"?: Booleanish\n  \"data-readonly\"?: Booleanish\n  \"data-indeterminate\"?: Booleanish\n  \"data-invalid\"?: Booleanish\n  \"data-hover\"?: Booleanish\n  \"data-active\"?: Booleanish\n  \"data-focus\"?: Booleanish\n  \"data-disabled\"?: Booleanish\n  \"data-open\"?: Booleanish\n  \"data-checked\"?: Booleanish\n  \"data-pressed\"?: Booleanish\n  \"data-complete\"?: Booleanish\n  \"data-empty\"?: Booleanish\n  \"data-placeholder-shown\"?: Booleanish\n  \"data-half\"?: Booleanish\n  \"data-scope\"?: string\n\n  \"data-uid\"?: string\n  \"data-name\"?: string\n  \"data-ownedby\"?: string\n  \"data-type\"?: string\n  \"data-valuetext\"?: string\n  \"data-placement\"?: string\n  \"data-controls\"?: string\n  \"data-part\"?: string\n  \"data-label\"?: string\n  \"data-state\"?: string | null\n  \"data-value\"?: string | number\n\n  \"data-orientation\"?: \"horizontal\" | \"vertical\"\n\n  \"data-count\"?: number\n  \"data-index\"?: number\n} & {\n  [key in `data-${string}`]?: string | number | Booleanish\n}\n\nexport type PropTypes<T = Dict> = Record<\n  \"button\" | \"label\" | \"input\" | \"textarea\" | \"img\" | \"output\" | \"element\" | \"select\" | \"style\" | \"circle\" | \"svg\",\n  T\n>\n\nexport type NormalizeProps<T extends PropTypes> = {\n  [K in keyof T]: (props: K extends keyof JSX.IntrinsicElements ? DataAttr & JSX.IntrinsicElements[K] : never) => T[K]\n} & {\n  element(props: DataAttr & JSX.HTMLAttributes<HTMLElement> & Record<string, any>): T[\"element\"]\n  style: JSX.CSSProperties\n}\nexport function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T> {\n  return new Proxy({} as any, {\n    get() {\n      return fn\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACyDO,SAAS,iBAAsC,IAA8C;AAClG,SAAO,IAAI,MAAM,CAAC,GAAU;AAAA,IAC1B,MAAM;AACJ,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/prop-types.ts","../src/create-props.ts"],"sourcesContent":["import type { JSX } from \"./jsx\"\n\nexport type RequiredBy<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>\n\nexport type Direction = \"ltr\" | \"rtl\"\n\nexport type Orientation = \"horizontal\" | \"vertical\"\n\nexport type MaybeElement<T extends HTMLElement = HTMLElement> = T | null\n\nexport interface OrientationProperty {\n  /**\n   * The orientation of the element.\n   * @default \"horizontal\"\n   */\n  orientation?: Orientation\n}\n\nexport interface DirectionProperty {\n  /**\n   * The document's text/writing direction.\n   * @default \"ltr\"\n   */\n  dir?: \"ltr\" | \"rtl\"\n}\n\nexport interface LocaleProperties extends DirectionProperty {\n  /**\n   * The current locale. Based on the BCP 47 definition.\n   * @default \"en-US\"\n   */\n  locale?: string\n}\n\nexport interface CommonProperties {\n  /**\n   * The unique identifier of the machine.\n   */\n  id: string\n  /**\n   * A root node to correctly resolve document in custom environments. E.x.: Iframes, Electron.\n   */\n  getRootNode?: () => ShadowRoot | Document | Node\n}\n\nexport type Style = JSX.CSSProperties\n\nexport * from \"./prop-types\"\nexport type { JSX }\nexport * from \"./create-props\"\n","import type { JSX } from \"./jsx\"\n\ntype Dict<T = any> = Record<string, T>\n\ntype Booleanish = boolean | \"true\" | \"false\"\n\ntype DataAttr = {\n  \"data-selected\"?: Booleanish\n  \"data-expanded\"?: Booleanish\n  \"data-highlighted\"?: Booleanish\n  \"data-readonly\"?: Booleanish\n  \"data-indeterminate\"?: Booleanish\n  \"data-invalid\"?: Booleanish\n  \"data-hover\"?: Booleanish\n  \"data-active\"?: Booleanish\n  \"data-focus\"?: Booleanish\n  \"data-disabled\"?: Booleanish\n  \"data-open\"?: Booleanish\n  \"data-checked\"?: Booleanish\n  \"data-pressed\"?: Booleanish\n  \"data-complete\"?: Booleanish\n  \"data-empty\"?: Booleanish\n  \"data-placeholder-shown\"?: Booleanish\n  \"data-half\"?: Booleanish\n  \"data-scope\"?: string\n\n  \"data-uid\"?: string\n  \"data-name\"?: string\n  \"data-ownedby\"?: string\n  \"data-type\"?: string\n  \"data-valuetext\"?: string\n  \"data-placement\"?: string\n  \"data-controls\"?: string\n  \"data-part\"?: string\n  \"data-label\"?: string\n  \"data-state\"?: string | null\n  \"data-value\"?: string | number\n\n  \"data-orientation\"?: \"horizontal\" | \"vertical\"\n\n  \"data-count\"?: number\n  \"data-index\"?: number\n} & {\n  [key in `data-${string}`]?: string | number | Booleanish\n}\n\nexport type PropTypes<T = Dict> = Record<\n  \"button\" | \"label\" | \"input\" | \"textarea\" | \"img\" | \"output\" | \"element\" | \"select\" | \"style\" | \"circle\" | \"svg\",\n  T\n>\n\nexport type NormalizeProps<T extends PropTypes> = {\n  [K in keyof T]: (props: K extends keyof JSX.IntrinsicElements ? DataAttr & JSX.IntrinsicElements[K] : never) => T[K]\n} & {\n  element(props: DataAttr & JSX.HTMLAttributes<HTMLElement> & Record<string, any>): T[\"element\"]\n  style: JSX.CSSProperties\n}\n\nexport function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T> {\n  return new Proxy({} as any, {\n    get() {\n      return fn\n    },\n  })\n}\n","type StrictKeys<K extends (keyof T)[], T> = K extends (keyof T)[]\n  ? [keyof T] extends [K[number]]\n    ? unknown\n    : `Missing required keys: ${Exclude<keyof T, K[number]>}`\n  : never\n\nexport const createProps =\n  <T extends Record<never, never>>() =>\n  <K extends (keyof T)[]>(props: K & StrictKeys<K, T>) =>\n    Array.from(new Set(props))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC0DO,SAAS,iBAAsC,IAA8C;AAClG,SAAO,IAAI,MAAM,CAAC,GAAU;AAAA,IAC1B,MAAM;AACJ,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;;;AC1DO,IAAM,cACX,MACA,CAAwB,UACtB,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC;","names":[]}

package/dist/index.mjs

@@ -6,7 +6,11 @@ function createNormalizer(fn) {
     }
   });
 }
+
+// src/create-props.ts
+var createProps = () => (props) => Array.from(new Set(props));
 export {
-  createNormalizer
+  createNormalizer,
+  createProps
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/prop-types.ts"],"sourcesContent":["import type { JSX } from \"./jsx\"\n\ntype Dict<T = any> = Record<string, T>\n\ntype Booleanish = boolean | \"true\" | \"false\"\n\ntype DataAttr = {\n  \"data-selected\"?: Booleanish\n  \"data-expanded\"?: Booleanish\n  \"data-highlighted\"?: Booleanish\n  \"data-readonly\"?: Booleanish\n  \"data-indeterminate\"?: Booleanish\n  \"data-invalid\"?: Booleanish\n  \"data-hover\"?: Booleanish\n  \"data-active\"?: Booleanish\n  \"data-focus\"?: Booleanish\n  \"data-disabled\"?: Booleanish\n  \"data-open\"?: Booleanish\n  \"data-checked\"?: Booleanish\n  \"data-pressed\"?: Booleanish\n  \"data-complete\"?: Booleanish\n  \"data-empty\"?: Booleanish\n  \"data-placeholder-shown\"?: Booleanish\n  \"data-half\"?: Booleanish\n  \"data-scope\"?: string\n\n  \"data-uid\"?: string\n  \"data-name\"?: string\n  \"data-ownedby\"?: string\n  \"data-type\"?: string\n  \"data-valuetext\"?: string\n  \"data-placement\"?: string\n  \"data-controls\"?: string\n  \"data-part\"?: string\n  \"data-label\"?: string\n  \"data-state\"?: string | null\n  \"data-value\"?: string | number\n\n  \"data-orientation\"?: \"horizontal\" | \"vertical\"\n\n  \"data-count\"?: number\n  \"data-index\"?: number\n} & {\n  [key in `data-${string}`]?: string | number | Booleanish\n}\n\nexport type PropTypes<T = Dict> = Record<\n  \"button\" | \"label\" | \"input\" | \"textarea\" | \"img\" | \"output\" | \"element\" | \"select\" | \"style\" | \"circle\" | \"svg\",\n  T\n>\n\nexport type NormalizeProps<T extends PropTypes> = {\n  [K in keyof T]: (props: K extends keyof JSX.IntrinsicElements ? DataAttr & JSX.IntrinsicElements[K] : never) => T[K]\n} & {\n  element(props: DataAttr & JSX.HTMLAttributes<HTMLElement> & Record<string, any>): T[\"element\"]\n  style: JSX.CSSProperties\n}\nexport function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T> {\n  return new Proxy({} as any, {\n    get() {\n      return fn\n    },\n  })\n}\n"],"mappings":";AAyDO,SAAS,iBAAsC,IAA8C;AAClG,SAAO,IAAI,MAAM,CAAC,GAAU;AAAA,IAC1B,MAAM;AACJ,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/prop-types.ts","../src/create-props.ts"],"sourcesContent":["import type { JSX } from \"./jsx\"\n\ntype Dict<T = any> = Record<string, T>\n\ntype Booleanish = boolean | \"true\" | \"false\"\n\ntype DataAttr = {\n  \"data-selected\"?: Booleanish\n  \"data-expanded\"?: Booleanish\n  \"data-highlighted\"?: Booleanish\n  \"data-readonly\"?: Booleanish\n  \"data-indeterminate\"?: Booleanish\n  \"data-invalid\"?: Booleanish\n  \"data-hover\"?: Booleanish\n  \"data-active\"?: Booleanish\n  \"data-focus\"?: Booleanish\n  \"data-disabled\"?: Booleanish\n  \"data-open\"?: Booleanish\n  \"data-checked\"?: Booleanish\n  \"data-pressed\"?: Booleanish\n  \"data-complete\"?: Booleanish\n  \"data-empty\"?: Booleanish\n  \"data-placeholder-shown\"?: Booleanish\n  \"data-half\"?: Booleanish\n  \"data-scope\"?: string\n\n  \"data-uid\"?: string\n  \"data-name\"?: string\n  \"data-ownedby\"?: string\n  \"data-type\"?: string\n  \"data-valuetext\"?: string\n  \"data-placement\"?: string\n  \"data-controls\"?: string\n  \"data-part\"?: string\n  \"data-label\"?: string\n  \"data-state\"?: string | null\n  \"data-value\"?: string | number\n\n  \"data-orientation\"?: \"horizontal\" | \"vertical\"\n\n  \"data-count\"?: number\n  \"data-index\"?: number\n} & {\n  [key in `data-${string}`]?: string | number | Booleanish\n}\n\nexport type PropTypes<T = Dict> = Record<\n  \"button\" | \"label\" | \"input\" | \"textarea\" | \"img\" | \"output\" | \"element\" | \"select\" | \"style\" | \"circle\" | \"svg\",\n  T\n>\n\nexport type NormalizeProps<T extends PropTypes> = {\n  [K in keyof T]: (props: K extends keyof JSX.IntrinsicElements ? DataAttr & JSX.IntrinsicElements[K] : never) => T[K]\n} & {\n  element(props: DataAttr & JSX.HTMLAttributes<HTMLElement> & Record<string, any>): T[\"element\"]\n  style: JSX.CSSProperties\n}\n\nexport function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T> {\n  return new Proxy({} as any, {\n    get() {\n      return fn\n    },\n  })\n}\n","type StrictKeys<K extends (keyof T)[], T> = K extends (keyof T)[]\n  ? [keyof T] extends [K[number]]\n    ? unknown\n    : `Missing required keys: ${Exclude<keyof T, K[number]>}`\n  : never\n\nexport const createProps =\n  <T extends Record<never, never>>() =>\n  <K extends (keyof T)[]>(props: K & StrictKeys<K, T>) =>\n    Array.from(new Set(props))\n"],"mappings":";AA0DO,SAAS,iBAAsC,IAA8C;AAClG,SAAO,IAAI,MAAM,CAAC,GAAU;AAAA,IAC1B,MAAM;AACJ,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;;;AC1DO,IAAM,cACX,MACA,CAAwB,UACtB,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/types",
-  "version": "0.36.3",
+  "version": "0.37.0",
   "keywords": [
     "js",
     "utils",

package/src/create-props.ts

@@ -0,0 +1,10 @@
+type StrictKeys<K extends (keyof T)[], T> = K extends (keyof T)[]
+  ? [keyof T] extends [K[number]]
+    ? unknown
+    : `Missing required keys: ${Exclude<keyof T, K[number]>}`
+  : never
+
+export const createProps =
+  <T extends Record<never, never>>() =>
+  <K extends (keyof T)[]>(props: K & StrictKeys<K, T>) =>
+    Array.from(new Set(props))

package/src/index.ts

@@ -43,25 +43,8 @@ export interface CommonProperties {
   getRootNode?: () => ShadowRoot | Document | Node
 }
 
-export interface RootProperties {
-  /**
-   * The owner document of the machine.
-   */
-  doc?: Document
-  /**
-   * The root node of the machine. Useful for shadow DOM.
-   */
-  rootNode?: ShadowRoot
-  /**
-   * The related target when the element is blurred.
-   * Used as a polyfill for `e.relatedTarget`
-   */
-  pointerdownNode?: HTMLElement | null
-}
-
-export type Context<T> = T & RootProperties
-
 export type Style = JSX.CSSProperties
 
 export * from "./prop-types"
 export type { JSX }
+export * from "./create-props"

package/src/prop-types.ts

@@ -55,6 +55,7 @@ export type NormalizeProps<T extends PropTypes> = {
   element(props: DataAttr & JSX.HTMLAttributes<HTMLElement> & Record<string, any>): T["element"]
   style: JSX.CSSProperties
 }
+
 export function createNormalizer<T extends PropTypes>(fn: (props: Dict) => Dict): NormalizeProps<T> {
   return new Proxy({} as any, {
     get() {