Promote dev to main

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: true
+contact_links:
+    - name: Contributing overview
+      url: https://code.textmode.art/docs/contributing/
+      about: Choose the correct repository and contribution path before opening an issue.
+    - name: Documentation
+      url: https://code.textmode.art/
+      about: Search the guides, API reference, and examples before reporting a documentation problem.
+    - name: textmode.js core repository
+      url: https://github.com/humanbydefinition/textmode.js/issues
+      about: Report core library and rendering problems in the core repository.
+    - name: Discord
+      url: https://discord.gg/sjrw8QXNks
+      about: Ask usage questions or discuss documentation ideas before filing an issue.

.github/assets/readme-og.options.json

@@ -0,0 +1,35 @@
+{
+	"schemaVersion": 1,
+	"generator": {
+		"package": "@textmode/og",
+		"version": "0.1.0"
+	},
+	"source": {
+		"name": "textmodeshift",
+		"repository": "https://github.com/humanbydefinition/editor.textmode.art",
+		"revision": "b037294d3e0abeff074d50b41235015b3f7d8e67",
+		"path": "sketches/textmodeshift/sketch.js",
+		"variantSeed": "readme:code.textmode.art:v1",
+		"randomSeedTemplate": "textmodeshift-v1:${variantSeed}:${seed}"
+	},
+	"output": {
+		"path": "readme-og.png",
+		"layout": {
+			"kind": "main"
+		},
+		"frame": 60,
+		"darken": 70
+	},
+	"branding": {
+		"logo": "default",
+		"labels": {
+			"brandName": "code.textmode.art",
+			"mainTopRight": "OFFICIAL DOCUMENTATION",
+			"mainHeadlinePrefix": "EXPLORE",
+			"mainHeadlineEmphasis": "TEXTMODE",
+			"mainHeadlineSecondLine": "ON THE WEB",
+			"mainBottomLeft": "GUIDES / API / EXAMPLES / INTEGRATIONS",
+			"mainBottomRight": "TEXTMODE.ART"
+		}
+	}
+}

.github/workflows/contributors.yml

@@ -43,10 +43,19 @@ jobs:
           exit 1
 
       - name: Checkout canonical source
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v6
         with:
           persist-credentials: false
 
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - name: Report toolchain
+        run: node --version && npm --version
+
       - name: Validate registry, tests, and generated README
         run: npm run check:contributors
 

.github/workflows/deploy.yml

@@ -19,27 +19,30 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
       - name: Setup Node
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        uses: actions/setup-node@v7
         with:
-          node-version: 20
+          node-version-file: .nvmrc
           cache: npm
 
+      - name: Report toolchain
+        run: node --version && npm --version
+
       - name: Setup Pages
-        uses: actions/configure-pages@1f0c5cde4bc74cd7e1254d0cb4de8d49e9068c7d # v4
+        uses: actions/configure-pages@v4
 
       - name: Install dependencies
-        run: npm install --frozen-lockfile
+        run: npm ci
 
       - name: Build VitePress site
         run: npm run build
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        uses: actions/upload-pages-artifact@v3
         with:
           path: .vitepress/dist
 
@@ -53,4 +56,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4
+        uses: actions/deploy-pages@v4

.github/workflows/reconcile-contributors.yml

@@ -66,7 +66,7 @@ jobs:
 
       - name: Create short-lived target token
         id: app-token
-        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3
+        uses: actions/create-github-app-token@v3
         with:
           client-id: ${{ inputs.app-client-id }}
           private-key: ${{ secrets.app-private-key }}
@@ -82,7 +82,7 @@ jobs:
         run: gh api "repos/humanbydefinition/$TARGET_REPOSITORY/branches/dev" --silent
 
       - name: Checkout target dev branch
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v6
         with:
           repository: humanbydefinition/${{ inputs.target-repository }}
           ref: dev
@@ -91,18 +91,27 @@ jobs:
           token: ${{ steps.app-token.outputs.token }}
 
       - name: Checkout canonical contributor source
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@v6
         with:
           repository: humanbydefinition/code.textmode.art
           ref: ${{ inputs.source-ref }}
           sparse-checkout: |
+            .nvmrc
             .vitepress/data/contribution-types.json
             .vitepress/data/contributors.json
             scripts/contributors.mjs
           sparse-checkout-cone-mode: false
           path: contributor-source
           persist-credentials: false
 
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version-file: contributor-source/.nvmrc
+
+      - name: Report toolchain
+        run: node --version && npm --version
+
       - name: Resolve canonical source
         id: source
         working-directory: contributor-source

.gitignore

@@ -5,4 +5,5 @@ node_modules
 .vitepress/dist/
 .vitepress/temp/
 .agents
-skills-lock.json
+skills-lock.json
+.vitepress/data/.generated-editor-sketches.json

.nvmrc

@@ -0,0 +1 @@
+24

.vitepress/configs/head.mts

@@ -54,7 +54,7 @@ export const transformHead = ({ pageData }: TransformContext): HeadConfig[] => {
   const defaultDescription = 'textmode.js is a lightweight creative coding library for creating real-time ASCII art on the web.'
   const ogTitle = pageData.title || 'textmode.js'
   const ogDescription = pageData.description || defaultDescription
-  const ogImage = 'https://code.textmode.art/png/textmodejs_banner.png'
+  const ogImage = 'https://code.textmode.art/png/readme-og.png'
 
   // Detect page types
   const isBlogPost = pageData.relativePath.startsWith('blog/') && pageData.relativePath !== 'blog/index.md';

.vitepress/configs/sidebar.mts

@@ -45,9 +45,10 @@ const docsSidebar: DefaultTheme.SidebarItem[] = [
             link: "/docs/randomness-math-vectors-and-noise",
           },
           { text: "Transforms", link: "/docs/transforms" },
-          { text: "Input events", link: "/docs/events" },
-          { text: "Fonts and tilesets", link: "/docs/fonts" },
-          { text: "Media sources", link: "/docs/loadables" },
+          { text: "Input events", link: "/docs/event-handling" },
+          { text: "Fonts and tilesets", link: "/docs/fonts-and-tilesets" },
+          { text: "FIGlet typography", link: "/docs/figlet-typography" },
+          { text: "Media sources", link: "/docs/media-sources" },
           { text: "Media conversion", link: "/docs/media-conversion" },
         ],
       },
@@ -86,8 +87,8 @@ const docsSidebar: DefaultTheme.SidebarItem[] = [
             items: [
               { text: "flok.cc", link: "/docs/live-coding-flok-cc" },
               {
-                text: "synth.textmode.art",
-                link: "/docs/live-coding-synth-textmode-art",
+                text: "editor.textmode.art",
+                link: "/docs/live-coding-editor-textmode-art",
               },
             ],
           },
@@ -97,15 +98,15 @@ const docsSidebar: DefaultTheme.SidebarItem[] = [
         text: "Contributing",
         items: [
           { text: "Overview", link: "/docs/contributing/" },
+          { text: "Contribute code", link: "/docs/contributing/code" },
           {
-            text: "Getting started",
-            link: "/docs/contributing/getting-started",
+            text: "Contribute docs",
+            link: "/docs/contributing/docs",
           },
           {
             text: "Submit a sketch",
             link: "/docs/contributing/submit-a-sketch",
           },
-          { text: "Improve docs", link: "/docs/contributing/improve-docs" },
           { text: "Contributors", link: "/docs/contributors" },
         ],
       },

.vitepress/data/apiExamples.data.ts

@@ -0,0 +1,51 @@
+import { scanApiExamples } from '../../scripts/lib/api-examples-scan.mjs'
+
+export type ApiProfile =
+  | 'textmode.js'
+  | 'textmode.synth.js'
+  | 'textmode.filters.js'
+  | 'textmode.figlet.js'
+  | 'textmode.export.js'
+
+export interface ApiExampleSketch {
+  id: string
+  slug: string
+  profile: ApiProfile
+  language: 'javascript' | 'typescript'
+  encodedCode: string
+  apiPath: string
+  pageUrl: string
+  heading?: string
+  ordinal: number
+  title: string
+  description?: string
+  kind?: string
+  owner?: string
+  ecosystem?: string
+  category?: string
+  lastModified?: string
+  tags: string[]
+}
+
+declare const data: ApiExampleSketch[]
+export { data }
+
+/**
+ * Build-time catalog of every runnable API example sketch embedded across the
+ * generated API reference (the api directory). Each entry is one live sandbox
+ * instance, ready to be passed straight to <TextmodeLiveSandbox />.
+ *
+ * The API markdown is the single source of truth; this loader only *reads* it,
+ * so regenerating API docs automatically updates the Examples page catalog.
+ */
+export default {
+  watch: ['api/**/*.md'],
+  load(): ApiExampleSketch[] {
+    try {
+      return scanApiExamples() as ApiExampleSketch[]
+    } catch (error) {
+      console.warn('[apiExamples] Failed to build the API example catalog:', error)
+      return []
+    }
+  },
+}