@justai/cuts 0.100.0 → 0.102.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justai/cuts",
-  "version": "0.100.0",
-  "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
+  "version": "0.102.0",
+  "description": "A persona's named parts \u2014 the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",

package/src/Catalogue.astro

@@ -64,6 +64,15 @@ interface Props {
     eyebrow: string;
     all: string;
     empty: string;
+    /** queries: empty catalogue · a new apex has no personas · first day · nothing matched vs nothing here
+     *
+     * WHAT AN APEX SAYS ON ITS FIRST DAY, and it is not what it says when a search misses. "No games
+     * match." is a true sentence about a filter and a wrong one about an empty shelf — it tells a
+     * visitor they typed something unlucky when in fact they arrived early. pin.games opened with a
+     * catalogue of zero on purpose, so this is the sentence that greeted the first person there.
+     *
+     * Optional: an apex with citizens can never reach this state, and falls back to `empty`. */
+    awaiting?: string;
     new: string;
   };
 }
@@ -193,7 +202,11 @@ const isNew = (added: string): boolean => { const t0 = Date.parse(added || "");
       <section class="grid" id="grid" data-kind={kind} data-apex={apexHost} data-new-label={strings.new} data-cat-map={JSON.stringify(catLabels)} data-order={JSON.stringify(order)} data-taglines={JSON.stringify(taglines)}>
         {seed.map((app) => <CatalogueCard app={app} name={appName(app)} desc={appDesc(app)} isNew={isNew(app.added)} newLabel={strings.new} />)}
       </section>
-      <p class="empty" id="empty" hidden>{strings.empty}</p>
+      {/* Both sentences ride data-attributes because the loader below is a BUNDLED script and
+          cannot see props — the same seam Posts uses. */}
+      <p class="empty" id="empty" hidden
+         data-empty={strings.empty}
+         data-awaiting={strings.awaiting ?? strings.empty}>{strings.empty}</p>
     </div>
 
 {/* `apexHost` rides define:vars for the same reason `supported` does: this block is emitted
@@ -335,6 +348,11 @@ const isNew = (added: string): boolean => { const t0 = Date.parse(added || "");
       card.style.display = ok ? "" : "none";
       if (ok) shown++;
     }
+    // TWO DIFFERENT SILENCES. `shown === 0` with cards on the page means a filter excluded them all;
+    // `total === 0` means the shelf itself is bare, which is a first day rather than a bad search.
+    // Same element, two sentences, and the wrong one reads as a fault the visitor caused.
+    const total = document.querySelectorAll(".card").length;
+    empty.textContent = (total === 0 ? empty.dataset.awaiting : empty.dataset.empty) ?? "";
     empty.hidden = shown !== 0;
   }
 

package/src/Posts.astro

@@ -260,7 +260,9 @@ const vars = [
   .phandle, .dot, .pt { color: var(--text-dim); font-weight: 400; }
   /* a persona's name in the feed links to its profile (X-style); humans have no link */
   .pn { color: inherit; text-decoration: none; }
-  .pn:hover b { color: var(--accent-text, var(--accent)); }
+  /* `a.pn`, not `.pn` — a persona whose home we were not told renders as a span, and a name that
+     lights up under the cursor while going nowhere is a promise the markup cannot keep. */
+  a.pn:hover b { color: var(--accent-text, var(--accent)); }
   a.pt { text-decoration: none; }
   a.pt:hover { text-decoration: underline; }
   .pbd { font-size: var(--fs-sm); line-height: 1.5; margin-block-start: 4px; }
@@ -352,11 +354,21 @@ const vars = [
       const mo = Math.floor(d / 30); if (mo < 12) return agoRtf.format(-mo, "month");
       return agoRtf.format(-Math.floor(d / 365), "year");
     };
-    // where a persona lives, so another persona's name in this feed can link to its profile. The two
-    // apexes are their own domains; every app persona is a subdomain of app.zone. The API may send the
-    // canonical personaUrl, in which case it wins.
-    const homeOf = (h: string): string =>
-      h === "justai" ? "https://justai.pro" : h === "app.zone" ? "https://app.zone" : `https://${h}.app.zone`;
+    // queries: a persona's name links to the wrong place · a comment links to a host that does not
+    //          exist · pin.games persona linked to app.zone · where does a commenter's name go
+    //
+    // WHERE A PERSONA LIVES IS A FACT WE ARE TOLD, NOT ONE WE DERIVE. The API sends `personaUrl`,
+    // built from the registry's own `home`, for every persona that has one — and `home` is required
+    // by the manifest, so in practice that is all of them.
+    //
+    // There used to be a fallback here that guessed: justai → justai.pro, app.zone → app.zone, and
+    // everything else → `${handle}.app.zone`. It was correct for exactly as long as one apex existed.
+    // The day a game persona comments on a feed, that guess sends the reader to a host that has never
+    // existed — and it does it silently, in a link, on somebody else's page.
+    //
+    // So there is no fallback now. If we were not told where a persona lives, its name is rendered
+    // WITHOUT a link: a name that goes nowhere is a small disappointment, and a name that goes
+    // somewhere wrong is a broken ecosystem seen by a stranger.
     const comment = (c: C, last: boolean): string => {
       const ln = last ? "" : `<span class="ln"></span>`;
       if (c.isPersona) {
@@ -370,10 +382,11 @@ const vars = [
             ? `<img class="mk" src="${esc(c.authorAvatar)}" alt="">`
             : `<span style="font-size:16px">${esc(c.authorGlyph || "✦")}</span>`;
         const nm = own ? NAME : esc(c.authorName); // own name is authored markup; an API name is escaped
-        const purl = own ? "#profile" : `${c.personaUrl || homeOf(c.authorHandle)}/#profile`;
+        const purl = own ? "#profile" : c.personaUrl ? `${c.personaUrl}/#profile` : null;
         const at = own ? PERSONA : c.authorHandle;
         const meta = `${at ? `@${esc(at)} ` : ""}· ${timeAgo(c.createdAt)}`;
-        return `<div class="trow${last ? " last" : ""}"><div class="avc"><span class="rav">${av}</span>${ln}</div><div class="cc"><div class="ch"><a class="pn" href="${esc(purl)}"><b>${nm}</b></a>${ck}<span class="muted">${meta}</span></div><p class="cb">${esc(c.body)}</p></div></div>`;
+        const nameEl = purl ? `<a class="pn" href="${esc(purl)}"><b>${nm}</b></a>` : `<span class="pn"><b>${nm}</b></span>`;
+        return `<div class="trow${last ? " last" : ""}"><div class="avc"><span class="rav">${av}</span>${ln}</div><div class="cc"><div class="ch">${nameEl}${ck}<span class="muted">${meta}</span></div><p class="cb">${esc(c.body)}</p></div></div>`;
       }
       const initial = esc(String(c.authorName || "?").slice(0, 1));
       // A person needs the handle MORE than a persona does — display names collide constantly among