@myparcel-dev/pdk-admin 2.1.0 → 2.2.1

package/dist/forms/helpers/getDeliveryTypes.d.ts

@@ -0,0 +1,3 @@
+import { type CarrierModel } from '@myparcel-dev/pdk-common';
+import { type SelectOption } from '../../types';
+export declare const getDeliveryTypes: (carrier: CarrierModel | undefined) => SelectOption[];

package/dist/forms/helpers/getFieldLabel.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates a translation key for a shipment option field label.
+ *
+ * Accepts `string` because option names come from the carrier context at
+ * runtime. Converts to snake_case for the translation lookup.
+ */
+export declare const getFieldLabel: (name: string) => string;

package/dist/forms/helpers/getFormCarrierName.d.ts

@@ -0,0 +1,2 @@
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+export declare const getFormCarrierName: (form: FormInstance) => string | undefined;

package/dist/forms/helpers/getPackageTypes.d.ts

@@ -0,0 +1,3 @@
+import { type CarrierModel } from '@myparcel-dev/pdk-common';
+import { type SelectOption } from '../../types';
+export declare const getPackageTypes: (carrier: CarrierModel | undefined) => SelectOption[];

package/dist/forms/helpers/index.d.ts

@@ -0,0 +1,14 @@
+export * from './addBulkEditNotification';
+export * from './addCapabilitiesClearNotification';
+export * from './createDefaultOption';
+export * from './createLabel';
+export * from './defineFormField';
+export * from './getDeliveryTypes';
+export * from './getFieldLabel';
+export * from './getFormCarrierName';
+export * from './getPackageTypes';
+export * from './resolveFormComponent';
+export * from './setFieldProp';
+export * from './triStateFieldIsEnabled';
+export * from './updateFieldsDefaults';
+export * from './useFormCapabilities';

package/dist/forms/helpers/resolveFormComponent.d.ts

@@ -0,0 +1,3 @@
+import { type Component } from 'vue';
+import { type AdminComponent } from '../../data';
+export declare const resolveFormComponent: (componentName: AdminComponent) => Component;

package/dist/forms/helpers/setFieldProp.d.ts

@@ -0,0 +1,8 @@
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type ElementInstance } from '../../types';
+type SetFieldProp = {
+    (form: FormInstance, name: string, key: string, value: unknown): void;
+    (field: ElementInstance, key: string, value: unknown, arg3?: never, arg4?: never): void;
+};
+export declare const setFieldProp: SetFieldProp;
+export {};

package/dist/forms/helpers/triStateFieldIsEnabled.d.ts

@@ -0,0 +1,2 @@
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+export declare const triStateFieldIsEnabled: (form: FormInstance, fieldName: string) => boolean;

package/dist/forms/helpers/updateFieldsDefaults.d.ts

@@ -0,0 +1,6 @@
+import { type Shipment } from '@myparcel-dev/pdk-common';
+import { type InteractiveElementInstance } from '@myparcel-dev/vue-form-builder';
+/**
+ * Update the default values of the fields based on the carrier, so the tri-state defaults are correct.
+ */
+export declare const updateFieldsDefaults: (carrier: string, { form, name }: InteractiveElementInstance, inheritedDeliveryOptions: Record<string, Shipment.ModelDeliveryOptions>) => void;

package/dist/forms/helpers/useFormCapabilities.d.ts

@@ -0,0 +1,66 @@
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type CarrierModel } from '@myparcel-dev/pdk-common';
+import { type SelectOption } from '../../types';
+import { type Formatter } from '../../composables';
+/**
+ * Bag of capability resolvers, each pre-bound to a Pinia store + orderId snapshot captured at
+ * the composable's invocation time. Returned by {@link useFormCapabilities}.
+ *
+ * The functions are plain — they don't call `useQueryStore()` / `getOrderId()` on each
+ * invocation, so they're safe to call from outside Vue setup context (e.g. inside
+ * vue-form-builder's `visibleWhen` / `disabledWhen` / `readOnlyWhen` / `afterUpdate`
+ * watchEffect-driven re-evaluators, where `inject()` is not available).
+ */
+export type FormCapabilities = {
+    /**
+     * Resolve the chosen carrier's order-level capability data — destination + weight scope only.
+     * Used to populate carrier / packageType / deliveryType dropdowns. `requires` / `excludes`
+     * are NEVER populated through this path; they only appear on `getCarrierCapabilitiesForShipment`.
+     */
+    getCarrierCapabilitiesForOrder: (form: FormInstance) => CarrierModel | undefined;
+    /**
+     * Resolve the chosen carrier's shipment-level capability data — narrowed to the full
+     * selection (carrier + packageType + deliveryType + cc + weight). Three return states:
+     *
+     * 1. **Shipment-narrow carrier** — query is `success` AND its results contain the chosen
+     *    carrier. Returns that carrier with the narrow option set.
+     * 2. **Order-level fallback** — query isn't registered, loading, or errored. Falls back to
+     *    `getCarrierCapabilitiesForOrder` so transient loading windows don't empty the form.
+     * 3. **`undefined`** — query is `success` but its results don't contain the chosen carrier.
+     *    Server has confirmed the combo is invalid; consumers must handle gracefully.
+     */
+    getCarrierCapabilitiesForShipment: (form: FormInstance) => CarrierModel | undefined;
+    /**
+     * Whether the chosen shipment configuration supports a given option. Reads from the
+     * shipment-scoped carrier; falls through to order-level data when shipment data isn't
+     * available yet.
+     */
+    hasShipmentOption: (form: FormInstance, option: string) => boolean;
+    /**
+     * Insurance amount bracket options derived from the currently selected carrier's
+     * `insuredAmount` data. Amounts in the context are in cents; emitted values are strings
+     * representing cent amounts so they round-trip through form select inputs unchanged.
+     */
+    getInsuranceOptions: (form: FormInstance, formatter: Formatter) => SelectOption[];
+};
+/**
+ * Closure-factory composable that captures Pinia + orderId references ONCE at its
+ * setup-context invocation, and returns plain resolver functions pre-bound to those captures.
+ *
+ * Why this exists: form-builder's `visibleWhen` / `disabledWhen` / `readOnlyWhen` / `afterUpdate`
+ * re-evaluators run inside an internal `watchEffect`, NOT inside Vue setup. Calling
+ * `useQueryStore()` / `useContext()` / `getOrderId()` from those callbacks fires Vue's
+ * `inject() can only be used inside setup()` warning AND can return a disconnected store
+ * instance, breaking reactive dep tracking on `queries.value[modifier]`.
+ *
+ * Capturing once here, then closing over those references in the returned resolvers, gives
+ * factories a single seam to call from setup — `const capabilities = useFormCapabilities()` — without
+ * threading a context object through every helper signature.
+ *
+ * Pinia is a singleton, so all `useFormCapabilities()` callers within the same Pinia instance
+ * reference the same underlying store. The dynamic-context entry in the store is itself a
+ * TanStack query whose `data` is reactive — `useFetchContextQuery` refetches `Dynamic` on
+ * window focus, so we read `query.data` live on every resolver call rather than snapshotting
+ * the carriers array at setup time.
+ */
+export declare const useFormCapabilities: () => FormCapabilities;

package/dist/forms/index.d.ts

@@ -0,0 +1,6 @@
+export * from './createReturnsForm';
+export * from './form-builder';
+export * from './formKeys';
+export * from './helpers';
+export * from './pluginSettings';
+export * from './shipmentOptions';

package/dist/forms/pluginSettings/createFormTab.d.ts

@@ -0,0 +1,3 @@
+import { type TabDefinition } from '../../types';
+import { type FormTab } from './types';
+export declare const createFormTab: (tab: FormTab) => TabDefinition;

package/dist/forms/pluginSettings/createPluginSettingsForm.d.ts

@@ -0,0 +1,4 @@
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type PluginSettingsTabsContext } from './types';
+export declare const createPluginSettingsForm: (id: string, view: Plugin.SettingsView, context: PluginSettingsTabsContext) => FormInstance;

package/dist/forms/pluginSettings/createPluginSettingsTabs.d.ts

@@ -0,0 +1,4 @@
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type TabDefinition } from '../../types';
+import { type PluginSettingsTabsContext } from './types';
+export declare const createPluginSettingsTabs: (view: Plugin.ModelContextPluginSettingsViewContext, context: PluginSettingsTabsContext) => TabDefinition[];

package/dist/forms/pluginSettings/createPluginSettingsTabsComponent.d.ts

@@ -0,0 +1,4 @@
+import { type Component } from 'vue';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type PluginSettingsTabsContext } from './types';
+export declare const createPluginSettingsTabsComponent: (id: string, view: Plugin.SettingsView, context: PluginSettingsTabsContext) => Component;

package/dist/forms/pluginSettings/filterPluginSettingsView.d.ts

@@ -0,0 +1,15 @@
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { OrderMode } from '../../data';
+/**
+ * Filter the plugin-settings view for the active order mode.
+ *
+ * Today the V2 hybrid surfaces all the same tabs and fields as Shipments mode so
+ * manual export keeps working. Only Order v1 hides the shipment-export-specific
+ * fields, because v1 uses fulfilment orders instead.
+ *
+ * @TODO INT-1590: once sales-channel detection lands, re-introduce tab hiding for
+ *       V2 with an active sales channel — the label/customs tabs and shipment-export
+ *       fields become irrelevant when the sales channel handles fulfilment
+ *       end-to-end.
+ */
+export declare const filterPluginSettingsView: (view: Plugin.ModelContextPluginSettingsViewContext, orderMode: OrderMode) => Plugin.ModelContextPluginSettingsViewContext;

package/dist/forms/pluginSettings/generateFormFields.d.ts

@@ -0,0 +1,8 @@
+import { type AnyElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+type GenerateFormFields = (config: {
+    fields: null | Plugin.Field[];
+    values: Record<string, unknown>;
+}, prefix?: string) => AnyElementConfiguration[];
+export declare const generateFormFields: GenerateFormFields;
+export {};

package/dist/forms/pluginSettings/index.d.ts

@@ -0,0 +1,7 @@
+export * from './createFormTab';
+export * from './createPluginSettingsForm';
+export * from './createPluginSettingsTabs';
+export * from './createPluginSettingsTabsComponent';
+export * from './filterPluginSettingsView';
+export * from './generateFormFields';
+export * from './types';

package/dist/forms/pluginSettings/resolveSettingsValues.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve settings values for a given form ID, falling back to the wildcard
+ * key when no carrier-specific settings have been saved yet.
+ *
+ * Example: "carrier.POSTNL" → try pluginSettings.carrier.POSTNL first,
+ * fall back to pluginSettings.carrier.* if it doesn't exist.
+ */
+export declare const resolveSettingsValues: (pluginSettings: Record<string, unknown>, id: string) => Record<string, unknown>;

package/dist/forms/pluginSettings/types.d.ts

@@ -0,0 +1,13 @@
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type AdminConfiguration, type TabDefinition } from '../../types';
+import { type AdminAction } from '../../data';
+import { type ActionContext } from '../../actions';
+export interface FormTab extends Omit<TabDefinition, 'component'> {
+    form: FormInstance;
+}
+export type PluginSettingsTabsContext = {
+    pluginSettings: Plugin.ModelContextDynamicContext['pluginSettings'];
+    actionContext: ActionContext<AdminAction.PluginSettingsUpdate>;
+    config: AdminConfiguration;
+};

package/dist/forms/shipmentOptions/createShipmentOptionsForm.d.ts

@@ -0,0 +1,4 @@
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type OneOrMore } from '@myparcel-dev/ts-utils';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+export declare const createShipmentOptionsForm: (orders?: OneOrMore<Plugin.ModelPdkOrder>) => FormInstance;

package/dist/forms/shipmentOptions/field.d.ts

@@ -0,0 +1,22 @@
+export type FieldName = string;
+export declare const SHIPMENT_OPTIONS = "shipmentOptions";
+export declare const CARRIER = "carrier";
+export declare const LABEL_AMOUNT = "labelAmount";
+export declare const PACKAGE_TYPE = "packageType";
+export declare const DELIVERY_TYPE = "deliveryType";
+export declare const MANUAL_WEIGHT = "manualWeight";
+export declare const LENGTH = "length";
+export declare const WIDTH = "width";
+export declare const HEIGHT = "height";
+export declare const PROP_OPTIONS = "options";
+export declare const KEY_DESCRIPTION = "description";
+export declare const KEY_SUBTEXT = "subtext";
+export declare const FIELD_CARRIER: FieldName;
+export declare const FIELD_LABEL_AMOUNT: FieldName;
+export declare const FIELD_PACKAGE_TYPE: FieldName;
+export declare const FIELD_DELIVERY_TYPE: FieldName;
+export declare const FIELD_MANUAL_WEIGHT: FieldName;
+export declare const FIELD_LENGTH: FieldName;
+export declare const FIELD_WIDTH: FieldName;
+export declare const FIELD_HEIGHT: FieldName;
+export declare const FIELD_SHIPMENT_OPTIONS_PREFIX: FieldName;

package/dist/forms/shipmentOptions/fieldFactoryRegistry.d.ts

@@ -0,0 +1,21 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from './types';
+/**
+ * Factory function signature for custom shipment option field creators.
+ *
+ * Uses `string` for fieldName because option names are determined at runtime
+ * from the carrier context and are not a fixed compile-time set.
+ */
+export type FieldFactory = (refs: ShipmentOptionsRefs, fieldName: string) => InteractiveElementConfiguration;
+/**
+ * Registry of shipment option names that require custom field rendering.
+ *
+ * Options NOT listed here are rendered as generic TriState toggles by
+ * `createShipmentOptionField`. Each entry maps an option name (as it appears in
+ * `carrier.options`) to its custom factory function.
+ *
+ * Current exceptions:
+ * - `insurance`: renders as a select/dropdown with amount brackets derived from
+ *   `insuredAmount` in the option data.
+ */
+export declare const fieldFactoryRegistry: Record<string, FieldFactory>;

package/dist/forms/shipmentOptions/fields/createCarrierField.d.ts

@@ -0,0 +1,4 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createCarrierField: (refs: ShipmentOptionsRefs, inheritedDeliveryOptions: Plugin.ModelContextOrderDataContext["inheritedDeliveryOptions"]) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createDeliveryTypeField.d.ts

@@ -0,0 +1,3 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createDeliveryTypeField: (refs: ShipmentOptionsRefs) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createDigitalStampRangeField.d.ts

@@ -0,0 +1,4 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createDigitalStampRangeField: (refs: ShipmentOptionsRefs, order?: Plugin.ModelContextOrderDataContext) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createDimensionFields.d.ts

@@ -0,0 +1,3 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createDimensionFields: (refs: ShipmentOptionsRefs) => InteractiveElementConfiguration[];

package/dist/forms/shipmentOptions/fields/createInsuranceField.d.ts

@@ -0,0 +1,17 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+/**
+ * Custom field factory for the insurance shipment option.
+ *
+ * Renders as a select/dropdown instead of a TriState toggle. Insurance amount brackets are
+ * derived from the currently selected carrier's shipment-scoped `insuredAmount` data (min/max)
+ * and refresh automatically whenever that data changes — i.e. on carrier change AND on
+ * packageType / deliveryType / weight / cc change, since those all narrow the shipment-scoped
+ * capabilities response.
+ *
+ * Visibility / disabled state is inherited from {@link createShipmentOptionField} — driven
+ * purely by `hasShipmentOption` (i.e. by the capabilities response). No manual package-type
+ * gating: if insurance isn't valid for the current combination, the API won't include it in
+ * `carrier.options` and the field will hide.
+ */
+export declare const createInsuranceField: (refs: ShipmentOptionsRefs, fieldName: string) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createLabelAmountField.d.ts

@@ -0,0 +1,3 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createLabelAmountField: (refs: ShipmentOptionsRefs) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createPackageTypeField.d.ts

@@ -0,0 +1,3 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createPackageTypeField: (refs: ShipmentOptionsRefs) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/createRef.d.ts

@@ -0,0 +1,3 @@
+import { type Ref, type UnwrapRef } from 'vue';
+import { type ShipmentOptionsRefs } from '../types';
+export declare const createRef: <T>(refs: ShipmentOptionsRefs, field: string, fallback?: T) => Ref<UnwrapRef<T>>;

package/dist/forms/shipmentOptions/fields/createShipmentOptionField.d.ts

@@ -0,0 +1,15 @@
+import { type InteractiveElementConfiguration } from '@myparcel-dev/vue-form-builder';
+import { type ShipmentOptionsRefs } from '../types';
+/**
+ * Creates a generic shipment option field as a TriState toggle.
+ *
+ * Default factory for any option from `carrier.options` that doesn't have a custom factory in
+ * `fieldFactoryRegistry`. `requires` / `excludes` are sourced from the shipment-scoped
+ * response (`getCarrierCapabilitiesForShipment`); they're absent while the shipment query is loading or
+ * falling back to order-level data — locking doesn't run during those windows.
+ *
+ * `useFormCapabilities()` is called at factory invocation (setup-time) so visibility, disabled,
+ * readOnly and afterUpdate handlers close over a captured Pinia store + orderId — no
+ * `inject()` calls during form-builder's watchEffect-driven re-evaluators.
+ */
+export declare const createShipmentOptionField: (refs: ShipmentOptionsRefs, fieldName: string, config?: Partial<InteractiveElementConfiguration>) => InteractiveElementConfiguration;

package/dist/forms/shipmentOptions/fields/index.d.ts

@@ -0,0 +1,7 @@
+export * from './createDigitalStampRangeField';
+export * from './createDimensionFields';
+export * from './createInsuranceField';
+export * from './createLabelAmountField';
+export * from './createPackageTypeField';
+export * from './createRef';
+export * from './createShipmentOptionField';

package/dist/forms/shipmentOptions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './createShipmentOptionsForm';
+export * from './field';
+export * from './fields';
+export * from './types';

package/dist/forms/shipmentOptions/types.d.ts

@@ -0,0 +1,2 @@
+import { type FieldName } from './field';
+export type ShipmentOptionsRefs = Record<FieldName, unknown>;

package/dist/forms/shipmentOptions/useCapabilitiesAutoClear.d.ts

@@ -0,0 +1,36 @@
+import { type Ref } from 'vue';
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type CapabilitiesSelection } from './wireProxyCapabilities';
+type InheritedDeliveryOptions = Plugin.ModelContextOrderDataContext['inheritedDeliveryOptions'];
+/**
+ * Watch the form's selection refs and the capability queries, and roll back any field that
+ * has become invalid because of another axis changing. Each clear is announced through a
+ * single rolling form-level notification (see {@link addCapabilitiesClearNotification}).
+ *
+ * The core rule (per design): when a user action invalidates the form, the field the user
+ * just touched is cleared — they're already at that field in the UI, so they immediately
+ * see the rollback and can pick again. We never silently mutate fields the user previously
+ * set without notifying them.
+ *
+ * Three independent invalidation sources are handled, each in its own watcher:
+ *
+ * 1. **Cross-axis (synchronous) — order data**: when the chosen carrier's `packageTypes` /
+ *    `deliveryTypes` (from the order query) no longer contain the form's current value,
+ *    we clear that field. Carrier-change is special-cased through the same silent +
+ *    inherited-defaults flow as the shipment-query path; without that, the order watcher
+ *    (which fires synchronously) would emit a noisy notification before the debounced
+ *    shipment watcher gets a chance to apply the silent reset.
+ * 2. **Shipment-empty — server invalidation**: when the shipment query returns no entry for
+ *    the chosen carrier (empty `results` or carrier not present), the server has confirmed
+ *    the combination isn't valid. Clears the just-touched axis (or deliveryType by default).
+ * 3. **Option key dropped — cross-axis effect on options**: when the shipment query has the
+ *    chosen carrier but its `options` no longer carries an option key the form has active,
+ *    that option is cleared (`TriState.Inherit`). Axis intent wins over an active option.
+ *
+ * Form values are read via `form.getValue(name)` rather than `form.values[name]` so reactive
+ * dep tracking inside `computed` / `watch` callbacks fires correctly (the PDK's existing
+ * `createValueGetter` follows the same pattern).
+ */
+export declare const useCapabilitiesAutoClear: (form: FormInstance, allOptionKeys: string[], orderId: string, inheritedDeliveryOptions: InheritedDeliveryOptions, selection: Readonly<Ref<CapabilitiesSelection>>) => void;
+export {};

package/dist/forms/shipmentOptions/useCapabilitiesWatcher.d.ts

@@ -0,0 +1,22 @@
+import { type MaybeRefOrGetter, type Ref } from 'vue';
+import { type CapabilitiesSelection } from '../../actions/composables/queries/account/useShipmentCapabilitiesQuery';
+export type OrderInput = {
+    cc?: string;
+    weight?: number;
+    isBusiness?: boolean;
+};
+export type FormInput = {
+    carrier?: string;
+    packageType?: string;
+    deliveryType?: string;
+};
+/**
+ * Merge an order source and a shipment-options form source into a single debounced selection
+ * ref suitable for the order and shipment capabilities queries. Rapid form-state changes
+ * (clicking through carriers, toggling options) collapse into one query refetch after the
+ * user pauses.
+ *
+ * Inputs accept any of `Ref<T>`, `ComputedRef<T>`, or `() => T` so callers can pass whatever
+ * shape they already have.
+ */
+export declare const useCapabilitiesWatcher: (order: MaybeRefOrGetter<OrderInput>, form: MaybeRefOrGetter<FormInput>) => Readonly<Ref<CapabilitiesSelection>>;

package/dist/forms/shipmentOptions/wireProxyCapabilities.d.ts

@@ -0,0 +1,31 @@
+import { type Ref } from 'vue';
+import { type FormInstance } from '@myparcel-dev/vue-form-builder';
+import { type Plugin } from '@myparcel-dev/pdk-common';
+import { type CapabilitiesSelection } from '../../actions/composables/queries/account/useShipmentCapabilitiesQuery';
+/**
+ * Wire BOTH capabilities queries — order-scoped (cc + weight + isBusiness) and shipment-scoped
+ * (full selection) — into the shipment-options form for a single order, register them in the
+ * query store under composite-string modifiers (`${orderId}.order` and `${orderId}.shipment`),
+ * and tear them down when the form's scope disposes (modal close).
+ *
+ * The two queries serve different concerns:
+ *
+ * - **Order query** drives the carrier / packageType / deliveryType dropdowns from each
+ *   carrier's flat union arrays. Refetches only when destination, weight or the recipient
+ *   business flag change.
+ * - **Shipment query** drives per-option metadata (`isRequired`, `requires`, `excludes`,
+ *   `insuredAmount`) for the chosen combination. Refetches when any axis of the selection
+ *   changes; the empty-result case is the invalid-combo signal consumed by
+ *   `useCapabilitiesAutoClear`.
+ *
+ * Manual-weight reactivity: weight is sourced from `FIELD_MANUAL_WEIGHT` when the user has set
+ * one, otherwise from `order.physicalProperties.initialWeight`. Both queries refetch when
+ * weight changes through the slider.
+ *
+ * Skipped for bulk forms (no single orderId) and for orders without an externalIdentifier (no
+ * key to register under).
+ */
+export declare const wireProxyCapabilities: (form: FormInstance, order: Plugin.ModelContextOrderDataContext) => {
+    selection: Readonly<Ref<CapabilitiesSelection>>;
+} | undefined;
+export type { CapabilitiesSelection };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type { AnyElementConfiguration, AnyElementInstance, ComponentOrHtmlElement, FormConfiguration, FormInstance, InteractiveElementConfiguration, InteractiveElementInstance, PlainElementConfiguration, PlainElementInstance, ResolvedElementConfiguration, } from '@myparcel-dev/vue-form-builder';
+export * from './actions';
+export * from './deprecated';
+export * from './types';
+export * from './views/integrated';
+export * from '@myparcel-dev/pdk-common';
+export { ActionButton, BulkSelectCheckbox, NotificationContainer, PackageType, PlainElement, ResetButton, ReturnsForm, ShipmentBarcode, ShipmentOptionsForm, ShipmentStatus, StatusIndicator, SubmitButton, TabNavigation, } from './components';
+export { AdminAction, AdminComponent, AdminIcon, AdminInstanceContextKey, AdminModalKey, AdminView, NotificationCategory, OrderMode, allAdminComponentNames, optionalAdminActionContainerComponentNames, optionalAdminComponentNames, optionalAdminPlainWrapperComponentNames, requiredAdminComponentNames, } from './data';
+export { FORM_KEYS, FORM_KEY_ACCOUNT_SETTINGS, FORM_KEY_CHILD_PRODUCT_SETTINGS, FORM_KEY_MODAL, FORM_KEY_MODAL_PRINT_OPTIONS, FORM_KEY_MODAL_RETURN_OPTIONS, FORM_KEY_MODAL_SHIPMENT_OPTIONS, FORM_KEY_PLUGIN_SETTINGS, FORM_KEY_PRODUCT_SETTINGS, resolveFormComponent, } from './forms';
+export { FormHook, useElement, useForm, useFormBuilder } from '@myparcel-dev/vue-form-builder';
+export { INJECT_ADMIN_INSTANCE, INJECT_GLOBAL_PDK_ADMIN } from './symbols';
+export { LogLevel, getActionIdentifier } from './services';
+export { PdkAdmin, createPdkAdmin } from './pdk';
+export { createAdminConfig, createPdkAdminPlugin } from './pdk';
+export { createFormElement } from './utils';
+export { createLogger } from './services';
+export { generateFieldId, prefixComponent } from './utils';
+export { useActionStore, useModalStore, useNotificationStore, useQueryStore } from './stores';
+export { useAdminConfig, useAppInfo, useCheckboxGroupContext, useDropOffInputContext, useDropdownButtonContext, useElementContext, useElementOptions, useFormatter, useGlobalContext, useGlobalPdkAdmin, useInputWithOptionsContext, useLanguage, useLoadMore, useLogger, useModalContext, useModalElementContext, useMultiSelectInputContext, useOrderData, useOrderMode, useOrdersData, useProductData, useRadioGroupContext, useSelectInputContext, useShippingMethodsInputContext, useStoreQuery, useTableContext, useToggleInputContext, useTriStateInputContext, useWeekdays, } from './composables';

package/dist/pdk/PdkAdmin.d.ts

@@ -0,0 +1,18 @@
+import { type App } from 'vue';
+import { type AdminAppConfig, type AdminConfiguration, type AdminContextObject } from '../types';
+import { AdminView } from '../data';
+export declare class PdkAdmin {
+    readonly config: AdminConfiguration;
+    readonly context: AdminContextObject;
+    readonly renderedComponents: string[];
+    constructor(config: AdminConfiguration, context: AdminContextObject);
+    /**
+     * Render a views in given selector.
+     */
+    render(view: AdminView, selector: string): Promise<void>;
+    protected createApp(view: AdminView, appConfig: AdminAppConfig): Promise<App>;
+    /**
+     * Create a unique app name for components that are rendered multiple times.
+     */
+    protected createAppName(componentName: AdminView, context: AdminContextObject): string;
+}

package/dist/pdk/boot.d.ts

@@ -0,0 +1,3 @@
+import { type AdminContextObject } from '../types';
+import { type PdkAdmin } from './PdkAdmin';
+export declare const boot: (pdkAdmin: PdkAdmin, context: AdminContextObject) => void;

package/dist/pdk/createAdminConfig.d.ts

@@ -0,0 +1,2 @@
+import { type AdminConfiguration, type InputAdminConfiguration } from '../types';
+export declare const createAdminConfig: (customConfig?: InputAdminConfiguration | undefined) => AdminConfiguration;

package/dist/pdk/createPdkAdmin.d.ts

@@ -0,0 +1,8 @@
+import { type InputAdminConfiguration } from '../types';
+import { PdkAdmin } from './PdkAdmin';
+export type CreatePdkAdmin = (configuration?: InputAdminConfiguration) => undefined | PdkAdmin;
+/**
+ * Initialize the pdk frontend, parse configuration, and send a boot event that triggers the
+ * components to render themselves using the PdkAdmin class.
+ */
+export declare const createPdkAdmin: CreatePdkAdmin;

package/dist/pdk/createPdkAdminPlugin.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin } from 'vue';
+import { type AdminContextObject, type InputAdminConfiguration } from '../types';
+export declare const createPdkAdminPlugin: (config: InputAdminConfiguration, context: AdminContextObject) => Plugin;

package/dist/pdk/fillShipmentsQueryData.d.ts

@@ -0,0 +1,4 @@
+import { type QueryClient } from '@tanstack/vue-query';
+import { type Plugin, type Shipment } from '@myparcel-dev/pdk-common';
+import { type OneOrMore } from '@myparcel-dev/ts-utils';
+export declare const fillShipmentsQueryData: (queryClient: QueryClient, shipments: OneOrMore<Shipment.ModelShipment>, order?: Plugin.ModelPdkOrder) => void;

package/dist/pdk/index.d.ts

@@ -0,0 +1,11 @@
+export * from './PdkAdmin';
+export * from './boot';
+export * from './createAdminConfig';
+export * from './createPdkAdmin';
+export * from './createPdkAdminPlugin';
+export * from './fillShipmentsQueryData';
+export * from './instance';
+export * from './renderMap';
+export * from './sendBootEvent';
+export * from './setupAdminApp';
+export * from './testIdDirective';

package/dist/pdk/instance/createInstanceContext.d.ts

@@ -0,0 +1,5 @@
+import { type AdminContextObject, type AdminInstanceContext } from '../../types';
+/**
+ * Creates a context object for the current instance.
+ */
+export declare const createInstanceContext: (context: AdminContextObject) => Partial<AdminInstanceContext>;

package/dist/pdk/instance/createQueryClient.d.ts

@@ -0,0 +1,2 @@
+import { QueryClient } from '@tanstack/vue-query';
+export declare const createQueryClient: () => QueryClient;

package/dist/pdk/instance/index.d.ts

@@ -0,0 +1,3 @@
+export * from './createInstanceContext';
+export * from './createQueryClient';
+export * from './plugins';

package/dist/pdk/instance/plugins/createContextPlugin.d.ts

@@ -0,0 +1,2 @@
+import { type PdkAppPlugin } from './plugins.types';
+export declare const createContextPlugin: PdkAppPlugin;

package/dist/pdk/instance/plugins/createLoggerPlugin.d.ts

@@ -0,0 +1,2 @@
+import { type PdkAppPlugin } from './plugins.types';
+export declare const createLoggerPlugin: PdkAppPlugin;

package/dist/pdk/instance/plugins/createRegisterComponentsPlugin.d.ts

@@ -0,0 +1,5 @@
+import { type PdkAppPlugin } from './plugins.types';
+/**
+ * Registers all replaceable vue components. They must all be provided, for tree shaking purposes.
+ */
+export declare const createRegisterComponentsPlugin: PdkAppPlugin;

package/dist/pdk/instance/plugins/createStorePlugin.d.ts

@@ -0,0 +1,2 @@
+import { type PdkAppPlugin } from './plugins.types';
+export declare const createStorePlugin: PdkAppPlugin;

package/dist/pdk/instance/plugins/createVueQueryPlugin.d.ts

@@ -0,0 +1,5 @@
+import { type PdkAppPlugin } from './plugins.types';
+/**
+ * Instantiate vue query client if it does not exist yet and provide it to the app.
+ */
+export declare const createVueQueryPlugin: PdkAppPlugin;

package/dist/pdk/instance/plugins/index.d.ts

@@ -0,0 +1,6 @@
+export * from './createContextPlugin';
+export * from './createLoggerPlugin';
+export * from './createRegisterComponentsPlugin';
+export * from './createStorePlugin';
+export * from './createVueQueryPlugin';
+export * from './plugins.types';

package/dist/pdk/instance/plugins/plugins.types.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin } from 'vue';
+import { type AdminAppConfig } from '../../../types';
+export type PdkAppPlugin = (appConfig: AdminAppConfig) => Plugin;

package/dist/pdk/renderMap.d.ts

@@ -0,0 +1,3 @@
+import { type Component } from 'vue';
+import { AdminView } from '../data';
+export declare const renderViewComponent: (componentName: AdminView) => Promise<Component>;