@lotics/app-sdk 0.36.0 → 0.36.1

package/AGENTS.md

@@ -48,9 +48,12 @@ Pick by intent. (→ open the `.d.ts` for the exact signature.)
   local object-URL preview AT ONCE and uploads in the background; each `files[]` entry carries
   `{ id, filename, mime_type, preview_url, status, file_id? }`; previews are revoked on remove/clear.
   Picking is yours (button → `@lotics/ui` `pickFiles`, or paste/drop) — pass the `File[]` to `add`.
-  Wire to `@lotics/ui` `Composer`: `actionsButton` triggers the pick, `files` maps to
-  `<FileThumbnail … uploading={f.status === "uploading"} />`, `sendDisabled` gates on `uploading`,
-  and the send payload is `fileIds`. Don't hand-roll `createObjectURL`/upload/revoke per app.
+  Wire to `@lotics/ui` `Composer`: `actionsButton` triggers the pick, then map each `AttachedFile`
+  to a `DisplayFile` (snake → camel — `mime_type`→`mimeType`, `preview_url`→`url` — the app owns this
+  data→UI adapter; the SDK never imports `@lotics/ui`) for
+  `<FileThumbnail file={{ id, filename, mimeType, url }} uploading={f.status === "uploading"} />`;
+  `sendDisabled` gates on `uploading` and the send payload is `fileIds`. Don't hand-roll
+  `createObjectURL`/upload/revoke per app.
 - **List members** — **`useMembers(opts?)`** → `{ members: {id,name,email,image}[], loading, error }`
   — the candidate set for an assign/picker. Gated: the app must declare a `member`-typed input
   (`opts.group` restricts to a declared group). Render with `@lotics/ui` `MemberSelect` / `MemberChip`.

package/dist/src/hooks.d.ts

@@ -355,7 +355,13 @@ interface AttachmentsState {
  * const { files, add, remove, clear, uploading, fileIds } = useAttachments();
  * const design = useWorkflow("design");
  * // attach:  <Button icon="paperclip" onPress={() => pickFiles({ accept: "image/*" }).then(add)} />
- * // preview: files.map((f) => <FileThumbnail file={f} uploading={f.status === "uploading"} onRemove={() => remove(f.id)} />)
+ * // preview: map each AttachedFile to a @lotics/ui DisplayFile (snake_case → camelCase) — the
+ * //          app owns this data→UI adapter; the SDK never imports @lotics/ui:
+ * //   files.map((f) => (
+ * //     <FileThumbnail
+ * //       file={{ id: f.id, filename: f.filename, mimeType: f.mime_type, url: f.preview_url }}
+ * //       uploading={f.status === "uploading"} onRemove={() => remove(f.id)} />
+ * //   ))
  * // send:    design({ photo: fileIds[0] }); clear();
  * ```
  */

package/dist/src/hooks.js

@@ -259,7 +259,13 @@ let attachSeq = 0;
  * const { files, add, remove, clear, uploading, fileIds } = useAttachments();
  * const design = useWorkflow("design");
  * // attach:  <Button icon="paperclip" onPress={() => pickFiles({ accept: "image/*" }).then(add)} />
- * // preview: files.map((f) => <FileThumbnail file={f} uploading={f.status === "uploading"} onRemove={() => remove(f.id)} />)
+ * // preview: map each AttachedFile to a @lotics/ui DisplayFile (snake_case → camelCase) — the
+ * //          app owns this data→UI adapter; the SDK never imports @lotics/ui:
+ * //   files.map((f) => (
+ * //     <FileThumbnail
+ * //       file={{ id: f.id, filename: f.filename, mimeType: f.mime_type, url: f.preview_url }}
+ * //       uploading={f.status === "uploading"} onRemove={() => remove(f.id)} />
+ * //   ))
  * // send:    design({ photo: fileIds[0] }); clear();
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.36.0",
+  "version": "0.36.1",
   "description": "Runtime SDK for Lotics custom-code apps — typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {