@shoalrun/cli 0.1.0-alpha.12 → 0.1.0-alpha.14

package/skills/shoalrun-author/SKILL.md

@@ -29,6 +29,8 @@ Edit ordinary source files and required companions. Choose a page type and revie
 
 For release notes, lead with the reader-visible change and why it matters. Explain the previous and new behavior with a concrete example when useful, then state any upgrade action. Introduce unfamiliar terms before using them. Put implementation details and test counts after the explanation; they do not substitute for it. Distinguish measured improvements from expected benefits, and package publication from site deployment.
 
+When importing a related-reading or related-material section, inspect native relationships and `RelatedReading` before translating it to manual links. Choose the purpose and reason for each connection; an authoring hint is a suggestion, not authorization to create relationships automatically.
+
 When adapting source material, choose components by reader purpose rather than translating unfamiliar markup into a generic container. Use authored `Fields` for client settings, source-backed `ApiSchema` or operation references for HTTP contracts, and `Steps` for procedures. Check field presence, nullability, defaults, constraints, warnings, and nested relationships against the source in both outputs. Keep configuration settings distinct from API request fields, and prefer source-backed contract data to a second handwritten copy.
 
 ## Validate, preview and obtain review

package/styles/site.css

@@ -26,7 +26,7 @@ a.brand{text-decoration:none}
 :where(a,button,input,summary,[tabindex]):focus-visible{outline:3px solid var(--color-focus);outline-offset:4px;border-radius:3px}
 button,input{font:inherit}
 button{cursor:pointer}
-::selection{background:var(--color-nav-active);color:var(--color-ink)}
+::selection{background:var(--color-nav-active);color:var(--color-nav-active-text)}
 .skip,.page-shortcuts a{position:fixed;left:-100vw;top:.6rem;background:var(--color-surface);padding:.5rem 1rem;z-index:50}
 .skip:focus,.page-shortcuts a:focus{left:1rem;max-width:calc(100vw - 2rem)}
 .region-return{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}
@@ -46,7 +46,10 @@ button{cursor:pointer}
 .navigation-dialog .section-disclosure{padding:.75rem 1rem}
 .navigation-dialog .section-nav-links{display:flex;flex-direction:column;gap:0}
 .navigation-dialog .section-nav-links a{overflow-wrap:anywhere}
-:is(#main,#docs-navigation,#page-outline):focus{outline:2px solid var(--color-accent);outline-offset:4px}
+/* Article focus is a reading destination, not a page-sized interactive control. */
+#main:focus{outline:none}
+#main:focus-visible h1{text-decoration-line:underline;text-decoration-color:var(--color-focus);text-decoration-thickness:3px;text-underline-offset:.2em}
+:is(#docs-navigation,#page-outline):focus{outline:2px solid var(--color-accent);outline-offset:4px}
 /* The masthead is its own stacking context (view-transition-name), so it needs a layer above sticky page parts for the search results to show over them; the expanded examples panel (30) still covers it. */
 .mast{position:relative;z-index:25;background:var(--color-surface);border-bottom:1px solid var(--color-border)}
 .mast-inner{max-width:var(--width-reference);margin:auto;min-height:4.5rem;padding:1rem 2rem;display:flex;gap:1rem;align-items:center;justify-content:space-between;flex-wrap:wrap}
@@ -303,10 +306,10 @@ button{cursor:pointer}
 .content article>h2:first-child{margin-top:0;padding-top:0;border-top:0}
 .content h3{font-size:1.1rem;line-height:1.4;letter-spacing:-.015em;margin:2rem 0 .75rem}
 .content h4{font-size:.92rem;line-height:1.5;margin:1.5rem 0 .65rem;color:var(--color-section-heading)}
-.content p{max-width:68ch;line-height:1.8;margin:.85rem 0 1.2rem}
+.content p{max-width:var(--prose-max-width,68ch);line-height:1.8;margin:.85rem 0 1.2rem}
 .content article>ul{margin:1rem 0 1.5rem}
 /* Limit ordinary list prose without constraining steps, fields, or file trees. */
-.content article :where(ul,ol):not([class]):not(:has([data-field])):not(.doc-file-tree ul){max-width:68ch}
+.content article :where(ul,ol):not([class]):not(:has([data-field])):not(.doc-file-tree ul){max-width:var(--prose-max-width,68ch)}
 .content li{margin:.5rem 0}
 .content li>p{margin:.35rem 0}
 .content ul,.content ol{padding-left:1.4rem}
@@ -597,6 +600,8 @@ button{cursor:pointer}
 @media print{.content .walkthrough-pane{display:none}.content .walkthrough.is-split{display:block}.content .walkthrough.is-split[data-layout=scroll]{height:auto}.content .walkthrough.is-split[data-layout=scroll]>.walkthrough-steps{overflow:visible;padding-bottom:0}.content .walkthrough.is-split .walkthrough-code{position:static;width:auto;height:auto;clip-path:none;white-space:normal}}
 
 /* Page layouts: wide drops the outline; landing drops the sidebar too and lets a Hero open the page. */
+/* Expanded layouts let ordinary prose fill its container, including nested Sections. */
+:is(.layout-wide,.layout-landing,.layout-splash){--prose-max-width:none}
 .layout.layout-wide:not(.has-examples){grid-template-areas:"side main";grid-template-columns:minmax(12rem,14rem) minmax(0,1fr)}
 .layout.layout-wide:not(.has-examples) .content article,.layout-wide .content{max-width:none}
 .layout.layout-landing{display:block;max-width:var(--landing-width);padding-top:1.5rem}