@servicetitan/anvil2-ext-common 0.4.0 → 0.5.1

package/dist/src/components/Suggestions/Suggestions.d.ts

@@ -0,0 +1,59 @@
+import { ReactNode } from 'react';
+type Handler = (...args: any[]) => void;
+type Handlers = Record<string, Handler | undefined>;
+export interface SuggestionsApi {
+    /**
+     * Props for a field that should be highlighted while it holds a suggested
+     * value. Returns `isHighlighted` plus copies of any handlers you pass, each
+     * wrapped to clear the highlight on the first user edit. Pass the handler
+     * under the field's own prop name (`onChange`, `onSelectedOptionChange`, ...).
+     *
+     * @example <TextField {...suggestable("city", { onChange: setCity })} />
+     */
+    suggestable: <O extends Handlers>(key: string, handlers?: O) => {
+        isHighlighted: boolean;
+    } & O;
+    /**
+     * Props for the field whose selection populates the others. Returns copies of
+     * the handlers you pass, each wrapped to first mark the suggestable fields as
+     * highlighted. Your handler still does the value population.
+     *
+     * @param keys which fields to highlight; defaults to every registered key.
+     * @example <TypeaheadTextField {...suggestor({ onSelectOption: apply })} />
+     */
+    suggestor: <O extends Handlers>(handlers?: O, keys?: string[]) => O;
+    /** Imperatively highlight fields (defaults to every registered key). */
+    markSuggested: (keys?: string[]) => void;
+    /** Imperatively clear a field's highlight. */
+    clearHighlight: (key: string) => void;
+    /** Whether a field is currently holding a suggested value. */
+    isHighlighted: (key: string) => boolean;
+}
+export interface SuggestionsProps {
+    children: (api: SuggestionsApi) => ReactNode;
+}
+/**
+ * Coordinates the "highlight fields populated by a suggestion until edited"
+ * behavior for a group of fields, without per-field state wiring.
+ *
+ * Relies on the fact that a controlled field's change handler fires only on
+ * user input, never when its `value` prop changes programmatically — so we
+ * track provenance per field rather than comparing values. A field stays
+ * un-highlighted after an edit even if the suggested value is re-entered,
+ * because typing still fires the handler.
+ *
+ * @example
+ * <Suggestions>
+ *   {({ suggestor, suggestable }) => (
+ *     <>
+ *       <TypeaheadTextField
+ *         {...suggestor({ onSelectOption: (opt) => applyAddress(opt.value) })}
+ *         loadOptions={lookupAddresses}
+ *       />
+ *       <TextField {...suggestable("city", { onChange: handleCity })} />
+ *     </>
+ *   )}
+ * </Suggestions>
+ */
+export declare function Suggestions({ children }: SuggestionsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/Suggestions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Suggestions';
+export { Suggestions as default } from './Suggestions';

package/dist/src/components/index.d.ts

@@ -1 +1,2 @@
 export * from './ExampleComponent';
+export * from './Suggestions';

package/dist/src/form/components/FormMultiSelect/FormMultiSelect.d.ts

@@ -1,4 +1,4 @@
-import { MultiSelectFieldOption, MultiSelectFieldProps } from '@servicetitan/anvil2/beta';
+import { MultiSelectFieldOption, MultiSelectFieldProps } from '@servicetitan/anvil2';
 import { A2InputFieldState, DistributiveOmit } from '../../state';
 /**
  * FormMultiSelect wraps the beta MultiSelectField and binds it to an

package/dist/src/form/components/FormSelect/FormSelect.d.ts

@@ -1,4 +1,4 @@
-import { SelectFieldOption, SelectFieldProps } from '@servicetitan/anvil2/beta';
+import { SelectFieldOption, SelectFieldProps } from '@servicetitan/anvil2';
 import { A2InputFieldState, DistributiveOmit } from '../../state';
 /**
  * FormSelect wraps the beta SelectField and binds it to an A2InputFieldState.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicetitan/anvil2-ext-common",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "type": "module",
   "types": "./dist/src/index.d.ts",
   "main": "./dist/index.js",
@@ -30,10 +30,10 @@
     "classnames": "^2.5.1",
     "tabbable": "^6.2.0",
     "tinycolor2": "^1.6.0",
-    "uuid": "^14.0.0",
-    "@servicetitan/anvil2": "3.1.0"
+    "uuid": "^14.0.0"
   },
   "peerDependencies": {
+    "@servicetitan/anvil2": "^3.3.0",
     "@types/react": "^18 || ^19",
     "@types/react-dom": "^18 || ^19",
     "formstate": "^2.1.0",
@@ -83,7 +83,8 @@
     "unified": "^11.0.5",
     "vite": "6.4.2",
     "vitest": "^3.2.4",
-    "vitest-axe": "^0.1.0"
+    "vitest-axe": "^0.1.0",
+    "@servicetitan/anvil2": "3.3.0"
   },
   "scripts": {
     "dev": "vite",