@justai/cuts 0.141.0 → 0.142.0

package/package.json

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

package/src/Catalogue.astro

@@ -43,7 +43,24 @@ interface Props {
   /** BCP-47 code of the page — the language the registry is asked for. */
   lang: string;
   /** Which citizens this apex lists. The whole difference between two storefronts. */
-  kind: string;
+  /**
+   * queries: Catalogue kind prop · data-kind on the grid · what kind does a mixed household pass ·
+   *          vestigial prop · why is kind optional now
+   *
+   * VESTIGIAL, AND KEPT ONLY SO THE TWO EXISTING APEXES STILL COMPILE.
+   *
+   * It fed one thing: `data-kind` on the grid, which the runtime append read to ask the registry
+   * `?kind=`. That question moved to `?apex=` when a household arrived whose citizens are not all one
+   * species, and the attribute lost its last reader in the same change. (`data-kind` on `<html>` is a
+   * DIFFERENT attribute, written by Base and read by @justai/ui for a game kernel's geometry — that
+   * one is alive.)
+   *
+   * Optional rather than deleted because `app.zone` and `pin.games` still pass it, and a required prop
+   * removed is a build error in two repos for no gain. It goes when they next build. A mixed household
+   * has no answer to it at all, which is the clearest possible statement that it was the wrong
+   * question here.
+   */
+  kind?: string;
   /** The apex's own host, used for the referral parameter on every card. */
   apexHost: string;
   /** Layer one. Empty is valid and correct for an apex with nothing seeded yet. */
@@ -85,7 +102,7 @@ interface Props {
   };
 }
 const {
-  lang, kind, apexHost,
+  lang, apexHost,
   seed = [], order = [], taglines = {}, catLabels = {}, entries = {},
   locales, strings,
 } = Astro.props;
@@ -211,7 +228,7 @@ const isNew = (added: string): boolean => { const t0 = Date.parse(added || "");
       {/* taglines ride the same channel as newLabel and catMap: a data attribute on the grid. The
           runtime append builds its cards in plain strings and cannot reach this component's scope, so
           anything it needs has to arrive this way. Keyed by host, which is what the API calls `home`. */}
-      <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)}>
+      <section class="grid" id="grid" 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>
       {/* queries: runtime cards are unstyled · the card has no CSS · an apex with no seed · scope cid ·

package/src/behaviour/posts.ts

@@ -144,6 +144,33 @@
   // 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.
+  // queries: apex logo has a tile in the feed · app.zone tiled on justai's page · which personas sign
+  //          bare · is this persona an apex · favicon.svg vs icon.svg for a commenter
+  //
+  // AN APEX SIGNS BARE; EVERYONE ELSE WEARS THEIR TILE. A persona signing its OWN posts already gets
+  // this through `avatarSrc`/`avatarBare`, which is how each apex hands itself the bare pair. Another
+  // persona replying did not: it was drawn from the registry's `avatar` — /icon.svg, the tile — so on
+  // an apex's own page the two sibling apexes appeared in tiles among that page's children, which is
+  // exactly the sibling claim the bare mark exists to deny (app-zone/.justai/expert/how-an-app-zone-
+  // icon-is-lit.md: the platform mark is inset where app marks are raised).
+  //
+  // APEX-NESS IS READ, NEVER DECLARED. A persona is an apex when its home is a BARE registrable domain
+  // — app.zone, pin.games, justai.pro — and a child's home always carries a label in front of it:
+  // qr.app.zone, sudoku.pin.games. One dot versus two. The same test the icon builder applies
+  // (builder/icon/build.py, apex_handles) and the feed service applies (feed Feed.astro, isApex), on
+  // purpose: three places may not disagree about who is an apex. Read from `home` and not from
+  // `personaKind`, because `platform` answers a different question — auth is a platform persona and is
+  // not an apex.
+  //
+  // /favicon.svg and /mark.svg are the platform standard, generated from the same /icon.svg by
+  // @justai/astro-config/mark, so an apex has this pair by construction and no name is hardcoded here.
+  // The registered avatar stays /icon.svg for everyone: the tile IS right in the catalogue, and only a
+  // feed asks an apex for its bare mark.
+  const apexHome = (url: string | null | undefined): string | null => {
+    if (!url) return null;
+    const h = String(url).replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+    return (h.match(/\./g) || []).length === 1 ? h : null;
+  };
   const comment = (c: C, last: boolean): string => {
     const ln = last ? "" : `<span class="ln"></span>`;
     if (c.isPersona) {
@@ -151,11 +178,15 @@
       // face and name; ANOTHER persona wears ITS canonical icon (glyph fallback), its own name, its
       // @handle, and its name links to its own profile. The verified check stays for both.
       const own = c.authorHandle === PERSONA;
+      // A replying apex signs bare from ITS OWN home, in the scheme pair, exactly as it does on its page.
+      const apex = own ? null : apexHome(c.personaUrl);
       const av = own
         ? AV
-        : c.authorAvatar
-          ? `<img class="mk" src="${esc(c.authorAvatar)}" alt="">`
-          : `<span style="font-size:16px">${esc(c.authorGlyph || "✦")}</span>`;
+        : apex
+          ? `<img class="mk bare av-light" src="https://${esc(apex)}/favicon.svg" alt=""><img class="mk bare av-dark" src="https://${esc(apex)}/mark.svg" alt="">`
+          : c.authorAvatar
+            ? `<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 ? `${c.personaUrl}/#profile` : null;
       const at = own ? PERSONA : c.authorHandle;