dogsbay 0.2.0-beta.11 → 0.2.0-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/registry.js CHANGED
@@ -388,6 +388,14 @@ export const registry = {
388
388
  primitives: [],
389
389
  description: "Clickable card with link",
390
390
  },
391
+ icon: {
392
+ name: "icon",
393
+ files: ["Icon.astro", "index.ts"],
394
+ dependencies: ["@dogsbay/icons"],
395
+ registryDependencies: [],
396
+ primitives: [],
397
+ description: "Build-time-resolved icon (Lucide default; mdi:, simple-icons:, etc. via Iconify)",
398
+ },
391
399
  sidebar: {
392
400
  name: "sidebar",
393
401
  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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dogsbay",
3
- "version": "0.2.0-beta.11",
3
+ "version": "0.2.0-beta.12",
4
4
  "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
5
5
  "type": "module",
6
6
  "bin": {
@@ -32,14 +32,14 @@
32
32
  "picocolors": "^1.1.0",
33
33
  "prompts": "^2.4.2",
34
34
  "yaml": "^2.8.3",
35
- "@dogsbay/format-obsidian": "0.2.0-beta.11",
36
- "@dogsbay/format-astro": "0.2.0-beta.11",
37
- "@dogsbay/format-mkdocs": "0.2.0-beta.11",
38
- "@dogsbay/format-mdx": "0.2.0-beta.11",
39
- "@dogsbay/format-openapi": "0.2.0-beta.11",
40
- "@dogsbay/format-dogsbay-md": "0.2.0-beta.11",
41
- "@dogsbay/types": "0.2.0-beta.11",
42
- "@dogsbay/format-starlight": "0.2.0-beta.11"
35
+ "@dogsbay/format-astro": "0.2.0-beta.12",
36
+ "@dogsbay/format-obsidian": "0.2.0-beta.12",
37
+ "@dogsbay/format-mkdocs": "0.2.0-beta.12",
38
+ "@dogsbay/format-mdx": "0.2.0-beta.12",
39
+ "@dogsbay/format-starlight": "0.2.0-beta.12",
40
+ "@dogsbay/format-dogsbay-md": "0.2.0-beta.12",
41
+ "@dogsbay/format-openapi": "0.2.0-beta.12",
42
+ "@dogsbay/types": "0.2.0-beta.12"
43
43
  },
44
44
  "devDependencies": {
45
45
  "@types/node": "^22.0.0",
@@ -177,6 +177,54 @@ icon: rocket
177
177
 
178
178
  Both forms are accepted by the parser.
179
179
 
180
+ ## Link card (`:::link-card`)
181
+
182
+ A focused variant of `:::card` for "go here next" navigation
183
+ affordances. Renders a chevron arrow on the right and a
184
+ distinctive hover state — visually clearer that it's a link
185
+ rather than a content tile.
186
+
187
+ ```markdown
188
+ :::link-card{title="Configuration guide" href="/config/"}
189
+ Site name, theme, base path, and per-source settings live in
190
+ dogsbay.config.yml.
191
+ :::
192
+ ```
193
+
194
+ YAML body form when prop count or content grows:
195
+
196
+ ```markdown
197
+ :::link-card
198
+ ---
199
+ title: Configuration guide
200
+ description: |
201
+ Site name, theme, base path, and per-source settings live in
202
+ dogsbay.config.yml.
203
+ href: /config/
204
+ ---
205
+ :::
206
+ ```
207
+
208
+ Props: `title` (required), `href` (required), `description`
209
+ (optional — also accepted as the body paragraph for ergonomic
210
+ authoring). No `icon` slot — link-cards intentionally lean on
211
+ the chevron alone for the link affordance. When you need an
212
+ icon, use `:::card`.
213
+
214
+ ### When to pick which card directive
215
+
216
+ - **`:::cards`** (plural) — list of related links, displayed as
217
+ a responsive grid. Best for "browse next" clusters at the
218
+ end of a page or on a landing page. Items are bulleted-link
219
+ shorthand.
220
+ - **`:::card`** (singular) — one rich card with full prop
221
+ surface (`icon`, `variant`, custom classes, arbitrary body).
222
+ Use when you want a tile with deliberate visual weight.
223
+ - **`:::link-card`** — one card scoped to a single navigation
224
+ link, with chevron arrow. Use for callouts that lead the
225
+ reader somewhere specific ("Continue with Configuration
226
+ guide →").
227
+
180
228
  ## Grid
181
229
 
182
230
  Generic responsive grid container with `cols` and `gap` attrs: