@elliemae/ds-props-helpers 3.70.0-next.9 → 3.70.0-rc.0

package/dist/cjs/contractProps/getContractProps.js

@@ -0,0 +1,47 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var getContractProps_exports = {};
+__export(getContractProps_exports, {
+  getContractProps: () => getContractProps
+});
+module.exports = __toCommonJS(getContractProps_exports);
+var React = __toESM(require("react"));
+const DOCUMENTATION_ONLY_SCHEMA_KEYS = /* @__PURE__ */ new Set(["aria-*", "on-*", "data-*", "all HTML attributes"]);
+const getContractProps = (props, contractShape) => {
+  const declaredKeys = new Set(Object.keys(contractShape).filter((key) => !DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)));
+  const contractProps = {};
+  Object.entries(props).forEach(([key, value]) => {
+    if (value === void 0) return;
+    if (DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)) return;
+    if (!declaredKeys.has(key) && !key.startsWith("data-")) return;
+    contractProps[key] = value;
+  });
+  return contractProps;
+};
+//# sourceMappingURL=getContractProps.js.map

package/dist/cjs/contractProps/getContractProps.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contractProps/getContractProps.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["/**\n * Documentation-only entries that live in `globalAttributesPropTypes` (and therefore in every\n * component schema that spreads it). They exist so the Storybook props table can show \"you may pass\n * any aria-* / data-* / on-* / HTML attribute\" in a single row \u2014 they are NOT prop names a consumer\n * can ever pass, so they must never be treated as part of the runtime key set.\n */\nconst DOCUMENTATION_ONLY_SCHEMA_KEYS = new Set(['aria-*', 'on-*', 'data-*', 'all HTML attributes']);\n\n/**\n * Filters an arbitrary object down to the props a component's contract declares.\n *\n * This is the engine behind each package's own curated passthrough utility (e.g. ds-app-picker's\n * `getDSAppPickerContractProps`). Packages are expected to expose a bound utility rather than their\n * schema: the schema stays an internal implementation detail, so the two can drift later without\n * expanding anyone's public API.\n *\n * Three behaviours worth knowing, because callers depend on them:\n *\n * 1. **Documentation-only wildcard keys are ignored.** See `DOCUMENTATION_ONLY_SCHEMA_KEYS`.\n * 2. **`data-*` is honoured by prefix**, matching `getGlobalAttributes` \u2014 arbitrary data attributes\n *    are a supported consumer surface even though no schema can enumerate them. Note the house\n *    behaviour deliberately does not extend the same courtesy to `aria-*` or `on*`: those are\n *    matched against the schema's explicit list, so a typo fails loudly instead of reaching the DOM.\n * 3. **`undefined` is dropped, `null` is forwarded.** These two are not interchangeable, and the rule\n *    follows React rather than being invented here:\n *\n *    - React's own default resolution (`resolveDefaultProps`) applies a `defaultProps` entry only when\n *      the incoming prop is `undefined`; a `null` is respected as an explicitly supplied value. This\n *      is the same rule as JS destructuring defaults and ES6 default parameters \u2014 a language-level\n *      standard, not a React invention. So `undefined` means \"I am not defining this, you decide\" and\n *      `null` means \"I am defining it, as nothing\".\n *    - Everywhere React *consumes* a value rather than defaulting it \u2014 DOM attributes, children, event\n *      handlers \u2014 it collapses the two and treats both as absent. The distinction is load-bearing\n *      only at a default-resolution boundary.\n *\n *    A contract passthrough is exactly such a boundary: the result is spread *after* a wrapper's own\n *    defaults, so dropping `undefined` is what stops an unset key from erasing a working default,\n *    while forwarding `null` is what lets a consumer deliberately override one. This matters more\n *    here than in plain React, because Dimsum's `useMemoMergePropsWithDefault` is a plain\n *    `{...defaults, ...props}` spread \u2014 it does NOT skip `undefined` the way `resolveDefaultProps`\n *    does, so an `undefined` that reaches it clobbers the component's default too.\n *\n *    What happens to a forwarded `null` afterwards is the receiving component's business, not this\n *    function's. Dimsum components are strictly typed: `validateTypescriptPropTypesImplementation`\n *    validates any value that is not `undefined`, and a prop declared as a function does not admit\n *    `null` \u2014 so passing `null` there raises a prop-type error, correctly. A prop only accepts `null`\n *    if its own declared type says so and its code carries the matching null guards. Where a consumer\n *    wants to state \"do nothing\", the type-honouring way to say it is an explicit no-op \u2014 `() => {}`\n *    for a handler, `() => null` for a component \u2014 which is unambiguous in a way that `null` is not.\n *    This function stays out of that decision: forwarding the value and letting the owning contract\n *    judge it is the correct division of concerns at this abstraction level.\n *\n * @param props - the object to filter; anything the contract does not declare is discarded\n * @param contractShape - any object whose KEYS name the contract's props. Only `Object.keys` is read,\n *   so it is deliberately not narrowed to `DSPropTypesSchema`\n *\n * a PropTypes schema is usually fine and there is a code dedicated to discarding the global attributes to make the schema compatible for faster internal transition/implementation.\n * @returns a new object containing only the declared, defined props\n */\nexport const getContractProps = <ContractProps>(props: object, contractShape: object): Partial<ContractProps> => {\n  const declaredKeys = new Set(Object.keys(contractShape).filter((key) => !DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)));\n\n  // `props` is typed as `object` rather than `Record<string, unknown>` so callers can pass their own\n  // declared prop interfaces without a cast at every call site. The casts live here instead.\n  const contractProps: Record<string, unknown> = {};\n\n  Object.entries(props as Record<string, unknown>).forEach(([key, value]) => {\n    if (value === undefined) return;\n    // Order matters: 'data-*' is itself prefixed with 'data-', so the documentation-only check has\n    // to win over the prefix rule below or the pseudo-key would readmit itself.\n    if (DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)) return;\n    if (!declaredKeys.has(key) && !key.startsWith('data-')) return;\n    contractProps[key] = value;\n  });\n\n  return contractProps as Partial<ContractProps>;\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADMvB,MAAM,iCAAiC,oBAAI,IAAI,CAAC,UAAU,QAAQ,UAAU,qBAAqB,CAAC;AAqD3F,MAAM,mBAAmB,CAAgB,OAAe,kBAAkD;AAC/G,QAAM,eAAe,IAAI,IAAI,OAAO,KAAK,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;AAIjH,QAAM,gBAAyC,CAAC;AAEhD,SAAO,QAAQ,KAAgC,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,QAAI,UAAU,OAAW;AAGzB,QAAI,+BAA+B,IAAI,GAAG,EAAG;AAC7C,QAAI,CAAC,aAAa,IAAI,GAAG,KAAK,CAAC,IAAI,WAAW,OAAO,EAAG;AACxD,kBAAc,GAAG,IAAI;AAAA,EACvB,CAAC;AAED,SAAO;AACT;",
+  "names": []
+}

package/dist/cjs/contractProps/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contractProps_exports = {};
+__export(contractProps_exports, {
+  getContractProps: () => import_getContractProps.getContractProps
+});
+module.exports = __toCommonJS(contractProps_exports);
+var React = __toESM(require("react"));
+var import_getContractProps = require("./getContractProps.js");
+//# sourceMappingURL=index.js.map

package/dist/cjs/contractProps/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contractProps/index.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["export { getContractProps } from './getContractProps.js';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAAiC;",
+  "names": []
+}

package/dist/cjs/index.js

@@ -31,6 +31,7 @@ __export(index_exports, {
   PropTypes: () => import_propTypes.PropTypes,
   describe: () => import_propTypes.describe,
   getAriaProps: () => import_getProps.getAriaProps,
+  getContractProps: () => import_contractProps.getContractProps,
   getDataProps: () => import_getProps.getDataProps,
   getGlobalAttributes: () => import_globalProps.getGlobalAttributes,
   getPropsPerDatatestIdPropTypes: () => import_propsPerDataTestId.getPropsPerDatatestIdPropTypes,
@@ -58,6 +59,7 @@ var import_propTypes = require("./propTypes/index.js");
 var import_validation = require("./validation/index.js");
 var import_xstyledProps = require("./xstyledProps/index.js");
 var import_useDeprecateComponent = require("./useDeprecateComponent/index.js");
+var import_contractProps = require("./contractProps/index.js");
 var import_propsPerDataTestId = require("./propsPerDataTestId/index.js");
 var import_propsPerSlot = require("./propsPerSlot/index.js");
 var import_useOwnerProps = require("./useOwnerProps/index.js");

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["export { useMemoMergePropsWithDefault } from './defaultProps/index.js';\nexport { getAriaProps, getDataProps } from './getProps/index.js';\nexport {\n  getGlobalAttributes,\n  useGetGlobalAttributes,\n  globalAttributesPropTypes,\n  type GlobalAttributesT,\n} from './globalProps/index.js';\nexport { describe, PropTypes, type DSPropTypesSchema } from './propTypes/index.js';\nexport type { ValidationMap } from 'prop-types';\nexport {\n  throwTypeError,\n  throwRequiredError,\n  useValidateTypescriptPropTypes,\n  validateTypescriptPropTypesImplementation,\n} from './validation/index.js';\nexport { type XstyledProps, useGetXstyledProps, xstyledPropTypes, getXstyledProps } from './xstyledProps/index.js';\nexport { useDeprecateComponent } from './useDeprecateComponent/index.js';\n\nexport { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from './propsPerDataTestId/index.js';\nexport { getPropsPerSlotPropTypes } from './propsPerSlot/index.js';\nexport { useOwnerProps } from './useOwnerProps/index.js';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,0BAA6C;AAC7C,sBAA2C;AAC3C,yBAKO;AACP,uBAA4D;AAE5D,wBAKO;AACP,0BAAyF;AACzF,mCAAsC;AAEtC,gCAAsE;AACtE,0BAAyC;AACzC,2BAA8B;",
+  "sourcesContent": ["export { useMemoMergePropsWithDefault } from './defaultProps/index.js';\nexport { getAriaProps, getDataProps } from './getProps/index.js';\nexport {\n  getGlobalAttributes,\n  useGetGlobalAttributes,\n  globalAttributesPropTypes,\n  type GlobalAttributesT,\n} from './globalProps/index.js';\nexport { describe, PropTypes, type DSPropTypesSchema } from './propTypes/index.js';\nexport type { ValidationMap } from 'prop-types';\nexport {\n  throwTypeError,\n  throwRequiredError,\n  useValidateTypescriptPropTypes,\n  validateTypescriptPropTypesImplementation,\n} from './validation/index.js';\nexport { type XstyledProps, useGetXstyledProps, xstyledPropTypes, getXstyledProps } from './xstyledProps/index.js';\nexport { useDeprecateComponent } from './useDeprecateComponent/index.js';\n\nexport { getContractProps } from './contractProps/index.js';\nexport { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from './propsPerDataTestId/index.js';\nexport { getPropsPerSlotPropTypes } from './propsPerSlot/index.js';\nexport { useOwnerProps } from './useOwnerProps/index.js';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,0BAA6C;AAC7C,sBAA2C;AAC3C,yBAKO;AACP,uBAA4D;AAE5D,wBAKO;AACP,0BAAyF;AACzF,mCAAsC;AAEtC,2BAAiC;AACjC,gCAAsE;AACtE,0BAAyC;AACzC,2BAA8B;",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,7 +1,4 @@
 {
   "type": "commonjs",
-  "sideEffects": [],
-  "publishConfig": {
-    "access": "public"
-  }
+  "sideEffects": []
 }

package/dist/cjs/propTypes/PropTypes.js

@@ -125,6 +125,7 @@ definePropType("any");
 definePropType("array");
 definePropType("bool");
 definePropType("element");
+definePropType("elementType");
 definePropType("func");
 definePropType("node");
 definePropType("number");

package/dist/cjs/propTypes/PropTypes.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/propTypes/PropTypes.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import type { PropTypesTypes, DocumentedPropType, ReactDescObjT, PropTypesObj } from './types.js';\n\nconst addPropTypeDocumentationField = <T extends keyof ReactDescObjT>(fieldName: T) =>\n  function addFieldToReactDesc(this: DocumentedPropType, value: ReactDescObjT[T]): DocumentedPropType {\n    if (!this.reactDesc) {\n      this.reactDesc = {};\n    }\n    let realValue = value;\n    if (\n      fieldName === 'global' ||\n      fieldName === 'dataTestId' ||\n      fieldName === 'hidden' ||\n      fieldName === 'xstyled' ||\n      fieldName === 'omitValidation'\n    )\n      realValue = true;\n\n    this.reactDesc[fieldName] = realValue;\n    return this;\n  };\n\nconst documentedPropType: Omit<DocumentedPropType, 'type' | 'isRequired' | 'reactDesc'> = {\n  defaultValue: addPropTypeDocumentationField('defaultValue'),\n  description: addPropTypeDocumentationField('description'),\n  deprecated: addPropTypeDocumentationField('deprecated'),\n  format: addPropTypeDocumentationField('format'),\n  signature: addPropTypeDocumentationField('signature'),\n  global: addPropTypeDocumentationField('global'),\n  omitValidation: addPropTypeDocumentationField('omitValidation'),\n  hidden: addPropTypeDocumentationField('hidden'),\n  dataTestId: addPropTypeDocumentationField('dataTestId'),\n  xstyled: addPropTypeDocumentationField('xstyled'),\n  isRequiredIf: addPropTypeDocumentationField('isRequiredIf'),\n};\n\nconst createPropType = (type: PropTypesTypes) => {\n  const propTypeObj = {\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n\n  return propTypeObj;\n};\n\nconst createPropTypeWithArgs = (type: PropTypesTypes) => (args: unknown) => {\n  const propTypeObj = {\n    args,\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n  return propTypeObj;\n};\n\nconst PropTypes = {\n  custom: (callback: CallableFunction) => {\n    const target = callback.bind(null) as CallableFunction & DocumentedPropType;\n    target.type = 'func';\n    Object.keys(documentedPropType).forEach((fieldName) => {\n      const fieldNameCasted = fieldName as keyof DocumentedPropType;\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n      (target[fieldNameCasted] as unknown) = documentedPropType[fieldNameCasted] as unknown;\n    });\n    return target;\n  },\n} as unknown as PropTypesObj;\n\nfunction definePropType(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropType(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\nfunction definePropTypeWithArgs(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropTypeWithArgs(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\ndefinePropType('any');\ndefinePropType('array');\ndefinePropType('bool');\ndefinePropType('element');\ndefinePropType('func');\ndefinePropType('node');\ndefinePropType('number');\ndefinePropType('object');\ndefinePropType('symbol');\ndefinePropType('string');\n\ndefinePropTypeWithArgs('arrayOf');\ndefinePropTypeWithArgs('instanceOf');\ndefinePropTypeWithArgs('objectOf');\ndefinePropTypeWithArgs('oneOfType');\ndefinePropTypeWithArgs('oneOf');\ndefinePropTypeWithArgs('shape');\ndefinePropTypeWithArgs('tuple');\n\nexport default PropTypes;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { PropTypesTypes, DocumentedPropType, ReactDescObjT, PropTypesObj } from './types.js';\n\nconst addPropTypeDocumentationField = <T extends keyof ReactDescObjT>(fieldName: T) =>\n  function addFieldToReactDesc(this: DocumentedPropType, value: ReactDescObjT[T]): DocumentedPropType {\n    if (!this.reactDesc) {\n      this.reactDesc = {};\n    }\n    let realValue = value;\n    if (\n      fieldName === 'global' ||\n      fieldName === 'dataTestId' ||\n      fieldName === 'hidden' ||\n      fieldName === 'xstyled' ||\n      fieldName === 'omitValidation'\n    )\n      realValue = true;\n\n    this.reactDesc[fieldName] = realValue;\n    return this;\n  };\n\nconst documentedPropType: Omit<DocumentedPropType, 'type' | 'isRequired' | 'reactDesc'> = {\n  defaultValue: addPropTypeDocumentationField('defaultValue'),\n  description: addPropTypeDocumentationField('description'),\n  deprecated: addPropTypeDocumentationField('deprecated'),\n  format: addPropTypeDocumentationField('format'),\n  signature: addPropTypeDocumentationField('signature'),\n  global: addPropTypeDocumentationField('global'),\n  omitValidation: addPropTypeDocumentationField('omitValidation'),\n  hidden: addPropTypeDocumentationField('hidden'),\n  dataTestId: addPropTypeDocumentationField('dataTestId'),\n  xstyled: addPropTypeDocumentationField('xstyled'),\n  isRequiredIf: addPropTypeDocumentationField('isRequiredIf'),\n};\n\nconst createPropType = (type: PropTypesTypes) => {\n  const propTypeObj = {\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n\n  return propTypeObj;\n};\n\nconst createPropTypeWithArgs = (type: PropTypesTypes) => (args: unknown) => {\n  const propTypeObj = {\n    args,\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n  return propTypeObj;\n};\n\nconst PropTypes = {\n  custom: (callback: CallableFunction) => {\n    const target = callback.bind(null) as CallableFunction & DocumentedPropType;\n    target.type = 'func';\n    Object.keys(documentedPropType).forEach((fieldName) => {\n      const fieldNameCasted = fieldName as keyof DocumentedPropType;\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n      (target[fieldNameCasted] as unknown) = documentedPropType[fieldNameCasted] as unknown;\n    });\n    return target;\n  },\n} as unknown as PropTypesObj;\n\nfunction definePropType(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropType(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\nfunction definePropTypeWithArgs(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropTypeWithArgs(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\ndefinePropType('any');\ndefinePropType('array');\ndefinePropType('bool');\ndefinePropType('element');\ndefinePropType('elementType');\ndefinePropType('func');\ndefinePropType('node');\ndefinePropType('number');\ndefinePropType('object');\ndefinePropType('symbol');\ndefinePropType('string');\n\ndefinePropTypeWithArgs('arrayOf');\ndefinePropTypeWithArgs('instanceOf');\ndefinePropTypeWithArgs('objectOf');\ndefinePropTypeWithArgs('oneOfType');\ndefinePropTypeWithArgs('oneOf');\ndefinePropTypeWithArgs('shape');\ndefinePropTypeWithArgs('tuple');\n\nexport default PropTypes;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/propTypes/toTypescript.js

@@ -45,7 +45,8 @@ const shapeFormat = (shape) => {
     } else {
       valueFormat = propTypeFormat(value);
     }
-    return `${key}${value.reactDesc && value.reactDesc.required ? "" : "?"}: ${valueFormat}`;
+    const deprecatedMarker = value.reactDesc?.deprecated ? `/** @deprecated v${value.reactDesc.deprecated.version} */ ` : "";
+    return `${deprecatedMarker}${key}${value.reactDesc && value.reactDesc.required ? "" : "?"}: ${valueFormat}`;
   });
   return `{${props.join(",")}}`;
 };
@@ -80,6 +81,9 @@ const propTypeFormat = (propType, joinWith = "") => {
       case "element":
         result = "JSX.Element";
         break;
+      case "elementType":
+        result = "React.ComponentType<Record<string,unknown>>";
+        break;
       case "instanceOf":
         result = "any";
         break;

package/dist/cjs/propTypes/toTypescript.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/propTypes/toTypescript.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/restrict-template-expressions */\n/* eslint-disable @typescript-eslint/no-use-before-define */\n/* eslint-disable complexity */\n/* eslint-disable react/forbid-foreign-prop-types */\nimport type React from 'react';\nimport type { ComponentDocumentation, Hook, ReactDescT, TypescriptDocumentation } from './types.js';\nimport { isReactDesc } from './describeGuards.js';\n\nconst arrayFormat = (array: ReactDescT[]) => array.map((propType) => propTypeFormat(propType));\n\nconst shapeFormat = (shape: Record<string, ReactDescT>) => {\n  const props = Object.keys(shape).map((key) => {\n    const value = shape[key];\n    let valueFormat;\n    if (\n      value.type &&\n      (value.type === 'arrayOf' || value.type === 'oneOfType' || value.type === 'oneOf') &&\n      Array.isArray(value.args)\n    ) {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else if (value.type === 'shape') {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else {\n      valueFormat = propTypeFormat(value);\n    }\n    return `${key}${value.reactDesc && value.reactDesc.required ? '' : '?'}: ${valueFormat}`;\n  });\n  return `{${props.join(',')}}`;\n};\n\nconst propTypeFormat = (propType: ReactDescT | ReactDescT[], joinWith = ''): string => {\n  let result;\n  if (Array.isArray(propType)) {\n    result = arrayFormat(propType).join(joinWith);\n  } else if (typeof propType !== 'function' && propType.type) {\n    switch (propType.type) {\n      case 'array':\n        result = 'any[]';\n        break;\n      case 'arrayOf':\n        if ((propType.args as ReactDescT).type === 'oneOfType') {\n          result = `(${propTypeFormat(propType.args as ReactDescT, ' | ')})[]`;\n        } else {\n          result = `${propTypeFormat(propType.args as ReactDescT, '\\n')}[]`;\n        }\n        break;\n      case 'tuple':\n        result = `[${propTypeFormat(propType.args as ReactDescT, ', ')}]`;\n        break;\n      case 'bool':\n        result = 'boolean';\n        break;\n      case 'func':\n        result = propType?.reactDesc?.signature ?? '((...args: any[]) => any)';\n        break;\n      case 'node':\n        result = 'React.ReactNode';\n        break;\n      case 'element':\n        result = 'JSX.Element';\n        break;\n      case 'instanceOf':\n        result = 'any';\n        break;\n      case 'symbol':\n        result = 'any';\n        break;\n      case 'objectOf':\n        result = `{ [key: string]: ${propTypeFormat(propType.args as ReactDescT)} }`;\n        break;\n      case 'oneOf':\n        result = (propType.args as unknown[]).map((a) => `\"${a}\"`).join(' | ');\n        break;\n      case 'oneOfType':\n        result = `${propTypeFormat(propType.args as ReactDescT[], ' | ')}`;\n        break;\n      case 'shape':\n        result = `${shapeFormat(propType.args as Record<string, ReactDescT>)}`;\n        break;\n      default:\n        result = `${propType.type}`;\n        break;\n    }\n  } else {\n    result = 'any';\n  }\n  return result;\n};\n\nconst propTypeAsTypescript = (propType: ReactDescT, propName: string) => {\n  const documentation = {\n    ...propType.reactDesc,\n    name: propName,\n  };\n\n  documentation.format = propTypeFormat(propType);\n\n  return documentation;\n};\n\nexport default function descToTypescript<C, R>(\n  component: React.ComponentType<C> | Hook<C, R>,\n  reactDesc: ComponentDocumentation,\n) {\n  if (!component) {\n    throw new Error('react-desc: component is required');\n  }\n\n  const documentation: Partial<TypescriptDocumentation> = {\n    name: component.displayName || component.name,\n    ...reactDesc,\n  };\n  if (reactDesc) {\n    delete documentation.propTypes;\n\n    if (reactDesc.propTypes) {\n      const propTypes: TypescriptDocumentation['properties'] = [];\n      Object.keys(reactDesc.propTypes).forEach((propName) => {\n        const propType = reactDesc.propTypes[propName];\n        if (propType.type === 'shape') {\n          propType.reactDesc.group = {};\n\n          Object.keys(propType.args as Record<string, ReactDescT>).forEach((prop) => {\n            if (!propType.reactDesc.group) return;\n            propType.reactDesc.group[prop] = propTypeAsTypescript(\n              (propType.args as Record<string, ReactDescT>)[prop],\n              prop,\n            );\n          });\n        }\n        propTypes.push(propTypeAsTypescript(propType, propName));\n      });\n      if (propTypes.length > 0) {\n        documentation.properties = propTypes;\n      }\n    }\n    if (reactDesc.returnType) {\n      if (isReactDesc(reactDesc.returnType)) {\n        documentation.returns = propTypeAsTypescript(reactDesc.returnType, 'returns');\n      } else {\n        documentation.returns = Object.entries(reactDesc.returnType).map(([propName, propType]) =>\n          propTypeAsTypescript(propType, propName),\n        );\n      }\n    }\n  }\n  return documentation as TypescriptDocumentation;\n}\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": "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",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/restrict-template-expressions */\n/* eslint-disable @typescript-eslint/no-use-before-define */\n/* eslint-disable complexity */\n/* eslint-disable react/forbid-foreign-prop-types */\nimport type React from 'react';\nimport type { ComponentDocumentation, Hook, ReactDescT, TypescriptDocumentation } from './types.js';\nimport { isReactDesc } from './describeGuards.js';\n\nconst arrayFormat = (array: ReactDescT[]) => array.map((propType) => propTypeFormat(propType));\n\nconst shapeFormat = (shape: Record<string, ReactDescT>) => {\n  const props = Object.keys(shape).map((key) => {\n    const value = shape[key];\n    let valueFormat;\n    if (\n      value.type &&\n      (value.type === 'arrayOf' || value.type === 'oneOfType' || value.type === 'oneOf') &&\n      Array.isArray(value.args)\n    ) {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else if (value.type === 'shape') {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else {\n      valueFormat = propTypeFormat(value);\n    }\n    const deprecatedMarker = value.reactDesc?.deprecated\n      ? `/** @deprecated v${value.reactDesc.deprecated.version} */ `\n      : '';\n    return `${deprecatedMarker}${key}${value.reactDesc && value.reactDesc.required ? '' : '?'}: ${valueFormat}`;\n  });\n  return `{${props.join(',')}}`;\n};\n\nconst propTypeFormat = (propType: ReactDescT | ReactDescT[], joinWith = ''): string => {\n  let result;\n  if (Array.isArray(propType)) {\n    result = arrayFormat(propType).join(joinWith);\n  } else if (typeof propType !== 'function' && propType.type) {\n    switch (propType.type) {\n      case 'array':\n        result = 'any[]';\n        break;\n      case 'arrayOf':\n        if ((propType.args as ReactDescT).type === 'oneOfType') {\n          result = `(${propTypeFormat(propType.args as ReactDescT, ' | ')})[]`;\n        } else {\n          result = `${propTypeFormat(propType.args as ReactDescT, '\\n')}[]`;\n        }\n        break;\n      case 'tuple':\n        result = `[${propTypeFormat(propType.args as ReactDescT, ', ')}]`;\n        break;\n      case 'bool':\n        result = 'boolean';\n        break;\n      case 'func':\n        result = propType?.reactDesc?.signature ?? '((...args: any[]) => any)';\n        break;\n      case 'node':\n        result = 'React.ReactNode';\n        break;\n      case 'element':\n        result = 'JSX.Element';\n        break;\n      case 'elementType':\n        result = 'React.ComponentType<Record<string,unknown>>';\n        break;\n      case 'instanceOf':\n        result = 'any';\n        break;\n      case 'symbol':\n        result = 'any';\n        break;\n      case 'objectOf':\n        result = `{ [key: string]: ${propTypeFormat(propType.args as ReactDescT)} }`;\n        break;\n      case 'oneOf':\n        result = (propType.args as unknown[]).map((a) => `\"${a}\"`).join(' | ');\n        break;\n      case 'oneOfType':\n        result = `${propTypeFormat(propType.args as ReactDescT[], ' | ')}`;\n        break;\n      case 'shape':\n        result = `${shapeFormat(propType.args as Record<string, ReactDescT>)}`;\n        break;\n      default:\n        result = `${propType.type}`;\n        break;\n    }\n  } else {\n    result = 'any';\n  }\n  return result;\n};\n\nconst propTypeAsTypescript = (propType: ReactDescT, propName: string) => {\n  const documentation = {\n    ...propType.reactDesc,\n    name: propName,\n  };\n\n  documentation.format = propTypeFormat(propType);\n\n  return documentation;\n};\n\nexport default function descToTypescript<C, R>(\n  component: React.ComponentType<C> | Hook<C, R>,\n  reactDesc: ComponentDocumentation,\n) {\n  if (!component) {\n    throw new Error('react-desc: component is required');\n  }\n\n  const documentation: Partial<TypescriptDocumentation> = {\n    name: component.displayName || component.name,\n    ...reactDesc,\n  };\n  if (reactDesc) {\n    delete documentation.propTypes;\n\n    if (reactDesc.propTypes) {\n      const propTypes: TypescriptDocumentation['properties'] = [];\n      Object.keys(reactDesc.propTypes).forEach((propName) => {\n        const propType = reactDesc.propTypes[propName];\n        if (propType.type === 'shape') {\n          propType.reactDesc.group = {};\n\n          Object.keys(propType.args as Record<string, ReactDescT>).forEach((prop) => {\n            if (!propType.reactDesc.group) return;\n            propType.reactDesc.group[prop] = propTypeAsTypescript(\n              (propType.args as Record<string, ReactDescT>)[prop],\n              prop,\n            );\n          });\n        }\n        propTypes.push(propTypeAsTypescript(propType, propName));\n      });\n      if (propTypes.length > 0) {\n        documentation.properties = propTypes;\n      }\n    }\n    if (reactDesc.returnType) {\n      if (isReactDesc(reactDesc.returnType)) {\n        documentation.returns = propTypeAsTypescript(reactDesc.returnType, 'returns');\n      } else {\n        documentation.returns = Object.entries(reactDesc.returnType).map(([propName, propType]) =>\n          propTypeAsTypescript(propType, propName),\n        );\n      }\n    }\n  }\n  return documentation as TypescriptDocumentation;\n}\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/useOwnerProps/index.js

@@ -36,6 +36,6 @@ var import_react = require("react");
 const useOwnerProps = (props, args) => {
   const getOwnerProps = (0, import_react.useCallback)(() => props, [props]);
   const getOwnerPropsArguments = (0, import_react.useCallback)(() => args ?? {}, [args]);
-  return { getOwnerProps, getOwnerPropsArguments };
+  return (0, import_react.useMemo)(() => ({ getOwnerProps, getOwnerPropsArguments }), [getOwnerProps, getOwnerPropsArguments]);
 };
 //# sourceMappingURL=index.js.map

package/dist/cjs/useOwnerProps/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/useOwnerProps/index.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useCallback } from 'react';\n\nexport const useOwnerProps = <P, A extends object = Record<string, never>>(props: P, args?: A) => {\n  const getOwnerProps = useCallback(() => props, [props]);\n  const getOwnerPropsArguments = useCallback(() => args ?? {}, [args]);\n  return { getOwnerProps, getOwnerPropsArguments };\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAA4B;AAErB,MAAM,gBAAgB,CAA8C,OAAU,SAAa;AAChG,QAAM,oBAAgB,0BAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,6BAAyB,0BAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AACnE,SAAO,EAAE,eAAe,uBAAuB;AACjD;",
+  "sourcesContent": ["import { useCallback, useMemo } from 'react';\n\nexport const useOwnerProps = <P, A extends object = Record<string, never>>(props: P, args?: A) => {\n  const getOwnerProps = useCallback(() => props, [props]);\n  const getOwnerPropsArguments = useCallback(() => args ?? {}, [args]);\n  return useMemo(() => ({ getOwnerProps, getOwnerPropsArguments }), [getOwnerProps, getOwnerPropsArguments]);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAqC;AAE9B,MAAM,gBAAgB,CAA8C,OAAU,SAAa;AAChG,QAAM,oBAAgB,0BAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,6BAAyB,0BAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AACnE,aAAO,sBAAQ,OAAO,EAAE,eAAe,uBAAuB,IAAI,CAAC,eAAe,sBAAsB,CAAC;AAC3G;",
   "names": []
 }

package/dist/cjs/validation/typescriptGuards.js

@@ -35,6 +35,7 @@ __export(typescriptGuards_exports, {
   isObject: () => isObject,
   isObjectOf: () => isObjectOf,
   isPrimitiveType: () => isPrimitiveType,
+  isReactComponentType: () => isReactComponentType,
   isSomethingWithParenthesis: () => isSomethingWithParenthesis,
   isString: () => isString,
   isUndefined: () => isUndefined,
@@ -75,5 +76,6 @@ const isFunction = (format) => {
   return arrowOccursAtDepth1;
 };
 const isJSXorNode = (format) => !isUnion(format) && ["React.ReactNode", "JSX.Element"].includes(format);
+const isReactComponentType = (format) => !isUnion(format) && format === "React.ComponentType<Record<string,unknown>>";
 const isSomethingWithParenthesis = (format) => !isUnion(format) && format[0] === "(" && format.slice(-1) === ")";
 //# sourceMappingURL=typescriptGuards.js.map

package/dist/cjs/validation/typescriptGuards.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/validation/typescriptGuards.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["type GuardFn = (format: string) => boolean;\n\nexport const isPrimitiveType: GuardFn = (format) => ['string', 'number', 'boolean'].includes(format);\nexport const isUndefined: GuardFn = (format) => format === '\"undefined\"';\nexport const isNull: GuardFn = (format) => format === '\"null\"';\nexport const isUnion: GuardFn = (format) => {\n  let depth = 0;\n  let satisfies = false;\n  format.split('').forEach((char) => {\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (char === '|' && depth === 0) satisfies = true;\n  });\n  return satisfies;\n};\n\nexport const isString: GuardFn = (format) => !isUnion(format) && format[0] === '\"' && format.slice(-1) === '\"';\n\nexport const isArray: GuardFn = (format) => !isUnion(format) && format.slice(-2) === '[]';\n\nexport const isObjectOf: GuardFn = (format) =>\n  format !== 'object' && !isUnion(format) && format.startsWith('{ [key: string]: ');\n\nexport const isObject: GuardFn = (format) =>\n  format === 'object' || (!isUnion(format) && format[0] === '{' && format.slice(-1) === '}');\n\nexport const isFunction: GuardFn = (format) => {\n  // It's isn't an union\n  if (isUnion(format)) return false;\n  // Has to start with (( and end with )\n  if (!format.startsWith('((') && format.slice(-1) !== ')') return false;\n\n  // The arrow MUST occur at depth 1 (when couting parenthesis)\n  // Otherwise the only possibility is that we have \"something with parenthesis\" (look down below)\n  let depth = 0;\n  let arrowOccursAtDepth1 = false;\n  for (let i = 0; i < format.length; i += 1) {\n    const char = format[i];\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (i < format.length - 1 && format.slice(i, i + 2) === '=>') {\n      arrowOccursAtDepth1 = arrowOccursAtDepth1 || depth === 1;\n    }\n  }\n  return arrowOccursAtDepth1;\n};\n\nexport const isJSXorNode: GuardFn = (format) => !isUnion(format) && ['React.ReactNode', 'JSX.Element'].includes(format);\n\nexport const isSomethingWithParenthesis: GuardFn = (format) =>\n  !isUnion(format) && format[0] === '(' && format.slice(-1) === ')';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEhB,MAAM,kBAA2B,CAAC,WAAW,CAAC,UAAU,UAAU,SAAS,EAAE,SAAS,MAAM;AAC5F,MAAM,cAAuB,CAAC,WAAW,WAAW;AACpD,MAAM,SAAkB,CAAC,WAAW,WAAW;AAC/C,MAAM,UAAmB,CAAC,WAAW;AAC1C,MAAI,QAAQ;AACZ,MAAI,YAAY;AAChB,SAAO,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS;AACjC,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,SAAS,OAAO,UAAU,EAAG,aAAY;AAAA,EACpD,CAAC;AACD,SAAO;AACT;AAEO,MAAM,WAAoB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEpG,MAAM,UAAmB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,MAAM,EAAE,MAAM;AAE9E,MAAM,aAAsB,CAAC,WAClC,WAAW,YAAY,CAAC,QAAQ,MAAM,KAAK,OAAO,WAAW,mBAAmB;AAE3E,MAAM,WAAoB,CAAC,WAChC,WAAW,YAAa,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEjF,MAAM,aAAsB,CAAC,WAAW;AAE7C,MAAI,QAAQ,MAAM,EAAG,QAAO;AAE5B,MAAI,CAAC,OAAO,WAAW,IAAI,KAAK,OAAO,MAAM,EAAE,MAAM,IAAK,QAAO;AAIjE,MAAI,QAAQ;AACZ,MAAI,sBAAsB;AAC1B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,IAAI,OAAO,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,MAAM;AACjE,4BAAsB,uBAAuB,UAAU;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,cAAuB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,CAAC,mBAAmB,aAAa,EAAE,SAAS,MAAM;AAE/G,MAAM,6BAAsC,CAAC,WAClD,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;",
+  "sourcesContent": ["type GuardFn = (format: string) => boolean;\n\nexport const isPrimitiveType: GuardFn = (format) => ['string', 'number', 'boolean'].includes(format);\nexport const isUndefined: GuardFn = (format) => format === '\"undefined\"';\nexport const isNull: GuardFn = (format) => format === '\"null\"';\nexport const isUnion: GuardFn = (format) => {\n  let depth = 0;\n  let satisfies = false;\n  format.split('').forEach((char) => {\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (char === '|' && depth === 0) satisfies = true;\n  });\n  return satisfies;\n};\n\nexport const isString: GuardFn = (format) => !isUnion(format) && format[0] === '\"' && format.slice(-1) === '\"';\n\nexport const isArray: GuardFn = (format) => !isUnion(format) && format.slice(-2) === '[]';\n\nexport const isObjectOf: GuardFn = (format) =>\n  format !== 'object' && !isUnion(format) && format.startsWith('{ [key: string]: ');\n\nexport const isObject: GuardFn = (format) =>\n  format === 'object' || (!isUnion(format) && format[0] === '{' && format.slice(-1) === '}');\n\nexport const isFunction: GuardFn = (format) => {\n  // It's isn't an union\n  if (isUnion(format)) return false;\n  // Has to start with (( and end with )\n  if (!format.startsWith('((') && format.slice(-1) !== ')') return false;\n\n  // The arrow MUST occur at depth 1 (when couting parenthesis)\n  // Otherwise the only possibility is that we have \"something with parenthesis\" (look down below)\n  let depth = 0;\n  let arrowOccursAtDepth1 = false;\n  for (let i = 0; i < format.length; i += 1) {\n    const char = format[i];\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (i < format.length - 1 && format.slice(i, i + 2) === '=>') {\n      arrowOccursAtDepth1 = arrowOccursAtDepth1 || depth === 1;\n    }\n  }\n  return arrowOccursAtDepth1;\n};\n\nexport const isJSXorNode: GuardFn = (format) => !isUnion(format) && ['React.ReactNode', 'JSX.Element'].includes(format);\n\nexport const isReactComponentType: GuardFn = (format) =>\n  !isUnion(format) && format === 'React.ComponentType<Record<string,unknown>>';\n\nexport const isSomethingWithParenthesis: GuardFn = (format) =>\n  !isUnion(format) && format[0] === '(' && format.slice(-1) === ')';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEhB,MAAM,kBAA2B,CAAC,WAAW,CAAC,UAAU,UAAU,SAAS,EAAE,SAAS,MAAM;AAC5F,MAAM,cAAuB,CAAC,WAAW,WAAW;AACpD,MAAM,SAAkB,CAAC,WAAW,WAAW;AAC/C,MAAM,UAAmB,CAAC,WAAW;AAC1C,MAAI,QAAQ;AACZ,MAAI,YAAY;AAChB,SAAO,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS;AACjC,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,SAAS,OAAO,UAAU,EAAG,aAAY;AAAA,EACpD,CAAC;AACD,SAAO;AACT;AAEO,MAAM,WAAoB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEpG,MAAM,UAAmB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,MAAM,EAAE,MAAM;AAE9E,MAAM,aAAsB,CAAC,WAClC,WAAW,YAAY,CAAC,QAAQ,MAAM,KAAK,OAAO,WAAW,mBAAmB;AAE3E,MAAM,WAAoB,CAAC,WAChC,WAAW,YAAa,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEjF,MAAM,aAAsB,CAAC,WAAW;AAE7C,MAAI,QAAQ,MAAM,EAAG,QAAO;AAE5B,MAAI,CAAC,OAAO,WAAW,IAAI,KAAK,OAAO,MAAM,EAAE,MAAM,IAAK,QAAO;AAIjE,MAAI,QAAQ;AACZ,MAAI,sBAAsB;AAC1B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,IAAI,OAAO,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,MAAM;AACjE,4BAAsB,uBAAuB,UAAU;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,cAAuB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,CAAC,mBAAmB,aAAa,EAAE,SAAS,MAAM;AAE/G,MAAM,uBAAgC,CAAC,WAC5C,CAAC,QAAQ,MAAM,KAAK,WAAW;AAE1B,MAAM,6BAAsC,CAAC,WAClD,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;",
   "names": []
 }

package/dist/cjs/validation/typescriptValidator.js

@@ -170,6 +170,8 @@ const validateValueWithFormat = (schemaName, key, value, format, validationsMemo
     validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if ((0, import_typescriptGuards.isFunction)(format)) {
     validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
+  } else if ((0, import_typescriptGuards.isReactComponentType)(format)) {
+    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if ((0, import_typescriptGuards.isJSXorNode)(format)) {
     validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if ((0, import_typescriptGuards.isSomethingWithParenthesis)(format)) {

package/dist/cjs/validation/typescriptValidator.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/validation/typescriptValidator.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["/* eslint-disable complexity */\n/* eslint-disable max-lines */\n/* eslint-disable max-params */\nimport type { PropsWithChildren, WeakValidationMap } from 'react';\nimport { useMemo, useRef } from 'react';\nimport type { TypescriptDocumentation } from '../propTypes/types.js';\nimport { describe } from '../propTypes/index.js';\nimport { throwRequiredError, throwTypeError } from './errorTemplates.js';\nimport {\n  isArray,\n  isFunction,\n  isJSXorNode,\n  isObject,\n  isPrimitiveType,\n  isSomethingWithParenthesis,\n  isString,\n  isUnion,\n  isUndefined,\n  isNull,\n  isObjectOf,\n} from './typescriptGuards.js';\nimport { typescriptObjectParser } from './typescriptParsers.js';\n\ntype ValidatorFn = (\n  schemaName: string,\n  key: string,\n  value: unknown,\n  format: string,\n  validationsMemo: Record<symbol, string>,\n  nextValidationsMemo: Record<symbol, string>,\n) => void;\n\n// =============================================================================\n// Atom Validators\n// =============================================================================\n\n// This functions will validate something from the data\n// and optionally recursively apply `validateValueWithFormat`\n// in smaller parts\n\nconst validateUndefined: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== undefined || value === 'undefined') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validateNull: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== null || value === 'null') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validatePrimitiveType: ValidatorFn = (schemaName, key, value, format) => {\n  if (typeof value !== format) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateString: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== format.slice(1, -1)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateArray: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  // Check that we have an array\n  if (!Array.isArray(value)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n\n  // Check that each element inside satisfies the format\n  (value as unknown[]).forEach((val, index) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${index}]`,\n      val,\n      format.slice(0, -2),\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\nfunction isObjectType(value: unknown): value is Record<string, unknown> {\n  return !(typeof value !== 'object' || Array.isArray(value));\n}\n\nconst validateObjectOf: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  const valuesFormat = format.slice('{ [key: string]: '.length, -2);\n\n  Object.keys(value).forEach((objectKey) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${objectKey}]`,\n      value[objectKey],\n      valuesFormat,\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\n\nconst validateObject: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  if (format === 'object') return;\n\n  const keyValuePairs = typescriptObjectParser(format);\n  // Now we have the key - value pairs\n  // Each key could either be required or not\n  // Just recursively check the object\n\n  keyValuePairs.forEach(([objectKey, objectValue]) => {\n    const trueKey = objectKey.slice(-1) === '?' ? objectKey.slice(0, -1) : objectKey;\n\n    if (trueKey === objectKey && !(trueKey in value)) {\n      throwRequiredError(schemaName, trueKey);\n    }\n\n    if (trueKey in value) {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(\n        schemaName,\n        `${key}[${trueKey}]`,\n        value[trueKey],\n        objectValue,\n        validationsMemo,\n        nextValidationsMemo,\n      );\n    }\n  });\n};\n\nconst validateUnion: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const possibilities = format.split(/\\s?\\|\\s?/);\n\n  const errors = [];\n\n  possibilities.forEach((possibility) => {\n    try {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(schemaName, key, value, possibility, validationsMemo, nextValidationsMemo);\n    } catch (e) {\n      errors.push(e);\n    }\n  });\n\n  if (errors.length === possibilities.length) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateFunction: ValidatorFn = (schemaName, key, value, format) => {\n  // Check that we have a function\n  if (typeof value !== 'function') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nfunction isJSXElement(value: unknown): value is JSX.Element {\n  return value === null || (typeof value === 'object' && value !== null && '$$typeof' in value);\n}\nconst validateJSXorNode: ValidatorFn = (schemaName, key, value, format) => {\n  const valueIsJSX = isJSXElement(value);\n  if (format === 'JSX.Element' && !valueIsJSX) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\n// =============================================================================\n// Schema validator\n// =============================================================================\n\nconst validateValueWithFormat: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  nextValidationsMemo[value as symbol] = format;\n\n  if ((value as symbol) in validationsMemo) {\n    // We already validated this value on this format\n    return;\n  }\n\n  if (isUndefined(format)) {\n    validateUndefined(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isNull(format)) {\n    validateNull(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isPrimitiveType(format)) {\n    validatePrimitiveType(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isUnion(format)) {\n    validateUnion(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isString(format)) {\n    validateString(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isArray(format)) {\n    validateArray(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObjectOf(format)) {\n    validateObjectOf(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObject(format)) {\n    validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isFunction(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isJSXorNode(format)) {\n    validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isSomethingWithParenthesis(format)) {\n    validateValueWithFormat(schemaName, key, value, format.slice(1, -1), validationsMemo, nextValidationsMemo);\n  }\n};\n\nexport const validateTypescriptPropTypesImplementation = (\n  props: PropsWithChildren<Record<string, unknown>>,\n  schema: TypescriptDocumentation,\n  validationsMemo: Record<string, string> = {},\n  nextValidationsMemo: Record<string, string> = {},\n): void => {\n  const { properties, name: schemaName } = schema;\n\n  properties.forEach((property) => {\n    const { name, format, required, isRequiredIf, omitValidation } = property;\n\n    const requiredConditionally = isRequiredIf && isRequiredIf(props);\n\n    if (omitValidation) {\n      return;\n    }\n\n    if (required && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    if (requiredConditionally && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    const shouldValidateProperty = props[name] !== undefined || required || requiredConditionally;\n\n    if (name in props && format && shouldValidateProperty) {\n      validateValueWithFormat(schemaName, name, props[name], format, validationsMemo, nextValidationsMemo);\n    }\n  });\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const useValidateTypescriptPropTypes = <T = Record<string, any>>(\n  props: PropsWithChildren<T>,\n  propTypes: WeakValidationMap<unknown>,\n  componentDisplayName: string,\n): void => {\n  if (!componentDisplayName) {\n    throw new Error('Provide display name for the component to use for validation');\n  }\n\n  const validationsMemo = useRef<Record<string, string>>({});\n\n  const typescriptSchema = useMemo(() => {\n    const Component = () => {};\n\n    const DescribedComponent = describe(Component);\n    DescribedComponent.propTypes = propTypes;\n    DescribedComponent.displayName = componentDisplayName;\n    return DescribedComponent.toTypescript();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [propTypes]);\n\n  useMemo(() => {\n    const nextValidationsMemo = {};\n\n    validateTypescriptPropTypesImplementation(props, typescriptSchema, validationsMemo.current, nextValidationsMemo);\n    validationsMemo.current = nextValidationsMemo;\n    return 'WE DONT NEED RETURN just the memo';\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [props]);\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": "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",
+  "sourcesContent": ["/* eslint-disable complexity */\n/* eslint-disable max-lines */\n/* eslint-disable max-params */\nimport type { PropsWithChildren, WeakValidationMap } from 'react';\nimport { useMemo, useRef } from 'react';\nimport type { TypescriptDocumentation } from '../propTypes/types.js';\nimport { describe } from '../propTypes/index.js';\nimport { throwRequiredError, throwTypeError } from './errorTemplates.js';\nimport {\n  isArray,\n  isFunction,\n  isJSXorNode,\n  isObject,\n  isReactComponentType,\n  isPrimitiveType,\n  isSomethingWithParenthesis,\n  isString,\n  isUnion,\n  isUndefined,\n  isNull,\n  isObjectOf,\n} from './typescriptGuards.js';\nimport { typescriptObjectParser } from './typescriptParsers.js';\n\ntype ValidatorFn = (\n  schemaName: string,\n  key: string,\n  value: unknown,\n  format: string,\n  validationsMemo: Record<symbol, string>,\n  nextValidationsMemo: Record<symbol, string>,\n) => void;\n\n// =============================================================================\n// Atom Validators\n// =============================================================================\n\n// This functions will validate something from the data\n// and optionally recursively apply `validateValueWithFormat`\n// in smaller parts\n\nconst validateUndefined: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== undefined || value === 'undefined') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validateNull: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== null || value === 'null') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validatePrimitiveType: ValidatorFn = (schemaName, key, value, format) => {\n  if (typeof value !== format) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateString: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== format.slice(1, -1)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateArray: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  // Check that we have an array\n  if (!Array.isArray(value)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n\n  // Check that each element inside satisfies the format\n  (value as unknown[]).forEach((val, index) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${index}]`,\n      val,\n      format.slice(0, -2),\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\nfunction isObjectType(value: unknown): value is Record<string, unknown> {\n  return !(typeof value !== 'object' || Array.isArray(value));\n}\n\nconst validateObjectOf: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  const valuesFormat = format.slice('{ [key: string]: '.length, -2);\n\n  Object.keys(value).forEach((objectKey) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${objectKey}]`,\n      value[objectKey],\n      valuesFormat,\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\n\nconst validateObject: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  if (format === 'object') return;\n\n  const keyValuePairs = typescriptObjectParser(format);\n  // Now we have the key - value pairs\n  // Each key could either be required or not\n  // Just recursively check the object\n\n  keyValuePairs.forEach(([objectKey, objectValue]) => {\n    const trueKey = objectKey.slice(-1) === '?' ? objectKey.slice(0, -1) : objectKey;\n\n    if (trueKey === objectKey && !(trueKey in value)) {\n      throwRequiredError(schemaName, trueKey);\n    }\n\n    if (trueKey in value) {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(\n        schemaName,\n        `${key}[${trueKey}]`,\n        value[trueKey],\n        objectValue,\n        validationsMemo,\n        nextValidationsMemo,\n      );\n    }\n  });\n};\n\nconst validateUnion: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const possibilities = format.split(/\\s?\\|\\s?/);\n\n  const errors = [];\n\n  possibilities.forEach((possibility) => {\n    try {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(schemaName, key, value, possibility, validationsMemo, nextValidationsMemo);\n    } catch (e) {\n      errors.push(e);\n    }\n  });\n\n  if (errors.length === possibilities.length) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateFunction: ValidatorFn = (schemaName, key, value, format) => {\n  // Check that we have a function\n  if (typeof value !== 'function') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nfunction isJSXElement(value: unknown): value is JSX.Element {\n  return value === null || (typeof value === 'object' && value !== null && '$$typeof' in value);\n}\nconst validateJSXorNode: ValidatorFn = (schemaName, key, value, format) => {\n  const valueIsJSX = isJSXElement(value);\n  if (format === 'JSX.Element' && !valueIsJSX) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\n// =============================================================================\n// Schema validator\n// =============================================================================\n\nconst validateValueWithFormat: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  nextValidationsMemo[value as symbol] = format;\n\n  if ((value as symbol) in validationsMemo) {\n    // We already validated this value on this format\n    return;\n  }\n\n  if (isUndefined(format)) {\n    validateUndefined(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isNull(format)) {\n    validateNull(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isPrimitiveType(format)) {\n    validatePrimitiveType(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isUnion(format)) {\n    validateUnion(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isString(format)) {\n    validateString(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isArray(format)) {\n    validateArray(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObjectOf(format)) {\n    validateObjectOf(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObject(format)) {\n    validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isFunction(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isReactComponentType(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isJSXorNode(format)) {\n    validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isSomethingWithParenthesis(format)) {\n    validateValueWithFormat(schemaName, key, value, format.slice(1, -1), validationsMemo, nextValidationsMemo);\n  }\n};\n\nexport const validateTypescriptPropTypesImplementation = (\n  props: PropsWithChildren<Record<string, unknown>>,\n  schema: TypescriptDocumentation,\n  validationsMemo: Record<string, string> = {},\n  nextValidationsMemo: Record<string, string> = {},\n): void => {\n  const { properties, name: schemaName } = schema;\n\n  properties.forEach((property) => {\n    const { name, format, required, isRequiredIf, omitValidation } = property;\n\n    const requiredConditionally = isRequiredIf && isRequiredIf(props);\n\n    if (omitValidation) {\n      return;\n    }\n\n    if (required && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    if (requiredConditionally && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    const shouldValidateProperty = props[name] !== undefined || required || requiredConditionally;\n\n    if (name in props && format && shouldValidateProperty) {\n      validateValueWithFormat(schemaName, name, props[name], format, validationsMemo, nextValidationsMemo);\n    }\n  });\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const useValidateTypescriptPropTypes = <T = Record<string, any>>(\n  props: PropsWithChildren<T>,\n  propTypes: WeakValidationMap<unknown>,\n  componentDisplayName: string,\n): void => {\n  if (!componentDisplayName) {\n    throw new Error('Provide display name for the component to use for validation');\n  }\n\n  const validationsMemo = useRef<Record<string, string>>({});\n\n  const typescriptSchema = useMemo(() => {\n    const Component = () => {};\n\n    const DescribedComponent = describe(Component);\n    DescribedComponent.propTypes = propTypes;\n    DescribedComponent.displayName = componentDisplayName;\n    return DescribedComponent.toTypescript();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [propTypes]);\n\n  useMemo(() => {\n    const nextValidationsMemo = {};\n\n    validateTypescriptPropTypesImplementation(props, typescriptSchema, validationsMemo.current, nextValidationsMemo);\n    validationsMemo.current = nextValidationsMemo;\n    return 'WE DONT NEED RETURN just the memo';\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [props]);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/xstyledProps/useGetXstyledProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/xstyledProps/useGetXstyledProps.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemo } from 'react';\nimport type {\n  SizingProps,\n  SpaceProps,\n  LayoutProps,\n  BoxShadowProps,\n  BorderProps,\n  BackgroundProps,\n  FontWeightProps,\n  TextAlignProps,\n} from '@elliemae/ds-system';\nimport { xstyledKeys } from './constants.js';\n\nexport interface XstyledProps\n  extends SpaceProps,\n    SizingProps,\n    LayoutProps,\n    BoxShadowProps,\n    BorderProps,\n    BackgroundProps,\n    FontWeightProps,\n    TextAlignProps {}\n\ntype PropsWithXstyled<T> = T & XstyledProps;\n\nexport const getXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps => {\n  const xstyledPropsObject: Record<string, unknown> = {};\n  Object.entries(props).forEach(([key, value]) => {\n    if (key in xstyledKeys) {\n      xstyledPropsObject[key] = value;\n    }\n  });\n  return xstyledPropsObject;\n};\n\nexport const useGetXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps =>\n  useMemo(() => getXstyledProps(props), [props]);\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AAWxB,uBAA4B;AAcrB,MAAM,kBAAkB,CAAK,UAA6C;AAC/E,QAAM,qBAA8C,CAAC;AACrD,SAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,QAAI,OAAO,8BAAa;AACtB,yBAAmB,GAAG,IAAI;AAAA,IAC5B;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,MAAM,qBAAqB,CAAK,cACrC,sBAAQ,MAAM,gBAAgB,KAAK,GAAG,CAAC,KAAK,CAAC;",
+  "sourcesContent": ["import { useMemo } from 'react';\nimport type {\n  SizingProps,\n  SpaceProps,\n  LayoutProps,\n  BoxShadowProps,\n  BorderProps,\n  BackgroundProps,\n  FontWeightProps,\n  TextAlignProps,\n} from '@elliemae/ds-system';\nimport { xstyledKeys } from './constants.js';\n\nexport interface XstyledProps\n  extends\n    SpaceProps,\n    SizingProps,\n    LayoutProps,\n    BoxShadowProps,\n    BorderProps,\n    BackgroundProps,\n    FontWeightProps,\n    TextAlignProps {}\n\ntype PropsWithXstyled<T> = T & XstyledProps;\n\nexport const getXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps => {\n  const xstyledPropsObject: Record<string, unknown> = {};\n  Object.entries(props).forEach(([key, value]) => {\n    if (key in xstyledKeys) {\n      xstyledPropsObject[key] = value;\n    }\n  });\n  return xstyledPropsObject;\n};\n\nexport const useGetXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps =>\n  useMemo(() => getXstyledProps(props), [props]);\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAwB;AAWxB,uBAA4B;AAerB,MAAM,kBAAkB,CAAK,UAA6C;AAC/E,QAAM,qBAA8C,CAAC;AACrD,SAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,QAAI,OAAO,8BAAa;AACtB,yBAAmB,GAAG,IAAI;AAAA,IAC5B;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,MAAM,qBAAqB,CAAK,cACrC,sBAAQ,MAAM,gBAAgB,KAAK,GAAG,CAAC,KAAK,CAAC;",
   "names": []
 }

package/dist/esm/contractProps/getContractProps.js

@@ -0,0 +1,17 @@
+import * as React from "react";
+const DOCUMENTATION_ONLY_SCHEMA_KEYS = /* @__PURE__ */ new Set(["aria-*", "on-*", "data-*", "all HTML attributes"]);
+const getContractProps = (props, contractShape) => {
+  const declaredKeys = new Set(Object.keys(contractShape).filter((key) => !DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)));
+  const contractProps = {};
+  Object.entries(props).forEach(([key, value]) => {
+    if (value === void 0) return;
+    if (DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)) return;
+    if (!declaredKeys.has(key) && !key.startsWith("data-")) return;
+    contractProps[key] = value;
+  });
+  return contractProps;
+};
+export {
+  getContractProps
+};
+//# sourceMappingURL=getContractProps.js.map

package/dist/esm/contractProps/getContractProps.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/contractProps/getContractProps.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/**\n * Documentation-only entries that live in `globalAttributesPropTypes` (and therefore in every\n * component schema that spreads it). They exist so the Storybook props table can show \"you may pass\n * any aria-* / data-* / on-* / HTML attribute\" in a single row \u2014 they are NOT prop names a consumer\n * can ever pass, so they must never be treated as part of the runtime key set.\n */\nconst DOCUMENTATION_ONLY_SCHEMA_KEYS = new Set(['aria-*', 'on-*', 'data-*', 'all HTML attributes']);\n\n/**\n * Filters an arbitrary object down to the props a component's contract declares.\n *\n * This is the engine behind each package's own curated passthrough utility (e.g. ds-app-picker's\n * `getDSAppPickerContractProps`). Packages are expected to expose a bound utility rather than their\n * schema: the schema stays an internal implementation detail, so the two can drift later without\n * expanding anyone's public API.\n *\n * Three behaviours worth knowing, because callers depend on them:\n *\n * 1. **Documentation-only wildcard keys are ignored.** See `DOCUMENTATION_ONLY_SCHEMA_KEYS`.\n * 2. **`data-*` is honoured by prefix**, matching `getGlobalAttributes` \u2014 arbitrary data attributes\n *    are a supported consumer surface even though no schema can enumerate them. Note the house\n *    behaviour deliberately does not extend the same courtesy to `aria-*` or `on*`: those are\n *    matched against the schema's explicit list, so a typo fails loudly instead of reaching the DOM.\n * 3. **`undefined` is dropped, `null` is forwarded.** These two are not interchangeable, and the rule\n *    follows React rather than being invented here:\n *\n *    - React's own default resolution (`resolveDefaultProps`) applies a `defaultProps` entry only when\n *      the incoming prop is `undefined`; a `null` is respected as an explicitly supplied value. This\n *      is the same rule as JS destructuring defaults and ES6 default parameters \u2014 a language-level\n *      standard, not a React invention. So `undefined` means \"I am not defining this, you decide\" and\n *      `null` means \"I am defining it, as nothing\".\n *    - Everywhere React *consumes* a value rather than defaulting it \u2014 DOM attributes, children, event\n *      handlers \u2014 it collapses the two and treats both as absent. The distinction is load-bearing\n *      only at a default-resolution boundary.\n *\n *    A contract passthrough is exactly such a boundary: the result is spread *after* a wrapper's own\n *    defaults, so dropping `undefined` is what stops an unset key from erasing a working default,\n *    while forwarding `null` is what lets a consumer deliberately override one. This matters more\n *    here than in plain React, because Dimsum's `useMemoMergePropsWithDefault` is a plain\n *    `{...defaults, ...props}` spread \u2014 it does NOT skip `undefined` the way `resolveDefaultProps`\n *    does, so an `undefined` that reaches it clobbers the component's default too.\n *\n *    What happens to a forwarded `null` afterwards is the receiving component's business, not this\n *    function's. Dimsum components are strictly typed: `validateTypescriptPropTypesImplementation`\n *    validates any value that is not `undefined`, and a prop declared as a function does not admit\n *    `null` \u2014 so passing `null` there raises a prop-type error, correctly. A prop only accepts `null`\n *    if its own declared type says so and its code carries the matching null guards. Where a consumer\n *    wants to state \"do nothing\", the type-honouring way to say it is an explicit no-op \u2014 `() => {}`\n *    for a handler, `() => null` for a component \u2014 which is unambiguous in a way that `null` is not.\n *    This function stays out of that decision: forwarding the value and letting the owning contract\n *    judge it is the correct division of concerns at this abstraction level.\n *\n * @param props - the object to filter; anything the contract does not declare is discarded\n * @param contractShape - any object whose KEYS name the contract's props. Only `Object.keys` is read,\n *   so it is deliberately not narrowed to `DSPropTypesSchema`\n *\n * a PropTypes schema is usually fine and there is a code dedicated to discarding the global attributes to make the schema compatible for faster internal transition/implementation.\n * @returns a new object containing only the declared, defined props\n */\nexport const getContractProps = <ContractProps>(props: object, contractShape: object): Partial<ContractProps> => {\n  const declaredKeys = new Set(Object.keys(contractShape).filter((key) => !DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)));\n\n  // `props` is typed as `object` rather than `Record<string, unknown>` so callers can pass their own\n  // declared prop interfaces without a cast at every call site. The casts live here instead.\n  const contractProps: Record<string, unknown> = {};\n\n  Object.entries(props as Record<string, unknown>).forEach(([key, value]) => {\n    if (value === undefined) return;\n    // Order matters: 'data-*' is itself prefixed with 'data-', so the documentation-only check has\n    // to win over the prefix rule below or the pseudo-key would readmit itself.\n    if (DOCUMENTATION_ONLY_SCHEMA_KEYS.has(key)) return;\n    if (!declaredKeys.has(key) && !key.startsWith('data-')) return;\n    contractProps[key] = value;\n  });\n\n  return contractProps as Partial<ContractProps>;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACMvB,MAAM,iCAAiC,oBAAI,IAAI,CAAC,UAAU,QAAQ,UAAU,qBAAqB,CAAC;AAqD3F,MAAM,mBAAmB,CAAgB,OAAe,kBAAkD;AAC/G,QAAM,eAAe,IAAI,IAAI,OAAO,KAAK,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;AAIjH,QAAM,gBAAyC,CAAC;AAEhD,SAAO,QAAQ,KAAgC,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,QAAI,UAAU,OAAW;AAGzB,QAAI,+BAA+B,IAAI,GAAG,EAAG;AAC7C,QAAI,CAAC,aAAa,IAAI,GAAG,KAAK,CAAC,IAAI,WAAW,OAAO,EAAG;AACxD,kBAAc,GAAG,IAAI;AAAA,EACvB,CAAC;AAED,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/contractProps/index.js

@@ -0,0 +1,6 @@
+import * as React from "react";
+import { getContractProps } from "./getContractProps.js";
+export {
+  getContractProps
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/contractProps/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/contractProps/index.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { getContractProps } from './getContractProps.js';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,wBAAwB;",
+  "names": []
+}

package/dist/esm/index.js

@@ -15,6 +15,7 @@ import {
 } from "./validation/index.js";
 import { useGetXstyledProps, xstyledPropTypes, getXstyledProps } from "./xstyledProps/index.js";
 import { useDeprecateComponent } from "./useDeprecateComponent/index.js";
+import { getContractProps } from "./contractProps/index.js";
 import { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from "./propsPerDataTestId/index.js";
 import { getPropsPerSlotPropTypes } from "./propsPerSlot/index.js";
 import { useOwnerProps } from "./useOwnerProps/index.js";
@@ -22,6 +23,7 @@ export {
   PropTypes,
   describe,
   getAriaProps,
+  getContractProps,
   getDataProps,
   getGlobalAttributes,
   getPropsPerDatatestIdPropTypes,

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/index.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { useMemoMergePropsWithDefault } from './defaultProps/index.js';\nexport { getAriaProps, getDataProps } from './getProps/index.js';\nexport {\n  getGlobalAttributes,\n  useGetGlobalAttributes,\n  globalAttributesPropTypes,\n  type GlobalAttributesT,\n} from './globalProps/index.js';\nexport { describe, PropTypes, type DSPropTypesSchema } from './propTypes/index.js';\nexport type { ValidationMap } from 'prop-types';\nexport {\n  throwTypeError,\n  throwRequiredError,\n  useValidateTypescriptPropTypes,\n  validateTypescriptPropTypesImplementation,\n} from './validation/index.js';\nexport { type XstyledProps, useGetXstyledProps, xstyledPropTypes, getXstyledProps } from './xstyledProps/index.js';\nexport { useDeprecateComponent } from './useDeprecateComponent/index.js';\n\nexport { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from './propsPerDataTestId/index.js';\nexport { getPropsPerSlotPropTypes } from './propsPerSlot/index.js';\nexport { useOwnerProps } from './useOwnerProps/index.js';\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,oCAAoC;AAC7C,SAAS,cAAc,oBAAoB;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,UAAU,iBAAyC;AAE5D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAA4B,oBAAoB,kBAAkB,uBAAuB;AACzF,SAAS,6BAA6B;AAEtC,SAAS,uBAAuB,sCAAsC;AACtE,SAAS,gCAAgC;AACzC,SAAS,qBAAqB;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { useMemoMergePropsWithDefault } from './defaultProps/index.js';\nexport { getAriaProps, getDataProps } from './getProps/index.js';\nexport {\n  getGlobalAttributes,\n  useGetGlobalAttributes,\n  globalAttributesPropTypes,\n  type GlobalAttributesT,\n} from './globalProps/index.js';\nexport { describe, PropTypes, type DSPropTypesSchema } from './propTypes/index.js';\nexport type { ValidationMap } from 'prop-types';\nexport {\n  throwTypeError,\n  throwRequiredError,\n  useValidateTypescriptPropTypes,\n  validateTypescriptPropTypesImplementation,\n} from './validation/index.js';\nexport { type XstyledProps, useGetXstyledProps, xstyledPropTypes, getXstyledProps } from './xstyledProps/index.js';\nexport { useDeprecateComponent } from './useDeprecateComponent/index.js';\n\nexport { getContractProps } from './contractProps/index.js';\nexport { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from './propsPerDataTestId/index.js';\nexport { getPropsPerSlotPropTypes } from './propsPerSlot/index.js';\nexport { useOwnerProps } from './useOwnerProps/index.js';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,oCAAoC;AAC7C,SAAS,cAAc,oBAAoB;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,UAAU,iBAAyC;AAE5D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAA4B,oBAAoB,kBAAkB,uBAAuB;AACzF,SAAS,6BAA6B;AAEtC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB,sCAAsC;AACtE,SAAS,gCAAgC;AACzC,SAAS,qBAAqB;",
   "names": []
 }

package/dist/esm/package.json

@@ -1,7 +1,4 @@
 {
   "type": "module",
-  "sideEffects": [],
-  "publishConfig": {
-    "access": "public"
-  }
+  "sideEffects": []
 }

package/dist/esm/propTypes/PropTypes.js

@@ -92,6 +92,7 @@ definePropType("any");
 definePropType("array");
 definePropType("bool");
 definePropType("element");
+definePropType("elementType");
 definePropType("func");
 definePropType("node");
 definePropType("number");

package/dist/esm/propTypes/PropTypes.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/propTypes/PropTypes.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type { PropTypesTypes, DocumentedPropType, ReactDescObjT, PropTypesObj } from './types.js';\n\nconst addPropTypeDocumentationField = <T extends keyof ReactDescObjT>(fieldName: T) =>\n  function addFieldToReactDesc(this: DocumentedPropType, value: ReactDescObjT[T]): DocumentedPropType {\n    if (!this.reactDesc) {\n      this.reactDesc = {};\n    }\n    let realValue = value;\n    if (\n      fieldName === 'global' ||\n      fieldName === 'dataTestId' ||\n      fieldName === 'hidden' ||\n      fieldName === 'xstyled' ||\n      fieldName === 'omitValidation'\n    )\n      realValue = true;\n\n    this.reactDesc[fieldName] = realValue;\n    return this;\n  };\n\nconst documentedPropType: Omit<DocumentedPropType, 'type' | 'isRequired' | 'reactDesc'> = {\n  defaultValue: addPropTypeDocumentationField('defaultValue'),\n  description: addPropTypeDocumentationField('description'),\n  deprecated: addPropTypeDocumentationField('deprecated'),\n  format: addPropTypeDocumentationField('format'),\n  signature: addPropTypeDocumentationField('signature'),\n  global: addPropTypeDocumentationField('global'),\n  omitValidation: addPropTypeDocumentationField('omitValidation'),\n  hidden: addPropTypeDocumentationField('hidden'),\n  dataTestId: addPropTypeDocumentationField('dataTestId'),\n  xstyled: addPropTypeDocumentationField('xstyled'),\n  isRequiredIf: addPropTypeDocumentationField('isRequiredIf'),\n};\n\nconst createPropType = (type: PropTypesTypes) => {\n  const propTypeObj = {\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n\n  return propTypeObj;\n};\n\nconst createPropTypeWithArgs = (type: PropTypesTypes) => (args: unknown) => {\n  const propTypeObj = {\n    args,\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n  return propTypeObj;\n};\n\nconst PropTypes = {\n  custom: (callback: CallableFunction) => {\n    const target = callback.bind(null) as CallableFunction & DocumentedPropType;\n    target.type = 'func';\n    Object.keys(documentedPropType).forEach((fieldName) => {\n      const fieldNameCasted = fieldName as keyof DocumentedPropType;\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n      (target[fieldNameCasted] as unknown) = documentedPropType[fieldNameCasted] as unknown;\n    });\n    return target;\n  },\n} as unknown as PropTypesObj;\n\nfunction definePropType(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropType(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\nfunction definePropTypeWithArgs(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropTypeWithArgs(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\ndefinePropType('any');\ndefinePropType('array');\ndefinePropType('bool');\ndefinePropType('element');\ndefinePropType('func');\ndefinePropType('node');\ndefinePropType('number');\ndefinePropType('object');\ndefinePropType('symbol');\ndefinePropType('string');\n\ndefinePropTypeWithArgs('arrayOf');\ndefinePropTypeWithArgs('instanceOf');\ndefinePropTypeWithArgs('objectOf');\ndefinePropTypeWithArgs('oneOfType');\ndefinePropTypeWithArgs('oneOf');\ndefinePropTypeWithArgs('shape');\ndefinePropTypeWithArgs('tuple');\n\nexport default PropTypes;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type { PropTypesTypes, DocumentedPropType, ReactDescObjT, PropTypesObj } from './types.js';\n\nconst addPropTypeDocumentationField = <T extends keyof ReactDescObjT>(fieldName: T) =>\n  function addFieldToReactDesc(this: DocumentedPropType, value: ReactDescObjT[T]): DocumentedPropType {\n    if (!this.reactDesc) {\n      this.reactDesc = {};\n    }\n    let realValue = value;\n    if (\n      fieldName === 'global' ||\n      fieldName === 'dataTestId' ||\n      fieldName === 'hidden' ||\n      fieldName === 'xstyled' ||\n      fieldName === 'omitValidation'\n    )\n      realValue = true;\n\n    this.reactDesc[fieldName] = realValue;\n    return this;\n  };\n\nconst documentedPropType: Omit<DocumentedPropType, 'type' | 'isRequired' | 'reactDesc'> = {\n  defaultValue: addPropTypeDocumentationField('defaultValue'),\n  description: addPropTypeDocumentationField('description'),\n  deprecated: addPropTypeDocumentationField('deprecated'),\n  format: addPropTypeDocumentationField('format'),\n  signature: addPropTypeDocumentationField('signature'),\n  global: addPropTypeDocumentationField('global'),\n  omitValidation: addPropTypeDocumentationField('omitValidation'),\n  hidden: addPropTypeDocumentationField('hidden'),\n  dataTestId: addPropTypeDocumentationField('dataTestId'),\n  xstyled: addPropTypeDocumentationField('xstyled'),\n  isRequiredIf: addPropTypeDocumentationField('isRequiredIf'),\n};\n\nconst createPropType = (type: PropTypesTypes) => {\n  const propTypeObj = {\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n\n  return propTypeObj;\n};\n\nconst createPropTypeWithArgs = (type: PropTypesTypes) => (args: unknown) => {\n  const propTypeObj = {\n    args,\n    type,\n    ...documentedPropType,\n  };\n  Object.defineProperty(propTypeObj, 'isRequired', {\n    get: function getRequired(this: DocumentedPropType) {\n      if (!this.reactDesc) {\n        this.reactDesc = {};\n      }\n      this.reactDesc.required = true;\n      return this;\n    },\n    enumerable: true,\n    configurable: true,\n  });\n  return propTypeObj;\n};\n\nconst PropTypes = {\n  custom: (callback: CallableFunction) => {\n    const target = callback.bind(null) as CallableFunction & DocumentedPropType;\n    target.type = 'func';\n    Object.keys(documentedPropType).forEach((fieldName) => {\n      const fieldNameCasted = fieldName as keyof DocumentedPropType;\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n      (target[fieldNameCasted] as unknown) = documentedPropType[fieldNameCasted] as unknown;\n    });\n    return target;\n  },\n} as unknown as PropTypesObj;\n\nfunction definePropType(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropType(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\nfunction definePropTypeWithArgs(type: PropTypesTypes) {\n  Object.defineProperty(PropTypes, type, {\n    get: function getPropType() {\n      return createPropTypeWithArgs(type);\n    },\n    enumerable: true,\n    configurable: true,\n  });\n}\n\ndefinePropType('any');\ndefinePropType('array');\ndefinePropType('bool');\ndefinePropType('element');\ndefinePropType('elementType');\ndefinePropType('func');\ndefinePropType('node');\ndefinePropType('number');\ndefinePropType('object');\ndefinePropType('symbol');\ndefinePropType('string');\n\ndefinePropTypeWithArgs('arrayOf');\ndefinePropTypeWithArgs('instanceOf');\ndefinePropTypeWithArgs('objectOf');\ndefinePropTypeWithArgs('oneOfType');\ndefinePropTypeWithArgs('oneOf');\ndefinePropTypeWithArgs('shape');\ndefinePropTypeWithArgs('tuple');\n\nexport default PropTypes;\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/propTypes/toTypescript.js

@@ -12,7 +12,8 @@ const shapeFormat = (shape) => {
     } else {
       valueFormat = propTypeFormat(value);
     }
-    return `${key}${value.reactDesc && value.reactDesc.required ? "" : "?"}: ${valueFormat}`;
+    const deprecatedMarker = value.reactDesc?.deprecated ? `/** @deprecated v${value.reactDesc.deprecated.version} */ ` : "";
+    return `${deprecatedMarker}${key}${value.reactDesc && value.reactDesc.required ? "" : "?"}: ${valueFormat}`;
   });
   return `{${props.join(",")}}`;
 };
@@ -47,6 +48,9 @@ const propTypeFormat = (propType, joinWith = "") => {
       case "element":
         result = "JSX.Element";
         break;
+      case "elementType":
+        result = "React.ComponentType<Record<string,unknown>>";
+        break;
       case "instanceOf":
         result = "any";
         break;

package/dist/esm/propTypes/toTypescript.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/propTypes/toTypescript.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/restrict-template-expressions */\n/* eslint-disable @typescript-eslint/no-use-before-define */\n/* eslint-disable complexity */\n/* eslint-disable react/forbid-foreign-prop-types */\nimport type React from 'react';\nimport type { ComponentDocumentation, Hook, ReactDescT, TypescriptDocumentation } from './types.js';\nimport { isReactDesc } from './describeGuards.js';\n\nconst arrayFormat = (array: ReactDescT[]) => array.map((propType) => propTypeFormat(propType));\n\nconst shapeFormat = (shape: Record<string, ReactDescT>) => {\n  const props = Object.keys(shape).map((key) => {\n    const value = shape[key];\n    let valueFormat;\n    if (\n      value.type &&\n      (value.type === 'arrayOf' || value.type === 'oneOfType' || value.type === 'oneOf') &&\n      Array.isArray(value.args)\n    ) {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else if (value.type === 'shape') {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else {\n      valueFormat = propTypeFormat(value);\n    }\n    return `${key}${value.reactDesc && value.reactDesc.required ? '' : '?'}: ${valueFormat}`;\n  });\n  return `{${props.join(',')}}`;\n};\n\nconst propTypeFormat = (propType: ReactDescT | ReactDescT[], joinWith = ''): string => {\n  let result;\n  if (Array.isArray(propType)) {\n    result = arrayFormat(propType).join(joinWith);\n  } else if (typeof propType !== 'function' && propType.type) {\n    switch (propType.type) {\n      case 'array':\n        result = 'any[]';\n        break;\n      case 'arrayOf':\n        if ((propType.args as ReactDescT).type === 'oneOfType') {\n          result = `(${propTypeFormat(propType.args as ReactDescT, ' | ')})[]`;\n        } else {\n          result = `${propTypeFormat(propType.args as ReactDescT, '\\n')}[]`;\n        }\n        break;\n      case 'tuple':\n        result = `[${propTypeFormat(propType.args as ReactDescT, ', ')}]`;\n        break;\n      case 'bool':\n        result = 'boolean';\n        break;\n      case 'func':\n        result = propType?.reactDesc?.signature ?? '((...args: any[]) => any)';\n        break;\n      case 'node':\n        result = 'React.ReactNode';\n        break;\n      case 'element':\n        result = 'JSX.Element';\n        break;\n      case 'instanceOf':\n        result = 'any';\n        break;\n      case 'symbol':\n        result = 'any';\n        break;\n      case 'objectOf':\n        result = `{ [key: string]: ${propTypeFormat(propType.args as ReactDescT)} }`;\n        break;\n      case 'oneOf':\n        result = (propType.args as unknown[]).map((a) => `\"${a}\"`).join(' | ');\n        break;\n      case 'oneOfType':\n        result = `${propTypeFormat(propType.args as ReactDescT[], ' | ')}`;\n        break;\n      case 'shape':\n        result = `${shapeFormat(propType.args as Record<string, ReactDescT>)}`;\n        break;\n      default:\n        result = `${propType.type}`;\n        break;\n    }\n  } else {\n    result = 'any';\n  }\n  return result;\n};\n\nconst propTypeAsTypescript = (propType: ReactDescT, propName: string) => {\n  const documentation = {\n    ...propType.reactDesc,\n    name: propName,\n  };\n\n  documentation.format = propTypeFormat(propType);\n\n  return documentation;\n};\n\nexport default function descToTypescript<C, R>(\n  component: React.ComponentType<C> | Hook<C, R>,\n  reactDesc: ComponentDocumentation,\n) {\n  if (!component) {\n    throw new Error('react-desc: component is required');\n  }\n\n  const documentation: Partial<TypescriptDocumentation> = {\n    name: component.displayName || component.name,\n    ...reactDesc,\n  };\n  if (reactDesc) {\n    delete documentation.propTypes;\n\n    if (reactDesc.propTypes) {\n      const propTypes: TypescriptDocumentation['properties'] = [];\n      Object.keys(reactDesc.propTypes).forEach((propName) => {\n        const propType = reactDesc.propTypes[propName];\n        if (propType.type === 'shape') {\n          propType.reactDesc.group = {};\n\n          Object.keys(propType.args as Record<string, ReactDescT>).forEach((prop) => {\n            if (!propType.reactDesc.group) return;\n            propType.reactDesc.group[prop] = propTypeAsTypescript(\n              (propType.args as Record<string, ReactDescT>)[prop],\n              prop,\n            );\n          });\n        }\n        propTypes.push(propTypeAsTypescript(propType, propName));\n      });\n      if (propTypes.length > 0) {\n        documentation.properties = propTypes;\n      }\n    }\n    if (reactDesc.returnType) {\n      if (isReactDesc(reactDesc.returnType)) {\n        documentation.returns = propTypeAsTypescript(reactDesc.returnType, 'returns');\n      } else {\n        documentation.returns = Object.entries(reactDesc.returnType).map(([propName, propType]) =>\n          propTypeAsTypescript(propType, propName),\n        );\n      }\n    }\n  }\n  return documentation as TypescriptDocumentation;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/restrict-template-expressions */\n/* eslint-disable @typescript-eslint/no-use-before-define */\n/* eslint-disable complexity */\n/* eslint-disable react/forbid-foreign-prop-types */\nimport type React from 'react';\nimport type { ComponentDocumentation, Hook, ReactDescT, TypescriptDocumentation } from './types.js';\nimport { isReactDesc } from './describeGuards.js';\n\nconst arrayFormat = (array: ReactDescT[]) => array.map((propType) => propTypeFormat(propType));\n\nconst shapeFormat = (shape: Record<string, ReactDescT>) => {\n  const props = Object.keys(shape).map((key) => {\n    const value = shape[key];\n    let valueFormat;\n    if (\n      value.type &&\n      (value.type === 'arrayOf' || value.type === 'oneOfType' || value.type === 'oneOf') &&\n      Array.isArray(value.args)\n    ) {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else if (value.type === 'shape') {\n      valueFormat = `${propTypeFormat(value)}`;\n    } else {\n      valueFormat = propTypeFormat(value);\n    }\n    const deprecatedMarker = value.reactDesc?.deprecated\n      ? `/** @deprecated v${value.reactDesc.deprecated.version} */ `\n      : '';\n    return `${deprecatedMarker}${key}${value.reactDesc && value.reactDesc.required ? '' : '?'}: ${valueFormat}`;\n  });\n  return `{${props.join(',')}}`;\n};\n\nconst propTypeFormat = (propType: ReactDescT | ReactDescT[], joinWith = ''): string => {\n  let result;\n  if (Array.isArray(propType)) {\n    result = arrayFormat(propType).join(joinWith);\n  } else if (typeof propType !== 'function' && propType.type) {\n    switch (propType.type) {\n      case 'array':\n        result = 'any[]';\n        break;\n      case 'arrayOf':\n        if ((propType.args as ReactDescT).type === 'oneOfType') {\n          result = `(${propTypeFormat(propType.args as ReactDescT, ' | ')})[]`;\n        } else {\n          result = `${propTypeFormat(propType.args as ReactDescT, '\\n')}[]`;\n        }\n        break;\n      case 'tuple':\n        result = `[${propTypeFormat(propType.args as ReactDescT, ', ')}]`;\n        break;\n      case 'bool':\n        result = 'boolean';\n        break;\n      case 'func':\n        result = propType?.reactDesc?.signature ?? '((...args: any[]) => any)';\n        break;\n      case 'node':\n        result = 'React.ReactNode';\n        break;\n      case 'element':\n        result = 'JSX.Element';\n        break;\n      case 'elementType':\n        result = 'React.ComponentType<Record<string,unknown>>';\n        break;\n      case 'instanceOf':\n        result = 'any';\n        break;\n      case 'symbol':\n        result = 'any';\n        break;\n      case 'objectOf':\n        result = `{ [key: string]: ${propTypeFormat(propType.args as ReactDescT)} }`;\n        break;\n      case 'oneOf':\n        result = (propType.args as unknown[]).map((a) => `\"${a}\"`).join(' | ');\n        break;\n      case 'oneOfType':\n        result = `${propTypeFormat(propType.args as ReactDescT[], ' | ')}`;\n        break;\n      case 'shape':\n        result = `${shapeFormat(propType.args as Record<string, ReactDescT>)}`;\n        break;\n      default:\n        result = `${propType.type}`;\n        break;\n    }\n  } else {\n    result = 'any';\n  }\n  return result;\n};\n\nconst propTypeAsTypescript = (propType: ReactDescT, propName: string) => {\n  const documentation = {\n    ...propType.reactDesc,\n    name: propName,\n  };\n\n  documentation.format = propTypeFormat(propType);\n\n  return documentation;\n};\n\nexport default function descToTypescript<C, R>(\n  component: React.ComponentType<C> | Hook<C, R>,\n  reactDesc: ComponentDocumentation,\n) {\n  if (!component) {\n    throw new Error('react-desc: component is required');\n  }\n\n  const documentation: Partial<TypescriptDocumentation> = {\n    name: component.displayName || component.name,\n    ...reactDesc,\n  };\n  if (reactDesc) {\n    delete documentation.propTypes;\n\n    if (reactDesc.propTypes) {\n      const propTypes: TypescriptDocumentation['properties'] = [];\n      Object.keys(reactDesc.propTypes).forEach((propName) => {\n        const propType = reactDesc.propTypes[propName];\n        if (propType.type === 'shape') {\n          propType.reactDesc.group = {};\n\n          Object.keys(propType.args as Record<string, ReactDescT>).forEach((prop) => {\n            if (!propType.reactDesc.group) return;\n            propType.reactDesc.group[prop] = propTypeAsTypescript(\n              (propType.args as Record<string, ReactDescT>)[prop],\n              prop,\n            );\n          });\n        }\n        propTypes.push(propTypeAsTypescript(propType, propName));\n      });\n      if (propTypes.length > 0) {\n        documentation.properties = propTypes;\n      }\n    }\n    if (reactDesc.returnType) {\n      if (isReactDesc(reactDesc.returnType)) {\n        documentation.returns = propTypeAsTypescript(reactDesc.returnType, 'returns');\n      } else {\n        documentation.returns = Object.entries(reactDesc.returnType).map(([propName, propType]) =>\n          propTypeAsTypescript(propType, propName),\n        );\n      }\n    }\n  }\n  return documentation as TypescriptDocumentation;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/useOwnerProps/index.js

@@ -1,9 +1,9 @@
 import * as React from "react";
-import { useCallback } from "react";
+import { useCallback, useMemo } from "react";
 const useOwnerProps = (props, args) => {
   const getOwnerProps = useCallback(() => props, [props]);
   const getOwnerPropsArguments = useCallback(() => args ?? {}, [args]);
-  return { getOwnerProps, getOwnerPropsArguments };
+  return useMemo(() => ({ getOwnerProps, getOwnerPropsArguments }), [getOwnerProps, getOwnerPropsArguments]);
 };
 export {
   useOwnerProps

package/dist/esm/useOwnerProps/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/useOwnerProps/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useCallback } from 'react';\n\nexport const useOwnerProps = <P, A extends object = Record<string, never>>(props: P, args?: A) => {\n  const getOwnerProps = useCallback(() => props, [props]);\n  const getOwnerPropsArguments = useCallback(() => args ?? {}, [args]);\n  return { getOwnerProps, getOwnerPropsArguments };\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,mBAAmB;AAErB,MAAM,gBAAgB,CAA8C,OAAU,SAAa;AAChG,QAAM,gBAAgB,YAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,yBAAyB,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AACnE,SAAO,EAAE,eAAe,uBAAuB;AACjD;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useCallback, useMemo } from 'react';\n\nexport const useOwnerProps = <P, A extends object = Record<string, never>>(props: P, args?: A) => {\n  const getOwnerProps = useCallback(() => props, [props]);\n  const getOwnerPropsArguments = useCallback(() => args ?? {}, [args]);\n  return useMemo(() => ({ getOwnerProps, getOwnerPropsArguments }), [getOwnerProps, getOwnerPropsArguments]);\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,aAAa,eAAe;AAE9B,MAAM,gBAAgB,CAA8C,OAAU,SAAa;AAChG,QAAM,gBAAgB,YAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,yBAAyB,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AACnE,SAAO,QAAQ,OAAO,EAAE,eAAe,uBAAuB,IAAI,CAAC,eAAe,sBAAsB,CAAC;AAC3G;",
   "names": []
 }

package/dist/esm/validation/typescriptGuards.js

@@ -32,6 +32,7 @@ const isFunction = (format) => {
   return arrowOccursAtDepth1;
 };
 const isJSXorNode = (format) => !isUnion(format) && ["React.ReactNode", "JSX.Element"].includes(format);
+const isReactComponentType = (format) => !isUnion(format) && format === "React.ComponentType<Record<string,unknown>>";
 const isSomethingWithParenthesis = (format) => !isUnion(format) && format[0] === "(" && format.slice(-1) === ")";
 export {
   isArray,
@@ -41,6 +42,7 @@ export {
   isObject,
   isObjectOf,
   isPrimitiveType,
+  isReactComponentType,
   isSomethingWithParenthesis,
   isString,
   isUndefined,

package/dist/esm/validation/typescriptGuards.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/validation/typescriptGuards.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "type GuardFn = (format: string) => boolean;\n\nexport const isPrimitiveType: GuardFn = (format) => ['string', 'number', 'boolean'].includes(format);\nexport const isUndefined: GuardFn = (format) => format === '\"undefined\"';\nexport const isNull: GuardFn = (format) => format === '\"null\"';\nexport const isUnion: GuardFn = (format) => {\n  let depth = 0;\n  let satisfies = false;\n  format.split('').forEach((char) => {\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (char === '|' && depth === 0) satisfies = true;\n  });\n  return satisfies;\n};\n\nexport const isString: GuardFn = (format) => !isUnion(format) && format[0] === '\"' && format.slice(-1) === '\"';\n\nexport const isArray: GuardFn = (format) => !isUnion(format) && format.slice(-2) === '[]';\n\nexport const isObjectOf: GuardFn = (format) =>\n  format !== 'object' && !isUnion(format) && format.startsWith('{ [key: string]: ');\n\nexport const isObject: GuardFn = (format) =>\n  format === 'object' || (!isUnion(format) && format[0] === '{' && format.slice(-1) === '}');\n\nexport const isFunction: GuardFn = (format) => {\n  // It's isn't an union\n  if (isUnion(format)) return false;\n  // Has to start with (( and end with )\n  if (!format.startsWith('((') && format.slice(-1) !== ')') return false;\n\n  // The arrow MUST occur at depth 1 (when couting parenthesis)\n  // Otherwise the only possibility is that we have \"something with parenthesis\" (look down below)\n  let depth = 0;\n  let arrowOccursAtDepth1 = false;\n  for (let i = 0; i < format.length; i += 1) {\n    const char = format[i];\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (i < format.length - 1 && format.slice(i, i + 2) === '=>') {\n      arrowOccursAtDepth1 = arrowOccursAtDepth1 || depth === 1;\n    }\n  }\n  return arrowOccursAtDepth1;\n};\n\nexport const isJSXorNode: GuardFn = (format) => !isUnion(format) && ['React.ReactNode', 'JSX.Element'].includes(format);\n\nexport const isSomethingWithParenthesis: GuardFn = (format) =>\n  !isUnion(format) && format[0] === '(' && format.slice(-1) === ')';\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACEhB,MAAM,kBAA2B,CAAC,WAAW,CAAC,UAAU,UAAU,SAAS,EAAE,SAAS,MAAM;AAC5F,MAAM,cAAuB,CAAC,WAAW,WAAW;AACpD,MAAM,SAAkB,CAAC,WAAW,WAAW;AAC/C,MAAM,UAAmB,CAAC,WAAW;AAC1C,MAAI,QAAQ;AACZ,MAAI,YAAY;AAChB,SAAO,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS;AACjC,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,SAAS,OAAO,UAAU,EAAG,aAAY;AAAA,EACpD,CAAC;AACD,SAAO;AACT;AAEO,MAAM,WAAoB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEpG,MAAM,UAAmB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,MAAM,EAAE,MAAM;AAE9E,MAAM,aAAsB,CAAC,WAClC,WAAW,YAAY,CAAC,QAAQ,MAAM,KAAK,OAAO,WAAW,mBAAmB;AAE3E,MAAM,WAAoB,CAAC,WAChC,WAAW,YAAa,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEjF,MAAM,aAAsB,CAAC,WAAW;AAE7C,MAAI,QAAQ,MAAM,EAAG,QAAO;AAE5B,MAAI,CAAC,OAAO,WAAW,IAAI,KAAK,OAAO,MAAM,EAAE,MAAM,IAAK,QAAO;AAIjE,MAAI,QAAQ;AACZ,MAAI,sBAAsB;AAC1B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,IAAI,OAAO,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,MAAM;AACjE,4BAAsB,uBAAuB,UAAU;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,cAAuB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,CAAC,mBAAmB,aAAa,EAAE,SAAS,MAAM;AAE/G,MAAM,6BAAsC,CAAC,WAClD,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "type GuardFn = (format: string) => boolean;\n\nexport const isPrimitiveType: GuardFn = (format) => ['string', 'number', 'boolean'].includes(format);\nexport const isUndefined: GuardFn = (format) => format === '\"undefined\"';\nexport const isNull: GuardFn = (format) => format === '\"null\"';\nexport const isUnion: GuardFn = (format) => {\n  let depth = 0;\n  let satisfies = false;\n  format.split('').forEach((char) => {\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (char === '|' && depth === 0) satisfies = true;\n  });\n  return satisfies;\n};\n\nexport const isString: GuardFn = (format) => !isUnion(format) && format[0] === '\"' && format.slice(-1) === '\"';\n\nexport const isArray: GuardFn = (format) => !isUnion(format) && format.slice(-2) === '[]';\n\nexport const isObjectOf: GuardFn = (format) =>\n  format !== 'object' && !isUnion(format) && format.startsWith('{ [key: string]: ');\n\nexport const isObject: GuardFn = (format) =>\n  format === 'object' || (!isUnion(format) && format[0] === '{' && format.slice(-1) === '}');\n\nexport const isFunction: GuardFn = (format) => {\n  // It's isn't an union\n  if (isUnion(format)) return false;\n  // Has to start with (( and end with )\n  if (!format.startsWith('((') && format.slice(-1) !== ')') return false;\n\n  // The arrow MUST occur at depth 1 (when couting parenthesis)\n  // Otherwise the only possibility is that we have \"something with parenthesis\" (look down below)\n  let depth = 0;\n  let arrowOccursAtDepth1 = false;\n  for (let i = 0; i < format.length; i += 1) {\n    const char = format[i];\n    if (['{', '('].includes(char)) depth += 1;\n    else if (['}', ')'].includes(char)) depth -= 1;\n    else if (i < format.length - 1 && format.slice(i, i + 2) === '=>') {\n      arrowOccursAtDepth1 = arrowOccursAtDepth1 || depth === 1;\n    }\n  }\n  return arrowOccursAtDepth1;\n};\n\nexport const isJSXorNode: GuardFn = (format) => !isUnion(format) && ['React.ReactNode', 'JSX.Element'].includes(format);\n\nexport const isReactComponentType: GuardFn = (format) =>\n  !isUnion(format) && format === 'React.ComponentType<Record<string,unknown>>';\n\nexport const isSomethingWithParenthesis: GuardFn = (format) =>\n  !isUnion(format) && format[0] === '(' && format.slice(-1) === ')';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACEhB,MAAM,kBAA2B,CAAC,WAAW,CAAC,UAAU,UAAU,SAAS,EAAE,SAAS,MAAM;AAC5F,MAAM,cAAuB,CAAC,WAAW,WAAW;AACpD,MAAM,SAAkB,CAAC,WAAW,WAAW;AAC/C,MAAM,UAAmB,CAAC,WAAW;AAC1C,MAAI,QAAQ;AACZ,MAAI,YAAY;AAChB,SAAO,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS;AACjC,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,SAAS,OAAO,UAAU,EAAG,aAAY;AAAA,EACpD,CAAC;AACD,SAAO;AACT;AAEO,MAAM,WAAoB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEpG,MAAM,UAAmB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,MAAM,EAAE,MAAM;AAE9E,MAAM,aAAsB,CAAC,WAClC,WAAW,YAAY,CAAC,QAAQ,MAAM,KAAK,OAAO,WAAW,mBAAmB;AAE3E,MAAM,WAAoB,CAAC,WAChC,WAAW,YAAa,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;AAEjF,MAAM,aAAsB,CAAC,WAAW;AAE7C,MAAI,QAAQ,MAAM,EAAG,QAAO;AAE5B,MAAI,CAAC,OAAO,WAAW,IAAI,KAAK,OAAO,MAAM,EAAE,MAAM,IAAK,QAAO;AAIjE,MAAI,QAAQ;AACZ,MAAI,sBAAsB;AAC1B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aAC/B,CAAC,KAAK,GAAG,EAAE,SAAS,IAAI,EAAG,UAAS;AAAA,aACpC,IAAI,OAAO,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,MAAM;AACjE,4BAAsB,uBAAuB,UAAU;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,cAAuB,CAAC,WAAW,CAAC,QAAQ,MAAM,KAAK,CAAC,mBAAmB,aAAa,EAAE,SAAS,MAAM;AAE/G,MAAM,uBAAgC,CAAC,WAC5C,CAAC,QAAQ,MAAM,KAAK,WAAW;AAE1B,MAAM,6BAAsC,CAAC,WAClD,CAAC,QAAQ,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,OAAO,MAAM,EAAE,MAAM;",
   "names": []
 }

package/dist/esm/validation/typescriptValidator.js

@@ -7,6 +7,7 @@ import {
   isFunction,
   isJSXorNode,
   isObject,
+  isReactComponentType,
   isPrimitiveType,
   isSomethingWithParenthesis,
   isString,
@@ -148,6 +149,8 @@ const validateValueWithFormat = (schemaName, key, value, format, validationsMemo
     validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if (isFunction(format)) {
     validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
+  } else if (isReactComponentType(format)) {
+    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if (isJSXorNode(format)) {
     validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);
   } else if (isSomethingWithParenthesis(format)) {

package/dist/esm/validation/typescriptValidator.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/validation/typescriptValidator.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable complexity */\n/* eslint-disable max-lines */\n/* eslint-disable max-params */\nimport type { PropsWithChildren, WeakValidationMap } from 'react';\nimport { useMemo, useRef } from 'react';\nimport type { TypescriptDocumentation } from '../propTypes/types.js';\nimport { describe } from '../propTypes/index.js';\nimport { throwRequiredError, throwTypeError } from './errorTemplates.js';\nimport {\n  isArray,\n  isFunction,\n  isJSXorNode,\n  isObject,\n  isPrimitiveType,\n  isSomethingWithParenthesis,\n  isString,\n  isUnion,\n  isUndefined,\n  isNull,\n  isObjectOf,\n} from './typescriptGuards.js';\nimport { typescriptObjectParser } from './typescriptParsers.js';\n\ntype ValidatorFn = (\n  schemaName: string,\n  key: string,\n  value: unknown,\n  format: string,\n  validationsMemo: Record<symbol, string>,\n  nextValidationsMemo: Record<symbol, string>,\n) => void;\n\n// =============================================================================\n// Atom Validators\n// =============================================================================\n\n// This functions will validate something from the data\n// and optionally recursively apply `validateValueWithFormat`\n// in smaller parts\n\nconst validateUndefined: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== undefined || value === 'undefined') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validateNull: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== null || value === 'null') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validatePrimitiveType: ValidatorFn = (schemaName, key, value, format) => {\n  if (typeof value !== format) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateString: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== format.slice(1, -1)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateArray: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  // Check that we have an array\n  if (!Array.isArray(value)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n\n  // Check that each element inside satisfies the format\n  (value as unknown[]).forEach((val, index) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${index}]`,\n      val,\n      format.slice(0, -2),\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\nfunction isObjectType(value: unknown): value is Record<string, unknown> {\n  return !(typeof value !== 'object' || Array.isArray(value));\n}\n\nconst validateObjectOf: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  const valuesFormat = format.slice('{ [key: string]: '.length, -2);\n\n  Object.keys(value).forEach((objectKey) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${objectKey}]`,\n      value[objectKey],\n      valuesFormat,\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\n\nconst validateObject: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  if (format === 'object') return;\n\n  const keyValuePairs = typescriptObjectParser(format);\n  // Now we have the key - value pairs\n  // Each key could either be required or not\n  // Just recursively check the object\n\n  keyValuePairs.forEach(([objectKey, objectValue]) => {\n    const trueKey = objectKey.slice(-1) === '?' ? objectKey.slice(0, -1) : objectKey;\n\n    if (trueKey === objectKey && !(trueKey in value)) {\n      throwRequiredError(schemaName, trueKey);\n    }\n\n    if (trueKey in value) {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(\n        schemaName,\n        `${key}[${trueKey}]`,\n        value[trueKey],\n        objectValue,\n        validationsMemo,\n        nextValidationsMemo,\n      );\n    }\n  });\n};\n\nconst validateUnion: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const possibilities = format.split(/\\s?\\|\\s?/);\n\n  const errors = [];\n\n  possibilities.forEach((possibility) => {\n    try {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(schemaName, key, value, possibility, validationsMemo, nextValidationsMemo);\n    } catch (e) {\n      errors.push(e);\n    }\n  });\n\n  if (errors.length === possibilities.length) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateFunction: ValidatorFn = (schemaName, key, value, format) => {\n  // Check that we have a function\n  if (typeof value !== 'function') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nfunction isJSXElement(value: unknown): value is JSX.Element {\n  return value === null || (typeof value === 'object' && value !== null && '$$typeof' in value);\n}\nconst validateJSXorNode: ValidatorFn = (schemaName, key, value, format) => {\n  const valueIsJSX = isJSXElement(value);\n  if (format === 'JSX.Element' && !valueIsJSX) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\n// =============================================================================\n// Schema validator\n// =============================================================================\n\nconst validateValueWithFormat: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  nextValidationsMemo[value as symbol] = format;\n\n  if ((value as symbol) in validationsMemo) {\n    // We already validated this value on this format\n    return;\n  }\n\n  if (isUndefined(format)) {\n    validateUndefined(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isNull(format)) {\n    validateNull(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isPrimitiveType(format)) {\n    validatePrimitiveType(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isUnion(format)) {\n    validateUnion(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isString(format)) {\n    validateString(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isArray(format)) {\n    validateArray(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObjectOf(format)) {\n    validateObjectOf(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObject(format)) {\n    validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isFunction(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isJSXorNode(format)) {\n    validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isSomethingWithParenthesis(format)) {\n    validateValueWithFormat(schemaName, key, value, format.slice(1, -1), validationsMemo, nextValidationsMemo);\n  }\n};\n\nexport const validateTypescriptPropTypesImplementation = (\n  props: PropsWithChildren<Record<string, unknown>>,\n  schema: TypescriptDocumentation,\n  validationsMemo: Record<string, string> = {},\n  nextValidationsMemo: Record<string, string> = {},\n): void => {\n  const { properties, name: schemaName } = schema;\n\n  properties.forEach((property) => {\n    const { name, format, required, isRequiredIf, omitValidation } = property;\n\n    const requiredConditionally = isRequiredIf && isRequiredIf(props);\n\n    if (omitValidation) {\n      return;\n    }\n\n    if (required && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    if (requiredConditionally && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    const shouldValidateProperty = props[name] !== undefined || required || requiredConditionally;\n\n    if (name in props && format && shouldValidateProperty) {\n      validateValueWithFormat(schemaName, name, props[name], format, validationsMemo, nextValidationsMemo);\n    }\n  });\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const useValidateTypescriptPropTypes = <T = Record<string, any>>(\n  props: PropsWithChildren<T>,\n  propTypes: WeakValidationMap<unknown>,\n  componentDisplayName: string,\n): void => {\n  if (!componentDisplayName) {\n    throw new Error('Provide display name for the component to use for validation');\n  }\n\n  const validationsMemo = useRef<Record<string, string>>({});\n\n  const typescriptSchema = useMemo(() => {\n    const Component = () => {};\n\n    const DescribedComponent = describe(Component);\n    DescribedComponent.propTypes = propTypes;\n    DescribedComponent.displayName = componentDisplayName;\n    return DescribedComponent.toTypescript();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [propTypes]);\n\n  useMemo(() => {\n    const nextValidationsMemo = {};\n\n    validateTypescriptPropTypesImplementation(props, typescriptSchema, validationsMemo.current, nextValidationsMemo);\n    validationsMemo.current = nextValidationsMemo;\n    return 'WE DONT NEED RETURN just the memo';\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [props]);\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable complexity */\n/* eslint-disable max-lines */\n/* eslint-disable max-params */\nimport type { PropsWithChildren, WeakValidationMap } from 'react';\nimport { useMemo, useRef } from 'react';\nimport type { TypescriptDocumentation } from '../propTypes/types.js';\nimport { describe } from '../propTypes/index.js';\nimport { throwRequiredError, throwTypeError } from './errorTemplates.js';\nimport {\n  isArray,\n  isFunction,\n  isJSXorNode,\n  isObject,\n  isReactComponentType,\n  isPrimitiveType,\n  isSomethingWithParenthesis,\n  isString,\n  isUnion,\n  isUndefined,\n  isNull,\n  isObjectOf,\n} from './typescriptGuards.js';\nimport { typescriptObjectParser } from './typescriptParsers.js';\n\ntype ValidatorFn = (\n  schemaName: string,\n  key: string,\n  value: unknown,\n  format: string,\n  validationsMemo: Record<symbol, string>,\n  nextValidationsMemo: Record<symbol, string>,\n) => void;\n\n// =============================================================================\n// Atom Validators\n// =============================================================================\n\n// This functions will validate something from the data\n// and optionally recursively apply `validateValueWithFormat`\n// in smaller parts\n\nconst validateUndefined: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== undefined || value === 'undefined') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validateNull: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== null || value === 'null') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\nconst validatePrimitiveType: ValidatorFn = (schemaName, key, value, format) => {\n  if (typeof value !== format) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateString: ValidatorFn = (schemaName, key, value, format) => {\n  if (value !== format.slice(1, -1)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateArray: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  // Check that we have an array\n  if (!Array.isArray(value)) {\n    throwTypeError(schemaName, key, value, format);\n  }\n\n  // Check that each element inside satisfies the format\n  (value as unknown[]).forEach((val, index) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${index}]`,\n      val,\n      format.slice(0, -2),\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\nfunction isObjectType(value: unknown): value is Record<string, unknown> {\n  return !(typeof value !== 'object' || Array.isArray(value));\n}\n\nconst validateObjectOf: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  const valuesFormat = format.slice('{ [key: string]: '.length, -2);\n\n  Object.keys(value).forEach((objectKey) => {\n    // this is a recursive func, we need to invoke it before it's defined.\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    validateValueWithFormat(\n      schemaName,\n      `${key}[${objectKey}]`,\n      value[objectKey],\n      valuesFormat,\n      validationsMemo,\n      nextValidationsMemo,\n    );\n  });\n};\n\nconst validateObject: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const valuesIsObject = isObjectType(value);\n  // Check that we have an object\n  if (!valuesIsObject) {\n    throwTypeError(schemaName, key, value, format);\n    return;\n  }\n\n  if (format === 'object') return;\n\n  const keyValuePairs = typescriptObjectParser(format);\n  // Now we have the key - value pairs\n  // Each key could either be required or not\n  // Just recursively check the object\n\n  keyValuePairs.forEach(([objectKey, objectValue]) => {\n    const trueKey = objectKey.slice(-1) === '?' ? objectKey.slice(0, -1) : objectKey;\n\n    if (trueKey === objectKey && !(trueKey in value)) {\n      throwRequiredError(schemaName, trueKey);\n    }\n\n    if (trueKey in value) {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(\n        schemaName,\n        `${key}[${trueKey}]`,\n        value[trueKey],\n        objectValue,\n        validationsMemo,\n        nextValidationsMemo,\n      );\n    }\n  });\n};\n\nconst validateUnion: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  const possibilities = format.split(/\\s?\\|\\s?/);\n\n  const errors = [];\n\n  possibilities.forEach((possibility) => {\n    try {\n      // this is a recursive func, we need to invoke it before it's defined.\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      validateValueWithFormat(schemaName, key, value, possibility, validationsMemo, nextValidationsMemo);\n    } catch (e) {\n      errors.push(e);\n    }\n  });\n\n  if (errors.length === possibilities.length) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nconst validateFunction: ValidatorFn = (schemaName, key, value, format) => {\n  // Check that we have a function\n  if (typeof value !== 'function') {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\nfunction isJSXElement(value: unknown): value is JSX.Element {\n  return value === null || (typeof value === 'object' && value !== null && '$$typeof' in value);\n}\nconst validateJSXorNode: ValidatorFn = (schemaName, key, value, format) => {\n  const valueIsJSX = isJSXElement(value);\n  if (format === 'JSX.Element' && !valueIsJSX) {\n    throwTypeError(schemaName, key, value, format);\n  }\n};\n\n// =============================================================================\n// Schema validator\n// =============================================================================\n\nconst validateValueWithFormat: ValidatorFn = (schemaName, key, value, format, validationsMemo, nextValidationsMemo) => {\n  nextValidationsMemo[value as symbol] = format;\n\n  if ((value as symbol) in validationsMemo) {\n    // We already validated this value on this format\n    return;\n  }\n\n  if (isUndefined(format)) {\n    validateUndefined(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isNull(format)) {\n    validateNull(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isPrimitiveType(format)) {\n    validatePrimitiveType(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isUnion(format)) {\n    validateUnion(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isString(format)) {\n    validateString(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isArray(format)) {\n    validateArray(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObjectOf(format)) {\n    validateObjectOf(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isObject(format)) {\n    validateObject(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isFunction(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isReactComponentType(format)) {\n    validateFunction(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isJSXorNode(format)) {\n    validateJSXorNode(schemaName, key, value, format, validationsMemo, nextValidationsMemo);\n  } else if (isSomethingWithParenthesis(format)) {\n    validateValueWithFormat(schemaName, key, value, format.slice(1, -1), validationsMemo, nextValidationsMemo);\n  }\n};\n\nexport const validateTypescriptPropTypesImplementation = (\n  props: PropsWithChildren<Record<string, unknown>>,\n  schema: TypescriptDocumentation,\n  validationsMemo: Record<string, string> = {},\n  nextValidationsMemo: Record<string, string> = {},\n): void => {\n  const { properties, name: schemaName } = schema;\n\n  properties.forEach((property) => {\n    const { name, format, required, isRequiredIf, omitValidation } = property;\n\n    const requiredConditionally = isRequiredIf && isRequiredIf(props);\n\n    if (omitValidation) {\n      return;\n    }\n\n    if (required && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    if (requiredConditionally && !(name in props)) {\n      throwRequiredError(schema.name, name);\n    }\n\n    const shouldValidateProperty = props[name] !== undefined || required || requiredConditionally;\n\n    if (name in props && format && shouldValidateProperty) {\n      validateValueWithFormat(schemaName, name, props[name], format, validationsMemo, nextValidationsMemo);\n    }\n  });\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const useValidateTypescriptPropTypes = <T = Record<string, any>>(\n  props: PropsWithChildren<T>,\n  propTypes: WeakValidationMap<unknown>,\n  componentDisplayName: string,\n): void => {\n  if (!componentDisplayName) {\n    throw new Error('Provide display name for the component to use for validation');\n  }\n\n  const validationsMemo = useRef<Record<string, string>>({});\n\n  const typescriptSchema = useMemo(() => {\n    const Component = () => {};\n\n    const DescribedComponent = describe(Component);\n    DescribedComponent.propTypes = propTypes;\n    DescribedComponent.displayName = componentDisplayName;\n    return DescribedComponent.toTypescript();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [propTypes]);\n\n  useMemo(() => {\n    const nextValidationsMemo = {};\n\n    validateTypescriptPropTypesImplementation(props, typescriptSchema, validationsMemo.current, nextValidationsMemo);\n    validationsMemo.current = nextValidationsMemo;\n    return 'WE DONT NEED RETURN just the memo';\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [props]);\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/xstyledProps/useGetXstyledProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/xstyledProps/useGetXstyledProps.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport type {\n  SizingProps,\n  SpaceProps,\n  LayoutProps,\n  BoxShadowProps,\n  BorderProps,\n  BackgroundProps,\n  FontWeightProps,\n  TextAlignProps,\n} from '@elliemae/ds-system';\nimport { xstyledKeys } from './constants.js';\n\nexport interface XstyledProps\n  extends SpaceProps,\n    SizingProps,\n    LayoutProps,\n    BoxShadowProps,\n    BorderProps,\n    BackgroundProps,\n    FontWeightProps,\n    TextAlignProps {}\n\ntype PropsWithXstyled<T> = T & XstyledProps;\n\nexport const getXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps => {\n  const xstyledPropsObject: Record<string, unknown> = {};\n  Object.entries(props).forEach(([key, value]) => {\n    if (key in xstyledKeys) {\n      xstyledPropsObject[key] = value;\n    }\n  });\n  return xstyledPropsObject;\n};\n\nexport const useGetXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps =>\n  useMemo(() => getXstyledProps(props), [props]);\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AAWxB,SAAS,mBAAmB;AAcrB,MAAM,kBAAkB,CAAK,UAA6C;AAC/E,QAAM,qBAA8C,CAAC;AACrD,SAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,QAAI,OAAO,aAAa;AACtB,yBAAmB,GAAG,IAAI;AAAA,IAC5B;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,MAAM,qBAAqB,CAAK,UACrC,QAAQ,MAAM,gBAAgB,KAAK,GAAG,CAAC,KAAK,CAAC;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useMemo } from 'react';\nimport type {\n  SizingProps,\n  SpaceProps,\n  LayoutProps,\n  BoxShadowProps,\n  BorderProps,\n  BackgroundProps,\n  FontWeightProps,\n  TextAlignProps,\n} from '@elliemae/ds-system';\nimport { xstyledKeys } from './constants.js';\n\nexport interface XstyledProps\n  extends\n    SpaceProps,\n    SizingProps,\n    LayoutProps,\n    BoxShadowProps,\n    BorderProps,\n    BackgroundProps,\n    FontWeightProps,\n    TextAlignProps {}\n\ntype PropsWithXstyled<T> = T & XstyledProps;\n\nexport const getXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps => {\n  const xstyledPropsObject: Record<string, unknown> = {};\n  Object.entries(props).forEach(([key, value]) => {\n    if (key in xstyledKeys) {\n      xstyledPropsObject[key] = value;\n    }\n  });\n  return xstyledPropsObject;\n};\n\nexport const useGetXstyledProps = <T,>(props: PropsWithXstyled<T>): XstyledProps =>\n  useMemo(() => getXstyledProps(props), [props]);\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,eAAe;AAWxB,SAAS,mBAAmB;AAerB,MAAM,kBAAkB,CAAK,UAA6C;AAC/E,QAAM,qBAA8C,CAAC;AACrD,SAAO,QAAQ,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,QAAI,OAAO,aAAa;AACtB,yBAAmB,GAAG,IAAI;AAAA,IAC5B;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,MAAM,qBAAqB,CAAK,UACrC,QAAQ,MAAM,gBAAgB,KAAK,GAAG,CAAC,KAAK,CAAC;",
   "names": []
 }

package/dist/types/contractProps/getContractProps.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Filters an arbitrary object down to the props a component's contract declares.
+ *
+ * This is the engine behind each package's own curated passthrough utility (e.g. ds-app-picker's
+ * `getDSAppPickerContractProps`). Packages are expected to expose a bound utility rather than their
+ * schema: the schema stays an internal implementation detail, so the two can drift later without
+ * expanding anyone's public API.
+ *
+ * Three behaviours worth knowing, because callers depend on them:
+ *
+ * 1. **Documentation-only wildcard keys are ignored.** See `DOCUMENTATION_ONLY_SCHEMA_KEYS`.
+ * 2. **`data-*` is honoured by prefix**, matching `getGlobalAttributes` — arbitrary data attributes
+ *    are a supported consumer surface even though no schema can enumerate them. Note the house
+ *    behaviour deliberately does not extend the same courtesy to `aria-*` or `on*`: those are
+ *    matched against the schema's explicit list, so a typo fails loudly instead of reaching the DOM.
+ * 3. **`undefined` is dropped, `null` is forwarded.** These two are not interchangeable, and the rule
+ *    follows React rather than being invented here:
+ *
+ *    - React's own default resolution (`resolveDefaultProps`) applies a `defaultProps` entry only when
+ *      the incoming prop is `undefined`; a `null` is respected as an explicitly supplied value. This
+ *      is the same rule as JS destructuring defaults and ES6 default parameters — a language-level
+ *      standard, not a React invention. So `undefined` means "I am not defining this, you decide" and
+ *      `null` means "I am defining it, as nothing".
+ *    - Everywhere React *consumes* a value rather than defaulting it — DOM attributes, children, event
+ *      handlers — it collapses the two and treats both as absent. The distinction is load-bearing
+ *      only at a default-resolution boundary.
+ *
+ *    A contract passthrough is exactly such a boundary: the result is spread *after* a wrapper's own
+ *    defaults, so dropping `undefined` is what stops an unset key from erasing a working default,
+ *    while forwarding `null` is what lets a consumer deliberately override one. This matters more
+ *    here than in plain React, because Dimsum's `useMemoMergePropsWithDefault` is a plain
+ *    `{...defaults, ...props}` spread — it does NOT skip `undefined` the way `resolveDefaultProps`
+ *    does, so an `undefined` that reaches it clobbers the component's default too.
+ *
+ *    What happens to a forwarded `null` afterwards is the receiving component's business, not this
+ *    function's. Dimsum components are strictly typed: `validateTypescriptPropTypesImplementation`
+ *    validates any value that is not `undefined`, and a prop declared as a function does not admit
+ *    `null` — so passing `null` there raises a prop-type error, correctly. A prop only accepts `null`
+ *    if its own declared type says so and its code carries the matching null guards. Where a consumer
+ *    wants to state "do nothing", the type-honouring way to say it is an explicit no-op — `() => {}`
+ *    for a handler, `() => null` for a component — which is unambiguous in a way that `null` is not.
+ *    This function stays out of that decision: forwarding the value and letting the owning contract
+ *    judge it is the correct division of concerns at this abstraction level.
+ *
+ * @param props - the object to filter; anything the contract does not declare is discarded
+ * @param contractShape - any object whose KEYS name the contract's props. Only `Object.keys` is read,
+ *   so it is deliberately not narrowed to `DSPropTypesSchema`
+ *
+ * a PropTypes schema is usually fine and there is a code dedicated to discarding the global attributes to make the schema compatible for faster internal transition/implementation.
+ * @returns a new object containing only the declared, defined props
+ */
+export declare const getContractProps: <ContractProps>(props: object, contractShape: object) => Partial<ContractProps>;

package/dist/types/contractProps/index.d.ts

@@ -0,0 +1 @@
+export { getContractProps } from './getContractProps.js';

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export type { ValidationMap } from 'prop-types';
 export { throwTypeError, throwRequiredError, useValidateTypescriptPropTypes, validateTypescriptPropTypesImplementation, } from './validation/index.js';
 export { type XstyledProps, useGetXstyledProps, xstyledPropTypes, getXstyledProps } from './xstyledProps/index.js';
 export { useDeprecateComponent } from './useDeprecateComponent/index.js';
+export { getContractProps } from './contractProps/index.js';
 export { getPropsPerDatatestid, getPropsPerDatatestIdPropTypes } from './propsPerDataTestId/index.js';
 export { getPropsPerSlotPropTypes } from './propsPerSlot/index.js';
 export { useOwnerProps } from './useOwnerProps/index.js';

package/dist/types/validation/typescriptGuards.d.ts

@@ -9,5 +9,6 @@ export declare const isObjectOf: GuardFn;
 export declare const isObject: GuardFn;
 export declare const isFunction: GuardFn;
 export declare const isJSXorNode: GuardFn;
+export declare const isReactComponentType: GuardFn;
 export declare const isSomethingWithParenthesis: GuardFn;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-props-helpers",
-  "version": "3.70.0-next.9",
+  "version": "3.70.0-rc.0",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Props Helpers",
   "files": [
@@ -19,7 +19,7 @@
   "sideEffects": [],
   "repository": {
     "type": "git",
-    "url": "https://git.elliemae.io/platform-ui/dimsum.git"
+    "url": "https://github.com/intcx/PLATFORM-UI.dimsum.git"
   },
   "engines": {
     "pnpm": ">=9",
@@ -35,15 +35,15 @@
   "dependencies": {
     "fast-deep-equal": "~3.1.3",
     "prop-types": "~15.8.1",
-    "@elliemae/ds-system": "3.70.0-next.9",
-    "@elliemae/ds-typescript-helpers": "3.70.0-next.9"
+    "@elliemae/ds-system": "3.70.0-rc.0",
+    "@elliemae/ds-typescript-helpers": "3.70.0-rc.0"
   },
   "devDependencies": {
     "jest": "^30.0.0",
-    "@elliemae/ds-monorepo-devops": "3.70.0-next.9"
+    "@elliemae/ds-monorepo-devops": "3.70.0-rc.0"
   },
   "peerDependencies": {
-    "lodash-es": "^4.17.21",
+    "lodash-es": "^4.18.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
@@ -60,4 +60,4 @@
     "build": "cross-env NODE_ENV=production node ../../../scripts/build/build.mjs",
     "checkDeps": "npx -yes ../../util/ds-codemods check-missing-packages --projectFolderPath=\"./\" --ignorePackagesGlobPattern=\"\" --ignoreFilesGlobPattern=\"**/test-ables/*,**/tests/*\""
   }
-}
+}

package/dist/types/tests/globalProps/TestComponent.d.ts

@@ -1 +0,0 @@
-export function TestComponent(props: any): import("react/jsx-runtime").JSX.Element;

package/dist/types/tests/globalProps/globalAttributes.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/propsPerDataTestId/getPropsPerDatatestIdPropTypes.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/propsPerDataTestId/getPropsPerDatatestid.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/any.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/array.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/boolean.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/function.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/isRequiredIf.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/number.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/object.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/objectOf.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/schema.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/shapeWithObjectOf.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/shapeWithObjectOfAndSignature.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/string.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/validation/test.schema.d.ts

@@ -1 +0,0 @@
-export const TypescriptSchema: import("../../propTypes/types.js").TypescriptDocumentation;

package/dist/types/tests/validation/union.validation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/tests/xstyledProps/TestComponent.d.ts

@@ -1 +0,0 @@
-export function TestComponent(props: any): import("react/jsx-runtime").JSX.Element;

package/dist/types/tests/xstyledProps/xstyledProps.test.d.ts

@@ -1 +0,0 @@
-export {};