create-mikrojs 0.0.7

package/dist/templates/_common/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/templates/_common/dependencies.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;CACoB,CAAA;AAEvC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,aAAa;CACe,CAAA"}

package/dist/templates/_common/env-example.d.ts

@@ -0,0 +1,2 @@
+export declare const envExample = "# Copy this file to .env and add environment variables for your project.\n# .env, .env.development, .env.production, .env.test, and .env.simulator\n# are auto-loaded by `mikro` and pushed to the device on deploy.\n# Names must be 15 characters or fewer (NVS key limit).\n\n# WIFI_SSID=\n# WIFI_PASSPHRASE=\n";
+//# sourceMappingURL=env-example.d.ts.map

package/dist/templates/_common/env-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-example.d.ts","sourceRoot":"","sources":["../../../src/templates/_common/env-example.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,wTAQtB,CAAA"}

package/dist/templates/_common/env-example.js

@@ -0,0 +1,10 @@
+export const envExample = `\
+# Copy this file to .env and add environment variables for your project.
+# .env, .env.development, .env.production, .env.test, and .env.simulator
+# are auto-loaded by \`mikro\` and pushed to the device on deploy.
+# Names must be 15 characters or fewer (NVS key limit).
+
+# WIFI_SSID=
+# WIFI_PASSPHRASE=
+`;
+//# sourceMappingURL=env-example.js.map

package/dist/templates/_common/env-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-example.js","sourceRoot":"","sources":["../../../src/templates/_common/env-example.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;CAQzB,CAAA"}

package/dist/templates/_common/gitignore.d.ts

@@ -0,0 +1,2 @@
+export declare const gitignore = ".env\n.env.*\n!.env.example\nnode_modules\n.mikro\n";
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/templates/_common/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../../src/templates/_common/gitignore.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,wDAMrB,CAAA"}

package/dist/templates/_common/gitignore.js

@@ -0,0 +1,8 @@
+export const gitignore = `\
+.env
+.env.*
+!.env.example
+node_modules
+.mikro
+`;
+//# sourceMappingURL=gitignore.js.map

package/dist/templates/_common/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../../src/templates/_common/gitignore.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;CAMxB,CAAA"}

package/dist/templates/_common/package-json.d.ts

@@ -0,0 +1,22 @@
+import type { PackageJson } from 'type-fest';
+export declare function packageJson(name: string, { devDependencies, dependencies, typescript, }?: {
+    dependencies?: PackageJson['devDependencies'];
+    devDependencies?: PackageJson['dependencies'];
+    /** Include the tsc predeploy hook. */
+    typescript?: boolean;
+}): {
+    mikrojs?: {
+        predeploy: string[];
+    } | undefined;
+    name: string;
+    version: string;
+    private: true;
+    type: "module";
+    main: string;
+    scripts: {
+        dev: string;
+    };
+    dependencies: {};
+    devDependencies: {};
+};
+//# sourceMappingURL=package-json.d.ts.map

package/dist/templates/_common/package-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../../src/templates/_common/package-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAE1C,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,EACE,eAAe,EACf,YAAY,EACZ,UAAU,GACX,GAAE;IACD,YAAY,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;IAC7C,eAAe,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAC7C,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChB;;;;;;;;;;;;kBAW0B,EAAE;qBACI,EAAE;EASzC"}

package/dist/templates/_common/package-json.js

@@ -0,0 +1,22 @@
+export function packageJson(name, { devDependencies, dependencies, typescript, } = {}) {
+    return {
+        name,
+        version: '0.0.0',
+        private: true,
+        type: 'module',
+        main: './app/main.ts',
+        scripts: {
+            dev: 'mikro dev',
+        },
+        dependencies: dependencies,
+        devDependencies: devDependencies,
+        ...(typescript
+            ? {
+                mikrojs: {
+                    predeploy: ['tsc --noEmit --pretty'],
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=package-json.js.map

package/dist/templates/_common/package-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../../src/templates/_common/package-json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,EACE,eAAe,EACf,YAAY,EACZ,UAAU,MAMR,EAAE;IAEN,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;YACP,GAAG,EAAE,WAAW;SACjB;QACD,YAAY,EAAE,YAAkB;QAChC,eAAe,EAAE,eAAqB;QACtC,GAAG,CAAC,UAAU;YACZ,CAAC,CAAC;gBACE,OAAO,EAAE;oBACP,SAAS,EAAE,CAAC,uBAAuB,CAAC;iBACrC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACc,CAAA;AACzB,CAAC"}

package/dist/templates/_common/readme.d.ts

@@ -0,0 +1,11 @@
+import type { PkgManager } from '../../pkg-manager.js';
+export interface ReadmeOptions {
+    projectName: string;
+    description: string;
+    pm: PkgManager;
+    hardware?: string;
+    wiring?: string;
+    setup?: string;
+}
+export declare function readme(options: ReadmeOptions): string;
+//# sourceMappingURL=readme.d.ts.map

package/dist/templates/_common/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../../src/templates/_common/readme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAA;AAOpD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,EAAE,EAAE,UAAU,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,UA+C5C"}

package/dist/templates/_common/readme.js

@@ -0,0 +1,45 @@
+function mikro(pm, cmd) {
+    if (pm === 'npm')
+        return `npx mikro ${cmd}`;
+    return `pnpm mikro ${cmd}`;
+}
+export function readme(options) {
+    const { projectName, description, pm, hardware, wiring, setup } = options;
+    const sections = [];
+    sections.push(`# ${projectName}\n\n${description}`);
+    if (hardware) {
+        sections.push(`## Hardware\n\n${hardware}`);
+    }
+    if (wiring) {
+        sections.push(`## Wiring\n\n${wiring}`);
+    }
+    if (setup) {
+        sections.push(`## Setup\n\n${setup}`);
+    }
+    sections.push(`## Getting started
+
+Install dependencies:
+
+\`\`\`sh
+${pm} install
+\`\`\`
+
+Flash firmware and start developing:
+
+\`\`\`sh
+${mikro(pm, 'dev')}
+\`\`\``);
+    sections.push(`## Commands
+
+- \`${mikro(pm, 'dev')}\` — develop on connected device
+- \`${mikro(pm, 'deploy')}\` — build and deploy to device
+- \`${mikro(pm, 'console')}\` — open REPL on device
+- \`${mikro(pm, 'env set KEY value')}\` — set environment variable on device`);
+    sections.push(`## Learn more
+
+- [Mikro.js documentation](https://mikrojs.dev)
+- [API reference](https://mikrojs.dev/api/)
+- [Examples](https://mikrojs.dev/examples/)`);
+    return sections.join('\n\n') + '\n';
+}
+//# sourceMappingURL=readme.js.map

package/dist/templates/_common/readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../../src/templates/_common/readme.ts"],"names":[],"mappings":"AAEA,SAAS,KAAK,CAAC,EAAc,EAAE,GAAW;IACxC,IAAI,EAAE,KAAK,KAAK;QAAE,OAAO,aAAa,GAAG,EAAE,CAAA;IAC3C,OAAO,cAAc,GAAG,EAAE,CAAA;AAC5B,CAAC;AAWD,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,MAAM,EAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAEvE,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,QAAQ,CAAC,IAAI,CAAC,KAAK,WAAW,OAAO,WAAW,EAAE,CAAC,CAAA;IAEnD,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC;;;;;EAKd,EAAE;;;;;;EAMF,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC;OACX,CAAC,CAAA;IAEN,QAAQ,CAAC,IAAI,CAAC;;MAEV,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC;MAChB,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC;MACnB,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC;MACpB,KAAK,CAAC,EAAE,EAAE,mBAAmB,CAAC,yCAAyC,CAAC,CAAA;IAE5E,QAAQ,CAAC,IAAI,CAAC;;;;4CAI4B,CAAC,CAAA;IAE3C,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;AACrC,CAAC"}

package/dist/templates/_common/tsconfig.d.ts

@@ -0,0 +1,3 @@
+import type { TsConfigJson } from 'type-fest';
+export declare const tsconfig: TsConfigJson;
+//# sourceMappingURL=tsconfig.d.ts.map

package/dist/templates/_common/tsconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.ts","sourceRoot":"","sources":["../../../src/templates/_common/tsconfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,QAAQ,EAAE,YAwBtB,CAAA"}

package/dist/templates/_common/tsconfig.js

@@ -0,0 +1,26 @@
+export const tsconfig = {
+    include: ['app/**/*'],
+    compilerOptions: {
+        module: 'nodenext',
+        target: 'es2024',
+        lib: ['es2024'],
+        noEmit: true,
+        types: ['mikrojs/runtime'],
+        sourceMap: true,
+        noUncheckedIndexedAccess: true,
+        allowUnreachableCode: false,
+        erasableSyntaxOnly: true,
+        strict: true,
+        verbatimModuleSyntax: true,
+        isolatedModules: true,
+        noUncheckedSideEffectImports: true,
+        moduleDetection: 'force',
+        jsx: 'preserve',
+        skipLibCheck: true,
+        noFallthroughCasesInSwitch: true,
+        noUnusedLocals: true,
+        forceConsistentCasingInFileNames: true,
+        resolveJsonModule: true,
+    },
+};
+//# sourceMappingURL=tsconfig.js.map

package/dist/templates/_common/tsconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.js","sourceRoot":"","sources":["../../../src/templates/_common/tsconfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,eAAe,EAAE;QACf,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,QAAQ,CAAC;QACf,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,CAAC,iBAAiB,CAAC;QAC1B,SAAS,EAAE,IAAI;QACf,wBAAwB,EAAE,IAAI;QAC9B,oBAAoB,EAAE,KAAK;QAC3B,kBAAkB,EAAE,IAAI;QACxB,MAAM,EAAE,IAAI;QACZ,oBAAoB,EAAE,IAAI;QAC1B,eAAe,EAAE,IAAI;QACrB,4BAA4B,EAAE,IAAI;QAClC,eAAe,EAAE,OAAO;QACxB,GAAG,EAAE,UAAU;QACf,YAAY,EAAE,IAAI;QAClB,0BAA0B,EAAE,IAAI;QAChC,cAAc,EAAE,IAAI;QACpB,gCAAgC,EAAE,IAAI;QACtC,iBAAiB,EAAE,IAAI;KACxB;CACF,CAAA"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "create-mikrojs",
+  "version": "0.0.7",
+  "description": "Create a new Mikro.js project",
+  "keywords": [
+    "esp32",
+    "javascript",
+    "microcontroller",
+    "mikrojs",
+    "quickjs",
+    "typescript"
+  ],
+  "homepage": "https://github.com/mikrojs/mikrojs#readme",
+  "bugs": {
+    "url": "https://github.com/mikrojs/mikrojs/issues"
+  },
+  "license": "MIT",
+  "author": "Bjørge Næss <bjoerge@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikrojs/mikrojs.git"
+  },
+  "bin": {
+    "create-mikrojs": "bin/create-mikrojs.js"
+  },
+  "files": [
+    "dist",
+    "src/templates",
+    "bin"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.2.0",
+    "@optique/core": "^1.0.2",
+    "@optique/run": "^1.0.2",
+    "type-fest": "^5.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build:ts": "tsc -p tsconfig.build.json",
+    "inspect": "tsx src/inspect.ts",
+    "publint": "publint",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/templates/_common/dependencies.ts

@@ -0,0 +1,9 @@
+import type {PackageJson} from 'type-fest'
+
+export const dependencies = {
+  mikrojs: 'latest',
+} satisfies PackageJson['dependencies']
+
+export const devDependencies = {
+  typescript: '^6.0.0-beta',
+} satisfies PackageJson['devDependencies']

package/src/templates/_common/env-example.ts

@@ -0,0 +1,9 @@
+export const envExample = `\
+# Copy this file to .env and add environment variables for your project.
+# .env, .env.development, .env.production, .env.test, and .env.simulator
+# are auto-loaded by \`mikro\` and pushed to the device on deploy.
+# Names must be 15 characters or fewer (NVS key limit).
+
+# WIFI_SSID=
+# WIFI_PASSPHRASE=
+`

package/src/templates/_common/gitignore.ts

@@ -0,0 +1,7 @@
+export const gitignore = `\
+.env
+.env.*
+!.env.example
+node_modules
+.mikro
+`

package/src/templates/_common/package-json.ts

@@ -0,0 +1,35 @@
+import type {PackageJson} from 'type-fest'
+
+export function packageJson(
+  name: string,
+  {
+    devDependencies,
+    dependencies,
+    typescript,
+  }: {
+    dependencies?: PackageJson['devDependencies']
+    devDependencies?: PackageJson['dependencies']
+    /** Include the tsc predeploy hook. */
+    typescript?: boolean
+  } = {},
+) {
+  return {
+    name,
+    version: '0.0.0',
+    private: true,
+    type: 'module',
+    main: './app/main.ts',
+    scripts: {
+      dev: 'mikro dev',
+    },
+    dependencies: dependencies as {},
+    devDependencies: devDependencies as {},
+    ...(typescript
+      ? {
+          mikrojs: {
+            predeploy: ['tsc --noEmit --pretty'],
+          },
+        }
+      : {}),
+  } satisfies PackageJson
+}

package/src/templates/_common/readme.ts

@@ -0,0 +1,64 @@
+import type {PkgManager} from '../../pkg-manager.js'
+
+function mikro(pm: PkgManager, cmd: string) {
+  if (pm === 'npm') return `npx mikro ${cmd}`
+  return `pnpm mikro ${cmd}`
+}
+
+export interface ReadmeOptions {
+  projectName: string
+  description: string
+  pm: PkgManager
+  hardware?: string
+  wiring?: string
+  setup?: string
+}
+
+export function readme(options: ReadmeOptions) {
+  const {projectName, description, pm, hardware, wiring, setup} = options
+
+  const sections: string[] = []
+
+  sections.push(`# ${projectName}\n\n${description}`)
+
+  if (hardware) {
+    sections.push(`## Hardware\n\n${hardware}`)
+  }
+
+  if (wiring) {
+    sections.push(`## Wiring\n\n${wiring}`)
+  }
+
+  if (setup) {
+    sections.push(`## Setup\n\n${setup}`)
+  }
+
+  sections.push(`## Getting started
+
+Install dependencies:
+
+\`\`\`sh
+${pm} install
+\`\`\`
+
+Flash firmware and start developing:
+
+\`\`\`sh
+${mikro(pm, 'dev')}
+\`\`\``)
+
+  sections.push(`## Commands
+
+- \`${mikro(pm, 'dev')}\` — develop on connected device
+- \`${mikro(pm, 'deploy')}\` — build and deploy to device
+- \`${mikro(pm, 'console')}\` — open REPL on device
+- \`${mikro(pm, 'env set KEY value')}\` — set environment variable on device`)
+
+  sections.push(`## Learn more
+
+- [Mikro.js documentation](https://mikrojs.dev)
+- [API reference](https://mikrojs.dev/api/)
+- [Examples](https://mikrojs.dev/examples/)`)
+
+  return sections.join('\n\n') + '\n'
+}

package/src/templates/_common/tsconfig.ts

@@ -0,0 +1,27 @@
+import type {TsConfigJson} from 'type-fest'
+
+export const tsconfig: TsConfigJson = {
+  include: ['app/**/*'],
+  compilerOptions: {
+    module: 'nodenext',
+    target: 'es2024',
+    lib: ['es2024'],
+    noEmit: true,
+    types: ['mikrojs/runtime'],
+    sourceMap: true,
+    noUncheckedIndexedAccess: true,
+    allowUnreachableCode: false,
+    erasableSyntaxOnly: true,
+    strict: true,
+    verbatimModuleSyntax: true,
+    isolatedModules: true,
+    noUncheckedSideEffectImports: true,
+    moduleDetection: 'force',
+    jsx: 'preserve',
+    skipLibCheck: true,
+    noFallthroughCasesInSwitch: true,
+    noUnusedLocals: true,
+    forceConsistentCasingInFileNames: true,
+    resolveJsonModule: true,
+  },
+}

package/src/templates/blank/app/main.ts

@@ -0,0 +1,3 @@
+import {board, version} from 'mikrojs/sys'
+
+console.log(`Hello World from MikroJS v${version} (${board.name}@${board.chip}@${board.revision})`)

package/src/templates/blinky/app/main.ts

@@ -0,0 +1,18 @@
+import {digitalWrite, pinMode} from 'mikrojs/pin'
+import {sleep} from 'mikrojs/sleep'
+
+let value: 0 | 1 = 0
+// GPIO 15 is the built-in LED on XIAO ESP32C6. Replace with your board's LED pin.
+const PIN = 15
+
+pinMode(PIN, 'OUTPUT').orPanic('Failed to configure LED pin')
+
+while (true) {
+  value = value === 0 ? 1 : 0
+  const writeResult = digitalWrite(PIN, value)
+  if (!writeResult.ok) {
+    console.error('Write pin failed: %s', writeResult.error.name)
+  }
+
+  await sleep(1000)
+}

package/src/templates/neopixel/app/color.ts

@@ -0,0 +1,23 @@
+/** Convert HSV (h: 0–360, s: 0–1, v: 0–1) to RGB tuple */
+export function hsv(h: number, s: number, v: number): [r: number, g: number, b: number] {
+  h = h % 360
+  const max = v * 255
+  const min = max * (1 - s)
+  const sector = Math.floor(h / 60)
+  const adj = ((max - min) * (h % 60)) / 60
+
+  switch (sector) {
+    case 0:
+      return [max, min + adj, min]
+    case 1:
+      return [max - adj, max, min]
+    case 2:
+      return [min, max, min + adj]
+    case 3:
+      return [min, max - adj, max]
+    case 4:
+      return [min + adj, min, max]
+    default:
+      return [max, min, max - adj]
+  }
+}

package/src/templates/neopixel/app/main.ts

@@ -0,0 +1,24 @@
+import {NeoPixel} from 'mikrojs/neopixel'
+
+import {breathe} from './patterns/breathe.js'
+import {colorWipe} from './patterns/color-wipe.js'
+import {comet} from './patterns/comet.js'
+import {rainbow} from './patterns/rainbow.js'
+import {sparkle} from './patterns/sparkle.js'
+
+const PIN = 8
+const NUM_LEDS = 24
+const BRIGHTNESS = 1
+const PATTERN_DURATION = 8000
+
+const pixels = new NeoPixel(PIN, {count: NUM_LEDS})
+
+const patterns = [rainbow, comet, breathe, sparkle, colorWipe]
+
+while (true) {
+  for (const pattern of patterns) {
+    ;(await pattern(pixels, NUM_LEDS, BRIGHTNESS, PATTERN_DURATION)).orPanic(
+      `NeoPixel pattern ${pattern.name} failed`,
+    )
+  }
+}

package/src/templates/neopixel/app/patterns/breathe.ts

@@ -0,0 +1,22 @@
+import type {NeoPixel} from 'mikrojs/neopixel'
+import {ok} from 'mikrojs/result'
+import {sleep} from 'mikrojs/sleep'
+
+import {hsv} from '../color.js'
+
+/** Breathe: all LEDs pulse a single color in and out */
+export async function breathe(pixels: NeoPixel, numLeds: number, brightness: number, ms: number) {
+  const end = Date.now() + ms
+  let t = 0
+  while (Date.now() < end) {
+    const v = ((Math.sin(t) + 1) / 2) * brightness
+    const [r, g, b] = hsv(30, 1, v)
+    const fillResult = pixels.fill(r, g, b)
+    if (!fillResult.ok) return fillResult
+    const showResult = pixels.show()
+    if (!showResult.ok) return showResult
+    t += 0.06
+    await sleep(20)
+  }
+  return ok(undefined)
+}

package/src/templates/neopixel/app/patterns/color-wipe.ts

@@ -0,0 +1,35 @@
+import type {NeoPixel} from 'mikrojs/neopixel'
+import {ok} from 'mikrojs/result'
+import {sleep} from 'mikrojs/sleep'
+
+import {hsv} from '../color.js'
+
+/** Color wipe: fill pixels one by one, then clear one by one */
+export async function colorWipe(pixels: NeoPixel, numLeds: number, brightness: number, ms: number) {
+  const colors: Array<[number, number, number]> = [
+    hsv(0, 1, brightness),
+    hsv(120, 1, brightness),
+    hsv(240, 1, brightness),
+  ]
+  const end = Date.now() + ms
+  let ci = 0
+  while (Date.now() < end) {
+    const [r, g, b] = colors[ci % colors.length]!
+    for (let i = 0; i < numLeds; i++) {
+      const pixelResult = pixels.setPixel(i, r, g, b)
+      if (!pixelResult.ok) return pixelResult
+      const showResult = pixels.show()
+      if (!showResult.ok) return showResult
+      await sleep(25)
+    }
+    for (let i = 0; i < numLeds; i++) {
+      const pixelResult = pixels.setPixel(i, 0, 0, 0)
+      if (!pixelResult.ok) return pixelResult
+      const showResult = pixels.show()
+      if (!showResult.ok) return showResult
+      await sleep(25)
+    }
+    ci++
+  }
+  return ok(undefined)
+}

package/src/templates/neopixel/app/patterns/comet.ts

@@ -0,0 +1,29 @@
+import type {NeoPixel} from 'mikrojs/neopixel'
+import {ok} from 'mikrojs/result'
+import {sleep} from 'mikrojs/sleep'
+
+import {hsv} from '../color.js'
+
+/** Comet: a bright head with a fading tail orbits the ring */
+export async function comet(pixels: NeoPixel, numLeds: number, brightness: number, ms: number) {
+  const TAIL_LEN = 8
+  const end = Date.now() + ms
+  let pos = 0
+  while (Date.now() < end) {
+    const fillResult = pixels.fill(0, 0, 0)
+    if (!fillResult.ok) return fillResult
+    for (let i = 0; i < TAIL_LEN; i++) {
+      const idx = (pos - i + numLeds) % numLeds
+      const fade = 1 - i / TAIL_LEN
+      const v = fade * fade * brightness
+      const [r, g, b] = hsv(200, 1, v)
+      const pixelResult = pixels.setPixel(idx, r, g, b)
+      if (!pixelResult.ok) return pixelResult
+    }
+    const showResult = pixels.show()
+    if (!showResult.ok) return showResult
+    pos = (pos + 1) % numLeds
+    await sleep(40)
+  }
+  return ok(undefined)
+}

package/src/templates/neopixel/app/patterns/rainbow.ts

@@ -0,0 +1,24 @@
+import type {NeoPixel} from 'mikrojs/neopixel'
+import {ok} from 'mikrojs/result'
+import {sleep} from 'mikrojs/sleep'
+
+import {hsv} from '../color.js'
+
+/** Rainbow: rotate a full spectrum around the ring */
+export async function rainbow(pixels: NeoPixel, numLeds: number, brightness: number, ms: number) {
+  const end = Date.now() + ms
+  let offset = 0
+  while (Date.now() < end) {
+    for (let i = 0; i < numLeds; i++) {
+      const hue = ((i * 360) / numLeds + offset) % 360
+      const [r, g, b] = hsv(hue, 1, brightness)
+      const pixelResult = pixels.setPixel(i, r, g, b)
+      if (!pixelResult.ok) return pixelResult
+    }
+    const showResult = pixels.show()
+    if (!showResult.ok) return showResult
+    offset = (offset + 5) % 360
+    await sleep(30)
+  }
+  return ok()
+}

package/src/templates/neopixel/app/patterns/sparkle.ts

@@ -0,0 +1,25 @@
+import type {NeoPixel} from 'mikrojs/neopixel'
+import {ok} from 'mikrojs/result'
+import {sleep} from 'mikrojs/sleep'
+
+import {hsv} from '../color.js'
+
+/** Sparkle: random pixels flash white on a dim background */
+export async function sparkle(pixels: NeoPixel, numLeds: number, brightness: number, ms: number) {
+  const end = Date.now() + ms
+  while (Date.now() < end) {
+    const [br, bg, bb] = hsv(270, 0.8, brightness * 0.15)
+    const fillResult = pixels.fill(br, bg, bb)
+    if (!fillResult.ok) return fillResult
+    for (let s = 0; s < 3; s++) {
+      const idx = Math.floor(Math.random() * numLeds)
+      const v = brightness * (0.5 + Math.random() * 0.5) * 255
+      const pixelResult = pixels.setPixel(idx, v, v, v)
+      if (!pixelResult.ok) return pixelResult
+    }
+    const showResult = pixels.show()
+    if (!showResult.ok) return showResult
+    await sleep(60)
+  }
+  return ok()
+}

package/src/templates/pwm-led/app/main.ts

@@ -0,0 +1,21 @@
+import {Pwm} from 'mikrojs/pwm'
+
+// GPIO 15 is the built-in LED on XIAO ESP32C6. Replace with your board's LED pin.
+const LED_PIN = 15
+
+const led = new Pwm(LED_PIN, {freq: 50, duty: 0})
+
+// Breathe: smoothly fade in and out forever
+while (true) {
+  const fadeIn = await led.fade(1.0, 1000)
+  if (!fadeIn.ok) {
+    console.error('Fade in failed: %s', fadeIn.error.name)
+    break
+  }
+
+  const fadeOut = await led.fade(0.0, 1000)
+  if (!fadeOut.ok) {
+    console.error('Fade out failed: %s', fadeOut.error.name)
+    break
+  }
+}