@aiaiai-pt/design-system 0.44.0 → 0.44.1

package/components/ActionFormRenderer.svelte

@@ -479,6 +479,16 @@
     return Object.values(fileUploads).flatMap((list) => list.map((f) => f.key));
   }
 
+  /** #629 follow-up — the same keys ATTRIBUTED to the param each was
+   *  uploaded against, so consumers never have to guess positionally. */
+  function attachmentsByParam(): Record<string, string[]> {
+    const out: Record<string, string[]> = {};
+    for (const [paramKey, list] of Object.entries(fileUploads)) {
+      if (list.length) out[paramKey] = list.map((f) => f.key);
+    }
+    return out;
+  }
+
   function buildPayload(): Record<string, unknown> {
     return buildActionPayload({
       action: renderedAction ?? null,
@@ -487,6 +497,7 @@
       sourceSchema: sourceSchema(),
       rawValues: visibleValueBag(),
       attachmentKeys: allAttachmentKeys(),
+      attachmentsByParam: attachmentsByParam(),
       schemaVersion: schema?.schema_version ?? null,
       mode,
     }) as unknown as Record<string, unknown>;
@@ -662,8 +673,10 @@
       aria-required={ariaRequired}
     />
   {/if}
-  {#if mode === "public-submit"}
-    <!-- Citizen-facing: just a quiet required hint, no operator type debug. -->
+  {#if isSubmitMode}
+    <!-- EXECUTE surfaces (citizen public-submit AND staff admin-execute,
+         #629 follow-up): just a quiet required hint — the "Required / type"
+         line is operator DEBUG chrome, preview modes only. -->
     {#if parameter.required}<p class="field-meta">Required</p>{/if}
   {:else}
     <p class="field-meta">
@@ -675,8 +688,12 @@
 <div class="renderer" data-testid={`action-form-renderer-${mode}`} data-layout={resolvedLayout.key}>
   <!-- Wizard pagination (#105 P6): the ServiceFlow shell owns the step
        heading, so the renderer's own action-title header is suppressed when a
-       section is active to avoid a duplicate heading per step. -->
-  {#if activeSectionKey == null}
+       section is active to avoid a duplicate heading per step.
+       admin-execute (#629 follow-up): the HOST container (drawer/modal) owns
+       the action heading — the renderer's header would duplicate it, and the
+       "Placement preview" eyebrow + placement Badge are authoring chrome that
+       has no meaning on an execute surface. -->
+  {#if activeSectionKey == null && mode !== "admin-execute"}
     <div class="renderer-header">
       <div>
         <!-- The placement-preview eyebrow + surface badge are operator chrome —

package/components/action-form-renderer-payload.d.ts

@@ -43,12 +43,20 @@ export interface BuildArgs {
      *  attachment contract: a TOP-LEVEL `attachment_keys` sibling, never part
      *  of raw_values (the form schema doesn't validate file params). */
     attachmentKeys?: string[];
+    /** #629 follow-up — the SAME storage keys, attributed to the file param
+     *  each was uploaded against (`{param_key: [keys]}`). Additive: consumers
+     *  that only read the flat `attachment_keys` are unaffected; consumers
+     *  that must map keys back to parameters (the staff execute adapter) read
+     *  this instead of guessing positionally. */
+    attachmentsByParam?: Record<string, string[]>;
     schemaVersion: string | null;
     mode: RendererMode;
 }
 export interface ActionPayload {
     /** Uploaded file storage keys (file-typed params) — absent when none. */
     attachment_keys?: string[];
+    /** Per-param attribution of the same keys — absent when none. */
+    attachments_by_param?: Record<string, string[]>;
     source: string;
     action: {
         id: string | null;

package/components/action-form-renderer-payload.ts

@@ -46,6 +46,12 @@ export interface BuildArgs {
    *  attachment contract: a TOP-LEVEL `attachment_keys` sibling, never part
    *  of raw_values (the form schema doesn't validate file params). */
   attachmentKeys?: string[];
+  /** #629 follow-up — the SAME storage keys, attributed to the file param
+   *  each was uploaded against (`{param_key: [keys]}`). Additive: consumers
+   *  that only read the flat `attachment_keys` are unaffected; consumers
+   *  that must map keys back to parameters (the staff execute adapter) read
+   *  this instead of guessing positionally. */
+  attachmentsByParam?: Record<string, string[]>;
   schemaVersion: string | null;
   mode: RendererMode;
 }
@@ -53,6 +59,8 @@ export interface BuildArgs {
 export interface ActionPayload {
   /** Uploaded file storage keys (file-typed params) — absent when none. */
   attachment_keys?: string[];
+  /** Per-param attribution of the same keys — absent when none. */
+  attachments_by_param?: Record<string, string[]>;
   source: string;
   action: {
     id: string | null;
@@ -108,7 +116,7 @@ function pickScope(targetConfig: Record<string, unknown>): Record<string, unknow
 }
 
 export function buildActionPayload(args: BuildArgs): ActionPayload {
-  const { action, placement, targetConfig, sourceSchema, rawValues, schemaVersion, mode, attachmentKeys } = args;
+  const { action, placement, targetConfig, sourceSchema, rawValues, schemaVersion, mode, attachmentKeys, attachmentsByParam } = args;
 
   const sourceFromSchema = nullableString(sourceSchema.source);
   const targetModel =
@@ -152,6 +160,9 @@ export function buildActionPayload(args: BuildArgs): ActionPayload {
     ...(attachmentKeys && attachmentKeys.length > 0
       ? { attachment_keys: attachmentKeys }
       : {}),
+    ...(attachmentsByParam && Object.keys(attachmentsByParam).length > 0
+      ? { attachments_by_param: attachmentsByParam }
+      : {}),
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/design-system",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "description": "Design system tokens and Svelte components for aiaiai products",
   "license": "MIT",
   "type": "module",