@brett_lamy/docstream 1.9.1 → 1.11.0

package/dist/styles.css

@@ -450,6 +450,570 @@
   border-radius: 12px;
 }
 
+/* StlViewer: a WebGL preview of an .stl model ({% embed url="part.stl" %}). The model takes
+   its color from `color`, so it follows the theme's primary. */
+.docstream-stl,
+.docstream-strudel {
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.docstream-stl__stage {
+  position: relative;
+  aspect-ratio: 16 / 9;
+  border: 1px solid var(--gb-border);
+  border-radius: 12px;
+  overflow: hidden;
+  color: var(--gb-primary, #6366f1);
+  background:
+    radial-gradient(circle at 50% 40%, color-mix(in srgb, var(--gb-muted, #f4f4f5) 40%, transparent), transparent 70%),
+    var(--gb-muted, #f4f4f5);
+}
+
+.docstream-stl__canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+  cursor: grab;
+  touch-action: none;
+}
+
+.docstream-stl__canvas:active {
+  cursor: grabbing;
+}
+
+.docstream-stl__canvas:focus-visible {
+  outline: 2px solid var(--gb-primary, #6366f1);
+  outline-offset: -2px;
+  border-radius: 12px;
+}
+
+.docstream-stl__status {
+  display: grid;
+  place-items: center;
+  height: 100%;
+  padding: 16px;
+  text-align: center;
+  font-size: 13px;
+  color: var(--gb-muted-foreground);
+}
+
+.docstream-stl__reset {
+  position: absolute;
+  top: 8px;
+  right: 8px;
+  padding: 3px 10px;
+  border: 1px solid var(--gb-border);
+  border-radius: 999px;
+  background: var(--gb-panel, #fff);
+  color: var(--gb-panel-foreground, inherit);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+  opacity: 0.85;
+}
+
+.docstream-stl__reset:hover {
+  opacity: 1;
+  background: var(--gb-hover, var(--gb-accent));
+}
+
+.docstream-stl__caption {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  gap: 4px 12px;
+  font-size: 12px;
+  color: var(--gb-muted-foreground);
+}
+
+.docstream-stl__caption a {
+  color: inherit;
+  font-weight: 500;
+}
+
+/* StrudelPlayer: a Strudel pattern as an audio player (```strudel fences, .strudel embeds). */
+.docstream-strudel__bar {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 12px;
+  border: 1px solid var(--gb-border);
+  border-radius: 12px;
+  background: var(--gb-panel, #fff);
+  color: var(--gb-panel-foreground, inherit);
+}
+
+.docstream-strudel__play {
+  flex: none;
+  display: grid;
+  place-items: center;
+  width: 40px;
+  height: 40px;
+  border: 0;
+  border-radius: 999px;
+  background: var(--gb-primary, #6366f1);
+  color: var(--gb-primary-foreground, #fff);
+  cursor: pointer;
+}
+
+.docstream-strudel__play:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.docstream-strudel__play:focus-visible,
+.docstream-strudel__toggle:focus-visible {
+  outline: 2px solid var(--gb-primary, #6366f1);
+  outline-offset: 2px;
+}
+
+.docstream-strudel__spin {
+  animation: docstream-strudel-spin 0.9s linear infinite;
+}
+
+@keyframes docstream-strudel-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.docstream-strudel__meta {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  flex: 0 1 auto;
+  max-width: 40%;
+}
+
+.docstream-strudel__title {
+  font-weight: 600;
+  font-size: 14px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.docstream-strudel__sub {
+  font-size: 12px;
+  color: var(--gb-muted-foreground);
+  font-variant-numeric: tabular-nums;
+}
+
+.docstream-strudel__roll {
+  flex: 1 1 auto;
+  min-width: 60px;
+  height: 40px;
+  color: var(--gb-primary, #6366f1);
+}
+
+.docstream-strudel__toggle {
+  flex: none;
+  display: grid;
+  place-items: center;
+  width: 32px;
+  height: 32px;
+  border: 1px solid var(--gb-border);
+  border-radius: 8px;
+  background: transparent;
+  color: var(--gb-muted-foreground);
+  cursor: pointer;
+}
+
+.docstream-strudel__toggle[aria-expanded="true"],
+.docstream-strudel__toggle:hover {
+  background: var(--gb-hover, var(--gb-accent));
+  color: inherit;
+}
+
+.docstream-strudel__error {
+  font-size: 12px;
+  color: var(--gb-danger, #dc2626);
+  white-space: pre-wrap;
+}
+
+.docstream-strudel__code {
+  border: 1px solid var(--gb-border);
+  border-radius: 12px;
+  background: var(--gb-code-bg);
+  color: var(--gb-code-fg);
+  padding: 12px 14px;
+  overflow-x: auto;
+  font-size: 13px;
+  white-space: pre;
+}
+
+/* StrudelRack: equipment generated from the code — a master strip, then one device per track. */
+.docstream-strudel__revert {
+  align-self: flex-start;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border: 1px solid var(--gb-border);
+  border-radius: 999px;
+  background: transparent;
+  color: var(--gb-muted-foreground);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+
+.strudel-rack {
+  --strudel-accent: var(--gb-primary, #6366f1);
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px;
+  border: 1px solid var(--gb-border);
+  border-radius: 12px;
+  background: var(--gb-muted, #f4f4f5);
+  font-size: 12px;
+}
+
+.strudel-rack__master {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  padding: 4px 6px;
+}
+
+.strudel-rack__title {
+  font-weight: 600;
+  font-size: 13px;
+}
+
+.strudel-rack__summary {
+  margin-left: auto;
+  color: var(--gb-muted-foreground);
+}
+
+.strudel-rack__error,
+.strudel-device__error {
+  margin: 0;
+  color: var(--gb-danger, #dc2626);
+  font-size: 12px;
+}
+
+.strudel-device {
+  border: 1px solid var(--gb-border);
+  border-radius: 10px;
+  background: var(--gb-panel, #fff);
+  color: var(--gb-panel-foreground, inherit);
+  overflow: hidden;
+}
+
+.strudel-device[data-audible="false"] .strudel-device__body {
+  opacity: 0.45;
+}
+
+.strudel-device__head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 8px 6px 10px;
+  border-bottom: 1px solid var(--gb-border);
+  color: var(--gb-muted-foreground);
+}
+
+.strudel-device[data-kind="drums"] .strudel-device__head svg { color: #f59e0b; }
+.strudel-device[data-kind="melodic"] .strudel-device__head svg { color: var(--strudel-accent); }
+
+.strudel-device__name {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-weight: 600;
+  color: var(--gb-panel-foreground, inherit);
+}
+
+.strudel-device__toggle {
+  width: 22px;
+  height: 22px;
+  border: 1px solid var(--gb-border);
+  border-radius: 5px;
+  background: transparent;
+  color: var(--gb-muted-foreground);
+  font: inherit;
+  font-size: 11px;
+  font-weight: 700;
+  cursor: pointer;
+}
+
+.strudel-device__toggle[data-kind="mute"][aria-pressed="true"] { background: #f59e0b; border-color: #f59e0b; color: #000; }
+.strudel-device__toggle[data-kind="solo"][aria-pressed="true"] { background: var(--strudel-accent); border-color: var(--strudel-accent); color: var(--gb-primary-foreground, #fff); }
+
+.strudel-device__body {
+  display: flex;
+  gap: 12px;
+  padding: 10px;
+}
+
+.strudel-device__main {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.strudel-device__selects {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px 14px;
+}
+
+.strudel-device__selects label {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--gb-muted-foreground);
+}
+
+.strudel-device__selects select,
+.strudel-device__add select {
+  font: inherit;
+  font-size: 12px;
+  padding: 2px 4px;
+  border: 1px solid var(--gb-border);
+  border-radius: 6px;
+  background: var(--gb-panel, #fff);
+  color: var(--gb-panel-foreground, inherit);
+}
+
+.strudel-device__knobs {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-start;
+  gap: 4px 10px;
+}
+
+.strudel-device__knob {
+  position: relative;
+}
+
+.strudel-device__remove {
+  position: absolute;
+  top: -2px;
+  right: -4px;
+  display: none;
+  place-items: center;
+  width: 14px;
+  height: 14px;
+  padding: 0;
+  border: 0;
+  border-radius: 999px;
+  background: var(--gb-muted-foreground);
+  color: var(--gb-panel, #fff);
+  cursor: pointer;
+}
+
+.strudel-device__knob:hover .strudel-device__remove,
+.strudel-device__remove:focus-visible {
+  display: grid;
+}
+
+.strudel-device__add {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  align-self: center;
+  color: var(--gb-muted-foreground);
+}
+
+.strudel-knob {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  width: 52px;
+  user-select: none;
+}
+
+.strudel-knob__dial {
+  width: 38px;
+  height: 38px;
+  border-radius: 999px;
+  cursor: ns-resize;
+  touch-action: none;
+}
+
+.strudel-knob__dial:focus-visible,
+.strudel-fader__track:focus-visible {
+  outline: 2px solid var(--strudel-accent, #6366f1);
+  outline-offset: 2px;
+}
+
+.strudel-knob__dial svg { width: 100%; height: 100%; display: block; }
+.strudel-knob__track { fill: none; stroke: var(--gb-border); stroke-width: 3; stroke-linecap: round; }
+.strudel-knob__fill { fill: none; stroke: var(--strudel-accent, #6366f1); stroke-width: 3; stroke-linecap: round; }
+.strudel-knob__cap { fill: var(--gb-muted, #f4f4f5); stroke: var(--gb-border); }
+.strudel-knob__pointer { stroke: var(--gb-panel-foreground, #18181b); stroke-width: 2; stroke-linecap: round; }
+
+.strudel-knob__value,
+.strudel-fader__value {
+  font-variant-numeric: tabular-nums;
+  font-size: 11px;
+  line-height: 1.3;
+}
+
+.strudel-knob__label,
+.strudel-fader__label {
+  font-size: 10px;
+  color: var(--gb-muted-foreground);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  white-space: nowrap;
+}
+
+.strudel-knob[data-disabled] .strudel-knob__dial,
+.strudel-fader[data-disabled] .strudel-fader__track {
+  cursor: not-allowed;
+  opacity: 0.6;
+}
+
+.strudel-fader {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  width: 36px;
+  user-select: none;
+}
+
+.strudel-fader__track {
+  position: relative;
+  width: 8px;
+  height: 90px;
+  border-radius: 999px;
+  background: var(--gb-border);
+  cursor: ns-resize;
+  touch-action: none;
+}
+
+.strudel-fader__fill {
+  position: absolute;
+  inset: auto 0 0;
+  border-radius: 999px;
+  background: var(--strudel-accent, #6366f1);
+}
+
+.strudel-fader__thumb {
+  position: absolute;
+  left: -6px;
+  width: 20px;
+  height: 10px;
+  border-radius: 3px;
+  background: var(--gb-panel, #fff);
+  border: 1px solid var(--gb-muted-foreground);
+  box-shadow: 0 1px 2px rgb(0 0 0 / 0.2);
+}
+
+/* StepGrid: mini-notation as a step sequencer. */
+.strudel-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding-top: 6px;
+  overflow-x: auto;
+}
+
+.strudel-step__layers {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  flex: 1;
+}
+
+.strudel-step__row {
+  display: flex;
+  gap: 3px;
+  min-width: 0;
+}
+
+.strudel-step {
+  position: relative;
+  flex: 1 1 0;
+  min-width: 18px;
+  display: flex;
+}
+
+.strudel-step__cell,
+.strudel-step__input {
+  flex: 1;
+  min-width: 0;
+  height: 26px;
+  padding: 0 3px;
+  border: 1px solid var(--gb-border);
+  border-radius: 5px;
+  font: inherit;
+  font-size: 11px;
+  font-family: var(--gb-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.strudel-step__cell {
+  background: color-mix(in srgb, var(--strudel-accent, #6366f1) 22%, var(--gb-panel, #fff));
+  color: var(--gb-panel-foreground, inherit);
+  cursor: pointer;
+}
+
+.strudel-device[data-kind="drums"] .strudel-step__cell:not([data-rest]) {
+  background: color-mix(in srgb, #f59e0b 30%, var(--gb-panel, #fff));
+}
+
+.strudel-step__cell[data-rest] {
+  background: transparent;
+  border-style: dashed;
+}
+
+.strudel-step__cell:hover {
+  border-color: var(--strudel-accent, #6366f1);
+}
+
+.strudel-step__input {
+  background: var(--gb-panel, #fff);
+  color: inherit;
+}
+
+.strudel-step__nest {
+  flex: 1;
+  display: flex;
+  padding: 2px;
+  border: 1px solid var(--gb-border);
+  border-radius: 6px;
+}
+
+.strudel-step__nest > .strudel-step__row {
+  flex: 1;
+}
+
+.strudel-step__nest[data-kind="alternation"] {
+  border-style: dashed;
+}
+
+.strudel-step__nest[data-kind="alternation"] > .strudel-step__layers > .strudel-step__row {
+  flex-wrap: wrap;
+}
+
+.strudel-step__badge {
+  position: absolute;
+  top: -6px;
+  right: 2px;
+  padding: 0 3px;
+  border-radius: 4px;
+  background: var(--gb-panel-foreground, #18181b);
+  color: var(--gb-panel, #fff);
+  font-size: 9px;
+  line-height: 12px;
+  pointer-events: none;
+}
+
 .docs-content-ref {
   display: flex !important;
   align-items: center;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brett_lamy/docstream",
-  "version": "1.9.1",
+  "version": "1.11.0",
   "description": "GitBook-aware readonly markdown and AI stream renderer.",
   "publishConfig": {
     "access": "public"
@@ -94,6 +94,18 @@
       "import": "./dist/video/index.js",
       "default": "./dist/video/index.js"
     },
+    "./stl": {
+      "source": "./src/stl/index.ts",
+      "types": "./dist/stl/index.d.ts",
+      "import": "./dist/stl/index.js",
+      "default": "./dist/stl/index.js"
+    },
+    "./strudel": {
+      "source": "./src/strudel/index.ts",
+      "types": "./dist/strudel/index.d.ts",
+      "import": "./dist/strudel/index.js",
+      "default": "./dist/strudel/index.js"
+    },
     "./viz": {
       "source": "./src/viz/index.ts",
       "types": "./dist/viz/index.d.ts",
@@ -127,6 +139,8 @@
     "./styles.css": "./dist/styles.css"
   },
   "dependencies": {
+    "@strudel/web": "1.3.0",
+    "acorn": "^8.15.0",
     "framer-motion": "^13.1.1",
     "gpu-lexer": "^0.0.2",
     "katex": "^0.18.5",

package/src/docs/DocsRenderer.tsx

@@ -27,6 +27,9 @@ import { useSyncedTab } from "./tabs-sync"
 import { ReplayPreview } from "../replay/ReplayPreview"
 import { isReplayQaUrl } from "../replay/url"
 import { VideoEmbed } from "../video"
+import { StlViewer, isStlUrl } from "../stl"
+import { StrudelPlayer } from "../strudel/StrudelPlayer"
+import { isStrudelFile, isStrudelLanguage } from "../strudel/url"
 import { OpenApiOperation } from "../openapi/OpenApiOperation"
 import { Mermaid } from "./Mermaid"
 import { HighlightedCode } from "./HighlightedCode"
@@ -153,7 +156,7 @@ function codeOnlyTabs(block: Extract<Block, { type: "tabs" }>): CodeBlockNode[]
   const codes: CodeBlockNode[] = []
   for (const tab of block.tabs) {
     const only = tab.children.length === 1 ? tab.children[0] : null
-    if (!only || only.type !== "code" || only.live || only.language === "mermaid") return null
+    if (!only || only.type !== "code" || only.live || only.language === "mermaid" || isStrudelLanguage(only.language)) return null
     codes.push(only)
   }
   return codes
@@ -342,6 +345,9 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
           />
         )
       }
+      if (isStrudelLanguage(block.language)) {
+        return <StrudelPlayer code={block.code} {...(block.title ? { title: block.title } : {})} />
+      }
       if (block.live && isReactLanguage(block.language) && liveRenderer) {
         const entry = block.entry ?? "/src/main.jsx"
         return liveRenderer({
@@ -419,6 +425,12 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
       if (isReplayQaUrl(block.url)) {
         return <ReplayPreview source={block.url} title="Replay preview" />
       }
+      if (isStlUrl(block.url)) {
+        return <StlViewer src={resolveAsset(block.url)} {...(block.title ? { title: block.title } : {})} />
+      }
+      if (isStrudelFile(block.url)) {
+        return <StrudelPlayer src={resolveAsset(block.url)} {...(block.title ? { title: block.title } : {})} />
+      }
       const src = embedSrc(block.url)
       return src || isDirectVideo(block.url) ? (
         <VideoEmbed

package/src/env.d.ts

@@ -2,3 +2,6 @@ declare module "*.css" {
   const href: string
   export default href
 }
+
+// @strudel/web ships no types; src/strudel/engine.ts types the slice it uses.
+declare module "@strudel/web"

package/src/index.ts

@@ -88,6 +88,11 @@ export type { ReplayEvent } from "./replay/types"
 export { isReplayQaUrl, normalizeReplayEmbedUrl } from "./replay/url"
 export { VideoEmbed } from "./video"
 export type { VideoEmbedProps } from "./video"
+export { StlViewer, isStlUrl, parseStl } from "./stl"
+export type { StlMesh, StlViewerProps } from "./stl"
+export { StrudelPlayer } from "./strudel/StrudelPlayer"
+export { isStrudelFile, isStrudelLanguage } from "./strudel/url"
+export type { StrudelPlayerProps } from "./strudel/StrudelPlayer"
 export { OpenApiOperation } from "./openapi/OpenApiOperation"
 export { createInlineDemoProject, createReactDemoFiles } from "./playground/project"
 export type {