dogsbay 0.2.0-beta.10 → 0.2.0-beta.12

package/dist/registry.js

@@ -388,6 +388,14 @@ export const registry = {
         primitives: [],
         description: "Clickable card with link",
     },
+    icon: {
+        name: "icon",
+        files: ["Icon.astro", "index.ts"],
+        dependencies: ["@dogsbay/icons"],
+        registryDependencies: [],
+        primitives: [],
+        description: "Build-time-resolved icon (Lucide default; mdi:, simple-icons:, etc. via Iconify)",
+    },
     sidebar: {
         name: "sidebar",
         files: ["Sidebar.astro", "SidebarContent.astro", "SidebarGroup.astro", "SidebarGroupContent.astro", "SidebarGroupLabel.astro", "SidebarHeader.astro", "SidebarInset.astro", "SidebarMenu.astro", "SidebarMenuButton.astro", "SidebarMenuItem.astro", "SidebarNavTree.astro", "SidebarProvider.astro", "SidebarRail.astro", "SidebarSeparator.astro", "SidebarTrigger.astro", "sidebar.ts", "index.ts"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.10",
+  "version": "0.2.0-beta.12",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -32,14 +32,14 @@
     "picocolors": "^1.1.0",
     "prompts": "^2.4.2",
     "yaml": "^2.8.3",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.10",
-    "@dogsbay/format-astro": "0.2.0-beta.10",
-    "@dogsbay/format-obsidian": "0.2.0-beta.10",
-    "@dogsbay/format-mdx": "0.2.0-beta.10",
-    "@dogsbay/format-starlight": "0.2.0-beta.10",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.10",
-    "@dogsbay/format-openapi": "0.2.0-beta.10",
-    "@dogsbay/types": "0.2.0-beta.10"
+    "@dogsbay/format-astro": "0.2.0-beta.12",
+    "@dogsbay/format-obsidian": "0.2.0-beta.12",
+    "@dogsbay/format-mkdocs": "0.2.0-beta.12",
+    "@dogsbay/format-mdx": "0.2.0-beta.12",
+    "@dogsbay/format-starlight": "0.2.0-beta.12",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.12",
+    "@dogsbay/format-openapi": "0.2.0-beta.12",
+    "@dogsbay/types": "0.2.0-beta.12"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/skills/platform/markdown-directives/SKILL.md

@@ -110,25 +110,43 @@ a responsive grid.
 
 ```markdown
 :::cards
-- **[Getting started](./getting-started)**
+- **[Getting started](./getting-started)** {icon="rocket"}
   Three-minute orientation to authoring.
 
-- **[API reference](./api/)**
+- **[API reference](./api/)** {icon="book-open"}
   Endpoint browser, schemas, code samples.
 
-- **[GitHub](https://github.com/your-org/repo)**
+- **[GitHub](https://github.com/your-org/repo)** {icon="github"}
   Star, browse, file an issue.
 :::
 ```
 
-Each item: `- **[Title](href)**` followed by the description on
-the next line, indented two spaces. Optional blank line between
+Each item: `- **[Title](href)**` optionally followed by an
+attribute block (`{icon="..."}`), then the description on the
+next line, indented two spaces. Optional blank line between
 items improves readability.
 
-**Known limitation**: the `{icon="rocket"}` attribute syntax
-documented in some places does NOT currently survive the
-parser — leaks into descriptions as literal text. Don't use icon
-attributes in cards yet. See `plans/openapi-builtin-followups.md`.
+### Icons on cards
+
+`icon` accepts any name from the platform Icon component
+(see `dogsbay:theme-tokens` for the Icon component reference):
+
+- **Bare names** default to Lucide:
+  `{icon="rocket"}`, `{icon="book-open"}`, `{icon="github"}`.
+  Browse the catalog at <https://lucide.dev/icons/>.
+- **`pack:name`** routes to other Iconify packs:
+  `{icon="mdi:home"}` (Material Design Icons),
+  `{icon="simple-icons:github"}` (brand glyphs),
+  `{icon="lucide:book-open"}` (explicit Lucide).
+- **Emoji shortcodes** map to Unicode characters when no
+  Iconify pack is given: `{icon="rocket"}` → 🚀,
+  `{icon="tada"}` → 🎉. The emoji map wins for bare names that
+  match it.
+
+When the name doesn't resolve in any pack, the icon slot
+renders nothing (silent fallback) — better than a broken-image
+placeholder, since the title and description still convey the
+card's intent.
 
 ## Single card (with attrs or YAML body)
 
@@ -159,6 +177,54 @@ icon: rocket
 
 Both forms are accepted by the parser.
 
+## Link card (`:::link-card`)
+
+A focused variant of `:::card` for "go here next" navigation
+affordances. Renders a chevron arrow on the right and a
+distinctive hover state — visually clearer that it's a link
+rather than a content tile.
+
+```markdown
+:::link-card{title="Configuration guide" href="/config/"}
+Site name, theme, base path, and per-source settings live in
+dogsbay.config.yml.
+:::
+```
+
+YAML body form when prop count or content grows:
+
+```markdown
+:::link-card
+---
+title: Configuration guide
+description: |
+  Site name, theme, base path, and per-source settings live in
+  dogsbay.config.yml.
+href: /config/
+---
+:::
+```
+
+Props: `title` (required), `href` (required), `description`
+(optional — also accepted as the body paragraph for ergonomic
+authoring). No `icon` slot — link-cards intentionally lean on
+the chevron alone for the link affordance. When you need an
+icon, use `:::card`.
+
+### When to pick which card directive
+
+- **`:::cards`** (plural) — list of related links, displayed as
+  a responsive grid. Best for "browse next" clusters at the
+  end of a page or on a landing page. Items are bulleted-link
+  shorthand.
+- **`:::card`** (singular) — one rich card with full prop
+  surface (`icon`, `variant`, custom classes, arbitrary body).
+  Use when you want a tile with deliberate visual weight.
+- **`:::link-card`** — one card scoped to a single navigation
+  link, with chevron arrow. Use for callouts that lead the
+  reader somewhere specific ("Continue with Configuration
+  guide →").
+
 ## Grid
 
 Generic responsive grid container with `cols` and `gap` attrs:
@@ -220,8 +286,14 @@ For inline-level marks, use `:name[text]{attrs}`:
 ```markdown
 Press :kbd[Ctrl+C] to copy.
 This is :badge[New]{tone="success"} content.
+Click :icon[rocket] to launch, or :icon[mdi:home] to go home.
 ```
 
+`:icon[name]` accepts the same shorthand as the `{icon=...}`
+attribute on cards — bare names default to Lucide,
+`pack:name` routes to other Iconify packs, emoji shortcodes
+render as Unicode. See "Icons on cards" above.
+
 ## Frontmatter
 
 Every page should start with YAML frontmatter delimited by `---`:
@@ -250,4 +322,8 @@ fields.
   — they're different syntactic structures.
 - ❌ Writing card descriptions on the same line as the title —
   must be on the next line, indented two spaces.
-- ❌ `{icon="..."}` on cards — known parser gap, doesn't render.
+- ❌ Using a non-existent icon name. The icon slot fails
+  silently when the name doesn't resolve, so a typo leaves the
+  card looking wrong without any error. Verify Lucide names
+  against <https://lucide.dev/icons/> or use the `pack:name`
+  form to be explicit.