@vc-shell/framework 2.5.0-pr341.2eb87f6 → 2.5.0-pr343.9724376

package/dist/core/composables/useDynamicProperties/resolveControlKind.d.ts

@@ -0,0 +1,23 @@
+import type { IBaseProperty } from "./types";
+/**
+ * Which control `VcDynamicProperty` renders for a property.
+ *
+ * This exists because the choice was encoded twice: once here in effect, as a
+ * chain of sixteen ordered `v-else-if` conditions in the template, and once in
+ * `resolveStrategy`, which decides how the value is read and written. The two
+ * chains had opposite precedence — the template tested `dictionary` first,
+ * `resolveStrategy` tests `Measure` first — so they disagreed.
+ *
+ * A `Measure` property carrying a dictionary got the dictionary `VcSelect`,
+ * while `measureStrategy` read `values[0].value` and wrote
+ * `{ value, unitOfMeasureId }`. The select works in `valueId`, so it showed
+ * nothing selected and stored no dictionary reference, and the unit could not
+ * be set at all. `Boolean` with a dictionary diverged the same way.
+ *
+ * Precedence here mirrors `resolveStrategy` exactly. The strategy is the data
+ * contract — non-UI code reads through it — so the control follows it, not the
+ * other way round.
+ */
+export type ControlKind = "dictionary" | "measure" | "boolean" | "datetime" | "long-text" | "number" | "number-multivalue" | "integer" | "integer-multivalue" | "short-text" | "short-text-multivalue" | "multivalue-dictionary" | "color" | "color-dictionary" | "color-multivalue" | "color-multivalue-dictionary" | "unsupported";
+export declare function resolveControlKind(property: IBaseProperty): ControlKind;
+//# sourceMappingURL=resolveControlKind.d.ts.map

package/dist/core/composables/useDynamicProperties/resolveControlKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveControlKind.d.ts","sourceRoot":"","sources":["../../../../core/composables/useDynamicProperties/resolveControlKind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,mBAAmB,GACnB,SAAS,GACT,oBAAoB,GACpB,YAAY,GACZ,uBAAuB,GACvB,uBAAuB,GACvB,OAAO,GACP,kBAAkB,GAClB,kBAAkB,GAClB,6BAA6B,GAC7B,aAAa,CAAC;AAElB,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,CAwCvE"}

package/dist/core/composables/useLatestRequest/index.d.ts

@@ -6,6 +6,25 @@ export interface LatestRequest {
     complete(): void;
 }
 export interface UseLatestRequestReturn {
+    /**
+     * Runs a request and hands back its result only while it is still the newest.
+     * A superseded request resolves to `undefined`, so the caller returns early
+     * instead of writing a stale answer:
+     *
+     * ```ts
+     * const result = await search.latest(client.searchProducts(criteria));
+     * if (!result) return;
+     * searchResult.value = result;
+     * ```
+     *
+     * This is `begin`/`isCurrent`/`complete` with the bookkeeping folded in —
+     * there is no `finally` to forget. Reach for `begin` directly only when the
+     * request and the check cannot sit in the same function.
+     *
+     * Rejections propagate untouched. `undefined` means superseded, so a request
+     * whose own successful result is `undefined` needs `begin` instead.
+     */
+    latest<T>(request: Promise<T>): Promise<T | undefined>;
     /** Starts a request and supersedes any earlier one. */
     begin(): LatestRequest;
     /** Supersedes the in-flight request without starting a new one — e.g. on selection change. */
@@ -23,17 +42,15 @@ export interface UseLatestRequestReturn {
  * const search = useLatestRequest();
  *
  * async function load(criteria) {
- *   const request = search.begin();
- *   try {
- *     const result = await api.search(criteria);
- *     if (!request.isCurrent()) return;   // a newer search won
- *     items.value = result;
- *   } finally {
- *     request.complete();
- *   }
+ *   const result = await search.latest(api.search(criteria));
+ *   if (!result) return;              // a newer search won
+ *   items.value = result;
  * }
  * ```
  *
+ * `begin` is the same thing with the bookkeeping exposed, for the cases where
+ * the request and the check cannot sit in the same function.
+ *
  * This discards the late result rather than cancelling the request: the
  * generated API clients build their own `RequestInit` and take no `AbortSignal`,
  * so there is nothing to cancel through. Aborting would additionally save the

package/dist/core/composables/useLatestRequest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useLatestRequest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,IAAI,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,KAAK,IAAI,aAAa,CAAC;IACvB,8FAA8F;IAC9F,UAAU,IAAI,IAAI,CAAC;IACnB,2FAA2F;IAC3F,OAAO,IAAI,IAAI,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA2CzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useLatestRequest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,IAAI,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACvD,uDAAuD;IACvD,KAAK,IAAI,aAAa,CAAC;IACvB,8FAA8F;IAC9F,UAAU,IAAI,IAAI,CAAC;IACnB,2FAA2F;IAC3F,OAAO,IAAI,IAAI,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAsDzD"}