tegaki 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
+## tegaki@0.20.0
+
+### Add `TegakiEngine.toSVG()` and a `canvas` accessor
+
+The engine can now serialize its current text to a standalone SVG string via `toSVG({ animated, loop })` — either self-drawing (SMIL mask reveal, variable stroke width) or looping (CSS keyframes, constant width), with the viewBox cropped to the ink. The backing `<canvas>` is also exposed through a `canvas` getter so export tooling can read pixels without reaching through the DOM.
+
+### Add a `tegaki` CLI and a `textToSvg()` export
+
+`npx tegaki` renders text to an animated handwriting SVG straight from the command line. The same output is available programmatically through the new `textToSvg()` export, along with its `TextToSvgMode` and `TextToSvgOptions` types.
+
 # tegaki
 
+## 0.19.0
+
+### Minor Changes
+
+- 68ee58f: Support Korean (Hangul) writing system and add Nanum Pen Script as a built-in font. The bundle ships ~650 most-frequent precomposed Hangul syllables (KS X 1001 common band ∪ top-N Korean-Wikipedia-frequency, capped by the Google Fonts subsetting ceiling) plus the 40 modern compatibility jamo (19 consonants ㄱ–ㅎ + 21 vowels ㅏ–ㅣ) and the Latin baseline. Hangul is precomposed in Unicode, so no shaper is required.
+
+### Patch Changes
+
+- 29e111e: Fix Next.js App Router / Turbopack compatibility. Two build/packaging issues prevented `tegaki` from being used in a Next.js (App Router) app:
+
+  - The bundler dropped the `'use client'` directive from the React adapter's output chunk, so importing `TegakiRenderer` into a Server Component failed with "You're importing a module that depends on `useState` into a React Server Component". The directive is now preserved in the built output.
+  - The font subpath exports (`tegaki/fonts/*`) resolved the `node` condition to the raw TypeScript source, which uses `import ... with { type: 'url' }` import attributes that Turbopack/webpack can't process. The `node` condition now points to the pre-built `.mjs` bundle (which loads the font via `new URL('./font.ttf', import.meta.url)`), so it works in any Node-based bundler.
+
 ## 0.18.0
 
 ### Minor Changes

package/FONTS-LICENSE.md

@@ -51,6 +51,12 @@ All fonts are licensed under the [SIL Open Font License, Version 1.1](https://op
 - **Copyright**: Copyright (c) 2014, Indian Type Foundry (info@indiantypefoundry.com)
 - **License**: SIL Open Font License, Version 1.1
 
+## Nanum Pen Script
+
+- **Designer**: Sandoll Communications Inc. for NHN Corporation
+- **Copyright**: Copyright © 2010 NHN Corporation. All rights reserved. Font designed by Sandoll Communications Inc.
+- **License**: SIL Open Font License, Version 1.1
+
 ---
 
 ## SIL Open Font License, Version 1.1

package/README.md

@@ -6,12 +6,12 @@ Tegaki (手書き) turns any font into animated handwriting.
 No manual path authoring. No native dependencies. Just pick a font.
 
 [![npm](https://img.shields.io/npm/v/tegaki)](https://www.npmjs.com/package/tegaki)
-[![license](https://img.shields.io/npm/l/tegaki)](https://github.com/KurtGokhan/tegaki/blob/main/LICENSE)
+[![license](https://img.shields.io/npm/l/tegaki)](https://github.com/gkurt/tegaki/blob/main/LICENSE)
 
 <br clear="both" />
 
 <p align="center">
-  <img src="media/hello-world.svg" alt="Hello World handwriting animation" width="500" />
+  <img src="media/hello-world.svg" alt="Tegaki is awesome handwriting animation" width="560" />
 </p>
 
 ---
@@ -41,6 +41,23 @@ function App() {
 
 That's it. The text draws itself stroke by stroke with natural timing.
 
+## Command Line
+
+Don't want to wire up a component? Generate an animated handwriting SVG straight from your terminal — nothing to install:
+
+```bash
+npx tegaki "Tegaki is awesome"
+```
+
+This writes a self-drawing, looping `tegaki-is-awesome.svg` — drop it into a README, a slide, or any page. Pick a font, mode, size, or color:
+
+```bash
+npx tegaki "Hello World" --font tangerine --mode once -o hello.svg
+npx tegaki "ABC" --stagger 80% --size 140 --color "#222"
+```
+
+`--mode` is `loop` (repeats forever, the default), `once` (draws itself a single time), or `static` (finished artwork). Run `npx tegaki --help` for every option and `--list-fonts` for the bundled fonts. The CLI emits SVG only — for PNG, GIF, or WebM use the [interactive studio](https://gkurt.com/tegaki/studio/).
+
 ## Framework Support
 
 Tegaki works with all major frameworks:
@@ -75,8 +92,9 @@ Several handwriting fonts are bundled and ready to use:
 - **Amiri** — `tegaki/fonts/amiri` _(Arabic + Latin)_
 - **Tillana** — `tegaki/fonts/tillana` _(Devanagari + Latin)_
 - **Klee One** — `tegaki/fonts/klee-one` _(Japanese: kana + Kyōiku grade 1–2 kanji + Latin)_
+- **Nanum Pen Script** — `tegaki/fonts/nanum-pen-script` _(Korean: Hangul syllables + jamo + Latin)_
 
-For other fonts, use the [interactive generator](https://gkurt.com/tegaki/generator/) to create a custom bundle.
+For other fonts, use the [interactive studio](https://gkurt.com/tegaki/studio/) to create a custom bundle.
 
 ## Documentation
 
@@ -90,7 +108,7 @@ Visit **[gkurt.com/tegaki](https://gkurt.com/tegaki)** for full documentation:
 ## Integrations
 
 - [Sli.dev](https://sli.dev/) - Create presentations using markdown. [See Tegaki integration example](https://andreas-taranetz.github.io/slidev-addon-animated-text/)
-- [Remotion](https://www.remotion.dev/) - Create videos programmatically with React. [See Tegaki integration example](https://github.com/KurtGokhan/tegaki/blob/gokhan/support-font-features/examples/remotion/src/Root.tsx)
+- [Remotion](https://www.remotion.dev/) - Create videos programmatically with React. [See Tegaki integration example](https://github.com/gkurt/tegaki/blob/gokhan/support-font-features/examples/remotion/src/Root.tsx)
 
 ## License
 

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+import { t as textToSvg } from "./textToSvg-GTQMM8Le.mjs";
+import { readFile, writeFile } from "node:fs/promises";
+//#region src/cli.ts
+/**
+* `tegaki` — turn text into an animated handwriting SVG from the command line.
+*
+*   npx tegaki "Tegaki is awesome"          # → tegaki-is-awesome.svg (looping)
+*   npx tegaki "Hello" -f tangerine -o hi.svg
+*
+* SVG is the only format emitted: it's the one the renderer can produce with
+* zero native dependencies (no canvas, no headless browser). Raster/video
+* export (PNG/GIF/WebM) lives in the browser studio at gkurt.com/tegaki/studio.
+*/
+/** Bundled fonts the CLI can load, keyed by `--font` name. */
+const FONTS = {
+	caveat: "Caveat (Latin)",
+	italianno: "Italianno (Latin)",
+	tangerine: "Tangerine (Latin)",
+	parisienne: "Parisienne (Latin)",
+	"suez-one": "Suez One (Hebrew + Latin)",
+	amiri: "Amiri (Arabic + Latin)",
+	tillana: "Tillana (Devanagari + Latin)",
+	"klee-one": "Klee One (Japanese + Latin)",
+	"nanum-pen-script": "Nanum Pen Script (Korean + Latin)"
+};
+/** Fonts whose scripts need shaping the headless CLI does not apply (RTL / complex GPOS). */
+const NEEDS_SHAPING = /* @__PURE__ */ new Set([
+	"suez-one",
+	"amiri",
+	"tillana"
+]);
+const MODES = [
+	"loop",
+	"once",
+	"static"
+];
+const HELP = `tegaki — animated handwriting SVG generator
+
+Usage:
+  tegaki <text...> [options]
+
+Options:
+  -o, --output <file>       Output path (default: <slug>.svg; "-" writes to stdout)
+  -f, --font <name>         Bundled font (default: caveat). See --list-fonts.
+  -m, --mode <mode>         loop | once | static (default: loop)
+                              loop   self-drawing, repeats forever (README hero)
+                              once   draws itself once, then stays complete
+                              static finished artwork, no animation
+      --size <px>           Font size in px (default: 100)
+      --color <css>         Stroke color (default: #1a1a1a)
+      --line-height <px>    Line height in px (default: from font metrics)
+      --stagger <advance>   Overlap glyphs instead of drawing them in sequence.
+                              e.g. "80%" (of the previous glyph) or "0.3" (seconds)
+      --stagger-duration <s|auto>   Per-glyph duration when staggering (default: auto)
+      --pressure <0-1>      Variable stroke width for once/static (default: 1)
+      --smoothing           Smooth strokes onto a spline
+      --segment-size <px>   Stroke subdivision threshold (default: 2 when applicable)
+  -h, --help                Show this help
+  -v, --version             Show version
+      --list-fonts          List bundled fonts
+
+Examples:
+  tegaki "Tegaki is awesome"
+  tegaki "Hello World" --font tangerine --mode once -o hello.svg
+  tegaki "ABC" --stagger 80% --size 140 --color "#222"
+`;
+function fail(message) {
+	process.stderr.write(`tegaki: ${message}\n`);
+	process.exit(1);
+}
+/** Slugify text into a safe base filename. */
+function slug(text) {
+	return text.trim().slice(0, 40).replace(/\s+/g, "-").replace(/[^\w-]/g, "").toLowerCase() || "tegaki";
+}
+function parseArgs(argv) {
+	const words = [];
+	const opts = {
+		text: "",
+		output: null,
+		font: "caveat",
+		fontSize: 100,
+		color: "#1a1a1a",
+		mode: "loop",
+		smoothing: false
+	};
+	const expectValue = (flag, inline, i) => {
+		if (inline !== void 0) return inline;
+		const next = argv[++i.v];
+		if (next === void 0) fail(`option ${flag} requires a value`);
+		return next;
+	};
+	const idx = { v: 0 };
+	for (idx.v = 0; idx.v < argv.length; idx.v++) {
+		const arg = argv[idx.v];
+		if (!arg.startsWith("-") || arg === "-") {
+			words.push(arg);
+			continue;
+		}
+		const eq = arg.indexOf("=");
+		const flag = eq >= 0 ? arg.slice(0, eq) : arg;
+		const inline = eq >= 0 ? arg.slice(eq + 1) : void 0;
+		switch (flag) {
+			case "-h":
+			case "--help":
+				process.stdout.write(HELP);
+				process.exit(0);
+				break;
+			case "-v":
+			case "--version":
+				process.stdout.write(`${cachedVersion}\n`);
+				process.exit(0);
+				break;
+			case "--list-fonts":
+				listFonts();
+				process.exit(0);
+				break;
+			case "-o":
+			case "--output":
+				opts.output = expectValue(flag, inline, idx);
+				break;
+			case "-f":
+			case "--font":
+				opts.font = expectValue(flag, inline, idx).toLowerCase();
+				break;
+			case "-m":
+			case "--mode": {
+				const m = expectValue(flag, inline, idx);
+				if (!MODES.includes(m)) fail(`unknown mode "${m}" (expected: ${MODES.join(", ")})`);
+				opts.mode = m;
+				break;
+			}
+			case "--size":
+				opts.fontSize = numeric(flag, expectValue(flag, inline, idx));
+				break;
+			case "--line-height":
+				opts.lineHeight = numeric(flag, expectValue(flag, inline, idx));
+				break;
+			case "--color":
+				opts.color = expectValue(flag, inline, idx);
+				break;
+			case "--stagger":
+				opts.stagger = expectValue(flag, inline, idx);
+				break;
+			case "--stagger-duration": {
+				const v = expectValue(flag, inline, idx);
+				opts.staggerDuration = v === "auto" ? "auto" : numeric(flag, v);
+				break;
+			}
+			case "--pressure":
+				opts.pressure = numeric(flag, expectValue(flag, inline, idx));
+				break;
+			case "--smoothing":
+				opts.smoothing = true;
+				break;
+			case "--segment-size":
+				opts.segmentSize = numeric(flag, expectValue(flag, inline, idx));
+				break;
+			default: fail(`unknown option "${flag}" (try --help)`);
+		}
+	}
+	opts.text = words.join(" ");
+	return opts;
+}
+function numeric(flag, value) {
+	const n = Number(value);
+	if (!Number.isFinite(n)) fail(`option ${flag} expects a number, got "${value}"`);
+	return n;
+}
+function listFonts() {
+	process.stdout.write("Bundled fonts:\n");
+	for (const [name, label] of Object.entries(FONTS)) process.stdout.write(`  ${name.padEnd(18)} ${label}\n`);
+}
+let cachedVersion = "unknown";
+async function resolveVersion() {
+	try {
+		const url = new URL("../package.json", import.meta.url);
+		const pkg = JSON.parse(await readFile(url, "utf-8"));
+		if (pkg.version) cachedVersion = pkg.version;
+	} catch {}
+}
+/**
+* Load a built font bundle by name. Tries the shipped `dist/fonts/<name>` first
+* (the `npx` path), then the source `fonts/<name>` (running from a checkout).
+*/
+async function loadBundle(name) {
+	if (!(name in FONTS)) fail(`unknown font "${name}". Run \`tegaki --list-fonts\` to see the ${Object.keys(FONTS).length} bundled fonts.`);
+	const candidates = [new URL(`./fonts/${name}/bundle.mjs`, import.meta.url), new URL(`../fonts/${name}/bundle.ts`, import.meta.url)];
+	for (const url of candidates) try {
+		const mod = await import(url.href);
+		if (mod?.default) return mod.default;
+	} catch {}
+	fail(`could not load font bundle "${name}".`);
+}
+async function main() {
+	await resolveVersion();
+	const opts = parseArgs(process.argv.slice(2));
+	if (!opts.text) {
+		process.stdout.write(HELP);
+		process.exit(0);
+	}
+	if (NEEDS_SHAPING.has(opts.font)) process.stderr.write(`tegaki: note — "${opts.font}" is a complex/RTL script. The CLI lays glyphs out by advance width without shaping, so joins and direction may be wrong. Use the browser studio (gkurt.com/tegaki/studio) for shaped output.\n`);
+	const font = await loadBundle(opts.font);
+	const timing = opts.stagger !== void 0 ? { stagger: {
+		advance: /%$/.test(opts.stagger) ? opts.stagger : Number(opts.stagger),
+		duration: opts.staggerDuration ?? "auto"
+	} } : void 0;
+	const svg = textToSvg(opts.text, font, {
+		fontSize: opts.fontSize,
+		lineHeight: opts.lineHeight,
+		color: opts.color,
+		mode: opts.mode,
+		pressure: opts.pressure,
+		smoothing: opts.smoothing,
+		segmentSize: opts.segmentSize,
+		timing
+	});
+	if (opts.output === "-") {
+		process.stdout.write(svg);
+		return;
+	}
+	const outPath = opts.output ?? `${slug(opts.text)}.svg`;
+	await writeFile(outPath, svg, "utf-8");
+	const kb = (Buffer.byteLength(svg, "utf-8") / 1024).toFixed(1);
+	process.stderr.write(`tegaki: wrote ${outPath} (${opts.mode}, ${FONTS[opts.font]}, ${kb} KB)\n`);
+}
+main().catch((err) => {
+	fail(err instanceof Error ? err.message : String(err));
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `tegaki` — turn text into an animated handwriting SVG from the command line.\n *\n *   npx tegaki \"Tegaki is awesome\"          # → tegaki-is-awesome.svg (looping)\n *   npx tegaki \"Hello\" -f tangerine -o hi.svg\n *\n * SVG is the only format emitted: it's the one the renderer can produce with\n * zero native dependencies (no canvas, no headless browser). Raster/video\n * export (PNG/GIF/WebM) lives in the browser studio at gkurt.com/tegaki/studio.\n */\nimport { readFile, writeFile } from 'node:fs/promises';\nimport { type TextToSvgMode, textToSvg } from './lib/textToSvg.ts';\nimport type { TegakiBundle } from './types.ts';\n\n/** Bundled fonts the CLI can load, keyed by `--font` name. */\nconst FONTS: Record<string, string> = {\n  caveat: 'Caveat (Latin)',\n  italianno: 'Italianno (Latin)',\n  tangerine: 'Tangerine (Latin)',\n  parisienne: 'Parisienne (Latin)',\n  'suez-one': 'Suez One (Hebrew + Latin)',\n  amiri: 'Amiri (Arabic + Latin)',\n  tillana: 'Tillana (Devanagari + Latin)',\n  'klee-one': 'Klee One (Japanese + Latin)',\n  'nanum-pen-script': 'Nanum Pen Script (Korean + Latin)',\n};\n\n/** Fonts whose scripts need shaping the headless CLI does not apply (RTL / complex GPOS). */\nconst NEEDS_SHAPING = new Set(['suez-one', 'amiri', 'tillana']);\n\nconst MODES: TextToSvgMode[] = ['loop', 'once', 'static'];\n\ninterface CliOptions {\n  text: string;\n  output: string | null; // null → derive from text; '-' → stdout\n  font: string;\n  fontSize: number;\n  lineHeight?: number;\n  color: string;\n  mode: TextToSvgMode;\n  stagger?: string;\n  staggerDuration?: number | 'auto';\n  pressure?: number;\n  smoothing: boolean;\n  segmentSize?: number;\n}\n\nconst HELP = `tegaki — animated handwriting SVG generator\n\nUsage:\n  tegaki <text...> [options]\n\nOptions:\n  -o, --output <file>       Output path (default: <slug>.svg; \"-\" writes to stdout)\n  -f, --font <name>         Bundled font (default: caveat). See --list-fonts.\n  -m, --mode <mode>         loop | once | static (default: loop)\n                              loop   self-drawing, repeats forever (README hero)\n                              once   draws itself once, then stays complete\n                              static finished artwork, no animation\n      --size <px>           Font size in px (default: 100)\n      --color <css>         Stroke color (default: #1a1a1a)\n      --line-height <px>    Line height in px (default: from font metrics)\n      --stagger <advance>   Overlap glyphs instead of drawing them in sequence.\n                              e.g. \"80%\" (of the previous glyph) or \"0.3\" (seconds)\n      --stagger-duration <s|auto>   Per-glyph duration when staggering (default: auto)\n      --pressure <0-1>      Variable stroke width for once/static (default: 1)\n      --smoothing           Smooth strokes onto a spline\n      --segment-size <px>   Stroke subdivision threshold (default: 2 when applicable)\n  -h, --help                Show this help\n  -v, --version             Show version\n      --list-fonts          List bundled fonts\n\nExamples:\n  tegaki \"Tegaki is awesome\"\n  tegaki \"Hello World\" --font tangerine --mode once -o hello.svg\n  tegaki \"ABC\" --stagger 80% --size 140 --color \"#222\"\n`;\n\nfunction fail(message: string): never {\n  process.stderr.write(`tegaki: ${message}\\n`);\n  process.exit(1);\n}\n\n/** Slugify text into a safe base filename. */\nfunction slug(text: string): string {\n  const s = text\n    .trim()\n    .slice(0, 40)\n    .replace(/\\s+/g, '-')\n    .replace(/[^\\w-]/g, '')\n    .toLowerCase();\n  return s || 'tegaki';\n}\n\nfunction parseArgs(argv: string[]): CliOptions {\n  const words: string[] = [];\n  const opts: CliOptions = {\n    text: '',\n    output: null,\n    font: 'caveat',\n    fontSize: 100,\n    color: '#1a1a1a',\n    mode: 'loop',\n    smoothing: false,\n  };\n\n  // Pull the value for a flag, supporting both `--flag value` and `--flag=value`.\n  const expectValue = (flag: string, inline: string | undefined, i: { v: number }): string => {\n    if (inline !== undefined) return inline;\n    const next = argv[++i.v];\n    if (next === undefined) fail(`option ${flag} requires a value`);\n    return next;\n  };\n\n  const idx = { v: 0 };\n  for (idx.v = 0; idx.v < argv.length; idx.v++) {\n    const arg = argv[idx.v]!;\n    if (!arg.startsWith('-') || arg === '-') {\n      words.push(arg);\n      continue;\n    }\n    const eq = arg.indexOf('=');\n    const flag = eq >= 0 ? arg.slice(0, eq) : arg;\n    const inline = eq >= 0 ? arg.slice(eq + 1) : undefined;\n\n    switch (flag) {\n      case '-h':\n      case '--help':\n        process.stdout.write(HELP);\n        process.exit(0);\n        break;\n      case '-v':\n      case '--version':\n        process.stdout.write(`${cachedVersion}\\n`);\n        process.exit(0);\n        break;\n      case '--list-fonts':\n        listFonts();\n        process.exit(0);\n        break;\n      case '-o':\n      case '--output':\n        opts.output = expectValue(flag, inline, idx);\n        break;\n      case '-f':\n      case '--font':\n        opts.font = expectValue(flag, inline, idx).toLowerCase();\n        break;\n      case '-m':\n      case '--mode': {\n        const m = expectValue(flag, inline, idx) as TextToSvgMode;\n        if (!MODES.includes(m)) fail(`unknown mode \"${m}\" (expected: ${MODES.join(', ')})`);\n        opts.mode = m;\n        break;\n      }\n      case '--size':\n        opts.fontSize = numeric(flag, expectValue(flag, inline, idx));\n        break;\n      case '--line-height':\n        opts.lineHeight = numeric(flag, expectValue(flag, inline, idx));\n        break;\n      case '--color':\n        opts.color = expectValue(flag, inline, idx);\n        break;\n      case '--stagger':\n        opts.stagger = expectValue(flag, inline, idx);\n        break;\n      case '--stagger-duration': {\n        const v = expectValue(flag, inline, idx);\n        opts.staggerDuration = v === 'auto' ? 'auto' : numeric(flag, v);\n        break;\n      }\n      case '--pressure':\n        opts.pressure = numeric(flag, expectValue(flag, inline, idx));\n        break;\n      case '--smoothing':\n        opts.smoothing = true;\n        break;\n      case '--segment-size':\n        opts.segmentSize = numeric(flag, expectValue(flag, inline, idx));\n        break;\n      default:\n        fail(`unknown option \"${flag}\" (try --help)`);\n    }\n  }\n\n  opts.text = words.join(' ');\n  return opts;\n}\n\nfunction numeric(flag: string, value: string): number {\n  const n = Number(value);\n  if (!Number.isFinite(n)) fail(`option ${flag} expects a number, got \"${value}\"`);\n  return n;\n}\n\nfunction listFonts(): void {\n  process.stdout.write('Bundled fonts:\\n');\n  for (const [name, label] of Object.entries(FONTS)) {\n    process.stdout.write(`  ${name.padEnd(18)} ${label}\\n`);\n  }\n}\n\n// Resolved once at startup (before args are parsed) so `--version` can print synchronously.\nlet cachedVersion = 'unknown';\nasync function resolveVersion(): Promise<void> {\n  try {\n    const url = new URL('../package.json', import.meta.url);\n    const pkg = JSON.parse(await readFile(url, 'utf-8')) as { version?: string };\n    if (pkg.version) cachedVersion = pkg.version;\n  } catch {\n    // leave default\n  }\n}\n\n/**\n * Load a built font bundle by name. Tries the shipped `dist/fonts/<name>` first\n * (the `npx` path), then the source `fonts/<name>` (running from a checkout).\n */\nasync function loadBundle(name: string): Promise<TegakiBundle> {\n  if (!(name in FONTS)) {\n    fail(`unknown font \"${name}\". Run \\`tegaki --list-fonts\\` to see the ${Object.keys(FONTS).length} bundled fonts.`);\n  }\n  const candidates = [\n    new URL(`./fonts/${name}/bundle.mjs`, import.meta.url), // built: dist/cli.mjs → dist/fonts/<name>/bundle.mjs\n    new URL(`../fonts/${name}/bundle.ts`, import.meta.url), // dev: src/cli.ts → fonts/<name>/bundle.ts\n  ];\n  for (const url of candidates) {\n    try {\n      const mod = (await import(url.href)) as { default?: TegakiBundle };\n      if (mod?.default) return mod.default;\n    } catch {\n      // try next candidate\n    }\n  }\n  fail(`could not load font bundle \"${name}\".`);\n}\n\nasync function main(): Promise<void> {\n  await resolveVersion();\n  const opts = parseArgs(process.argv.slice(2));\n\n  if (!opts.text) {\n    process.stdout.write(HELP);\n    process.exit(0);\n  }\n\n  if (NEEDS_SHAPING.has(opts.font)) {\n    process.stderr.write(\n      `tegaki: note — \"${opts.font}\" is a complex/RTL script. The CLI lays glyphs out by ` +\n        `advance width without shaping, so joins and direction may be wrong. ` +\n        `Use the browser studio (gkurt.com/tegaki/studio) for shaped output.\\n`,\n    );\n  }\n\n  const font = await loadBundle(opts.font);\n\n  const timing =\n    opts.stagger !== undefined\n      ? {\n          stagger: {\n            advance: /%$/.test(opts.stagger) ? (opts.stagger as `${number}%`) : Number(opts.stagger),\n            duration: opts.staggerDuration ?? ('auto' as const),\n          },\n        }\n      : undefined;\n\n  const svg = textToSvg(opts.text, font, {\n    fontSize: opts.fontSize,\n    lineHeight: opts.lineHeight,\n    color: opts.color,\n    mode: opts.mode,\n    pressure: opts.pressure,\n    smoothing: opts.smoothing,\n    segmentSize: opts.segmentSize,\n    timing,\n  });\n\n  if (opts.output === '-') {\n    process.stdout.write(svg);\n    return;\n  }\n\n  const outPath = opts.output ?? `${slug(opts.text)}.svg`;\n  await writeFile(outPath, svg, 'utf-8');\n  const kb = (Buffer.byteLength(svg, 'utf-8') / 1024).toFixed(1);\n  process.stderr.write(`tegaki: wrote ${outPath} (${opts.mode}, ${FONTS[opts.font]}, ${kb} KB)\\n`);\n}\n\nmain().catch((err: unknown) => {\n  fail(err instanceof Error ? err.message : String(err));\n});\n"],"mappings":"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"}

package/dist/core/index.d.mts

@@ -1,3 +1,3 @@
-import { S as TimedPoint, _ as TegakiEffectName, a as BBox, b as TegakiMultiEffectName, c as CSSLength, d as LineCap, f as PathCommand, g as TegakiEffectConfigs, h as TegakiBundle, i as ShapedGlyph, l as FontOutput, m as Stroke, o as BUNDLE_VERSION, p as Point, r as BundleShaper, s as COMPATIBLE_BUNDLE_VERSIONS, t as ShaperFactory, u as GlyphData, v as TegakiEffects, x as TegakiSingletonEffectName, y as TegakiGlyphData } from "../shaper-registry-CrfNiB1j.mjs";
-import { A as TimelineEntry, C as resolveEffects, D as computeTextLayout, E as computeLayoutBbox, M as computeTimeline, O as Timeline, S as hasRenderHooks, T as TextLayout, _ as RenderStageContext, a as CreateElementFn, b as findEffects, c as TimeControlMode, d as getBundle, f as registerBundle, g as EffectDefinition, h as drawGlyph, i as TegakiEngine, j as TimelineStaggerConfig, k as TimelineConfig, l as TimeControlProp, m as ensureFontFace, n as buildRootProps, o as TegakiEngineOptions, p as resolveBundle, r as domCreateElement, s as TegakiQuality, t as buildChildren, u as createBundle, v as ResolvedEffect, w as LayoutBBox, x as getEffectDefinition, y as findEffect } from "../index-BVYJFRMq.mjs";
-export { BBox, BUNDLE_VERSION, BundleShaper, COMPATIBLE_BUNDLE_VERSIONS, CSSLength, CreateElementFn, EffectDefinition, FontOutput, GlyphData, LayoutBBox, LineCap, PathCommand, Point, RenderStageContext, ResolvedEffect, ShapedGlyph, ShaperFactory, Stroke, TegakiBundle, TegakiEffectConfigs, TegakiEffectName, TegakiEffects, TegakiEngine, TegakiEngineOptions, TegakiGlyphData, TegakiMultiEffectName, TegakiQuality, TegakiSingletonEffectName, TextLayout, TimeControlMode, TimeControlProp, TimedPoint, Timeline, TimelineConfig, TimelineEntry, TimelineStaggerConfig, buildChildren, buildRootProps, computeLayoutBbox, computeTextLayout, computeTimeline, createBundle, domCreateElement, drawGlyph, ensureFontFace, findEffect, findEffects, getBundle, getEffectDefinition, hasRenderHooks, registerBundle, resolveBundle, resolveEffects };
+import { S as TimedPoint, _ as TegakiEffectName, a as BBox, b as TegakiMultiEffectName, c as CSSLength, d as LineCap, f as PathCommand, g as TegakiEffectConfigs, h as TegakiBundle, i as ShapedGlyph, l as FontOutput, m as Stroke, o as BUNDLE_VERSION, p as Point, r as BundleShaper, s as COMPATIBLE_BUNDLE_VERSIONS, t as ShaperFactory, u as GlyphData, v as TegakiEffects, x as TegakiSingletonEffectName, y as TegakiGlyphData } from "../shaper-registry-DmlJGnE3.mjs";
+import { A as computeTextLayout, C as findEffects, D as LayoutBBox, E as resolveEffects, F as computeTimeline, M as TimelineConfig, N as TimelineEntry, O as TextLayout, P as TimelineStaggerConfig, S as findEffect, T as hasRenderHooks, _ as ensureFontFace, a as CreateElementFn, b as RenderStageContext, c as TimeControlMode, d as getBundle, f as registerBundle, g as textToSvg, h as TextToSvgOptions, i as TegakiEngine, j as Timeline, k as computeLayoutBbox, l as TimeControlProp, m as TextToSvgMode, n as buildRootProps, o as TegakiEngineOptions, p as resolveBundle, r as domCreateElement, s as TegakiQuality, t as buildChildren, u as createBundle, v as drawGlyph, w as getEffectDefinition, x as ResolvedEffect, y as EffectDefinition } from "../index-D-lHv505.mjs";
+export { type BBox, BUNDLE_VERSION, type BundleShaper, COMPATIBLE_BUNDLE_VERSIONS, type CSSLength, type CreateElementFn, type EffectDefinition, type FontOutput, type GlyphData, type LayoutBBox, type LineCap, type PathCommand, type Point, type RenderStageContext, type ResolvedEffect, type ShapedGlyph, type ShaperFactory, type Stroke, type TegakiBundle, type TegakiEffectConfigs, type TegakiEffectName, type TegakiEffects, TegakiEngine, type TegakiEngineOptions, type TegakiGlyphData, type TegakiMultiEffectName, type TegakiQuality, type TegakiSingletonEffectName, type TextLayout, type TextToSvgMode, type TextToSvgOptions, type TimeControlMode, type TimeControlProp, type TimedPoint, type Timeline, type TimelineConfig, type TimelineEntry, type TimelineStaggerConfig, buildChildren, buildRootProps, computeLayoutBbox, computeTextLayout, computeTimeline, createBundle, domCreateElement, drawGlyph, ensureFontFace, findEffect, findEffects, getBundle, getEffectDefinition, hasRenderHooks, registerBundle, resolveBundle, resolveEffects, textToSvg };

package/dist/core/index.mjs

@@ -1,2 +1,3 @@
-import { _ as findEffect, a as createBundle, b as hasRenderHooks, c as resolveBundle, d as computeTimeline, f as computeLayoutBbox, h as drawGlyph, i as domCreateElement, l as BUNDLE_VERSION, m as ensureFontFace, n as buildChildren, o as getBundle, p as computeTextLayout, r as buildRootProps, s as registerBundle, t as TegakiEngine, u as COMPATIBLE_BUNDLE_VERSIONS, v as findEffects, x as resolveEffects, y as getEffectDefinition } from "../core-MwnsJAbN.mjs";
-export { BUNDLE_VERSION, COMPATIBLE_BUNDLE_VERSIONS, TegakiEngine, buildChildren, buildRootProps, computeLayoutBbox, computeTextLayout, computeTimeline, createBundle, domCreateElement, drawGlyph, ensureFontFace, findEffect, findEffects, getBundle, getEffectDefinition, hasRenderHooks, registerBundle, resolveBundle, resolveEffects };
+import { _ as getEffectDefinition, a as createBundle, c as resolveBundle, d as computeLayoutBbox, f as computeTextLayout, g as findEffects, h as findEffect, i as domCreateElement, l as BUNDLE_VERSION, m as drawGlyph, n as buildChildren, o as getBundle, p as ensureFontFace, r as buildRootProps, s as registerBundle, t as TegakiEngine, u as COMPATIBLE_BUNDLE_VERSIONS, v as hasRenderHooks, y as resolveEffects } from "../core-VIBhSqFM.mjs";
+import { n as computeTimeline, t as textToSvg } from "../textToSvg-GTQMM8Le.mjs";
+export { BUNDLE_VERSION, COMPATIBLE_BUNDLE_VERSIONS, TegakiEngine, buildChildren, buildRootProps, computeLayoutBbox, computeTextLayout, computeTimeline, createBundle, domCreateElement, drawGlyph, ensureFontFace, findEffect, findEffects, getBundle, getEffectDefinition, hasRenderHooks, registerBundle, resolveBundle, resolveEffects, textToSvg };