@half-built/astro 0.8.0 → 0.10.0

package/README.md

@@ -57,20 +57,37 @@ consumer config itself.
 
 ## WhenPublished and PostLink
 
-`content/WhenPublished.astro` renders its children only when the post
-at `slug` is visible, so a published post can tease one still in
-draft and the passage appears on its own when the target ships.
 `content/PostLink.astro` links to a post by slug and resolves the
 href at build time through `postPath`, so a re-dated post does not
-strand the links pointing at it. Both take the consumer's collection
-as the `posts` prop (the full collection, drafts included, so an
-unknown slug can throw instead of hiding as "still a draft");
-`WhenPublished` also takes the consumer's draft gate as `showDrafts`,
-and `PostLink` accepts an optional `tip` carried as `data-tooltip` for
-the link-tip island. A consumer wraps each in a one-line site
-component that injects `getCollection` and its own gate, the way the
-blog does. The resolvers live in `lib/drafts.ts` for consumers that
-want the logic without the components.
+strand the links pointing at it. While the target is hidden (a draft, with the
+draft gate off) it renders its text alone, with no element and no
+styling, and becomes a link on its own when the post ships. That makes
+it the right tool for a draft's name in published prose.
+
+`content/WhenPublished.astro` renders its children only when the post
+at `slug` is visible. Use it when a whole phrase only makes sense once
+the post exists ("its own post", "see it here"). An optional `fallback`
+slot renders while the target is hidden:
+
+```mdx
+<WhenPublished slug="my-draft">
+  It has <PostLink slug="my-draft">its own post</PostLink> now.
+  <Fragment slot="fallback">A post on it is coming.</Fragment>
+</WhenPublished>
+```
+
+Both take the consumer's collection as the `posts` prop (the full
+collection, drafts included, so an unknown slug can throw instead of
+hiding as "still a draft") and the consumer's draft gate as
+`showDrafts`. `showDrafts` defaults to false, so a preview build must
+pass its own draft gate through to `PostLink` to keep draft links
+live. `PostLink` also accepts an optional `tip` carried as
+`data-tooltip` for the link-tip island; a hidden `PostLink` drops it. A
+consumer wraps each in a one-line site component that injects
+`getCollection` and its own gate, the way the blog does. The resolvers
+(`postLinkHref`, `resolvePostHref`, `forwardLinkVisible`) live in
+`lib/drafts.ts` for consumers that want the logic without the
+components.
 
 ## Derived excerpts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@half-built/astro",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Astro components, islands, and pure helpers for the half-built design system.",
   "license": "MIT",
   "repository": {

package/src/components/Footer.astro

@@ -3,7 +3,6 @@ import type { SitemapGroup, EcosystemEntry } from "./models";
 import { BP_PHONE_MAX } from "../scripts/core/breakpoints";
 
 interface Props {
-  siteName: string;
   legalHolder: string;
   sitemap: SitemapGroup[];
   ecosystem: EcosystemEntry[];
@@ -12,7 +11,6 @@ interface Props {
 }
 
 const {
-  siteName,
   legalHolder,
   sitemap,
   ecosystem,
@@ -28,17 +26,15 @@ const year = new Date().getFullYear();
     <div class="shell">
       <div class="bottom-footer-info">
         <div class="site-info">
-          {/* Two lines at every width (owner call 2026-09-13): the
-              copyright over the site name, a real break rather than the
-              old pipe that retired on phones and left the wrap to do
-              the separating. The copyright's segments stay unbreakable
-              so a narrow screen wraps that line only after the year. */}
+          {/* The copyright line alone (owner call 2026-09-14). The
+              site-name home link that used to sit under it retired.
+              The masthead and the Ecosystem group's bold entry already
+              say where you are, and the notice is complete without it.
+              The segments stay unbreakable so a narrow screen wraps
+              only after the year. */}
           <slot name="site-info">
-            <span class="site-info-line">
-              <span class="site-info-seg">Copyright © {year}</span>{" "}
-              <span class="site-info-seg">{legalHolder}</span>
-            </span>
-            <span class="site-info-line"><a href="/">{siteName}</a></span>
+            <span class="site-info-seg">Copyright © {year}</span>{" "}
+            <span class="site-info-seg">{legalHolder}</span>
           </slot>
         </div>
       </div>
@@ -128,18 +124,9 @@ const year = new Date().getFullYear();
     font-size: var(--font-size-sm);
   }
 
-  /* The two lines center under each other like the sitemap below
-     (owner report 2026-08-25). */
+  /* Centered like the sitemap below (owner report 2026-08-25). */
   .site-info { text-align: center; }
-  .site-info-line { display: block; }
-
-  /* Underlined, unlike the sitemap links below: this one sits inside
-     running text (the copyright block), where the same ink at 0.8
-     opacity is not a visible link mark (WCAG 1.4.1, axe
-     link-in-text-block; the line break is all that frames it). */
-  .site-info a { text-decoration: underline; opacity: 0.8; transition: var(--transition); color: var(--ink); }
   .site-info-seg { white-space: nowrap; }
-  .site-info a:hover { opacity: 1; }
 
   /* Sitemap columns under the copyright line, centered like it (owner
      feedback 2026-08-01). position: relative lifts the content above the

package/src/components/content/PostLink.astro

@@ -1,15 +1,22 @@
 ---
-import { resolvePostHref, type Linkable } from "../../lib/drafts";
+import { postLinkHref, type Linkable } from "../../lib/drafts";
 
 interface Props {
   slug: string;
   posts: Linkable[];
+  showDrafts?: boolean;
   tip?: string;
   class?: string;
 }
 
-const { slug, posts, tip, class: className } = Astro.props;
-const href = resolvePostHref(slug, posts);
+const { slug, posts, showDrafts = false, tip, class: className } = Astro.props;
+const href = postLinkHref(slug, posts, showDrafts);
 ---
 
-<a href={href} data-tooltip={tip} class={className}><slot /></a>
+{href ? (
+  <a href={href} data-tooltip={tip} class={className}>
+    <slot />
+  </a>
+) : (
+  <slot />
+)}

package/src/components/content/WhenPublished.astro

@@ -11,4 +11,4 @@ const { slug, posts, showDrafts = false } = Astro.props;
 const visible = forwardLinkVisible(slug, posts, showDrafts);
 ---
 
-{visible && <slot />}
+{visible ? <slot /> : <slot name="fallback" />}

package/src/lib/drafts.ts

@@ -43,17 +43,21 @@ export function forwardLinkVisible(
 /* Post links by slug. A hand-typed post URL bakes in the target's date,
    so a re-dated draft silently breaks every earlier link to it. The
    PostLink content component resolves the slug through postPath() at
-   build time instead. It resolves drafts too, and must: Astro renders
-   MDX slot children eagerly, so a PostLink inside a hidden WhenPublished
-   still runs (learned the hard way 2026-08-24). The deploy-build guard
-   against a bare link to a draft is therefore a test, not a throw here:
-   test/post-link.test.ts asserts no draft slug appears in any built
-   page. Unknown slugs throw for the same reason forwardLinkVisible's do. */
+   build time instead. postLinkHref() is its policy: a visible target
+   gets its href, a hidden one gets null and the component renders its
+   text with no link (owner decision 2026-09-26), so a draft's name can
+   sit in published prose and becomes a link on its own when the draft
+   ships. resolvePostHref() still resolves drafts: consumers use it for
+   lookups keyed by href, and Astro renders MDX slot children eagerly,
+   so a PostLink inside a hidden WhenPublished still runs. The
+   deploy-build guard against a link to a draft stays a consumer test
+   (no draft slug in any built page). Unknown slugs throw for the same
+   reason forwardLinkVisible's do. */
 
 import { postPath } from "./slug";
 
 export interface Linkable {
-  data: { slug: string; date: Date };
+  data: { slug: string; date: Date; draft?: boolean };
 }
 
 export function resolvePostHref(slug: string, posts: Linkable[]): string {
@@ -61,3 +65,14 @@ export function resolvePostHref(slug: string, posts: Linkable[]): string {
   if (!target) throw new Error(`PostLink: no post has slug "${slug}"`);
   return postPath(target);
 }
+
+export function postLinkHref(
+  slug: string,
+  posts: Linkable[],
+  showDrafts: boolean,
+): string | null {
+  const target = posts.find((p) => p.data.slug === slug);
+  if (!target) throw new Error(`PostLink: no post has slug "${slug}"`);
+  if (target.data.draft && !showDrafts) return null;
+  return resolvePostHref(slug, posts);
+}