@elliemae/ds-app-picker 3.70.0-next.61 → 3.70.0-next.63

package/dist/types/util/getDSAppPickerContractProps.d.ts

@@ -0,0 +1,37 @@
+import { type DSAppPickerT } from '../react-desc-prop-types.js';
+/**
+ * Filters an arbitrary object down to the props DSAppPicker actually accepts.
+ *
+ * **Who this is for.** Components that wrap DSAppPicker and receive its props indirectly — as a
+ * configuration object from their own consumer rather than as JSX props.
+ *
+ * The canonical case is `ds-global-header`, whose `toolbar` config carries a `componentProps` object for
+ * the `ds-app-picker` item type. Such a wrapper cannot spread that object blindly: its config type is
+ * DSAppPicker's props *plus* the wrapper's own — `triggerOnClick` there — and those must not leak into
+ * DSAppPicker.
+ *
+ * Do not swap this for a hand-listed set of forwardable keys. A hand-list has no way to fail when the
+ * contract grows: the new prop type-checks at the call site, is dropped silently at runtime, and nothing
+ * reports it. Deriving the set from the contract is what makes that class of bug impossible.
+ *
+ * **Why a utility instead of exporting the schema.** `DSAppPickerPropTypes` is internal. It exists to
+ * drive prop validation and the Storybook props table; that it also happens to describe the exact set
+ * of forwardable props is a convenience today, not a promise. Exposing the schema would weld those
+ * concerns together and make every future change to it a public API change. Exposing this utility
+ * instead means the public commitment is only "you get the props DSAppPicker accepts" — if the two
+ * ever need to diverge, only this function changes.
+ *
+ * Anything the contract does not declare is discarded. Arbitrary `data-*` attributes are kept (a
+ * supported consumer surface no schema can enumerate).
+ *
+ * `undefined` vs `null` — see `getContractProps` for the implemented rule and the React precedent it
+ * follows. In short: `undefined` is dropped ("I am not defining this, you decide" — the wrapper's
+ * default stands), `null` is forwarded ("I am explicitly asking for nothing") and is then judged by
+ * DSAppPicker's own strictly-typed contract, which rejects it for props whose declared type does not
+ * admit null. To disable a handler, pass an explicit no-op (`() => {}`) — it honours the type and
+ * states the intent unambiguously.
+ *
+ * @param props - the object to filter, typically a wrapper's `componentProps` configuration
+ * @returns a new object containing only props DSAppPicker declares
+ */
+export declare const getDSAppPickerContractProps: (props: object) => Partial<DSAppPickerT.Props>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-app-picker",
-  "version": "3.70.0-next.61",
+  "version": "3.70.0-next.63",
   "license": "MIT",
   "description": "ICE MT - Dimsum - App Picker",
   "files": [
@@ -22,7 +22,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://git.elliemae.io/platform-ui/dimsum.git"
+    "url": "https://github.com/intcx/PLATFORM-UI.dimsum.git"
   },
   "engines": {
     "pnpm": ">=9",
@@ -37,23 +37,24 @@
   },
   "dependencies": {
     "uid": "^2.0.2",
-    "@elliemae/ds-button-v2": "3.70.0-next.61",
-    "@elliemae/ds-floating-context": "3.70.0-next.61",
-    "@elliemae/ds-props-helpers": "3.70.0-next.61",
-    "@elliemae/ds-hooks-focus-trap": "3.70.0-next.61",
-    "@elliemae/ds-grid": "3.70.0-next.61",
-    "@elliemae/ds-icons": "3.70.0-next.61",
-    "@elliemae/ds-typography": "3.70.0-next.61",
-    "@elliemae/ds-system": "3.70.0-next.61",
-    "@elliemae/ds-chip": "3.70.0-next.61"
+    "@elliemae/ds-grid": "3.70.0-next.63",
+    "@elliemae/ds-floating-context": "3.70.0-next.63",
+    "@elliemae/ds-hooks-focus-trap": "3.70.0-next.63",
+    "@elliemae/ds-button-v2": "3.70.0-next.63",
+    "@elliemae/ds-icons": "3.70.0-next.63",
+    "@elliemae/ds-chip": "3.70.0-next.63",
+    "@elliemae/ds-typography": "3.70.0-next.63",
+    "@elliemae/ds-props-helpers": "3.70.0-next.63",
+    "@elliemae/ds-system": "3.70.0-next.63"
   },
   "devDependencies": {
     "@playwright/experimental-ct-react": "1.61.1",
     "jest": "^30.0.0",
+    "jest-axe": "^11.0.0",
     "styled-components": "~5.3.11",
-    "@elliemae/ds-monorepo-devops": "3.70.0-next.61",
-    "@elliemae/ds-test-utils": "3.70.0-next.61",
-    "@elliemae/ds-typescript-helpers": "3.70.0-next.61"
+    "@elliemae/ds-test-utils": "3.70.0-next.63",
+    "@elliemae/ds-monorepo-devops": "3.70.0-next.63",
+    "@elliemae/ds-typescript-helpers": "3.70.0-next.63"
   },
   "peerDependencies": {
     "react": "^18.3.1",
@@ -66,7 +67,7 @@
   },
   "scripts": {
     "dev": "cross-env NODE_ENV=development node ../../../scripts/build/build.mjs --watch",
-    "test": "ds-monorepo-devops test --passWithNoTests --coverage=\"false\"",
+    "test": "playwright test -c ./playwright.config.mjs && ds-monorepo-devops test --passWithNoTests --coverage=\"false\"",
     "lint": "node ../../../scripts/lint.mjs --fix",
     "lint:strict": "node ../../../scripts/lint-strict.mjs",
     "dts": "node ../../../scripts/dts.mjs",