@wix/himalaya-cli 0.1029.0 → 0.1031.0

package/templates/nonprofit-cause/tier5-src/_shared/collection-contract.ts

@@ -14,6 +14,9 @@ export interface CollectionConfig {
   searchPlaceholder?: string;
   sortLabels?: { default: string; az: string; za: string };
   metadata?: string[];
+  /** Numeric 0–5 row field rendered as a Rating (accessible "N out of 5") instead of
+   *  folding a "★★★★☆" glyph string into the metadata line, so screen readers get a value. */
+  rating?: string;
   sectioned?: boolean;
   view: 'list' | 'grid';
   backendQuery?: boolean;
@@ -58,7 +61,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedCoupons: { rows: 'coupons', title: 'name', subtitle: 'subtitle', view: 'list', primaryVerb: { label: 'Get code' } },
   himiBrandedNotifications: { rows: 'items', title: 'name', subtitle: 'subtitle', image: 'photo', metadata: ['unreadDot'], view: 'list' },
   himiBrandedLoyalty: { rows: 'rewards', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Redeem' } },
-  himiBrandedReviews: { rows: 'reviews', title: 'title', subtitle: 'body', metadata: ['author', 'stars'], view: 'list' },
+  himiBrandedReviews: { rows: 'reviews', title: 'title', subtitle: 'body', metadata: ['author'], rating: 'rating', view: 'list' },
   himiBrandedPortfolio: { rows: 'projects', title: 'title', subtitle: 'subtitle', image: 'image', view: 'grid', gridImageHeight: 180 },
   himiBrandedInvoices: { rows: 'invoices', title: 'title', subtitle: 'subtitle', view: 'list' },
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },

package/templates/nonprofit-cause/tier5-src/_shared/owner-load-error.ts

@@ -1,6 +1,12 @@
 import { copyParam } from "./himi-copy.js";
 
-/** Host-owned preview input. Absent on native and older hosts. */
+/** Host-owned preview input. Absent on native and older hosts.
+ *
+ *  `"sample"` — the built-in demo records; `"live"` — the viewer's own business over the
+ *  owner rung; `"fixtures"` — a DEV web host over a sealed hermetic gateway, where
+ *  the dev fixtures are the sample data. `"fixtures"` is neither live nor demo, so a
+ *  worker READS through the bridge as it does on a device; it is still a preview host
+ *  (`isOwnerPreviewHost`), so failure copy may name the web preview. */
 function ownerPreviewMode(): unknown {
   return (globalThis as unknown as { himalaya?: { input?: Record<string, unknown> } }).himalaya?.input?.__himiOwnerPreview;
 }

package/templates/nonprofit-cause/tier5-src/himi-branded-lite-appearance/index.ts

@@ -1,5 +1,6 @@
 import { defineService } from "@himalaya/state";
 import {
+  ACCENT_IDS,
   ACCENT_KEY,
   ACCENT_META,
   DEFAULT_ACCENT,
@@ -29,6 +30,10 @@ interface State {
   accentHex_sage: string;
   accentHex_plum: string;
   accentHex_ocean: string;
+  // Per-accent selection flags for the radio group (`selected_<id>`) and the
+  // check mark on the swatch (`notSelected_<id>`, hiddenWhen hides on TRUE). Flat
+  // fields for the same reason as the hex ones: the swatches are static nodes.
+  [flag: `selected_${string}` | `notSelected_${string}`]: boolean | string;
 }
 
 interface StorageLike {
@@ -50,7 +55,13 @@ function paramValue(arg: unknown, key: string): string {
 }
 
 function build(pendingAccent: string, brandAccent: string): State {
+  const flags: Record<string, boolean> = {};
+  for (const id of ACCENT_IDS) {
+    flags[`selected_${id}`] = id === pendingAccent;
+    flags[`notSelected_${id}`] = id !== pendingAccent;
+  }
   return {
+    ...flags,
     pendingAccent,
     brandAccent,
     accentHex_brand: brandAccent || ACCENT_META.amber.hex,
@@ -85,7 +96,7 @@ const svc = defineService<State, {
     selectAccent: (state, arg) => {
       const id = paramValue(arg, "id");
       if (!isAccentId(id)) return state;
-      return { ...state, pendingAccent: id };
+      return build(id, state.brandAccent);
     },
     // Apply: persist the accent; the home worker re-reads it on launch.
     apply: (state) => {

package/templates/nonprofit-cause/tier5-src/wix-spaces-app-language/index.ts

@@ -5,11 +5,12 @@
 import { defineService } from "@himalaya/state";
 import { dispatch } from "@himalaya/dispatch";
 
-interface Row { id: string; name: string; subtitle: string }
+/** `selected` drives the row's radio; `subtitle` stays for older descriptors. */
+interface Row { id: string; name: string; subtitle: string; selected: boolean }
 interface S { status: "ready"; options: Row[] }
 
 /** Locales with catalogs (`tools/l10n/catalog.<tag>.json`) + LocaleStore support. */
-const LOCALE_OPTIONS: Omit<Row, "subtitle">[] = [
+const LOCALE_OPTIONS: Omit<Row, "subtitle" | "selected">[] = [
   { id: "en", name: "English" },
   { id: "es", name: "Español" },
   { id: "he", name: "עברית" },
@@ -19,6 +20,7 @@ function withSelected(selected: string): Row[] {
   return LOCALE_OPTIONS.map((o) => ({
     ...o,
     subtitle: o.id === selected ? "Selected" : "",
+    selected: o.id === selected,
   }));
 }
 

package/templates/nonprofit-cause-owner/config.ts

@@ -37,7 +37,7 @@ export default defineApp({
     actions: "http://localhost:8190/v1/actions",
     sync: "http://localhost:8190/v1/sync",
   },
-  capabilities: ["live_activity","push","share","secure_storage","open_url","local_database","clipboard","ui"],
+  capabilities: ["live_activity","push","share","secure_storage","open_url","local_database","clipboard","ui","camera","presigned_upload"],
   designTokensPath: "./tokens.json",
   navigation: {
     "navKind": "responsive",

package/templates/nonprofit-cause-owner/dev/index.ts

@@ -50090,7 +50090,7 @@ const SCREENS = runtimeSetting({
                           "itemsPath": "$service:himiOwnerLiteManage.recents",
                           "items": [
                             {
-                              "id": "",
+                              "id": "himi_owner_lite.manage.recent.$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "VStack",
@@ -50235,7 +50235,7 @@ const SCREENS = runtimeSetting({
                                           "spacing": 14,
                                           "children": [
                                             {
-                                              "id": "",
+                                              "id": "himi_owner_lite.manage.recent.create.$item.id",
                                               "body": {
                                                 "package": "himalaya",
                                                 "type": "Text",
@@ -50260,7 +50260,7 @@ const SCREENS = runtimeSetting({
                                               }
                                             },
                                             {
-                                              "id": "",
+                                              "id": "himi_owner_lite.manage.recent.handoff.$item.id",
                                               "body": {
                                                 "package": "himalaya",
                                                 "type": "Text",
@@ -50396,7 +50396,7 @@ const SCREENS = runtimeSetting({
                                   "itemsPath": "$item.areas",
                                   "items": [
                                     {
-                                      "id": "",
+                                      "id": "himi_owner_lite.manage.area.$item.id",
                                       "body": {
                                         "package": "himalaya",
                                         "type": "VStack",
@@ -50541,7 +50541,7 @@ const SCREENS = runtimeSetting({
                                                   "spacing": 14,
                                                   "children": [
                                                     {
-                                                      "id": "",
+                                                      "id": "himi_owner_lite.manage.area.create.$item.id",
                                                       "body": {
                                                         "package": "himalaya",
                                                         "type": "Text",
@@ -50566,7 +50566,7 @@ const SCREENS = runtimeSetting({
                                                       }
                                                     },
                                                     {
-                                                      "id": "",
+                                                      "id": "himi_owner_lite.manage.area.handoff.$item.id",
                                                       "body": {
                                                         "package": "himalaya",
                                                         "type": "Text",
@@ -51346,7 +51346,7 @@ const SCREENS = runtimeSetting({
                 "props": {
                   "items": [
                     {
-                      "id": "",
+                      "id": "ol_drawer_nav.$item.id",
                       "body": {
                         "package": "himalaya",
                         "type": "ListItem",
@@ -51398,7 +51398,7 @@ const SCREENS = runtimeSetting({
                         "props": {
                           "items": [
                             {
-                              "id": "",
+                              "id": "ol_drawer_attention.$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "ListItem",
@@ -54959,6 +54959,45 @@ const SCREENS = runtimeSetting({
                                 }
                               }
                             },
+                            {
+                              "id": "himi_owner_lite_aria.msg_attach_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "HStack",
+                                "props": {
+                                  "spacing": 0,
+                                  "children": [
+                                    {
+                                      "id": "",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Spacer",
+                                        "props": {}
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.notUser"
+                                      }
+                                    },
+                                    {
+                                      "id": "",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Text",
+                                        "props": {
+                                          "text": "$item.attachText",
+                                          "style": "footnote",
+                                          "color": "textSecondary",
+                                          "maxLines": 3
+                                        }
+                                      }
+                                    }
+                                  ]
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.attachHidden"
+                              }
+                            },
                             {
                               "id": "himi_owner_lite_aria.msg_$item.id.link1",
                               "body": {
@@ -58539,6 +58578,203 @@ const SCREENS = runtimeSetting({
                 }
               }
             },
+            {
+              "id": "himi_owner_lite_aria.attachments.bound",
+              "body": {
+                "package": "himalaya",
+                "type": "LazyList",
+                "props": {
+                  "itemsPath": "$service:himiOwnerLiteAria.attachments",
+                  "horizontal": true,
+                  "spacing": 8,
+                  "items": [
+                    {
+                      "id": "himi_owner_lite_aria.attachment_$item.id",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "VStack",
+                        "props": {
+                          "spacing": 4,
+                          "children": [
+                            {
+                              "id": "himi_owner_lite_aria.attachment_thumb_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Image",
+                                "props": {
+                                  "url": "$item.thumbUrl",
+                                  "width": 72,
+                                  "height": 72,
+                                  "contentMode": "fill",
+                                  "shape": "rounded",
+                                  "contentDescription": "$item.name"
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.thumbHidden"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.statusText",
+                                  "style": "caption",
+                                  "color": "textSecondary",
+                                  "maxLines": 2
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.statusHidden"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "HStack",
+                                "props": {
+                                  "spacing": 8,
+                                  "children": [
+                                    {
+                                      "id": "himi_owner_lite_aria.attachment_retry_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Text",
+                                        "props": {
+                                          "text": "Retry",
+                                          "style": "caption",
+                                          "color": "accentPrimary",
+                                          "maxLines": 1
+                                        }
+                                      },
+                                      "modifiers": {
+                                        "onTap": {
+                                          "actionId": "tier5.himiOwnerLiteAria.retryAttachment",
+                                          "params": {
+                                            "id": "$item.id"
+                                          }
+                                        },
+                                        "hiddenPath": "$item.retryHidden"
+                                      }
+                                    },
+                                    {
+                                      "id": "himi_owner_lite_aria.attachment_remove_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Icon",
+                                        "props": {
+                                          "name": "close",
+                                          "size": 14,
+                                          "tint": "textSecondary"
+                                        }
+                                      },
+                                      "modifiers": {
+                                        "onTap": {
+                                          "actionId": "tier5.himiOwnerLiteAria.removeAttachment",
+                                          "params": {
+                                            "id": "$item.id"
+                                          }
+                                        },
+                                        "accessibilityLabel": "Remove photo"
+                                      }
+                                    }
+                                  ]
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "width": 72
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteAria.attachmentsHidden",
+                "padding": {
+                  "leading": 0,
+                  "trailing": 0,
+                  "top": 8,
+                  "bottom": 0
+                }
+              }
+            },
+            {
+              "id": "",
+              "body": {
+                "package": "himalaya",
+                "type": "HStack",
+                "props": {
+                  "spacing": 16,
+                  "children": [
+                    {
+                      "id": "himi_owner_lite_aria.attach.library",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Icon",
+                        "props": {
+                          "name": "image",
+                          "size": 22,
+                          "tint": "accentPrimary"
+                        }
+                      },
+                      "modifiers": {
+                        "onTap": {
+                          "actionId": "tier5.himiOwnerLiteAria.attach",
+                          "params": {
+                            "source": "library"
+                          }
+                        },
+                        "accessibilityLabel": "Add a photo"
+                      }
+                    },
+                    {
+                      "id": "himi_owner_lite_aria.attach.camera",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Icon",
+                        "props": {
+                          "name": "camera",
+                          "size": 22,
+                          "tint": "accentPrimary"
+                        }
+                      },
+                      "modifiers": {
+                        "onTap": {
+                          "actionId": "tier5.himiOwnerLiteAria.attach",
+                          "params": {
+                            "source": "camera"
+                          }
+                        },
+                        "accessibilityLabel": "Take a photo"
+                      }
+                    },
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Spacer",
+                        "props": {}
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "padding": {
+                  "leading": 0,
+                  "trailing": 0,
+                  "top": 8,
+                  "bottom": 0
+                }
+              }
+            },
             {
               "id": "form_aria",
               "body": {
@@ -58624,7 +58860,9 @@ const SCREENS = runtimeSetting({
         "wix_api",
         "open_url",
         "clipboard",
-        "ui"
+        "ui",
+        "camera",
+        "presigned_upload"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"

package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-attachments.ts

@@ -0,0 +1,179 @@
+// Photo attachments for the Aria composer — the pure half.
+//
+// Everything here is a decision that can be made without touching the device
+// or the network: which files may be attached, how many, how large, what a chip
+// in the composer says in each of its three states, and how a picked image is
+// turned into the bytes an upload sends. The half that DOES touch the world —
+// minting the upload, sending the bytes, picking — lives in `aria-chat.ts`
+// (the mint, through `@himalaya/wix-genie-chat`) and in each app's adapter (the
+// picker and the byte transfer, which are device capabilities the adapter's
+// screen has to declare).
+//
+// This file is copied verbatim into every generated starter app, so it explains
+// itself without pointing at anything only this repo has.
+
+/** Image types the composer accepts. The first-party clients' own allowlist
+ *  for images: png, jpeg (and the non-standard `image/jpg` some pickers still
+ *  report), webp, gif and heic. Anything else is REFUSED with a line saying so,
+ *  never silently dropped — the native Aria app drops unsupported files without a
+ *  word, and an owner who picked something and sees nothing happen assumes the
+ *  button is broken. */
+export const ARIA_IMAGE_TYPES: readonly string[] = [
+  "image/png",
+  "image/jpeg",
+  "image/jpg",
+  "image/webp",
+  "image/gif",
+  "image/heic",
+];
+
+/** At most this many attachments ride one message. The native Aria app caps at
+ *  10; nothing on the wire says otherwise. */
+export const ARIA_MAX_ATTACHMENTS = 10;
+
+/** The largest image the composer will try to send, in bytes.
+ *
+ *  Not a product choice: it is the ceiling of the transfer this slice uses. A
+ *  picked photo crosses the worker bridge as a base64 string and is sent inline,
+ *  and the inline upload refuses anything over 8 MiB (the `MAX_INLINE_BASE64_BYTES`
+ *  bound of the pre-signed upload capability, which it enforces on every arm).
+ *  Checking it HERE is what turns that refusal into a sentence the owner can act
+ *  on, instead of a chip that fails for no stated reason. */
+export const ARIA_MAX_IMAGE_BYTES = 8 * 1024 * 1024;
+
+/** A chip in the composer. Every field is always present — a `$item.` path that
+ *  is missing on some rows does not substitute — and each `…Hidden` flag
+ *  collapses the part it names. */
+export interface AriaAttachmentChip {
+  /** Minted by the worker, never derived from the file. The native Aria app keyed
+   *  concurrent uploads by file NAME and collided on the second `IMG_0001.jpg`. */
+  id: string;
+  name: string;
+  mimeType: string;
+  state: "uploading" | "ready" | "failed";
+  /** The chip's thumbnail as a `data:` URI, set only when the picked image is
+   *  small; "" otherwise, which collapses the preview. The full bytes an upload
+   *  and a retry send are held by the worker, never in the chip, because the chip
+   *  rides the service state and a large photo there would exceed the web
+   *  runtime's frame limit. */
+  thumbUrl: string;
+  thumbHidden: boolean;
+  /** "Uploading…" / "Couldn't upload" / "" — collapses when empty. */
+  statusText: string;
+  statusHidden: boolean;
+  /** The retry control shows ONLY on a failed chip. */
+  retryHidden: boolean;
+  /** `genie-upload://<id>` once the bytes have landed; "" until then. The send
+   *  carries a chip only when this is set. */
+  ref: string;
+}
+
+/** What an upload reports back, delivered as a fresh action so it lands on the
+ *  CURRENT state rather than on the snapshot the upload started from. */
+export interface AriaAttachmentOutcome {
+  id: string;
+  ok: boolean;
+  /** Set when `ok`. */
+  ref?: string;
+}
+
+export interface ParsedDataUri { mimeType: string; base64: string; bytes: number }
+
+/** `data:<mime>;base64,<payload>` → its parts, or null for anything else.
+ *
+ *  Only the base64 form: every picker this composer is wired to returns it, and
+ *  a percent-encoded `data:` URI would need decoding the bridge cannot do. The
+ *  byte count is computed from the payload length, so a multi-megabyte photo is
+ *  sized without being decoded. */
+export function parseDataUri(uri: string): ParsedDataUri | null {
+  const m = /^data:([^;,]*)((?:;[^;,]*)*?);base64,/i.exec(uri ?? "");
+  if (!m) return null;
+  const base64 = uri.slice(m[0].length).replace(/\s+/g, "");
+  const pad = base64.endsWith("==") ? 2 : base64.endsWith("=") ? 1 : 0;
+  const bytes = Math.max(0, Math.floor((base64.length * 3) / 4) - pad);
+  return { mimeType: (m[1] || "").trim().toLowerCase(), base64, bytes };
+}
+
+/** Normalize a MIME type a picker reported.
+ *
+ *  Some pickers hand back a platform type identifier where a MIME type belongs
+ *  (`public.jpeg`, `public.heic`), and the service validates the field as a MIME
+ *  type. Mapped for the image identifiers this composer accepts; anything else
+ *  is returned lowercased and left for the allowlist to judge. */
+export function normalizeMime(mime: string): string {
+  const v = (mime ?? "").trim().toLowerCase();
+  switch (v) {
+    case "public.jpeg": return "image/jpeg";
+    case "public.png": return "image/png";
+    case "public.heic": return "image/heic";
+    case "com.compuserve.gif": return "image/gif";
+    case "org.webmproject.webp": return "image/webp";
+    case "image/jpg": return "image/jpeg";
+    default: return v;
+  }
+}
+
+/** A file name for an image the picker did not name, by type. The service
+ *  requires one (1–255 characters), and it is what the transcript shows. */
+export function imageFileName(mimeType: string, n: number, given?: string): string {
+  const name = (given ?? "").trim();
+  if (name) return name.slice(0, 255);
+  const ext = mimeType === "image/png" ? "png"
+    : mimeType === "image/webp" ? "webp"
+    : mimeType === "image/gif" ? "gif"
+    : mimeType === "image/heic" ? "heic"
+    : "jpg";
+  return `photo-${n}.${ext}`;
+}
+
+/** Why a picked file cannot be attached, or "" when it can. */
+export type AttachRefusal = "" | "type" | "size" | "count";
+
+export function refusalFor(parsed: ParsedDataUri | null, mimeType: string, attached: number): AttachRefusal {
+  if (attached >= ARIA_MAX_ATTACHMENTS) return "count";
+  if (!parsed || !ARIA_IMAGE_TYPES.includes(mimeType)) return "type";
+  if (parsed.bytes > ARIA_MAX_IMAGE_BYTES) return "size";
+  return "";
+}
+
+/** A chip in a given state. One constructor so the flags can never disagree
+ *  with the state they describe — a failed chip without its retry control is
+ *  the shape of bug this rules out. */
+export function chipIn(
+  base: Pick<AriaAttachmentChip, "id" | "name" | "mimeType" | "thumbUrl">,
+  state: AriaAttachmentChip["state"],
+  labels: { uploading: string; failed: string },
+  ref = "",
+): AriaAttachmentChip {
+  const statusText = state === "uploading" ? labels.uploading : state === "failed" ? labels.failed : "";
+  return {
+    ...base,
+    state,
+    thumbHidden: !base.thumbUrl,
+    statusText,
+    statusHidden: !statusText,
+    retryHidden: state !== "failed",
+    ref: state === "ready" ? ref : "",
+  };
+}
+
+/** Why Send is refused while attachments are pending, or "" when it is not.
+ *
+ *  An upload still running would be dropped from the message, and a failed one
+ *  would be sent as if the owner had never picked it — in both cases the
+ *  assistant answers about a photo it never received. So the send waits, and
+ *  says what it is waiting for. */
+export function sendBlocker(chips: readonly AriaAttachmentChip[]): "" | "uploading" | "failed" {
+  if (chips.some((c) => c.state === "uploading")) return "uploading";
+  if (chips.some((c) => c.state === "failed")) return "failed";
+  return "";
+}
+
+/** The one line a bubble shows for its attachments: a paperclip and the file
+ *  names. Text, not thumbnails, and not by choice: a `genie-upload://`
+ *  reference has no published download url, so a sent photo cannot be shown
+ *  again from the server's copy — and a resumed conversation has nothing else. */
+export function attachmentLine(names: readonly string[]): string {
+  const shown = names.map((n) => n.trim()).filter(Boolean);
+  return shown.length ? `📎 ${shown.join(", ")}` : "";
+}