npm - @vibes.diy/prompts - Versions diffs - 14.1.38 → 14.1.40 - Mend

@vibes.diy/prompts 14.1.38 → 14.1.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/generation-variety.d.ts CHANGED Viewed

@@ -13,7 +13,26 @@ export interface GenerationVariety {
     readonly archetype: string;
     readonly flourishes: string[];
 }
-export declare function drawGenerationVariety(rnd: () => number): GenerationVariety;
+export interface VarietyPin {
+    readonly archetype: string;
+    readonly flourishes: string[];
+}
+export declare const VARIETY_PIN_GRAMMAR = "<archetype>:<flourish>,<flourish>,<flourish>";
+export declare function varietyNames(): {
+    archetypes: string[];
+    flourishes: string[];
+};
+export type VarietyPinCheck = {
+    readonly ok: true;
+    readonly pin: VarietyPin;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function validateVarietyPin(candidate: unknown): VarietyPinCheck;
+export declare function parseVarietyPin(spec: string): VarietyPinCheck;
+export declare function validVarietyPinOrUndefined(candidate: unknown): VarietyPin | undefined;
+export declare function drawGenerationVariety(rnd: () => number, pin?: VarietyPin): GenerationVariety;
 export declare function renderVarietySection(variety: Partial<GenerationVariety>): string;
 export declare function renderVarietyContextForPreAlloc(variety: Partial<GenerationVariety>): string;
 export declare function renderTextureNoteSection(note: string | undefined): string;

package/generation-variety.js CHANGED Viewed

@@ -75,11 +75,76 @@ export const FLOURISHES = [
     },
 ];
 export const FLOURISH_DRAW_COUNT = 3;
+export const VARIETY_PIN_GRAMMAR = "<archetype>:<flourish>,<flourish>,<flourish>";
+export function varietyNames() {
+    return {
+        archetypes: LAYOUT_ARCHETYPES.map((a) => a.id),
+        flourishes: FLOURISHES.map((f) => f.id),
+    };
+}
+function varietyNamesMessage() {
+    const names = varietyNames();
+    return (`Grammar: ${VARIETY_PIN_GRAMMAR}\n` +
+        `Archetypes: ${names.archetypes.join(", ")}\n` +
+        `Flourishes: ${names.flourishes.join(", ")}`);
+}
+export function validateVarietyPin(candidate) {
+    const c = candidate;
+    const archetype = typeof c?.archetype === "string" ? c.archetype.trim() : "";
+    const rawFlourishes = Array.isArray(c?.flourishes) ? c.flourishes : undefined;
+    if (archetype.length === 0 || rawFlourishes === undefined) {
+        return {
+            ok: false,
+            message: `A variety pin needs an archetype and ${FLOURISH_DRAW_COUNT} flourishes.\n${varietyNamesMessage()}`,
+        };
+    }
+    const flourishes = rawFlourishes.map((f) => (typeof f === "string" ? f.trim() : ""));
+    if (LAYOUT_ARCHETYPES.some((a) => a.id === archetype) === false) {
+        return { ok: false, message: `Unknown layout archetype "${archetype}".\n${varietyNamesMessage()}` };
+    }
+    if (flourishes.length !== FLOURISH_DRAW_COUNT) {
+        return {
+            ok: false,
+            message: `A variety pin names exactly ${FLOURISH_DRAW_COUNT} flourishes; got ${flourishes.length}.\n${varietyNamesMessage()}`,
+        };
+    }
+    if (new Set(flourishes).size !== flourishes.length) {
+        return { ok: false, message: `A variety pin's flourishes must be distinct.\n${varietyNamesMessage()}` };
+    }
+    const unknown = flourishes.filter((f) => FLOURISHES.some((known) => known.id === f) === false);
+    if (unknown.length > 0) {
+        return { ok: false, message: `Unknown flourish(es) ${unknown.map((u) => `"${u}"`).join(", ")}.\n${varietyNamesMessage()}` };
+    }
+    return { ok: true, pin: { archetype, flourishes } };
+}
+export function parseVarietyPin(spec) {
+    const trimmed = spec.trim();
+    const colon = trimmed.indexOf(":");
+    if (colon <= 0) {
+        return { ok: false, message: `A variety pin is written ${VARIETY_PIN_GRAMMAR}.\n${varietyNamesMessage()}` };
+    }
+    return validateVarietyPin({
+        archetype: trimmed.slice(0, colon),
+        flourishes: trimmed
+            .slice(colon + 1)
+            .split(",")
+            .map((f) => f.trim())
+            .filter((f) => f.length > 0),
+    });
+}
+export function validVarietyPinOrUndefined(candidate) {
+    if (candidate === undefined || candidate === null)
+        return undefined;
+    const checked = validateVarietyPin(candidate);
+    return checked.ok ? checked.pin : undefined;
+}
 function pickIndex(rnd, length) {
     const raw = Math.floor(rnd() * length);
     return raw >= length ? length - 1 : raw;
 }
-export function drawGenerationVariety(rnd) {
+export function drawGenerationVariety(rnd, pin) {
+    if (pin !== undefined)
+        return { archetype: pin.archetype, flourishes: [...pin.flourishes] };
     const archetype = LAYOUT_ARCHETYPES[pickIndex(rnd, LAYOUT_ARCHETYPES.length)].id;
     const pool = FLOURISHES.map((f) => f.id);
     const flourishes = [];

package/generation-variety.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"generation-variety.js","sourceRoot":"","sources":["../jsr/generation-variety.ts"],"names":[],"mappings":"AAoEA,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D;QACE,EAAE,EAAE,oBAAoB;QACxB,QAAQ,EACN,6RAA6R;KAChS;IACD;QACE,EAAE,EAAE,WAAW;QACf,QAAQ,EACN,4PAA4P;KAC/P;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EACN,uPAAuP;KAC1P;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EACN,yRAAyR;KAC5R;IACD;QACE,EAAE,EAAE,WAAW;QACf,QAAQ,EACN,+PAA+P;KAClQ;CACF,CAAC;AAuBF,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EACN,8aAA8a;KACjb;IACD;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EACN,+TAA+T;KAClU;IACD;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EACN,8VAA8V;KACjW;IACD;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EACN,6jBAA6jB;KAChkB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EACN,25BAA25B;KAC95B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EACN,oXAAoX;KACvX;IACD;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EACN,2aAA2a;KAC9a;IACD;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EACN,qoBAAqoB;KACxoB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EACN,sUAAsU;KACzU;IACD;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EACN,mUAAmU;KACtU;IACD;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EACN,4TAA4T;KAC/T;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EACN,gXAAgX;KACnX;IACD;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EACN,8UAA8U;KACjV;CACF,CAAC;AAeF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;~~AASrC~~,SAAS,SAAS,CAAC,GAAiB,EAAE,MAAc;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IACvC,OAAO,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC1C,CAAC;AAeD,MAAM,UAAU,qBAAqB,CAAC,GAAiB;~~IACrD~~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"}
1	+ {"version":3,"file":"generation-variety.js","sourceRoot":"","sources":["../jsr/generation-variety.ts"],"names":[],"mappings":"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"}

package/llms/access.md CHANGED Viewed

@@ -66,7 +66,9 @@ Keep the two visually distinct (a checkbox with its own explanatory line; a sepa
 App.jsx — the checkbox is the consent call; the picker is a doc write:
-```jsx
+```jsx file=App.jsx
+const { can } = useVibe("logs"); // the write gate is always the server's own verdict
 // checking is the consent preflight; unchecking is the off switch. Never one verb for both edges.
 <label>
   <input
@@ -82,12 +84,16 @@ App.jsx — the checkbox is the consent call; the picker is a doc write:
 {showFollowers && <ul>{followers.map((f) => <li key={f.handle}>{f.handle}</li>)}</ul>}
 {/* the app's own list — one share doc per person picked */}
-{can.create({ type: "share", authorHandle: me?.userHandle, buddyHandle: "x" }).ok && <AddBuddyForm />}
+{can.create({ type: "share", authorHandle: me?.userHandle, buddyHandle: "x" }).ok && (
+  <AddBuddyForm
+    onAdd={(buddyHandle) => database.put({ type: "share", authorHandle: me?.userHandle, buddyHandle })}
+  />
+)}
 ```
 access.js — the buddy grant and the followers audience arm are independent:
-```js
+```js file=access.js
 const ch = `log:${user.userHandle}`;
 if (doc.type === "share") {
@@ -105,6 +111,8 @@ if (doc.type === "entry") {
     audience: { followersOf: user.userHandle },
   };
 }
+throw { forbidden: "unknown document type" }; // every access.js ends by denying what it does not know
 ```
 ### The ImgGen version-append nuance
@@ -195,7 +203,7 @@ Use `oldDoc` (the previous version of the document) to enforce invariants across
 Some documents belong to the machinery rather than to a person: a scheduled run's state doc, a counter a `scheduled` sweep advances, a notification the backend generates. Gate those on the **origin** with `ctx.requireBackend(...)` — one line, no conditional:
-```js
+```js file=access.js partial
 if (doc.type === "runState") {
   ctx.requireBackend("scheduled");
   return { channels: ["show"] };
@@ -224,7 +232,7 @@ Worked example — members-only chat writes
 access.js
-```js
+```js file=access.js partial
 export function chat(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "authentication required" };
@@ -279,7 +287,7 @@ _Each example below closes its type dispatch with the default terminal `throw {
 access.js
-```js
+```js file=access.js partial
 export function wall(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
@@ -310,7 +318,7 @@ export function wall(doc, oldDoc, user, ctx) {
 access.js
-```js
+```js file=access.js partial
 export function board(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
   const channel = `board:${doc.boardId}`;
@@ -343,7 +351,7 @@ export function board(doc, oldDoc, user, ctx) {
 access.js
-```js
+```js file=access.js partial
 export function notes(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
   const ch = `user:${user.userHandle}`; // this visitor's own private space
@@ -372,7 +380,7 @@ Every item a visitor creates lands on their own `user:<handle>` channel, private
 access.js
-```js
+```js file=access.js partial
 export function habits(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
@@ -414,7 +422,7 @@ The leaderboard is just the access model: read the public `track:` channels and
 The personal blog's post branch is small — public read is the blog's resting state, declared inline on every post result (readers are the point of publishing):
-```js
+```js file=access.js partial
 if (doc.type === "post") {
   if (!oldDoc) {
     if (doc.authorHandle !== user.userHandle) throw { forbidden: "not author" };
@@ -496,7 +504,7 @@ This example shows the full round-trip — access.js declares channels and grant
 access.js
-```js
+```js file=access.js
 export function announcements(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
@@ -546,7 +554,7 @@ export function announcements(doc, oldDoc, user, ctx) {
 App.jsx — `useVibe().can` gates every write surface (posts AND owner-only management); `access.hasChannel()` reflects display-only membership:
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
 import { useViewer, useVibe } from "use-vibes";
@@ -648,7 +656,7 @@ Channels everyone can read, and any signed-in user can post to. The channel doc
 access.js
-```js
+```js file=access.js partial
 export function chat(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
@@ -718,7 +726,7 @@ Reach for this by default, and certainly whenever the prompt says **invite, join
 access.js
-```js
+```js file=access.js partial
 export default function (doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "sign in" };
   const ch = (id) => `list:${id}`;
@@ -805,7 +813,7 @@ Reach for this variant whenever the app is built around a *thing* people come ba
 access.js
-```js
+```js file=access.js partial
 export function boards(doc, oldDoc, user, ctx) {
   if (!user?.userHandle) throw { forbidden: "sign in" };
   const safeId = (id) => {
@@ -911,7 +919,7 @@ That bounds what the build's own closing line says: the rules and the screen it
 access.js
-```js
+```js file=access.js partial
 export function chat(doc, oldDoc, user, ctx) {
   if (!user) throw { forbidden: "authentication required" };
@@ -997,7 +1005,7 @@ App.jsx — show only channels the viewer is in (`access.hasChannel`), gate the
 access.js
-```js
+```js file=access.js partial
 export function survey(doc, oldDoc, user, ctx) {
   if (doc.type === "survey-response") {
     if (oldDoc) throw { forbidden: "responses are write-once" };
@@ -1073,7 +1081,7 @@ When the prompt says **anyone can sign / submit without logging in** (a guestboo
 access.js
-```js
+```js file=access.js partial
 export function guestbook(doc, oldDoc, user, ctx) {
   if (doc.type === "entry") {
     if (oldDoc) throw { forbidden: "entries are write-once" };

package/llms/backend.md CHANGED Viewed

@@ -444,7 +444,7 @@ in `nodeReleases`, and records refresh state in that same database.
 backend.js
-```js
+```js file=backend.js
 export const config = { scheduled: { interval: "15m" } };
 const SNAPSHOT = [
@@ -486,6 +486,7 @@ async function putIfChanged(ctx, next, db) {
 }
 export async function scheduled(event, ctx) {
+  ctx.log("debug", "refresh tick", { at: event.scheduledTime }); // proof of life, before any read
   await ensureSnapshot(ctx);
   // One request, no retry storm; ctx.fetch enforces 15s/10MB and egress caps.
@@ -540,7 +541,7 @@ export async function scheduled(event, ctx) {
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
@@ -612,7 +613,7 @@ Runs for requests to the app's `/_api` route. The request path is rooted after
 `/_api`: a call to `https://slug--owner.host/_api/webhooks/pay` arrives with
 pathname `/webhooks/pay`. Return a standard `Response`.
-```js
+```js file=backend.js
 export async function fetch(request, ctx) {
   const url = new URL(request.url);
   if (url.pathname === "/rsvp" && request.method === "POST") {
@@ -628,7 +629,7 @@ export async function fetch(request, ctx) {
 From `App.jsx`, call it with a relative fetch — no host needed:
-```js
+```js file=App.jsx partial
 const res = await fetch("/_api/rsvp", { method: "POST", body: JSON.stringify({ name }) });
 ```
@@ -640,7 +641,7 @@ owner, declare `config.fetch.unfilteredReads` for the collections it reads, page
 `ctx.db.query` returns, and keep progress in a state document read by id so a second run continues
 where the first stopped.
-```js
+```js file=backend.js
 export const config = { fetch: { unfilteredReads: ["rsvps"] } };
 export async function fetch(request, ctx) {
@@ -681,7 +682,7 @@ branch on: a score or a summary is only ever computed from text the handler actu
 backend.js
-```js
+```js file=backend.js
 export async function fetch(request, ctx) {
   const url = new URL(request.url);
   if (url.pathname === "/page") {
@@ -720,7 +721,7 @@ export async function fetch(request, ctx) {
 From `App.jsx`, the page asks the handler for the address it was given:
-```js
+```js file=App.jsx partial
 const res = await fetch(`/_api/page?url=${encodeURIComponent(url)}`);
 const page = await res.json();
 if (page.ok === false) {
@@ -747,7 +748,7 @@ server owes in response.
 Runs after any document write to the app's databases commits (user writes and
 backend writes alike). The event:
-```js
+```js file=backend.js
 export async function onChange(event, ctx) {
   // event: { dbName, docId, doc, oldDoc, seq, deleted }
   if (event.dbName !== "votes" || event.deleted) return;
@@ -771,11 +772,12 @@ Two rules keep change-reactions sane:
 Requires a `config` export with a **static string-literal** interval between
 `"5s"` and `"1h"` (e.g. `"30s"`, `"5m"`, `"1h"` — computed values are rejected):
-```js
+```js file=backend.js
 export const config = { scheduled: { interval: "15m" } };
 export async function scheduled(event, ctx) {
   // event: { scheduledTime } — ISO timestamp of this tick
+  ctx.log("debug", "heartbeat tick", { at: event.scheduledTime }); // proof of life, every tick
   await ctx.db.put({ kind: "heartbeat", at: event.scheduledTime }, { db: "status" });
 }
 ```
@@ -798,7 +800,7 @@ saving on its own, which a stored hour-offset does not.
 App.jsx — when the owner saves the schedule:
-```jsx
+```jsx file=App.jsx partial
 await merge({
   hour: 12, // the hour they picked, in their own day
   timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone, // e.g. "America/Detroit"
@@ -807,7 +809,7 @@ await merge({
 backend.js — the tick compares in that zone:
-```js
+```js file=backend.js partial
 const hourLocal = Number(
   new Intl.DateTimeFormat("en-US", {
     timeZone: settings.timeZone ?? "UTC",
@@ -873,7 +875,7 @@ repeats" above: the interval is only how often the handler wakes up.
 App.jsx — write the zone once, when they arrive:
-```jsx
+```jsx file=App.jsx
 useEffect(() => {
   if (!me?.userHandle) return;
   const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -884,7 +886,7 @@ useEffect(() => {
 backend.js — evaluate each person in their own zone:
-```js
+```js file=backend.js
 export const config = { scheduled: { interval: "15m" } };
 const WEEKDAYS = new Set(["Mon", "Tue", "Wed", "Thu", "Fri"]);
@@ -940,7 +942,7 @@ is the only place an owner can tell. For a job that acts twice a month that mean
 weeks of silence that reads exactly like a dead alarm. So log once per tick,
 before any early return:
-```js
+```js file=backend.js partial
 export async function scheduled(event, ctx) {
   const due = eventsDueNow(event.scheduledTime);
   ctx.log("debug", "tick", { due: due.length }); // proof of life; no reads, no spend
@@ -1022,7 +1024,7 @@ genuinely produced something is a real state change and belongs in that doc —
 unlike a per-tick `checkedAt`, which is the churn the zero-churn rule above is
 about.
-```js
+```js file=backend.js
 export const config = { scheduled: { interval: "15m" } };
 const SHOW_DB = "show"; // the one database App.jsx live-queries
@@ -1032,6 +1034,7 @@ const SHOW_DB = "show"; // the one database App.jsx live-queries
 let lastFinishedDay;
 export async function scheduled(event, ctx) {
+  ctx.log("debug", "digest tick", { at: event.scheduledTime }); // proof of life, before any return
   const settings = await ctx.db.get("schedule", { db: SHOW_DB });
   const zone = settings?.timeZone ?? "UTC"; // captured in the owner's browser
   const at = new Date(event.scheduledTime);
@@ -1097,7 +1100,13 @@ export async function scheduled(event, ctx) {
     // The day stays claimed: the owner sees what went wrong and is not billed twice for it.
     ctx.log("error", "[digest] draft failed after the day was claimed", { message: err.message });
     await ctx.db.put(
-      { _id: "run:status", type: "runStatus", state: "failed", message: "today's draft didn't finish" },
+      {
+        _id: "run:status",
+        type: "runStatus",
+        state: "failed",
+        checkedAt: event.scheduledTime, // a second failure must still read as a new one
+        message: "today's draft didn't finish",
+      },
       { db: SHOW_DB }
     );
   }
@@ -1111,7 +1120,7 @@ including the owner's own — while still no-opping under admin mode, so a hand
 repair runs the function and keeps the routing. `access.js` is where that is
 said:
-```js
+```js file=access.js
 // access.js
 export default function (doc, oldDoc, user, ctx) {
   if (doc.type === "runState" || doc.type === "runStatus") {
@@ -1123,11 +1132,24 @@ export default function (doc, oldDoc, user, ctx) {
 }
 ```
-App.jsx reads the same database, and renders that status beside the drafts, so a
-failed run and a good one never look alike:
+App.jsx writes the `schedule` document that tick reads — the hour the owner
+picked and, beside it, the zone their own browser reported — and reads the same
+database back, rendering the status beside the drafts so a failed run and a good
+one never look alike:
+```jsx file=App.jsx
+const { useLiveQuery, database } = useFireproof("show");
+async function saveSchedule(hour) {
+  // The hour is theirs and so is the zone: capture it here, store it beside the hour.
+  await database.put({
+    _id: "schedule",
+    type: "schedule",
+    hour,
+    timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+  });
+}
-```jsx
-const { useLiveQuery } = useFireproof("show");
 const { docs: statusDocs } = useLiveQuery("type", { key: "runStatus" });
 const run = statusDocs.find((doc) => doc._id === "run:status");
 // …
@@ -1147,7 +1169,7 @@ mirrors each note into a per-author `activity` entry (acting as that author —
 same privilege, just automated), and a `scheduled` sweep maintains one `digest`
 doc that `access.js` restricts to the **owner**, so no user can forge it.
-```js
+```js file=backend.js
 export const config = { scheduled: { interval: "15m" } };
 export async function onChange(event, ctx) {
@@ -1159,6 +1181,7 @@ export async function onChange(event, ctx) {
 }
 export async function scheduled(event, ctx) {
+  ctx.log("debug", "digest sweep", { at: event.scheduledTime }); // proof of life, before any return
   // Acts as the app owner — access.js allows `digest` docs for the owner only,
   // making this document genuinely server-controlled.
   //

package/llms/bluesky.md CHANGED Viewed

@@ -135,7 +135,7 @@ person can act on — "no data" is not.
 ## Complete backend.js
-```js
+```js file=backend.js app=bluesky-browser
 const XRPC = "https://public.api.bsky.app/xrpc";
 const DB = "bluesky";
@@ -253,7 +253,7 @@ export async function fetch(request, ctx) {
 A profile card, its follow graph, and the account's posts — one handle in, no
 account of the visitor's involved.
-```jsx
+```jsx file=App.jsx app=bluesky-browser
 import React, { useState } from "react";
 export default function App() {

package/llms/calendar.md CHANGED Viewed

@@ -110,7 +110,7 @@ button is simply there once the user has subscribable content.
 there means the Subscribe link never renders, even though the mint effect and
 the feed itself work.
-```jsx
+```jsx file=App.jsx app=calendar-feed
 // access.js needs a `caltoken` branch routing the doc to the owner's PRIVATE
 // channel (like notes) — the token is the secret.
 const { docs: calTokens } = useLiveQuery(byTypeUser, { key: ["caltoken", me.userHandle] });
@@ -153,7 +153,7 @@ the button tooltip.
 "2026-07-31", time: "18:00:00", endtime: "", title, venue, url } }` — adapt
 the doc shape, db name, and timezone to the app.
-```js
+```js file=backend.js app=calendar-feed
 export const config = { scheduled: { interval: "1m" } };
 const TZ = "America/Los_Angeles"; // the app's local timezone

package/llms/callai.md CHANGED Viewed

@@ -62,7 +62,7 @@ Send an image by passing the prompt as an array of content parts: an `image_url`
 The prompt is the content of one user message, so a plain string means exactly one text part and the array is that same message's parts. Read the picture the user picked with a `FileReader` and hand over the data URL it produces:
-```javascript
+```javascript file=App.jsx
 import { callAI } from "call-ai";
 function readAsDataUrl(file) {

package/llms/connections.md CHANGED Viewed

@@ -31,7 +31,7 @@ a public profile) is an ordinary `ctx.fetch` and needs no connection.
 ### 1. Declare it — `backend.js`
-```js
+```js file=backend.js app=instagram-connection
 export const config = {
   connections: [
     {
@@ -70,7 +70,7 @@ for the rest.
 ### 2. Ask for it — `App.jsx`
-```jsx
+```jsx file=App.jsx app=instagram-connection
 import { useConnection } from "use-vibes";
 function ConnectInstagram() {
@@ -112,7 +112,7 @@ the platform's Settings page, not in your app.
 ### 3. Read it — `backend.js`
-```js
+```js file=backend.js app=instagram-connection
 import { instagram, connectionState } from "@vibes.diy/social";
 export async function fetch(request, ctx) {

package/llms/create-vibe.md CHANGED Viewed

@@ -24,7 +24,7 @@ never automatically from an effect, a timer, or straight out of an async `callAI
 resolution. Gate it behind an explicit "Create my ___" button the user presses
 when they're ready.
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { createVibe } from "use-vibes";
@@ -63,7 +63,7 @@ Let the user edit each slide inline and present full-screen.`;
 ## Full pattern — interview, then hand off
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { callAI } from "call-ai";
 import { createVibe } from "use-vibes";

package/llms/d3.md CHANGED Viewed

@@ -138,7 +138,7 @@ Structure your component in this order:
 ### 1. Simple Bar Chart
-```js
+```js file=App.jsx
 import * as d3 from "d3";
 // 1. Design tokens and dimensions

package/llms/fireproof.md CHANGED Viewed

@@ -29,7 +29,7 @@ This complete app shows Fireproof's core: `useFireproof` gives you hooks, `useDo
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
@@ -112,7 +112,7 @@ When an app ships with default content — starter slides, template rows, exampl
 The trap is the live-query empty state. `useLiveQuery` renders empty before data arrives, so `docs.length === 0` is briefly true on **every** fresh load — and a `useRef`/`useState` "already seeded" flag only guards the current session, never the next reload, a second device, or another collaborator. With **auto-generated** `_id`s, each of those re-seeds the full set and duplicate copies pile up without bound. Deterministic `_id`s collapse every re-seed back onto the same N documents.
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
 import { useVibe } from "use-vibes";
@@ -442,7 +442,7 @@ Building an image uploader with `_files`:
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
@@ -576,7 +576,7 @@ App.jsx
 Code listing for todo tracker App.jsx. Note the code ordering: hooks, then handlers, then classNames right before JSX.
-```js
+```js file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";

package/llms/image-gen.md CHANGED Viewed

@@ -10,7 +10,7 @@ Start with a minimal image generation component:
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
 import { ImgGen } from "use-vibes";

package/llms/p5.md CHANGED Viewed

@@ -22,7 +22,7 @@ the instance so remounts do not leak a second draw loop.
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import p5 from "https://esm.sh/p5@1.11.13";

package/llms/spotify.md CHANGED Viewed

@@ -158,7 +158,7 @@ the app looks broken rather than misconfigured.
 ## Complete backend.js
-```js
+```js file=backend.js app=spotify-browser
 const TOKEN_URL = "https://accounts.spotify.com/api/token";
 const API = "https://api.spotify.com/v1";
@@ -301,7 +301,7 @@ function artistRow(a) {
 ## App.jsx sketch
-```jsx
+```jsx file=App.jsx app=spotify-browser
 import React, { useState } from "react";
 const SETUP_STEPS = [

package/llms/three-js.md CHANGED Viewed

@@ -17,7 +17,7 @@ and renderer so remounts don't leak GPU memory.
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import * as THREE from "three";

package/llms/use-vibe.md CHANGED Viewed

@@ -26,7 +26,7 @@ Never stamp author fields from `me` while the verdict is pending — `me` is nul
 Gate every write affordance on `can.*`. Hold it while `pending`, and write your own copy when denied. Never branch write permission on `viewer`, `access.hasRole()`/`access.hasChannel()`, or document fields — those drift from what `access.js` actually does. Rendering **other** users (authors, rosters) is `useViewer()`'s `<ViewerTag userHandle={...} />`, not `useVibe`. The current viewer's own pill and the "signed in as" label are system chrome in the Vibes Switch (the logo) — don't build them into the app. Asking an anonymous visitor to sign in is a different thing and it IS yours: `useViewer().requestLogin()`, at the moment their work becomes worth keeping (see use-viewer docs). A resolved denial is one such moment — write the sign-in copy in your app's own words and wire it to that callable, never to a sentence about the logo. (The one exception is inline avatar self-edit: a guarded no-prop `{viewer && <ViewerTag />}` lets any signed-in member change their own photo in place — see use-viewer docs.)
-```jsx
+```jsx file=App.jsx
 import { useVibe } from "use-vibes";
 function PromptBar({ database }) {
@@ -38,9 +38,14 @@ function PromptBar({ database }) {
   if (!v.ok) return <p className="muted">Join the board to add a tile.</p>;
   // 3. allowed
   return (
-    <form onSubmit={/* … */}>
+    <form
+      onSubmit={(e) => {
+        e.preventDefault();
+        database.put({ type: "tile", authorHandle: me?.userHandle, text: e.target.tile.value });
+      }}
+    >
       {/* no current-user pill — identity + sign-in live in the Vibes Switch (the logo) */}
-      <input placeholder="Add a tile…" />
+      <input name="tile" placeholder="Add a tile…" />
       <button type="submit">Post</button>
     </form>
   );

package/llms/use-viewer.md CHANGED Viewed

@@ -14,7 +14,7 @@ Start with a minimal component that reads the viewer identity. You don't render
 App.jsx
-```jsx
+```jsx file=App.jsx
 import React from "react";
 import { useFireproof } from "use-fireproof";
 import { useViewer } from "use-vibes";

package/llms/webxr.md CHANGED Viewed

@@ -417,7 +417,7 @@ for (let i = 0; i < 200; i++) {
 A floating galaxy of 2000 particles with a custom-shader core sphere, navigable in VR. Session data stored in Fireproof.
-```javascript
+```javascript file=App.jsx
 import * as BABYLON from "@babylonjs/core";
 import React, { useEffect, useRef } from "react";
 import { useFireproof } from "use-fireproof";

package/llms/youtube.md CHANGED Viewed

@@ -250,7 +250,7 @@ nothing they can act on, and the four cases above each have a different fix.
 ## Complete backend.js
-```js
+```js file=backend.js app=youtube-dashboard
 export const config = {
   scheduled: { interval: "1h" },
   // The visitor path below reads the snapshot docs on the fetch lane, which
@@ -507,7 +507,7 @@ export async function scheduled(event, ctx) {
 ## App.jsx sketch
-```jsx
+```jsx file=App.jsx app=youtube-dashboard
 import React, { useState } from "react";
 import { useFireproof } from "use-fireproof";

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@vibes.diy/prompts",
-  "version": "14.1.38",
+  "version": "14.1.40",
   "type": "module",
   "main": "./index.js",
   "exports": {
@@ -34,9 +34,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@adviser/cement": "~0.5.34",
-    "@vibes.diy/call-ai-v2": "14.1.38",
-    "@vibes.diy/identity": "14.1.38",
-    "@vibes.diy/use-vibes-types": "14.1.38",
+    "@vibes.diy/call-ai-v2": "14.1.40",
+    "@vibes.diy/identity": "14.1.40",
+    "@vibes.diy/use-vibes-types": "14.1.40",
     "arktype": "~2.2.3",
     "json-schema-faker": "~0.6.3"
   },