@standardagents/code-plugin-sdk 1.0.0-alpha.8-title.0 → 1.0.0-alpha.9-icons.0

package/README.md

@@ -11,8 +11,8 @@ Its `package.json` includes a static `standardPlugin` manifest.
 {
   "name": "example-status",
   "type": "module",
-  "peerDependencies": { "@standardagents/code-plugin-sdk": "^1.0.0-alpha.7-theme.0" },
-  "devDependencies": { "@standardagents/code-plugin-sdk": "^1.0.0-alpha.7-theme.0" },
+  "peerDependencies": { "@standardagents/code-plugin-sdk": "^1.0.0-alpha.9-icons.0" },
+  "devDependencies": { "@standardagents/code-plugin-sdk": "^1.0.0-alpha.9-icons.0" },
   "standardPlugin": {
     "apiVersion": 1,
     "id": "example-status",
@@ -195,14 +195,14 @@ The Standard Code build workflow publishes this package when the version in
 under `latest`. Feature branches publish under their product branch tag. Authors
 can install a published prerelease by its exact version.
 
-## License
-
-MIT. See `LICENSE`.
+## Sidebar card titles
 
-Sidebar card titles use muted, regular-weight text. The host prefixes a plugin
-identity icon only on the viewer's Nerd Font symbol tier. Other tiers render
-the title alone. This applies to bordered and borderless cards. Empty titles
-remain empty; no author-supplied icon or font detection is required.
+Sidebar card titles use muted, regular-weight text. A card declaration may
+supply an `icon` containing one Nerd Font private-use glyph, for example
+`"icon": "\uDB81\uDCC5"` (a gauge). The author chooses the card's topic icon.
+The host shows it only on the viewer's Nerd Font tier. Other tiers omit the
+icon and its spacing. Omitted icons have no fallback. This applies to bordered
+and borderless cards. Empty titles remain empty.
 
 A card view may replace its declared title through
 `ui.view(root, { title: [{ text: 'Builds ' }, { text: '●', foreground: 'green' }] })`.
@@ -214,4 +214,8 @@ Actions, control characters, and bidi formatting are rejected. Each replacement
 updates the body and title together. Omitting `title` restores the manifest title.
 This option belongs to card views. Plugins own the meaning and color of any
 status light; the SDK adds no health indicator. Host title styling and supported
-Nerd Font identity icons apply around the author-supplied spans.
+author-selected Nerd Font icons apply around the author-supplied spans.
+
+## License
+
+MIT. See `LICENSE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standardagents/code-plugin-sdk",
-  "version": "1.0.0-alpha.8-title.0",
+  "version": "1.0.0-alpha.9-icons.0",
   "type": "module",
   "description": "Standard Code plugin authoring SDK",
   "license": "MIT",

package/src/index.d.ts

@@ -16,6 +16,8 @@ export interface ContributionDeclaration {
   anchor: Anchor;
   /** Sidebar card border. Defaults to true; false retains the title and content padding. */
   border?: boolean;
+  /** One author-selected Nerd Font glyph; omitted on non-Nerd viewer tiers. */
+  icon?: string;
   title?: string;
   merge?: 'by-machine' | 'by-identity';
   width?: 'full' | 'half';

package/src/manifest.mjs

@@ -76,6 +76,9 @@ export function validateManifest(value) {
     ensure(object(declaration) && identifier(declaration.id) && !ids.has(declaration.id) &&
       SURFACE_KINDS.includes(declaration.kind) && ANCHORS.includes(declaration.anchor), 'invalid_manifest', 'Invalid contribution declaration')
     ids.add(declaration.id)
+    ensure(declaration.icon === undefined || (declaration.kind === 'card' && typeof declaration.icon === 'string' &&
+      /^[\uE000-\uF8FF\u{F0000}-\u{FFFFD}\u{100000}-\u{10FFFD}]$/u.test(declaration.icon)),
+    'invalid_manifest', 'Card icon must be one Nerd Font private-use glyph')
     ensure(declaration.border === undefined || (typeof declaration.border === 'boolean' && declaration.kind === 'card'),
       'invalid_manifest', 'Only sidebar cards declare a boolean border preference')
     for (const [key, choices] of Object.entries({ merge: ['by-machine', 'by-identity'], width: ['full', 'half'],