@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/registry/layers/framework/webgpu-render/files/src/main.ts

@@ -0,0 +1,113 @@
+// Raw WebGPU rendering bootstrap — no engine, no abstraction.
+// adapter → device → canvas context → render pipeline → render loop.
+
+import mainWgsl from './shaders/main.wgsl?raw'
+
+const canvas = document.getElementById('scene') as HTMLCanvasElement
+const statusEl = document.getElementById('status') as HTMLDivElement
+if (!canvas) throw new Error('#scene canvas missing from index.html')
+
+function setStatus(msg: string, cls: '' | 'err' = ''): void {
+  statusEl.textContent = msg
+  statusEl.className = cls
+}
+
+async function run(): Promise<void> {
+  if (!('gpu' in navigator)) {
+    throw new Error('navigator.gpu unavailable — use Chrome 113+, Edge 113+, Safari 18+, or enable dom.webgpu.enabled in Firefox.')
+  }
+
+  const adapter = await navigator.gpu.requestAdapter()
+  if (!adapter) {
+    throw new Error('requestAdapter() returned null — GPU may be blocklisted or disabled in this browser profile.')
+  }
+
+  const device = await adapter.requestDevice()
+  device.lost.then((info) => {
+    setStatus(`GPUDevice lost: ${info.reason} — ${info.message}`, 'err')
+  })
+
+  const context = canvas.getContext('webgpu') as GPUCanvasContext | null
+  if (!context) throw new Error('canvas.getContext("webgpu") returned null')
+
+  // Preferred format must match between context.configure and the
+  // pipeline's fragment target — store once, reuse.
+  const format = navigator.gpu.getPreferredCanvasFormat()
+
+  function configureSwapchain(): void {
+    const dpr = Math.min(window.devicePixelRatio, 2)
+    canvas.width = Math.max(1, Math.floor(window.innerWidth * dpr))
+    canvas.height = Math.max(1, Math.floor(window.innerHeight * dpr))
+    context!.configure({
+      device,
+      format,
+      alphaMode: 'premultiplied',
+    })
+  }
+  configureSwapchain()
+
+  const shaderModule = device.createShaderModule({ code: mainWgsl })
+  const compilation = await shaderModule.getCompilationInfo()
+  for (const msg of compilation.messages) {
+    if (msg.type === 'error') {
+      throw new Error(`WGSL compile error at ${msg.lineNum}:${msg.linePos}: ${msg.message}`)
+    }
+  }
+
+  const pipeline = device.createRenderPipeline({
+    layout: 'auto',
+    vertex: { module: shaderModule, entryPoint: 'vs_main' },
+    fragment: {
+      module: shaderModule,
+      entryPoint: 'fs_main',
+      targets: [{ format }],
+    },
+    primitive: { topology: 'triangle-list' },
+  })
+
+  let rafHandle = 0
+  function frame(): void {
+    const view = context!.getCurrentTexture().createView()
+    const encoder = device.createCommandEncoder()
+    const pass = encoder.beginRenderPass({
+      colorAttachments: [
+        {
+          view,
+          clearValue: { r: 0.043, g: 0.051, b: 0.063, a: 1 },
+          loadOp: 'clear',
+          storeOp: 'store',
+        },
+      ],
+    })
+    pass.setPipeline(pipeline)
+    pass.draw(3, 1, 0, 0)
+    pass.end()
+    device.queue.submit([encoder.finish()])
+    rafHandle = requestAnimationFrame(frame)
+  }
+  frame()
+
+  function onResize(): void {
+    configureSwapchain()
+  }
+  window.addEventListener('resize', onResize)
+
+  const adapterInfo = (adapter as GPUAdapter & { info?: GPUAdapterInfo }).info
+  const vendor = adapterInfo?.vendor ?? 'unknown'
+  const arch = adapterInfo?.architecture ?? 'unknown'
+  setStatus(`WebGPU ${vendor}/${arch} · format ${format}`)
+
+  if (import.meta.hot) {
+    import.meta.hot.dispose(() => {
+      cancelAnimationFrame(rafHandle)
+      window.removeEventListener('resize', onResize)
+      device.destroy()
+    })
+  }
+}
+
+run().catch((err: unknown) => {
+  const message = err instanceof Error ? err.message : String(err)
+  setStatus(`Fatal: ${message}`, 'err')
+  console.error(err)
+})

package/registry/layers/framework/webgpu-render/files/src/shaders/main.wgsl

@@ -0,0 +1,37 @@
+// Vertex + fragment stages in one module. The vertex stage emits three
+// hard-coded clip-space positions from @builtin(vertex_index), so we draw
+// a full-colour triangle with zero vertex buffers — the canonical "hello
+// WebGPU" shape. Replace with a vertex buffer binding once you add real
+// geometry.
+
+struct VSOut {
+  @builtin(position) position: vec4<f32>,
+  @location(0) color: vec3<f32>,
+}
+
+@vertex
+fn vs_main(@builtin(vertex_index) vi: u32) -> VSOut {
+  // Equilateral triangle filling ~2/3 of the viewport.
+  var positions = array<vec2<f32>, 3>(
+    vec2<f32>( 0.0,  0.65),
+    vec2<f32>(-0.65, -0.5),
+    vec2<f32>( 0.65, -0.5),
+  );
+  var colors = array<vec3<f32>, 3>(
+    vec3<f32>(1.0, 0.25, 0.4),
+    vec3<f32>(0.25, 0.75, 1.0),
+    vec3<f32>(0.45, 1.0, 0.45),
+  );
+
+  var out: VSOut;
+  out.position = vec4<f32>(positions[vi], 0.0, 1.0);
+  out.color = colors[vi];
+  return out;
+}
+
+@fragment
+fn fs_main(in: VSOut) -> @location(0) vec4<f32> {
+  // Interpolated vertex colours give a free gradient — a real scene
+  // would sample textures or compute lighting here.
+  return vec4<f32>(in.color, 1.0);
+}

package/registry/layers/framework/webgpu-render/files/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/registry/layers/framework/webgpu-render/manifest.json

@@ -0,0 +1,56 @@
+{
+  "id": "webgpu-render",
+  "description": "Raw WebGPU rendering framework layer — src/main.ts drives navigator.gpu directly with a real render pipeline, plus vertex+fragment WGSL.",
+  "appliesTo": ["webgpu-render"],
+  "files": [
+    { "source": "files/src/main.ts", "target": "src/main.ts" },
+    { "source": "files/src/shaders/main.wgsl", "target": "src/shaders/main.wgsl" },
+    { "source": "files/src/vite-env.d.ts", "target": "src/vite-env.d.ts" }
+  ],
+  "packageDeps": {
+    "devDependencies": {
+      "@webgpu/types": "^0.1.52",
+      "typescript": "^5.9.0",
+      "vite": "^6.4.2"
+    }
+  },
+  "buildHints": {
+    "whenToUse": "Any product that needs the raw WebGPU API — custom renderers, engine internals, novel rendering techniques (deferred, cluster-forward, raymarching), or shader-driven art where three.js abstractions get in the way. Pick threejs-game instead if you want a batteries-included 3D scene graph.",
+    "firstSteps": [
+      "Run `pnpm install` then `pnpm dev` — Vite serves on 5173 with HMR; open Chrome 113+, Edge 113+, or Safari 18+; a gradient triangle fills the canvas.",
+      "All rendering logic is in `src/main.ts`: adapter → device → canvas context → render pipeline → render loop → resize handler.",
+      "The shader is `src/shaders/main.wgsl` containing both the `@vertex` and `@fragment` entry points. Extend by adding vertex buffers for real geometry or uniform buffers for camera/time.",
+      "To add a textured quad next: create a GPUTexture, upload via `queue.copyExternalImageToTexture`, bind a GPUSampler + texture in a new bind group, then sample in the fragment shader.",
+      "Run `pnpm build` to emit static assets to `dist/` — deploy to any static host. WebGPU requires HTTPS in production (localhost is exempt)."
+    ],
+    "gotchas": [
+      "WebGPU is Chrome/Edge 113+ and Safari 18+ stable. Always feature-detect `navigator.gpu` and show a fallback UI — Firefox requires `dom.webgpu.enabled`.",
+      "The canvas format from `getPreferredCanvasFormat()` differs by platform (bgra8unorm on macOS, rgba8unorm elsewhere) — store it once and use it in both `context.configure({ format })` AND `pipeline.fragment.targets[0].format`; a mismatch throws at pipeline creation.",
+      "Each frame must call `context.getCurrentTexture().createView()` — the texture is recycled by the swap chain and stale views throw on the next submit.",
+      "Canvas resize: set `canvas.width`/`canvas.height` to `innerWidth * devicePixelRatio` (cap DPR at 2) and re-call `context.configure()` — ignoring this gives blurry output.",
+      "Always cancel `requestAnimationFrame` in the HMR dispose callback — WebGPU does not garbage-collect GPU resources and dangling frames will eventually crash the tab.",
+      "Call `shaderModule.getCompilationInfo()` during development — a broken WGSL module otherwise produces a silent black canvas."
+    ],
+    "architectureNotes": [
+      "Create the GPUDevice once per page — `requestDevice()` is expensive; reuse the device for every pipeline and buffer.",
+      "Pre-create pipelines, bind group layouts, and buffers outside the render loop; only command-buffer construction belongs inside `requestAnimationFrame`.",
+      "For multiple render passes (shadow + main + post), batch into a single GPUCommandEncoder and `queue.submit` once per frame — each submit has a non-trivial CPU/GPU sync cost."
+    ],
+    "placeholders": [
+      {
+        "path": "src/main.ts",
+        "description": "WebGPU render bootstrap — device, canvas context, pipeline, render loop, resize handling. Extend by adding vertex buffers for real geometry, uniform buffers for camera/time, and textures via `queue.copyExternalImageToTexture`."
+      },
+      {
+        "path": "src/shaders/main.wgsl",
+        "description": "Vertex + fragment WGSL. The vertex stage emits a gradient triangle from @builtin(vertex_index). Replace positions with a vertex buffer binding for real meshes."
+      }
+    ]
+  },
+  "contextHints": {
+    "commands": ["pnpm install", "pnpm dev", "pnpm build", "pnpm run validate"],
+    "entrypoints": ["src/main.ts", "src/shaders/main.wgsl"],
+    "preview": { "path": "/" },
+    "extensionPoints": ["src/main.ts", "src/shaders/main.wgsl"]
+  }
+}

package/registry/layers/framework/zola-static/files/_index.md

@@ -0,0 +1,10 @@
++++
+title = "{{headline}}"
+sort_by = "date"
+template = "index.html"
++++
+
+{{subheadline}}
+
+Add posts to `content/posts/` as Markdown with TOML `+++` frontmatter.
+Templates live under `templates/`. Styles compile from `sass/main.scss`.

package/registry/layers/framework/zola-static/files/base.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="{{ config.default_language }}">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{% block title %}{{ config.title }}{% endblock title %}</title>
+  <link rel="stylesheet" href="{{ get_url(path='main.css') | safe }}" />
+</head>
+<body>
+  {% block content %}{% endblock content %}
+</body>
+</html>

package/registry/layers/framework/zola-static/files/gitignore

@@ -0,0 +1,3 @@
+public/
+node_modules/
+.DS_Store

package/registry/layers/framework/zola-static/files/index.html

@@ -0,0 +1,26 @@
+<!doctype html>
+<html lang="{{ config.default_language }}">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{ section.title | default(value=config.title) }}</title>
+    <link rel="stylesheet" href="{{ get_url(path='main.css') | safe }}" />
+  </head>
+  <body>
+    <header>
+      <h1>{{ config.title }}</h1>
+      <p>{{ config.extra.subtitle }}</p>
+    </header>
+    <main>
+      {{ section.content | safe }}
+      {% if section.pages %}
+        <h2>Posts</h2>
+        <ul>
+          {% for page in section.pages %}
+            <li><a href="{{ page.permalink | safe }}">{{ page.title }}</a></li>
+          {% endfor %}
+        </ul>
+      {% endif %}
+    </main>
+  </body>
+</html>

package/registry/layers/framework/zola-static/files/main.scss

@@ -0,0 +1,21 @@
+$fg: #0f172a;
+$muted: #64748b;
+$accent: #2563eb;
+
+body {
+  font-family: ui-sans-serif, system-ui, sans-serif;
+  max-width: 720px;
+  margin: 2rem auto;
+  padding: 0 1rem;
+  color: $fg;
+}
+
+header {
+  border-bottom: 1px solid #e2e8f0;
+  margin-bottom: 1.5rem;
+  padding-bottom: 1rem;
+
+  p { color: $muted; margin: 0; }
+}
+
+a { color: $accent; }

package/registry/layers/framework/zola-static/files/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "zola-static-scaffold",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "zola build",
+    "serve": "zola serve",
+    "check": "zola check",
+    "validate": "node validate-zola.mjs"
+  },
+  "devDependencies": {}
+}

package/registry/layers/framework/zola-static/manifest.json

@@ -0,0 +1,72 @@
+{
+  "id": "zola-static",
+  "description": "Zola framework layer: index Tera template, home content bundle, and a SASS entry file — three files that complete a bootable Zola site when composed with the zola-static family.",
+  "appliesTo": ["zola-static"],
+  "files": [
+    { "source": "files/package.json", "target": "package.json" },
+    { "source": "files/gitignore", "target": ".gitignore" },
+    { "source": "files/index.html", "target": "templates/index.html" },
+    { "source": "files/base.html", "target": "templates/base.html" },
+    { "source": "files/_index.md", "target": "content/_index.md" },
+    { "source": "files/main.scss", "target": "sass/main.scss" },
+    { "source": "files/static.gitkeep", "target": "static/.gitkeep" }
+  ],
+  "buildHints": {
+    "whenToUse": "Static blogs, documentation sites, marketing pages, or any project that needs a zero-JS build pipeline, built-in SASS compilation, and Tera templating without a Node.js dependency.",
+    "firstSteps": [
+      "Install the Zola binary: `brew install zola` (macOS), `snap install zola` (Linux), or download from https://www.getzola.org/documentation/getting-started/installation/",
+      "Run `npm install` (no-op — no Node deps; the package.json scripts are thin wrappers around the Zola CLI for tooling consistency).",
+      "Run `npm run serve` (or `zola serve --port 1111`) from the project root — Zola compiles templates + SASS and live-reloads at http://127.0.0.1:1111.",
+      "Edit `content/_index.md` to change the home page title and body copy; TOML frontmatter is delimited by `+++`.",
+      "Add blog posts as Markdown files in `content/posts/<slug>.md` — each needs `title`, `date`, and optionally `draft = true` in TOML frontmatter.",
+      "Run `zola build` to emit the production site to `public/` — no server required, deploy any static host."
+    ],
+    "gotchas": [
+      "`templates/index.html` is required for the root section (`content/_index.md`); if it is missing or misnamed, Zola aborts with a template-not-found error.",
+      "SASS is compiled automatically from `sass/main.scss` into `public/main.css`; reference it in templates via `{{ get_url(path='main.css') }}`.",
+      "Content files do not render Tera by default — `{{ ... }}` in a Markdown body appears verbatim. The foundry substitutes `{{headline}}` / `{{subheadline}}` placeholders at compose time, before Zola ever sees the files.",
+      "Zola requires `base_url` in `config.toml` to be an absolute URL; leave it as `http://127.0.0.1:1111` for local dev and override for production.",
+      "Section pages (`_index.md`) cannot be drafts — the `draft = true` flag only works on leaf pages."
+    ],
+    "architectureNotes": [
+      "Single Rust binary, zero Node.js / npm required. The only runtime dependency is the `zola` executable on PATH.",
+      "Standard layout: `config.toml` at root, content under `content/`, Tera templates under `templates/`, SASS under `sass/`, static assets under `static/`. Output lands in `public/`.",
+      "Tera inherits work via `{% extends \"base.html\" %}` — `templates/base.html` is scaffolded; extend it from new page templates to share `<head>`, nav, and footer without duplication."
+    ],
+    "placeholders": [
+      {
+        "path": "content/_index.md",
+        "description": "`{{headline}}` and `{{subheadline}}` are substituted by the foundry at compose time using the family defaults (`Starter Foundry Zola` / `Zola content site with built-in SASS pipeline.`). Replace them with real copy after scaffolding."
+      },
+      {
+        "path": "templates/index.html",
+        "description": "Minimal single-page template: title, subtitle, and a post list. Extract shared structure (head, nav, footer) into `templates/base.html` and `{% extends %}` from here once a second template is needed."
+      }
+    ]
+  },
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "pnpm run validate",
+      "zola serve --port 1111",
+      "zola build",
+      "zola check"
+    ],
+    "entrypoints": [
+      "config.toml",
+      "content/_index.md",
+      "templates/index.html",
+      "sass/main.scss"
+    ],
+    "preview": {
+      "port": "1111",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "content/posts/",
+      "templates/",
+      "sass/",
+      "static/"
+    ]
+  }
+}

package/registry/layers/payments/coinbase-commerce/manifest.json

@@ -3,29 +3,38 @@
   "slot": "payments",
   "description": "Coinbase Commerce payments profile.",
   "appliesTo": [
-    "react-vite-ts",
-    "nextjs-ts",
-    "fullstack-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "agent-service-ts",
+    "angular-ts",
     "api-service",
+    "bun-http",
     "cloudflare-worker-ts",
-    "python-api",
-    "rust-service",
-    "go-api",
-    "expo-react-native-ts",
-    "electron-desktop-ts",
-    "tauri-desktop",
-    "mcp-server-ts",
+    "deno-edge",
     "dspy-pipeline-py",
-    "agent-service-ts",
-    "agent-service-py",
-    "agent-service-rust",
-    "x402-service",
-    "zk-prover-service",
+    "electron-desktop-ts",
+    "electron-native-os",
     "evm-infra-ts",
-    "angular-ts",
+    "expo-react-native-ts",
+    "expo-rn-rich",
+    "flutter-app",
+    "fullstack-ts",
+    "go-api",
+    "kotlin-multiplatform",
+    "mcp-server-ts",
+    "nextjs-ts",
+    "python-api",
+    "react-vite-ts",
+    "realtime-audio-ts",
     "remix-ts",
+    "rust-service",
     "sveltekit-ts",
-    "vue-ts"
+    "tauri-desktop",
+    "tauri-menubar",
+    "tauri-tray",
+    "vue-ts",
+    "x402-service",
+    "zk-prover-service"
   ],
   "defaults": {
     "paymentsProvider": "coinbase-commerce"

package/registry/layers/payments/none/manifest.json

@@ -3,28 +3,39 @@
   "slot": "payments",
   "description": "No payments provider selected.",
   "appliesTo": [
-    "react-vite-ts",
-    "nextjs-ts",
-    "fullstack-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "agent-service-ts",
+    "angular-ts",
     "api-service",
+    "bun-http",
     "cloudflare-worker-ts",
-    "python-api",
-    "rust-service",
-    "go-api",
-    "expo-react-native-ts",
-    "electron-desktop-ts",
-    "tauri-desktop",
-    "mcp-server-ts",
+    "deno-edge",
     "dspy-pipeline-py",
-    "agent-service-ts",
-    "agent-service-py",
-    "agent-service-rust",
-    "x402-service",
-    "zk-prover-service",
+    "electron-desktop-ts",
+    "electron-native-os",
+    "esp32-rust",
     "evm-infra-ts",
-    "angular-ts",
+    "expo-react-native-ts",
+    "expo-rn-rich",
+    "flutter-app",
+    "fullstack-ts",
+    "go-api",
+    "kotlin-multiplatform",
+    "mcp-server-ts",
+    "nextjs-ts",
+    "python-api",
+    "react-vite-ts",
+    "realtime-audio-ts",
     "remix-ts",
+    "rust-service",
+    "stm32-rust",
     "sveltekit-ts",
-    "vue-ts"
+    "tauri-desktop",
+    "tauri-menubar",
+    "tauri-tray",
+    "vue-ts",
+    "x402-service",
+    "zk-prover-service"
   ]
 }

package/registry/layers/payments/stripe/manifest.json

@@ -3,29 +3,39 @@
   "slot": "payments",
   "description": "Stripe payments profile.",
   "appliesTo": [
-    "react-vite-ts",
-    "nextjs-ts",
-    "fullstack-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "agent-service-ts",
+    "angular-ts",
     "api-service",
+    "bun-http",
     "cloudflare-worker-ts",
-    "python-api",
-    "rust-service",
-    "go-api",
-    "expo-react-native-ts",
-    "electron-desktop-ts",
-    "tauri-desktop",
-    "mcp-server-ts",
+    "deno-edge",
     "dspy-pipeline-py",
-    "agent-service-ts",
-    "agent-service-py",
-    "agent-service-rust",
-    "x402-service",
-    "zk-prover-service",
+    "ecommerce-headless",
+    "electron-desktop-ts",
+    "electron-native-os",
     "evm-infra-ts",
-    "angular-ts",
+    "expo-react-native-ts",
+    "expo-rn-rich",
+    "flutter-app",
+    "fullstack-ts",
+    "go-api",
+    "kotlin-multiplatform",
+    "mcp-server-ts",
+    "nextjs-ts",
+    "python-api",
+    "react-vite-ts",
+    "realtime-audio-ts",
     "remix-ts",
+    "rust-service",
     "sveltekit-ts",
-    "vue-ts"
+    "tauri-desktop",
+    "tauri-menubar",
+    "tauri-tray",
+    "vue-ts",
+    "x402-service",
+    "zk-prover-service"
   ],
   "defaults": {
     "paymentsProvider": "stripe"

package/registry/layers/queue/bullmq/manifest.json

@@ -3,25 +3,27 @@
   "slot": "queue",
   "description": "BullMQ queue profile for worker-backed flows.",
   "appliesTo": [
-    "fullstack-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "agent-service-ts",
     "api-service",
+    "bun-http",
+    "cli-ts",
     "cloudflare-worker-ts",
-    "python-api",
-    "rust-service",
+    "deno-edge",
+    "dspy-pipeline-py",
+    "evm-infra-ts",
+    "fullstack-ts",
     "go-api",
-    "worker-job",
-    "cli-ts",
     "go-worker",
-    "playwright-worker",
     "mcp-server-ts",
-    "dspy-pipeline-py",
-    "agent-service-ts",
-    "agent-service-py",
-    "agent-service-rust",
+    "playwright-worker",
+    "python-api",
+    "python-worker",
+    "rust-service",
+    "worker-job",
     "x402-service",
-    "zk-prover-service",
-    "evm-infra-ts",
-    "python-worker"
+    "zk-prover-service"
   ],
   "defaults": {
     "queueProvider": "bullmq"

package/registry/layers/queue/none/manifest.json

@@ -3,24 +3,26 @@
   "slot": "queue",
   "description": "No queue provider selected.",
   "appliesTo": [
-    "fullstack-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "agent-service-ts",
     "api-service",
+    "bun-http",
+    "cli-ts",
     "cloudflare-worker-ts",
-    "python-api",
-    "rust-service",
+    "deno-edge",
+    "dspy-pipeline-py",
+    "evm-infra-ts",
+    "fullstack-ts",
     "go-api",
-    "worker-job",
-    "cli-ts",
     "go-worker",
-    "playwright-worker",
     "mcp-server-ts",
-    "dspy-pipeline-py",
-    "agent-service-ts",
-    "agent-service-py",
-    "agent-service-rust",
+    "playwright-worker",
+    "python-api",
+    "python-worker",
+    "rust-service",
+    "worker-job",
     "x402-service",
-    "zk-prover-service",
-    "evm-infra-ts",
-    "python-worker"
+    "zk-prover-service"
   ]
 }