@justai/cuts 0.9.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justai/cuts",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {
@@ -17,7 +17,8 @@
     "./LangPicker.astro": "./src/LangPicker.astro",
     "./BackToZone.astro": "./src/BackToZone.astro",
     "./Posts.astro": "./src/Posts.astro",
-    "./Toolbar.astro": "./src/Toolbar.astro"
+    "./Toolbar.astro": "./src/Toolbar.astro",
+    "./Profile.astro": "./src/Profile.astro"
   },
   "peerDependencies": {
     "@justai/ui": ">=0.2.0",

package/src/Profile.astro

@@ -0,0 +1,91 @@
+---
+// ░░ PROFILE cut — the persona's face: a cover, an avatar, its name · @handle · bio · meta. ░░
+//
+// Structurally identical in every persona; only the CONTENT and a handful of colours differ. It lives
+// here now. A persona writes:
+//
+//   <Profile name={t.title} handle="@qr" bio={t.bio} meta={t.meta}
+//            avatarLabel="QR code linking to qr.app.zone"
+//            cover="linear-gradient(135deg, …)" avatarBg="#fff" avatarPad="7px">
+//     <Fragment slot="avatar" set:html={avatarSvg} />
+//   </Profile>
+//
+// PROPS carry resolved strings (same convention as Posts/Toolbar/LangPicker — never the whole `t`).
+// The per-persona COLOURS ride in as CSS custom properties (set inline from props), so the shared
+// scoped CSS can theme itself without a variant per persona:
+//   --cover        the cover background (any CSS <image>: a linear- or radial-gradient)
+//   --cover-h      cover height (default 132px; the clock personas use 118px)
+//   --avatar-bg    the avatar tile background (a colour OR a gradient)
+//   --avatar-bg-light  optional light-scheme override for the tile (whatismyip inverts its icon ground)
+//   --avatar-pad   padding inside the tile (a QR needs a quiet zone; an icon that bleeds needs 0)
+//   --edge         inherited from the persona's page padding (16px default; time pads at 20px) so the
+//                  full-bleed cover reaches the SAME edge as the body — see Toolbar for the same knob.
+//
+// The AVATAR content is a slot (an <img>, or a build-time SVG via set:html) because it is the most
+// persona-specific thing on the page; the tile that frames it is shared. `avatarLabel` gives the tile
+// its accessible name (role="img"); omit it and the tile is inert.
+//
+// CONTRACT: the shell's scroll-spy reads `.pname` and `.handle` from here to name the title strip, and
+// the section id `#profile` is one of the three cut anchors. Nothing else depends on the profile.
+interface Props {
+  name: string;          // the persona name (the <h1>)
+  handle: string;        // the @handle line, e.g. "@qr"
+  bio: string;           // the one-line bio
+  meta?: string;         // the small meta line under the bio (optional)
+  avatarLabel?: string;  // accessible name for the avatar tile (role="img"); omit → inert tile
+  cover?: string;        // CSS background for .cover
+  coverHeight?: string;  // e.g. "118px"
+  avatarBg?: string;     // CSS background for the avatar tile
+  avatarBgLight?: string;// light-scheme override for the avatar tile
+  avatarPad?: string;    // padding inside the avatar tile, e.g. "7px"
+}
+const { name, handle, bio, meta, avatarLabel, cover, coverHeight, avatarBg, avatarBgLight, avatarPad } = Astro.props;
+const vars = [
+  cover && `--cover:${cover}`,
+  coverHeight && `--cover-h:${coverHeight}`,
+  avatarBg && `--avatar-bg:${avatarBg}`,
+  avatarBgLight && `--avatar-bg-light:${avatarBgLight}`,
+  avatarPad && `--avatar-pad:${avatarPad}`,
+].filter(Boolean).join(";");
+---
+
+<section class="cut profile" id="profile" style={vars || undefined}>
+  <div class="cover"></div>
+  <div class="pbody">
+    <div class="avatar" role={avatarLabel ? "img" : undefined} aria-label={avatarLabel}><slot name="avatar" /></div>
+    <h1 class="pname">{name}</h1>
+    <p class="handle">{handle}</p>
+    <p class="bio">{bio}</p>
+    {meta && <p class="meta">{meta}</p>}
+  </div>
+</section>
+
+<style>
+  /* ---- PROFILE cut ---- */
+  .profile { padding-block-end: 8px; }
+  .cover {
+    height: var(--cover-h, 132px);
+    /* full-bleed to the persona's page edge (see --edge on Toolbar) */
+    margin-inline: calc(-1 * max(var(--edge, 16px), env(safe-area-inset-left))) calc(-1 * max(var(--edge, 16px), env(safe-area-inset-right)));
+    background: var(--cover, linear-gradient(135deg, var(--accent), transparent));
+    position: relative;
+  }
+  @media (min-width: 768px) { .cover { margin-inline: -28px; } }
+  .avatar {
+    width: 76px; height: 76px; border-radius: var(--radius-lg); margin-block-start: -40px;
+    display: grid; place-items: center; padding: var(--avatar-pad, 0);
+    background: var(--avatar-bg, #fff);
+    border: 3px solid var(--bg); box-shadow: 0 8px 22px -16px rgba(0, 0, 0, 0.22);
+    position: relative;
+  }
+  /* the avatar content is slotted (persona-owned) → style it globally */
+  .avatar :global(svg) { width: 100%; height: 100%; display: block; }
+  .avatar :global(img) { width: 100%; height: 100%; display: block; object-fit: cover; }
+  @media (prefers-color-scheme: light) {
+    .avatar { border-color: #fff; background: var(--avatar-bg-light, var(--avatar-bg, #fff)); }
+  }
+  .pname { font-size: var(--fs-lg); font-weight: 700; letter-spacing: -0.02em; margin-block-start: 12px; }
+  .handle { color: var(--text-dim); font-size: var(--fs-xs); margin-block-start: 2px; }
+  .bio { font-size: var(--fs-sm); line-height: 1.5; margin-block-start: 12px; }
+  .meta { color: var(--text-dim); font-size: var(--fs-2xs); margin-block-start: 10px; }
+</style>

package/src/Toolbar.astro

@@ -72,11 +72,13 @@ const { sectionsLabel, profileLabel, kernelLabel, postsLabel } = Astro.props;
   .toolbar {
     position: sticky; top: 0; z-index: 40;
     display: flex; flex-direction: column;
-    /* full-bleed: the bar (frosted bg + hairline) touches the contained-view edges; the
-       icons stay aligned with the body via matching inline padding. */
-    margin-inline: calc(-1 * max(16px, env(safe-area-inset-left))) calc(-1 * max(16px, env(safe-area-inset-right)));
+    /* full-bleed: the bar (frosted bg + hairline) touches the contained-view edges; the icons stay
+       aligned with the body via matching inline padding. --edge is the persona's page inline padding
+       (16px default; a persona that pads its body differently — e.g. time at 20px — sets --edge so the
+       bar bleeds to the SAME edge as its content instead of a hardcoded 16px). */
+    margin-inline: calc(-1 * max(var(--edge, 16px), env(safe-area-inset-left))) calc(-1 * max(var(--edge, 16px), env(safe-area-inset-right)));
     padding-block: max(8px, env(safe-area-inset-top)) 8px;
-    padding-inline: max(16px, env(safe-area-inset-left)) max(16px, env(safe-area-inset-right));
+    padding-inline: max(var(--edge, 16px), env(safe-area-inset-left)) max(var(--edge, 16px), env(safe-area-inset-right));
     background: color-mix(in srgb, var(--bg) 70%, transparent);
     backdrop-filter: blur(22px) saturate(1.5);
     -webkit-backdrop-filter: blur(22px) saturate(1.5);