@justai/cuts 0.78.0 → 0.79.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justai/cuts",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {

package/src/Toolbar.astro

@@ -61,6 +61,10 @@ interface Props {
   // destination, and justai.pro is above it (sending the parent "home" to a child platform is
   // the wrong direction). Every other persona keeps it.
   home?: boolean;
+
+  // Posts is required only where there IS a stream (doctrine 02 — an empty cut shipped to look
+  // complete is the buffet). A child persona has none, so `parent` turns this off by default.
+  posts?: boolean;
   // What the title strip says when the Kernel or the Posts cut is the one at the toolbar line.
   //
   // OMIT THEM AND NOTHING MOVES: the strip keeps naming the persona and its handle, which is right
@@ -93,9 +97,47 @@ interface Props {
   // The `profileIcon` slot still wins when a persona passes one — an inline SVG can take
   // `currentColor` where an <img> cannot, which is why qr passes its mark rather than pointing at it.
   avatar?: string;
+
+  // queries: child persona toolbar · files me feed toolbar · the toolbar inside /files ·
+  //          how does a child persona get back to its parent · parent icon in the toolbar
+  //
+  // ── THE CHILD PERSONA TOOLBAR ────────────────────────────────────────────────────────────────
+  //
+  // `me`, `files` and `feed` are sub-personas mounted BY THE EDGE on every persona's host — you meet
+  // them at `qr.app.zone/files`, wearing qr's face, in qr's origin. They are somebody else's
+  // codebase living at your address, and their row has to say so.
+  //
+  // Pass `parent` and the row becomes the child's:
+  //
+  //     the PARENT's face  →  this child's own mark  →  the bolt
+  //
+  // which is the ordinary row's grammar, unchanged. Position one is still "where you came from" —
+  // for a persona that is app.zone, and for a child it is the persona above it. Position two is
+  // still WHO. Position three is still the way IN. Nothing new was invented; the same four kinds of
+  // thing are being said by a shorter row, and there is no app.zone or justai icon in it because
+  // neither is where a visitor to `qr.app.zone/files` came from.
+  //
+  // THE PARENT'S FACE COSTS NOTHING TO FIND. A child runs in the parent's origin, so `/icon.svg` —
+  // the same path this cut already uses for a persona's own face — resolves to the PARENT's mark
+  // when the page is a child's. One path, two meanings, both correct, and neither needs a registry
+  // lookup or a build-time value the edge would have to inject.
+  //
+  // A child has no Posts and no BackToZone: `parent` turns both off unless asked otherwise.
+  //
+  // `icon` is optional and almost always should be: `/icon.svg` is already the parent's face when the
+  // child runs in the parent's origin. It exists for the one child that does not have to guess —
+  // `feed` already reads the host persona's avatar from the registry, and an absolute URL it was
+  // given beats a relative one it inferred.
+  parent?: { href?: string; label?: string; icon?: string };
 }
 import BackToZone from "./BackToZone.astro";
-const { sectionsLabel, profileLabel, kernelLabel, postsLabel, home = true, files = true, filesLabel = "Files", kernelTitle, postsTitle, avatar = "/icon.svg" } = Astro.props;
+const {
+  sectionsLabel, profileLabel, kernelLabel, postsLabel,
+  files = true, filesLabel = "Files", kernelTitle, postsTitle, avatar = "/icon.svg", parent,
+} = Astro.props;
+// A child's row answers UP to its parent, not out to the zone, and has no stream of its own — so
+// both default off the moment `parent` is given, rather than each consumer remembering to say so.
+const { home = !parent, posts = !parent } = Astro.props;
 import AuthMount from "./AuthMount.astro";
 ---
 
@@ -107,6 +149,15 @@ import AuthMount from "./AuthMount.astro";
     <div class="tb-left">
       {home && <BackToZone />}
       <nav class="tb-nav-group" aria-label={sectionsLabel}>
+        {/* POSITION ONE OF A CHILD'S ROW: the persona this one is mounted inside. `/icon.svg` is the
+            parent's face here, because a child runs in the parent's origin — the same path, read from
+            a different address. `#kernel` rather than `/` so the way back lands on the parent's work
+            and not on its biography, which is where a person who came from there was standing. */}
+        {parent && (
+          <a class="tb-nav tb-mark" id="navParent" href={parent.href ?? "/#kernel"} aria-label={parent.label ?? "Home"} title={parent.label ?? "Home"}>
+            <img src={parent.icon ?? "/icon.svg"} alt="" width="19" height="19" loading="lazy" decoding="async" />
+          </a>
+        )}
         {/* THE PROFILE ICON IS THE PERSONA'S OWN FACE. Always — the founder's rule, and app.zone and
             qr had already settled it while thirteen siblings still showed a generic bust.
 
@@ -119,8 +170,24 @@ import AuthMount from "./AuthMount.astro";
             `tb-mark` is set whichever way the face arrives, because it is what the sizing rule looks
             for: a mark runs to the edge of its viewBox and a glyph does not, so they need different
             boxes to put the same ink on screen. */}
-        <a class="tb-nav tb-mark" id="navProfile" href="#profile" aria-label={profileLabel} title={profileLabel}>
-          {Astro.slots.has("profileIcon") ? <slot name="profileIcon" /> : <img src={avatar} alt="" width="19" height="19" loading="lazy" decoding="async" />}
+        {/* `tb-mark` says "a solid MARK is in this box" — it is what the sizing rule looks for, and a
+            mark runs to the edge of its viewBox where a stroke glyph sits inside 75% of one. A
+            persona's face is always a mark, so a persona always carries the class.
+
+            A CHILD IS THE OTHER CASE, and it was measured rather than assumed: files passes a stroke
+            folder, and with `tb-mark` on it, it rendered at 19px beside a 25.33px bolt — one size
+            smaller, which is exactly the defect the 25.33 rule exists to remove. So in child mode the
+            slotted icon takes the GLYPH box and the row reads level. A child that draws a solid mark
+            instead should say so in its own CSS; every child in the fleet draws a glyph today. */}
+        <a class:list={["tb-nav", { "tb-mark": !parent }]} id="navProfile" href="#profile" aria-label={profileLabel} title={profileLabel}>
+          {/* A CHILD MUST PASS ITS OWN MARK. The default `/icon.svg` is the face of whoever owns this
+              origin — right for a persona, and its PARENT for a child, which would put the same
+              picture in two places and say nothing in either. So when `parent` is given there is no
+              fallback: a child that passes nothing renders an empty box, which is a defect somebody
+              sees, rather than a duplicate face, which is a defect nobody reports. */}
+          {Astro.slots.has("profileIcon")
+            ? <slot name="profileIcon" />
+            : (!parent && <img src={avatar} alt="" width="19" height="19" loading="lazy" decoding="async" />)}
         </a>
         {/* THE KERNEL IS ALWAYS THE BOLT. The founder's rule, and it is the shell's to draw rather
             than the persona's to remember.
@@ -137,9 +204,11 @@ import AuthMount from "./AuthMount.astro";
         <a class="tb-nav" id="navKernel" href="#kernel" aria-label={kernelLabel} title={kernelLabel}>
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12.9 3L5.7 13.35h5.4L10.2 21l8.1-10.8h-5.4l.9-7.2z"/></svg>
         </a>
-        <a class="tb-nav" id="navPosts" href="#posts" aria-label={postsLabel} title={postsLabel}>
-          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 11.5a8.4 8.4 0 0 1-9 8.3 9.6 9.6 0 0 1-4-.9L3 21l1.1-5A8.4 8.4 0 1 1 21 11.5z"/></svg>
-        </a>
+        {posts && (
+          <a class="tb-nav" id="navPosts" href="#posts" aria-label={postsLabel} title={postsLabel}>
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 11.5a8.4 8.4 0 0 1-9 8.3 9.6 9.6 0 0 1-4-.9L3 21l1.1-5A8.4 8.4 0 1 1 21 11.5z"/></svg>
+          </a>
+        )}
         <slot name="navExtra" />
       </nav>
       {files && (