@streamline-pulse/formkrafter-core 0.15.2 → 0.17.0

package/README.md

@@ -4,7 +4,7 @@ The framework-agnostic heart of FormKrafter: form **specs**, immutable **mutatio
 
 ## The spec
 
-A form is a tree of `BrickSpec` nodes. Each brick has a `type` (`input`, `panel`, `collection`, `output`, `action`), an `id` (which registered brick renders it), `configs` (with a unique `uid` and a data `key`), plus optional `validations`, `rules`, `styles`, and `children`.
+A form is a tree of `BrickSpec` nodes. Each brick has a `type` (`input`, `panel`, `collection`, `output`, `action`), an `id` (which registered brick renders it), `configs` (with a data `key`), plus optional `validations`, `rules`, `styles`, and `children`.
 
 ```mermaid
 flowchart TD
@@ -40,7 +40,7 @@ flowchart LR
     H -->|redo → apply patches| S1[spec']
 ```
 
-Available ops: `addBrick`, `removeBrick`, `moveBrick`, `duplicateBrick` (fresh uids), `updateBrickConfigs`, `updateBrickStyles`, `updateBrickValidations`, `updateBrickRules`. Addressing helpers: `getBrickAt(spec, path)`, `pointerOfUid(spec, uid)`, `iterateBricks(spec)`.
+Available ops: `addBrick`, `removeBrick`, `moveBrick`, `duplicateBrick`, `updateBrickConfigs`, `updateBrickStyles`, `updateBrickValidations`, `updateBrickRules`. Addressing helpers: `getBrickAt(spec, path)`, `pointerFromPath(path)`, `iterateBricks(spec)`.
 
 Patches are plain RFC 6902 — persist them, sync them, audit them.
 

package/dist/brick/brick.d.ts

@@ -8,8 +8,8 @@ import type { BrickType } from "../utils/brick-type";
 import type { BrickBaseConfigs, CommonBrickProps } from "../utils/common-brick-props";
 import type { BrickMoldDropType } from "../utils/drop-type";
 export interface BrickProps<DataType, Configs extends BrickBaseConfigs, Styles> extends CommonBrickProps<Configs, Styles> {
-    onConfigsChange?: (configs: BrickBaseConfigs & Record<string, unknown>, uid?: string) => void;
-    onStylesChange?: (styles: Record<string, unknown>, uid?: string) => void;
+    onConfigsChange?: (configs: BrickBaseConfigs & Record<string, unknown>, path?: string) => void;
+    onStylesChange?: (styles: Record<string, unknown>, path?: string) => void;
     data?: DataType;
     dataMap?: Record<string, unknown>;
     rootSpec?: BrickSpec;
@@ -26,9 +26,9 @@ export interface BrickProps<DataType, Configs extends BrickBaseConfigs, Styles>
     brickSpec?: BrickSpec;
     editable?: boolean;
     validations?: Validation[];
-    onValidationsChange?: (validations: Validation[], uid?: string) => void;
+    onValidationsChange?: (validations: Validation[], path?: string) => void;
     rules?: Rule[];
-    onRulesChange?: (rules: Rule[], uid?: string) => void;
+    onRulesChange?: (rules: Rule[], path?: string) => void;
     utils: Utils;
 }
 export declare abstract class Brick<DataType, Configs extends BrickBaseConfigs, Styles extends Record<string, unknown>> {

package/dist/index.d.ts

@@ -27,7 +27,7 @@ export { DataSourceService, FetchDataSourceService } from "./services/data_sourc
 export { FileLike, UploadedFile, FileUploadService, FileUploadOptions, Base64FileUploadService, UrlFileUploadService, UrlFileUploadDefaults } from "./services/file_upload_service";
 export { LocalizedText, isLocalizedObject, resolveLocalizedText, resolveLocalizedRecord } from "./utils/localized-text";
 export { FkTranslations, setFkTranslations, fkT, fkTOr, frFkTranslations } from "./i18n";
-export { pointerFromPath, pointerOfUid, getBrickAt } from "./ops/pointer";
+export { pointerFromPath, getBrickAt } from "./ops/pointer";
 export { SpecUpdate, addBrick, removeBrick, moveBrick, duplicateBrick, updateBrickConfigs, updateBrickStyles, updateBrickValidations, updateBrickRules } from "./ops/ops";
 export { SpecHistory } from "./ops/history";
 export type { Operation } from "fast-json-patch";

package/dist/index.js

@@ -7125,6 +7125,7 @@ var en = {
   "panel.content": "Content",
   "panel.dataKey": "Data key",
   "panel.url": "URL",
+  "panel.responsePath": "Response path (optional)",
   "panel.headers": "Headers ({token} reads form data)",
   "panel.searchParam": "Server search param",
   "panel.labelKey": "Label key",
@@ -7259,6 +7260,7 @@ var frFkTranslations = {
   "panel.content": "Contenu",
   "panel.dataKey": "Clé de données",
   "panel.url": "URL",
+  "panel.responsePath": "Chemin dans la réponse (optionnel)",
   "panel.headers": "En-têtes ({token} lit les données du formulaire)",
   "panel.searchParam": "Paramètre de recherche serveur",
   "panel.labelKey": "Clé du libellé",
@@ -7710,7 +7712,68 @@ class SandboxJsRunnerService {
   }
 }
 
+// lib/utils/remote.ts
+function resolvePath(source, path) {
+  if (Object.prototype.hasOwnProperty.call(source, path))
+    return source[path];
+  let current = source;
+  for (const segment of path.split(".")) {
+    if (current === null || typeof current !== "object")
+      return;
+    if (!Object.prototype.hasOwnProperty.call(current, segment))
+      return;
+    current = current[segment];
+  }
+  return current;
+}
+function interpolateTemplate(template, dataMap) {
+  return template.replace(/\{([\w.]+)\}/g, (_, token) => {
+    const value = dataMap && resolvePath(dataMap, token);
+    return value === undefined || value === null ? "" : String(value);
+  });
+}
+function parseHeaderLines(raw, dataMap) {
+  if (typeof raw !== "string" || !raw.trim())
+    return;
+  const headers = {};
+  for (const line of raw.split(`
+`)) {
+    const separator = line.indexOf(":");
+    if (separator <= 0)
+      continue;
+    const name = line.slice(0, separator).trim();
+    const value = interpolateTemplate(line.slice(separator + 1).trim(), dataMap);
+    if (name)
+      headers[name] = value;
+  }
+  return Object.keys(headers).length ? headers : undefined;
+}
+function appendSearchParam(url, param, term) {
+  if (!term)
+    return url;
+  const separator = url.includes("?") ? "&" : "?";
+  return `${url}${separator}${encodeURIComponent(param)}=${encodeURIComponent(term)}`;
+}
+
 // lib/services/data_source_service.ts
+function optionsFromPayload(json, url, path) {
+  if (path) {
+    const picked = json !== null && typeof json === "object" ? resolvePath(json, path) : undefined;
+    if (!Array.isArray(picked)) {
+      throw new Error(`Data source has no array at "${path}": ${url}`);
+    }
+    return picked;
+  }
+  if (Array.isArray(json))
+    return json;
+  if (json !== null && typeof json === "object") {
+    const envelope = json.data;
+    if (Array.isArray(envelope))
+      return envelope;
+  }
+  throw new Error(`Data source did not return an array: ${url}`);
+}
+
 class FetchDataSourceService {
   defaults;
   cache = new Map;
@@ -7724,7 +7787,7 @@ class FetchDataSourceService {
       init.headers = headers;
     if (this.defaults.credentials)
       init.credentials = this.defaults.credentials;
-    const key = `${url}|${JSON.stringify(init)}`;
+    const key = `${url}|${JSON.stringify(init)}|${options?.path ?? ""}`;
     let pending = this.cache.get(key);
     if (!pending) {
       pending = fetch(url, Object.keys(init).length ? init : undefined).then((response) => {
@@ -7732,12 +7795,7 @@ class FetchDataSourceService {
           throw new Error(`Data source request failed (${response.status}): ${url}`);
         }
         return response.json();
-      }).then((json) => {
-        if (!Array.isArray(json)) {
-          throw new Error(`Data source did not return an array: ${url}`);
-        }
-        return json;
-      }).catch((error) => {
+      }).then((json) => optionsFromPayload(json, url, options?.path)).catch((error) => {
         this.cache.delete(key);
         throw error;
       });
@@ -8148,35 +8206,6 @@ function stripUidsFromPatches(patches) {
     value: stripPatchValue(patch.value, patch.path)
   } : patch);
 }
-// lib/utils/remote.ts
-function interpolateTemplate(template, dataMap) {
-  return template.replace(/\{(\w+)\}/g, (_, token) => {
-    const value = dataMap?.[token];
-    return value === undefined || value === null ? "" : String(value);
-  });
-}
-function parseHeaderLines(raw, dataMap) {
-  if (typeof raw !== "string" || !raw.trim())
-    return;
-  const headers = {};
-  for (const line of raw.split(`
-`)) {
-    const separator = line.indexOf(":");
-    if (separator <= 0)
-      continue;
-    const name = line.slice(0, separator).trim();
-    const value = interpolateTemplate(line.slice(separator + 1).trim(), dataMap);
-    if (name)
-      headers[name] = value;
-  }
-  return Object.keys(headers).length ? headers : undefined;
-}
-function appendSearchParam(url, param, term) {
-  if (!term)
-    return url;
-  const separator = url.includes("?") ? "&" : "?";
-  return `${url}${separator}${encodeURIComponent(param)}=${encodeURIComponent(term)}`;
-}
 // lib/brick/brick.ts
 class Brick {
   type;
@@ -8414,19 +8443,14 @@ ${js}})();`;
 function pointerFromPath(path) {
   return path.split(".").slice(1).map((segment) => `/children/${segment}`).join("");
 }
-function pointerOfUid(spec, uid) {
-  if (spec.configs?.uid === uid)
-    return "";
-  for (const [index, child] of (spec.children ?? []).entries()) {
-    const childPointer = pointerOfUid(child, uid);
-    if (childPointer !== undefined)
-      return `/children/${index}${childPointer}`;
-  }
-  return;
-}
 function getBrickAt(spec, path) {
+  const [root, ...segments] = path.split(".");
+  if (root !== "0")
+    return;
   let current = spec;
-  for (const segment of path.split(".").slice(1)) {
+  for (const segment of segments) {
+    if (!/^\d+$/.test(segment))
+      return;
     current = current?.children?.[Number(segment)];
   }
   return current;
@@ -8448,16 +8472,10 @@ var requireBrickAt = (spec, path) => {
     throw new Error(`No brick at path "${path}"`);
   return brick;
 };
-var requireBrickByUid = (spec, uid) => {
-  const pointer = pointerOfUid(spec, uid);
-  if (pointer === undefined)
-    throw new Error(`No brick with uid "${uid}"`);
-  let brick = spec;
-  for (const segment of pointer.split("/children/").slice(1)) {
-    brick = brick.children[Number(segment)];
-  }
-  return { pointer, brick };
-};
+var requireBrickForUpdate = (spec, path) => ({
+  pointer: pointerFromPath(path),
+  brick: requireBrickAt(spec, path)
+});
 var toJsonValue = (value) => JSON.parse(JSON.stringify(value));
 function addBrick(spec, brick, parentPath, index) {
   const parent = requireBrickAt(spec, parentPath);
@@ -8527,22 +8545,22 @@ var setBrickSection = (spec, brickPointer, section, value, previous) => {
   }
   return apply(spec, [{ op: "replace", path: pointer, value }], [{ op: "replace", path: pointer, value: previous }]);
 };
-function updateBrickConfigs(spec, uid, configs) {
-  const { pointer, brick } = requireBrickByUid(spec, uid);
+function updateBrickConfigs(spec, path, configs) {
+  const { pointer, brick } = requireBrickForUpdate(spec, path);
   const merged = { ...brick.configs, ...configs };
   return setBrickSection(spec, pointer, "configs", merged, brick.configs);
 }
-function updateBrickStyles(spec, uid, styles) {
-  const { pointer, brick } = requireBrickByUid(spec, uid);
+function updateBrickStyles(spec, path, styles) {
+  const { pointer, brick } = requireBrickForUpdate(spec, path);
   const merged = { ...brick.styles, ...styles };
   return setBrickSection(spec, pointer, "styles", merged, brick.styles);
 }
-function updateBrickValidations(spec, uid, validations) {
-  const { pointer, brick } = requireBrickByUid(spec, uid);
+function updateBrickValidations(spec, path, validations) {
+  const { pointer, brick } = requireBrickForUpdate(spec, path);
   return setBrickSection(spec, pointer, "validations", validations, brick.validations);
 }
-function updateBrickRules(spec, uid, rules) {
-  const { pointer, brick } = requireBrickByUid(spec, uid);
+function updateBrickRules(spec, path, rules) {
+  const { pointer, brick } = requireBrickForUpdate(spec, path);
   return setBrickSection(spec, pointer, "rules", rules, brick.rules);
 }
 // lib/ops/history.ts
@@ -9181,7 +9199,6 @@ export {
   resolveLocalizedRecord,
   removeBrick,
   registerValidationMessages,
-  pointerOfUid,
   pointerFromPath,
   parseHeaderLines,
   normalizeOptions,
@@ -9219,5 +9236,5 @@ export {
   Base64FileUploadService
 };
 
-//# debugId=F8E3FDC2C406A49364756E2164756E21
+//# debugId=7CC5CCE3A23FDF4A64756E2164756E21
 //# sourceMappingURL=index.js.map