@elliemae/ds-props-helpers 3.70.0-next.61 → 3.70.0-next.63

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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-props-helpers",
-  "version": "3.70.0-next.61",
+  "version": "3.70.0-next.63",
   "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,12 +35,12 @@
   "dependencies": {
     "fast-deep-equal": "~3.1.3",
     "prop-types": "~15.8.1",
-    "@elliemae/ds-system": "3.70.0-next.61",
-    "@elliemae/ds-typescript-helpers": "3.70.0-next.61"
+    "@elliemae/ds-typescript-helpers": "3.70.0-next.63",
+    "@elliemae/ds-system": "3.70.0-next.63"
   },
   "devDependencies": {
     "jest": "^30.0.0",
-    "@elliemae/ds-monorepo-devops": "3.70.0-next.61"
+    "@elliemae/ds-monorepo-devops": "3.70.0-next.63"
   },
   "peerDependencies": {
     "lodash-es": "^4.18.1",