@svara/prompts 0.1.0

package/README.md

@@ -0,0 +1,304 @@
+# prompt
+
+A tiny, ergonomic tagged-template utility for assembling LLM prompts in TypeScript.
+
+It turns this:
+
+```ts
+const p = ai`
+  You are a helpful assistant.
+
+  Context:
+  > ${context}
+
+  Items:
+  - ${items}
+
+  Schema:
+  ${UserSchema}
+`
+```
+
+...into a clean, well-indented prompt string ready to send to a model.
+
+The library is intentionally small: a single tagged template (`prompt` / `ai`) plus a factory (`promptCreate`) for advanced configuration. All conditionals, loops, and composition stay in plain JavaScript inside `${...}` — no DSL, no helpers to learn.
+
+## Install
+
+Copy `prompt.ts` into your project. No runtime dependencies.
+
+## Quick start
+
+```ts
+import { prompt, ai } from './prompt'
+
+const p = ai`
+  Summarize the following text in one sentence.
+
+  Text:
+  > ${userInput}
+`
+```
+
+`prompt` and `ai` are the same function — `ai` is just an alias that reads nicely at call sites.
+
+## How it works
+
+The tag walks the template and, for each interpolated value, captures the **prefix of the line that value sits on**. Every line of the rendered value is then re-emitted with that prefix. This is what makes lists, block quotes, and multi-line interpolations look right:
+
+```ts
+ai`
+  Items:
+  - ${['apple', 'banana', 'cherry']}
+`
+// Items:
+// - apple
+// - banana
+// - cherry
+
+ai`
+  > ${"line one\nline two"}
+`
+// > line one
+// > line two
+```
+
+After assembly the output is cleaned up:
+
+- common leading indentation is stripped (auto-dedent)
+- whitespace-only lines are collapsed to empty
+- runs of 3+ blank lines are reduced to 2
+- the result is trimmed
+
+## Interpolated value types
+
+`flatten` decides how each `${value}` renders. Detection order:
+
+1. **`renderPrompt` symbol** — your own opt-in render protocol (see below).
+2. **`JsonValue`** — explicit "render me as a JSON code fence" wrapper.
+3. **Zod-like** — anything exposing `toJSONSchema()` (e.g. Zod schemas) renders as its JSON Schema in a fenced block.
+4. **Arrays** — each element is flattened and joined with newlines. `null`, `undefined`, and `false` are dropped; `0` and `''` are kept.
+5. **Other objects** — `JSON.stringify`d in a ```` ```json ```` fence.
+6. **Primitives** — `String(value).trim()`.
+7. **Nullish / `false`** — empty string.
+
+### `JsonValue<T>`
+
+Wrap a value to force JSON-fence rendering even when it would otherwise be treated as a primitive or skipped:
+
+```ts
+import { JsonValue, ai } from './prompt'
+
+ai`
+  Config:
+  ${new JsonValue({ retries: 3, timeoutMs: 5_000 })}
+`
+```
+
+### Zod (and other schema libs)
+
+Any object with a `toJSONSchema()` method is rendered as its schema. Zod v4 is the typical case:
+
+```ts
+import { z } from 'zod'
+
+const UserSchema = z.object({ id: z.string(), name: z.string() })
+
+ai`
+  Return data matching this schema:
+  ${UserSchema}
+`
+```
+
+### Custom render protocol
+
+For your own classes, opt in via the exported `renderPrompt` symbol:
+
+```ts
+import { renderPrompt, ai } from './prompt'
+
+class Document {
+  constructor(public title: string, public body: string) {}
+  [renderPrompt]() {
+    return ai`
+      # ${this.title}
+
+      ${this.body}
+    `
+  }
+}
+
+ai`
+  Read the document below and answer the question.
+
+  ${new Document('Onboarding', '...')}
+`
+```
+
+The value returned from `[renderPrompt]()` is itself a `PromptValue` and gets re-flattened — so you can return a string, an array, another `ai\`\`` result, or a `JsonValue`.
+
+## The factory: `promptCreate(options?)`
+
+`promptCreate` returns a configured `prompt` tag. With no arguments it behaves identically to bare `prompt`.
+
+```ts
+import { promptCreate } from './prompt'
+
+const ai = promptCreate({
+  dedent: true,
+  maxChars: 8_000,
+  truncate: 'end',
+})
+
+ai`...`
+```
+
+### Options
+
+All options are optional and flat.
+
+```ts
+type TruncateMode   = 'end' | 'start' | 'middle'
+type TruncateMarker = string | ((removedChars: number) => string)
+
+interface TruncateCtx {
+  maxChars: number
+  mode: TruncateMode
+  marker: TruncateMarker
+  truncate: (text: string, mode?: TruncateMode) => string
+}
+
+type OutputTruncateFn = (text: string, ctx: TruncateCtx) => string
+type ValueTruncateFn  = (rendered: string, original: PromptValue, ctx: TruncateCtx) => string
+
+type OutputTruncate =
+  | { maxChars: number; truncate?: TruncateMode; marker?: TruncateMarker }
+  | { truncate: OutputTruncateFn; maxChars?: number; marker?: TruncateMarker }
+
+type ValueTruncate =
+  | { valueMaxChars: number; valueTruncate?: TruncateMode; valueMarker?: TruncateMarker }
+  | { valueTruncate: ValueTruncateFn; valueMaxChars?: number; valueMarker?: TruncateMarker }
+
+type PromptOptions =
+  { dedent?: boolean }
+  & Partial<OutputTruncate>
+  & Partial<ValueTruncate>
+```
+
+| Option            | Default                     | Effect                                                                 |
+|-------------------|-----------------------------|------------------------------------------------------------------------|
+| `dedent`          | `true`                      | Strip common leading indentation from the static template parts.       |
+| `maxChars`        | —                           | Cap on the whole assembled output. Required when `truncate` is a mode. |
+| `truncate`        | `'end'` (when `maxChars` set) | Built-in mode or full custom function for the whole-output pass.     |
+| `marker`          | `…[truncated N chars]`      | Marker for the whole-output pass. String or `(removed) => string`.     |
+| `valueMaxChars`   | —                           | Per-value cap. Required when `valueTruncate` is a mode.                |
+| `valueTruncate`   | `'end'` (when `valueMaxChars` set) | Built-in mode or full custom function for the per-value pass.    |
+| `valueMarker`     | `…[truncated N chars]`      | Marker for the per-value pass.                                         |
+
+The discriminated unions enforce at compile time that:
+- a mode string requires its matching `maxChars` (or `valueMaxChars`),
+- a function in `truncate` / `valueTruncate` takes over and may read `maxChars` / `marker` from `ctx` or ignore them.
+
+### Truncation passes
+
+Both passes are independent and both can fire on the same render:
+
+1. **Per-value pass** runs inside `flatten`, on each interpolated value after it is rendered to a string.
+2. **Whole-output pass** runs once on the final assembled string after whitespace cleanup, as a safety net.
+
+#### Built-in modes
+
+- `'end'` — keep the head, drop the tail, append the marker.
+- `'start'` — drop the head, keep the tail, prepend the marker.
+- `'middle'` — keep head and tail, drop the middle, insert the marker between them.
+
+The default marker is `…[truncated N chars]`, where `N` is the number of characters removed.
+
+#### Custom truncation functions
+
+A function in `truncate` or `valueTruncate` fully owns the decision. It receives a `ctx` containing the resolved options plus `ctx.truncate(text, mode?)` — a delegate back into the library's built-in algorithm.
+
+```ts
+const ai = promptCreate({
+  maxChars: 8_000,
+  marker: (removed) => `\n…[dropped ${removed} chars]`,
+  truncate: (text, ctx) => {
+    if (text.length <= ctx.maxChars) return text
+    // Custom rule: try middle first, fall back to end.
+    const mid = ctx.truncate(text, 'middle')
+    return mid.length <= ctx.maxChars ? mid : ctx.truncate(text, 'end')
+  },
+})
+```
+
+The per-value variant additionally receives the original `PromptValue`, so it can branch on type — e.g. render a giant array differently from a long string:
+
+```ts
+const ai = promptCreate({
+  valueMaxChars: 1_000,
+  valueTruncate: (rendered, original, ctx) => {
+    if (Array.isArray(original) && original.length > 50) {
+      return ctx.truncate(rendered, 'end')
+    }
+    return ctx.truncate(rendered, 'middle')
+  },
+})
+```
+
+## Composition
+
+Because every `prompt\`...\`` call returns a plain string and accepts plain strings as values, prompts compose by ordinary interpolation:
+
+```ts
+const persona = ai`
+  You are a senior reviewer. Be concise.
+`
+
+const task = ai`
+  Review the diff and list risks.
+`
+
+const full = ai`
+  ${persona}
+
+  ${task}
+
+  Diff:
+  ${diff}
+`
+```
+
+Conditionals are plain JS — no `when` / `if` helpers:
+
+```ts
+ai`
+  ${user.isAdmin && ai`
+    Admin notes:
+    ${adminNotes}
+  `}
+`
+```
+
+A falsy interpolation renders as nothing and its surrounding blank lines are collapsed by the cleanup pass.
+
+## API surface
+
+```ts
+export class JsonValue<T = any>
+export const renderPrompt: unique symbol
+export type  PromptValue
+export type  PromptOptions
+export function prompt(strings: TemplateStringsArray, ...values: PromptValue[]): string
+export function promptCreate(options?: PromptOptions): typeof prompt
+export const ai: typeof prompt
+```
+
+## Non-goals
+
+Kept deliberately out of scope to stay simple:
+
+- token counting (needs a model-specific tokenizer; belongs in the API client layer)
+- async / `Promise` values (await before passing in)
+- message arrays, roles, tools, multi-modal content (caller's responsibility)
+- helper sugar like `section()`, `when()`, `list()` (use plain JS)
+- markdown / XML escaping (caller's responsibility)

package/dist/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+// src/prompt.ts
+var JsonValue = class {
+  constructor(value) {
+    this.value = value;
+  }
+  value;
+};
+var renderPrompt = /* @__PURE__ */ Symbol("prompt.render");
+var defaultMarker = (removed) => `\u2026[truncated ${removed} chars]`;
+function resolveMarker(m, removed) {
+  const mk = m ?? defaultMarker;
+  return typeof mk === "function" ? mk(removed) : mk;
+}
+function builtinTruncate(text, mode, maxChars, marker) {
+  if (text.length <= maxChars) return text;
+  const estRemoved = text.length - maxChars;
+  const markerStr = resolveMarker(marker, estRemoved);
+  const budget = Math.max(0, maxChars - markerStr.length);
+  if (budget <= 0) return markerStr.slice(0, maxChars);
+  switch (mode) {
+    case "end":
+      return text.slice(0, budget) + markerStr;
+    case "start":
+      return markerStr + text.slice(text.length - budget);
+    case "middle": {
+      const head = Math.ceil(budget / 2);
+      const tail = budget - head;
+      return text.slice(0, head) + markerStr + text.slice(text.length - tail);
+    }
+  }
+}
+function resolveOutput(opts) {
+  const t = opts.truncate;
+  const custom = typeof t === "function" ? t : void 0;
+  const mode = typeof t === "string" ? t : "end";
+  const maxChars = opts.maxChars ?? 0;
+  return {
+    enabled: custom !== void 0 || maxChars > 0,
+    maxChars,
+    mode,
+    marker: opts.marker ?? defaultMarker,
+    custom
+  };
+}
+function resolveValue(opts) {
+  const t = opts.valueTruncate;
+  const custom = typeof t === "function" ? t : void 0;
+  const mode = typeof t === "string" ? t : "end";
+  const maxChars = opts.valueMaxChars ?? 0;
+  return {
+    enabled: custom !== void 0 || maxChars > 0,
+    maxChars,
+    mode,
+    marker: opts.valueMarker ?? defaultMarker,
+    custom
+  };
+}
+function makeCtx(r) {
+  return {
+    maxChars: r.maxChars,
+    mode: r.mode,
+    marker: r.marker,
+    truncate: (text, mode) => builtinTruncate(text, mode ?? r.mode, r.maxChars, r.marker)
+  };
+}
+function renderRaw(value, valueCfg) {
+  if (Array.isArray(value)) {
+    return value.filter((v) => v !== null && v !== void 0 && v !== false).map((v) => flatten(v, valueCfg)).join("\n");
+  }
+  if (value === null || value === void 0 || value === false) return "";
+  if (typeof value === "object") {
+    const r = value[renderPrompt];
+    if (typeof r === "function") {
+      return flatten(r.call(value), valueCfg);
+    }
+    let jsonValue;
+    if (value instanceof JsonValue) {
+      jsonValue = value.value;
+    } else if (typeof value.toJSONSchema === "function") {
+      jsonValue = value.toJSONSchema({ io: "input" });
+    } else {
+      jsonValue = value;
+    }
+    return "```json\n" + JSON.stringify(jsonValue, null, 2) + "\n```";
+  }
+  return String(value).trim();
+}
+function flatten(value, valueCfg) {
+  const rendered = renderRaw(value, valueCfg);
+  if (!valueCfg.enabled) return rendered;
+  const ctx = makeCtx(valueCfg);
+  if (valueCfg.custom) return valueCfg.custom(rendered, value, ctx);
+  return builtinTruncate(rendered, valueCfg.mode, valueCfg.maxChars, valueCfg.marker);
+}
+function measureMinIndent(strings) {
+  const joined = strings.join("\0");
+  let min = Infinity;
+  for (const line of joined.split("\n")) {
+    if (!/\S/.test(line)) continue;
+    const m = /^[ \t]*/.exec(line);
+    const ind = m ? m[0].length : 0;
+    if (ind < min) min = ind;
+  }
+  return min === Infinity ? 0 : min;
+}
+function dedentStrings(strings) {
+  const n = measureMinIndent(strings);
+  if (n === 0) return strings.slice();
+  const re = new RegExp(`^[ \\t]{0,${n}}`);
+  return strings.map((s, i) => {
+    const lines = s.split("\n");
+    return lines.map((line, j) => {
+      const isLineStart = j > 0 || i === 0;
+      return isLineStart ? line.replace(re, "") : line;
+    }).join("\n");
+  });
+}
+function assemble(strings, values, valueCfg) {
+  const out = [];
+  for (let i = 0; i < strings.length; i++) {
+    const lines = strings[i].split("\n");
+    const lastPrefix = lines.pop() ?? "";
+    for (const l of lines) out.push(l, "\n");
+    out.push(lastPrefix);
+    if (i < values.length) {
+      const flat = flatten(values[i], valueCfg).split("\n");
+      out.push(flat[0]);
+      for (let k = 1; k < flat.length; k++) out.push("\n", lastPrefix, flat[k]);
+    }
+  }
+  return out.join("");
+}
+function compose(strings, values, opts) {
+  const dedent = opts.dedent !== false;
+  const valueCfg = resolveValue(opts);
+  const outputCfg = resolveOutput(opts);
+  const prepared = dedent ? dedentStrings(strings) : strings.slice();
+  let result = assemble(prepared, values, valueCfg);
+  result = result.replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+  if (outputCfg.enabled) {
+    const ctx = makeCtx(outputCfg);
+    result = outputCfg.custom ? outputCfg.custom(result, ctx) : builtinTruncate(result, outputCfg.mode, outputCfg.maxChars, outputCfg.marker);
+  }
+  return result;
+}
+function prompt(strings, ...values) {
+  return compose(strings, values, {});
+}
+function promptCreate(options = {}) {
+  return ((strings, ...values) => compose(strings, values, options));
+}
+var ai = prompt;
+
+exports.JsonValue = JsonValue;
+exports.ai = ai;
+exports.prompt = prompt;
+exports.promptCreate = promptCreate;
+exports.renderPrompt = renderPrompt;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prompt.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export class JsonValue<T = unknown> {\n\tconstructor(public readonly value: T) {}\n}\n\nexport const renderPrompt = Symbol('prompt.render')\n\ntype ZodLike = { toJSONSchema(input?: { io: 'input' | 'output' }): object }\ntype Renderable = { [renderPrompt](): PromptValue }\n\ntype Primitive =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| undefined\n\t| object\n\t| JsonValue\n\t| ZodLike\n\t| Renderable\n\nexport type PromptValue = Primitive | readonly PromptValue[]\n\nexport type TruncateMode = 'end' | 'start' | 'middle'\nexport type TruncateMarker = string | ((removedChars: number) => string)\n\nexport interface TruncateCtx {\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\ttruncate: (text: string, mode?: TruncateMode) => string\n}\n\nexport type OutputTruncateFn = (text: string, ctx: TruncateCtx) => string\nexport type ValueTruncateFn = (rendered: string, original: PromptValue, ctx: TruncateCtx) => string\n\ntype OutputTruncate =\n\t| { maxChars: number; truncate?: TruncateMode; marker?: TruncateMarker }\n\t| { truncate: OutputTruncateFn; maxChars?: number; marker?: TruncateMarker }\n\ntype ValueTruncate =\n\t| { valueMaxChars: number; valueTruncate?: TruncateMode; valueMarker?: TruncateMarker }\n\t| { valueTruncate: ValueTruncateFn; valueMaxChars?: number; valueMarker?: TruncateMarker }\n\nexport type PromptOptions =\n\t& { dedent?: boolean }\n\t& Partial<OutputTruncate>\n\t& Partial<ValueTruncate>\n\nconst defaultMarker: TruncateMarker = (removed) => `…[truncated ${removed} chars]`\n\nfunction resolveMarker(m: TruncateMarker | undefined, removed: number): string {\n\tconst mk = m ?? defaultMarker\n\treturn typeof mk === 'function' ? mk(removed) : mk\n}\n\nfunction builtinTruncate(\n\ttext: string,\n\tmode: TruncateMode,\n\tmaxChars: number,\n\tmarker: TruncateMarker,\n): string {\n\tif (text.length <= maxChars) return text\n\tconst estRemoved = text.length - maxChars\n\tconst markerStr = resolveMarker(marker, estRemoved)\n\tconst budget = Math.max(0, maxChars - markerStr.length)\n\tif (budget <= 0) return markerStr.slice(0, maxChars)\n\tswitch (mode) {\n\t\tcase 'end':\n\t\t\treturn text.slice(0, budget) + markerStr\n\t\tcase 'start':\n\t\t\treturn markerStr + text.slice(text.length - budget)\n\t\tcase 'middle': {\n\t\t\tconst head = Math.ceil(budget / 2)\n\t\t\tconst tail = budget - head\n\t\t\treturn text.slice(0, head) + markerStr + text.slice(text.length - tail)\n\t\t}\n\t}\n}\n\ninterface ResolvedOutput {\n\tenabled: boolean\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\tcustom?: OutputTruncateFn\n}\n\ninterface ResolvedValue {\n\tenabled: boolean\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\tcustom?: ValueTruncateFn\n}\n\nfunction resolveOutput(opts: PromptOptions): ResolvedOutput {\n\tconst t = opts.truncate\n\tconst custom = typeof t === 'function' ? (t as OutputTruncateFn) : undefined\n\tconst mode: TruncateMode = typeof t === 'string' ? t : 'end'\n\tconst maxChars = opts.maxChars ?? 0\n\treturn {\n\t\tenabled: custom !== undefined || maxChars > 0,\n\t\tmaxChars,\n\t\tmode,\n\t\tmarker: opts.marker ?? defaultMarker,\n\t\tcustom,\n\t}\n}\n\nfunction resolveValue(opts: PromptOptions): ResolvedValue {\n\tconst t = opts.valueTruncate\n\tconst custom = typeof t === 'function' ? (t as ValueTruncateFn) : undefined\n\tconst mode: TruncateMode = typeof t === 'string' ? t : 'end'\n\tconst maxChars = opts.valueMaxChars ?? 0\n\treturn {\n\t\tenabled: custom !== undefined || maxChars > 0,\n\t\tmaxChars,\n\t\tmode,\n\t\tmarker: opts.valueMarker ?? defaultMarker,\n\t\tcustom,\n\t}\n}\n\nfunction makeCtx(r: { maxChars: number; mode: TruncateMode; marker: TruncateMarker }): TruncateCtx {\n\treturn {\n\t\tmaxChars: r.maxChars,\n\t\tmode: r.mode,\n\t\tmarker: r.marker,\n\t\ttruncate: (text, mode) => builtinTruncate(text, mode ?? r.mode, r.maxChars, r.marker),\n\t}\n}\n\nfunction renderRaw(value: PromptValue, valueCfg: ResolvedValue): string {\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t\t\t.filter((v) => v !== null && v !== undefined && v !== false)\n\t\t\t.map((v) => flatten(v as PromptValue, valueCfg))\n\t\t\t.join('\\n')\n\t}\n\tif (value === null || value === undefined || value === false) return ''\n\tif (typeof value === 'object') {\n\t\tconst r = (value as Record<symbol, unknown>)[renderPrompt]\n\t\tif (typeof r === 'function') {\n\t\t\treturn flatten((r as () => PromptValue).call(value), valueCfg)\n\t\t}\n\t\tlet jsonValue: unknown\n\t\tif (value instanceof JsonValue) {\n\t\t\tjsonValue = value.value\n\t\t} else if (typeof (value as ZodLike).toJSONSchema === 'function') {\n\t\t\tjsonValue = (value as ZodLike).toJSONSchema({ io: 'input' })\n\t\t} else {\n\t\t\tjsonValue = value\n\t\t}\n\t\treturn '```json\\n' + JSON.stringify(jsonValue, null, 2) + '\\n```'\n\t}\n\treturn String(value).trim()\n}\n\nfunction flatten(value: PromptValue, valueCfg: ResolvedValue): string {\n\tconst rendered = renderRaw(value, valueCfg)\n\tif (!valueCfg.enabled) return rendered\n\tconst ctx = makeCtx(valueCfg)\n\tif (valueCfg.custom) return valueCfg.custom(rendered, value, ctx)\n\treturn builtinTruncate(rendered, valueCfg.mode, valueCfg.maxChars, valueCfg.marker)\n}\n\nfunction measureMinIndent(strings: readonly string[]): number {\n\t// Placeholder for interpolation slots so lines that contain only an indent\n\t// + a ${value} still count as content lines for indent measurement.\n\tconst joined = strings.join('\\x00')\n\tlet min = Infinity\n\tfor (const line of joined.split('\\n')) {\n\t\tif (!/\\S/.test(line)) continue\n\t\tconst m = /^[ \\t]*/.exec(line)\n\t\tconst ind = m ? m[0].length : 0\n\t\tif (ind < min) min = ind\n\t}\n\treturn min === Infinity ? 0 : min\n}\n\nfunction dedentStrings(strings: readonly string[]): string[] {\n\tconst n = measureMinIndent(strings)\n\tif (n === 0) return strings.slice()\n\tconst re = new RegExp(`^[ \\\\t]{0,${n}}`)\n\treturn strings.map((s, i) => {\n\t\tconst lines = s.split('\\n')\n\t\treturn lines\n\t\t\t.map((line, j) => {\n\t\t\t\tconst isLineStart = j > 0 || i === 0\n\t\t\t\treturn isLineStart ? line.replace(re, '') : line\n\t\t\t})\n\t\t\t.join('\\n')\n\t})\n}\n\nfunction assemble(\n\tstrings: readonly string[],\n\tvalues: readonly PromptValue[],\n\tvalueCfg: ResolvedValue,\n): string {\n\tconst out: string[] = []\n\tfor (let i = 0; i < strings.length; i++) {\n\t\tconst lines = strings[i]!.split('\\n')\n\t\tconst lastPrefix = lines.pop() ?? ''\n\t\tfor (const l of lines) out.push(l, '\\n')\n\t\tout.push(lastPrefix)\n\t\tif (i < values.length) {\n\t\t\tconst flat = flatten(values[i]!, valueCfg).split('\\n')\n\t\t\tout.push(flat[0]!)\n\t\t\tfor (let k = 1; k < flat.length; k++) out.push('\\n', lastPrefix, flat[k]!)\n\t\t}\n\t}\n\treturn out.join('')\n}\n\nfunction compose(\n\tstrings: readonly string[],\n\tvalues: readonly PromptValue[],\n\topts: PromptOptions,\n): string {\n\tconst dedent = opts.dedent !== false\n\tconst valueCfg = resolveValue(opts)\n\tconst outputCfg = resolveOutput(opts)\n\tconst prepared = dedent ? dedentStrings(strings) : strings.slice()\n\tlet result = assemble(prepared, values, valueCfg)\n\tresult = result.replace(/[ \\t]+\\n/g, '\\n').replace(/\\n{3,}/g, '\\n\\n').trim()\n\tif (outputCfg.enabled) {\n\t\tconst ctx = makeCtx(outputCfg)\n\t\tresult = outputCfg.custom\n\t\t\t? outputCfg.custom(result, ctx)\n\t\t\t: builtinTruncate(result, outputCfg.mode, outputCfg.maxChars, outputCfg.marker)\n\t}\n\treturn result\n}\n\n/**\n * Tagged template that assembles a clean LLM prompt string.\n *\n * Preserves the indentation/prefix of the line each `${value}` sits on so\n * lists, block quotes, and multi-line interpolations render correctly.\n */\nexport function prompt(strings: TemplateStringsArray, ...values: PromptValue[]): string {\n\treturn compose(strings, values, {})\n}\n\n/**\n * Returns a configured `prompt` tag. With no arguments it behaves identically\n * to bare {@link prompt}.\n */\nexport function promptCreate(options: PromptOptions = {}): typeof prompt {\n\treturn ((strings: TemplateStringsArray, ...values: PromptValue[]) =>\n\t\tcompose(strings, values, options)) as typeof prompt\n}\n\nexport const ai: typeof prompt = prompt\n"]}

package/dist/index.d.cts

@@ -0,0 +1,61 @@
+declare class JsonValue<T = unknown> {
+    readonly value: T;
+    constructor(value: T);
+}
+declare const renderPrompt: unique symbol;
+type ZodLike = {
+    toJSONSchema(input?: {
+        io: 'input' | 'output';
+    }): object;
+};
+type Renderable = {
+    [renderPrompt](): PromptValue;
+};
+type Primitive = string | number | boolean | null | undefined | object | JsonValue | ZodLike | Renderable;
+type PromptValue = Primitive | readonly PromptValue[];
+type TruncateMode = 'end' | 'start' | 'middle';
+type TruncateMarker = string | ((removedChars: number) => string);
+interface TruncateCtx {
+    maxChars: number;
+    mode: TruncateMode;
+    marker: TruncateMarker;
+    truncate: (text: string, mode?: TruncateMode) => string;
+}
+type OutputTruncateFn = (text: string, ctx: TruncateCtx) => string;
+type ValueTruncateFn = (rendered: string, original: PromptValue, ctx: TruncateCtx) => string;
+type OutputTruncate = {
+    maxChars: number;
+    truncate?: TruncateMode;
+    marker?: TruncateMarker;
+} | {
+    truncate: OutputTruncateFn;
+    maxChars?: number;
+    marker?: TruncateMarker;
+};
+type ValueTruncate = {
+    valueMaxChars: number;
+    valueTruncate?: TruncateMode;
+    valueMarker?: TruncateMarker;
+} | {
+    valueTruncate: ValueTruncateFn;
+    valueMaxChars?: number;
+    valueMarker?: TruncateMarker;
+};
+type PromptOptions = {
+    dedent?: boolean;
+} & Partial<OutputTruncate> & Partial<ValueTruncate>;
+/**
+ * Tagged template that assembles a clean LLM prompt string.
+ *
+ * Preserves the indentation/prefix of the line each `${value}` sits on so
+ * lists, block quotes, and multi-line interpolations render correctly.
+ */
+declare function prompt(strings: TemplateStringsArray, ...values: PromptValue[]): string;
+/**
+ * Returns a configured `prompt` tag. With no arguments it behaves identically
+ * to bare {@link prompt}.
+ */
+declare function promptCreate(options?: PromptOptions): typeof prompt;
+declare const ai: typeof prompt;
+
+export { JsonValue, type OutputTruncateFn, type PromptOptions, type PromptValue, type TruncateCtx, type TruncateMarker, type TruncateMode, type ValueTruncateFn, ai, prompt, promptCreate, renderPrompt };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+declare class JsonValue<T = unknown> {
+    readonly value: T;
+    constructor(value: T);
+}
+declare const renderPrompt: unique symbol;
+type ZodLike = {
+    toJSONSchema(input?: {
+        io: 'input' | 'output';
+    }): object;
+};
+type Renderable = {
+    [renderPrompt](): PromptValue;
+};
+type Primitive = string | number | boolean | null | undefined | object | JsonValue | ZodLike | Renderable;
+type PromptValue = Primitive | readonly PromptValue[];
+type TruncateMode = 'end' | 'start' | 'middle';
+type TruncateMarker = string | ((removedChars: number) => string);
+interface TruncateCtx {
+    maxChars: number;
+    mode: TruncateMode;
+    marker: TruncateMarker;
+    truncate: (text: string, mode?: TruncateMode) => string;
+}
+type OutputTruncateFn = (text: string, ctx: TruncateCtx) => string;
+type ValueTruncateFn = (rendered: string, original: PromptValue, ctx: TruncateCtx) => string;
+type OutputTruncate = {
+    maxChars: number;
+    truncate?: TruncateMode;
+    marker?: TruncateMarker;
+} | {
+    truncate: OutputTruncateFn;
+    maxChars?: number;
+    marker?: TruncateMarker;
+};
+type ValueTruncate = {
+    valueMaxChars: number;
+    valueTruncate?: TruncateMode;
+    valueMarker?: TruncateMarker;
+} | {
+    valueTruncate: ValueTruncateFn;
+    valueMaxChars?: number;
+    valueMarker?: TruncateMarker;
+};
+type PromptOptions = {
+    dedent?: boolean;
+} & Partial<OutputTruncate> & Partial<ValueTruncate>;
+/**
+ * Tagged template that assembles a clean LLM prompt string.
+ *
+ * Preserves the indentation/prefix of the line each `${value}` sits on so
+ * lists, block quotes, and multi-line interpolations render correctly.
+ */
+declare function prompt(strings: TemplateStringsArray, ...values: PromptValue[]): string;
+/**
+ * Returns a configured `prompt` tag. With no arguments it behaves identically
+ * to bare {@link prompt}.
+ */
+declare function promptCreate(options?: PromptOptions): typeof prompt;
+declare const ai: typeof prompt;
+
+export { JsonValue, type OutputTruncateFn, type PromptOptions, type PromptValue, type TruncateCtx, type TruncateMarker, type TruncateMode, type ValueTruncateFn, ai, prompt, promptCreate, renderPrompt };

package/dist/index.js

@@ -0,0 +1,156 @@
+// src/prompt.ts
+var JsonValue = class {
+  constructor(value) {
+    this.value = value;
+  }
+  value;
+};
+var renderPrompt = /* @__PURE__ */ Symbol("prompt.render");
+var defaultMarker = (removed) => `\u2026[truncated ${removed} chars]`;
+function resolveMarker(m, removed) {
+  const mk = m ?? defaultMarker;
+  return typeof mk === "function" ? mk(removed) : mk;
+}
+function builtinTruncate(text, mode, maxChars, marker) {
+  if (text.length <= maxChars) return text;
+  const estRemoved = text.length - maxChars;
+  const markerStr = resolveMarker(marker, estRemoved);
+  const budget = Math.max(0, maxChars - markerStr.length);
+  if (budget <= 0) return markerStr.slice(0, maxChars);
+  switch (mode) {
+    case "end":
+      return text.slice(0, budget) + markerStr;
+    case "start":
+      return markerStr + text.slice(text.length - budget);
+    case "middle": {
+      const head = Math.ceil(budget / 2);
+      const tail = budget - head;
+      return text.slice(0, head) + markerStr + text.slice(text.length - tail);
+    }
+  }
+}
+function resolveOutput(opts) {
+  const t = opts.truncate;
+  const custom = typeof t === "function" ? t : void 0;
+  const mode = typeof t === "string" ? t : "end";
+  const maxChars = opts.maxChars ?? 0;
+  return {
+    enabled: custom !== void 0 || maxChars > 0,
+    maxChars,
+    mode,
+    marker: opts.marker ?? defaultMarker,
+    custom
+  };
+}
+function resolveValue(opts) {
+  const t = opts.valueTruncate;
+  const custom = typeof t === "function" ? t : void 0;
+  const mode = typeof t === "string" ? t : "end";
+  const maxChars = opts.valueMaxChars ?? 0;
+  return {
+    enabled: custom !== void 0 || maxChars > 0,
+    maxChars,
+    mode,
+    marker: opts.valueMarker ?? defaultMarker,
+    custom
+  };
+}
+function makeCtx(r) {
+  return {
+    maxChars: r.maxChars,
+    mode: r.mode,
+    marker: r.marker,
+    truncate: (text, mode) => builtinTruncate(text, mode ?? r.mode, r.maxChars, r.marker)
+  };
+}
+function renderRaw(value, valueCfg) {
+  if (Array.isArray(value)) {
+    return value.filter((v) => v !== null && v !== void 0 && v !== false).map((v) => flatten(v, valueCfg)).join("\n");
+  }
+  if (value === null || value === void 0 || value === false) return "";
+  if (typeof value === "object") {
+    const r = value[renderPrompt];
+    if (typeof r === "function") {
+      return flatten(r.call(value), valueCfg);
+    }
+    let jsonValue;
+    if (value instanceof JsonValue) {
+      jsonValue = value.value;
+    } else if (typeof value.toJSONSchema === "function") {
+      jsonValue = value.toJSONSchema({ io: "input" });
+    } else {
+      jsonValue = value;
+    }
+    return "```json\n" + JSON.stringify(jsonValue, null, 2) + "\n```";
+  }
+  return String(value).trim();
+}
+function flatten(value, valueCfg) {
+  const rendered = renderRaw(value, valueCfg);
+  if (!valueCfg.enabled) return rendered;
+  const ctx = makeCtx(valueCfg);
+  if (valueCfg.custom) return valueCfg.custom(rendered, value, ctx);
+  return builtinTruncate(rendered, valueCfg.mode, valueCfg.maxChars, valueCfg.marker);
+}
+function measureMinIndent(strings) {
+  const joined = strings.join("\0");
+  let min = Infinity;
+  for (const line of joined.split("\n")) {
+    if (!/\S/.test(line)) continue;
+    const m = /^[ \t]*/.exec(line);
+    const ind = m ? m[0].length : 0;
+    if (ind < min) min = ind;
+  }
+  return min === Infinity ? 0 : min;
+}
+function dedentStrings(strings) {
+  const n = measureMinIndent(strings);
+  if (n === 0) return strings.slice();
+  const re = new RegExp(`^[ \\t]{0,${n}}`);
+  return strings.map((s, i) => {
+    const lines = s.split("\n");
+    return lines.map((line, j) => {
+      const isLineStart = j > 0 || i === 0;
+      return isLineStart ? line.replace(re, "") : line;
+    }).join("\n");
+  });
+}
+function assemble(strings, values, valueCfg) {
+  const out = [];
+  for (let i = 0; i < strings.length; i++) {
+    const lines = strings[i].split("\n");
+    const lastPrefix = lines.pop() ?? "";
+    for (const l of lines) out.push(l, "\n");
+    out.push(lastPrefix);
+    if (i < values.length) {
+      const flat = flatten(values[i], valueCfg).split("\n");
+      out.push(flat[0]);
+      for (let k = 1; k < flat.length; k++) out.push("\n", lastPrefix, flat[k]);
+    }
+  }
+  return out.join("");
+}
+function compose(strings, values, opts) {
+  const dedent = opts.dedent !== false;
+  const valueCfg = resolveValue(opts);
+  const outputCfg = resolveOutput(opts);
+  const prepared = dedent ? dedentStrings(strings) : strings.slice();
+  let result = assemble(prepared, values, valueCfg);
+  result = result.replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+  if (outputCfg.enabled) {
+    const ctx = makeCtx(outputCfg);
+    result = outputCfg.custom ? outputCfg.custom(result, ctx) : builtinTruncate(result, outputCfg.mode, outputCfg.maxChars, outputCfg.marker);
+  }
+  return result;
+}
+function prompt(strings, ...values) {
+  return compose(strings, values, {});
+}
+function promptCreate(options = {}) {
+  return ((strings, ...values) => compose(strings, values, options));
+}
+var ai = prompt;
+
+export { JsonValue, ai, prompt, promptCreate, renderPrompt };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prompt.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export class JsonValue<T = unknown> {\n\tconstructor(public readonly value: T) {}\n}\n\nexport const renderPrompt = Symbol('prompt.render')\n\ntype ZodLike = { toJSONSchema(input?: { io: 'input' | 'output' }): object }\ntype Renderable = { [renderPrompt](): PromptValue }\n\ntype Primitive =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| undefined\n\t| object\n\t| JsonValue\n\t| ZodLike\n\t| Renderable\n\nexport type PromptValue = Primitive | readonly PromptValue[]\n\nexport type TruncateMode = 'end' | 'start' | 'middle'\nexport type TruncateMarker = string | ((removedChars: number) => string)\n\nexport interface TruncateCtx {\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\ttruncate: (text: string, mode?: TruncateMode) => string\n}\n\nexport type OutputTruncateFn = (text: string, ctx: TruncateCtx) => string\nexport type ValueTruncateFn = (rendered: string, original: PromptValue, ctx: TruncateCtx) => string\n\ntype OutputTruncate =\n\t| { maxChars: number; truncate?: TruncateMode; marker?: TruncateMarker }\n\t| { truncate: OutputTruncateFn; maxChars?: number; marker?: TruncateMarker }\n\ntype ValueTruncate =\n\t| { valueMaxChars: number; valueTruncate?: TruncateMode; valueMarker?: TruncateMarker }\n\t| { valueTruncate: ValueTruncateFn; valueMaxChars?: number; valueMarker?: TruncateMarker }\n\nexport type PromptOptions =\n\t& { dedent?: boolean }\n\t& Partial<OutputTruncate>\n\t& Partial<ValueTruncate>\n\nconst defaultMarker: TruncateMarker = (removed) => `…[truncated ${removed} chars]`\n\nfunction resolveMarker(m: TruncateMarker | undefined, removed: number): string {\n\tconst mk = m ?? defaultMarker\n\treturn typeof mk === 'function' ? mk(removed) : mk\n}\n\nfunction builtinTruncate(\n\ttext: string,\n\tmode: TruncateMode,\n\tmaxChars: number,\n\tmarker: TruncateMarker,\n): string {\n\tif (text.length <= maxChars) return text\n\tconst estRemoved = text.length - maxChars\n\tconst markerStr = resolveMarker(marker, estRemoved)\n\tconst budget = Math.max(0, maxChars - markerStr.length)\n\tif (budget <= 0) return markerStr.slice(0, maxChars)\n\tswitch (mode) {\n\t\tcase 'end':\n\t\t\treturn text.slice(0, budget) + markerStr\n\t\tcase 'start':\n\t\t\treturn markerStr + text.slice(text.length - budget)\n\t\tcase 'middle': {\n\t\t\tconst head = Math.ceil(budget / 2)\n\t\t\tconst tail = budget - head\n\t\t\treturn text.slice(0, head) + markerStr + text.slice(text.length - tail)\n\t\t}\n\t}\n}\n\ninterface ResolvedOutput {\n\tenabled: boolean\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\tcustom?: OutputTruncateFn\n}\n\ninterface ResolvedValue {\n\tenabled: boolean\n\tmaxChars: number\n\tmode: TruncateMode\n\tmarker: TruncateMarker\n\tcustom?: ValueTruncateFn\n}\n\nfunction resolveOutput(opts: PromptOptions): ResolvedOutput {\n\tconst t = opts.truncate\n\tconst custom = typeof t === 'function' ? (t as OutputTruncateFn) : undefined\n\tconst mode: TruncateMode = typeof t === 'string' ? t : 'end'\n\tconst maxChars = opts.maxChars ?? 0\n\treturn {\n\t\tenabled: custom !== undefined || maxChars > 0,\n\t\tmaxChars,\n\t\tmode,\n\t\tmarker: opts.marker ?? defaultMarker,\n\t\tcustom,\n\t}\n}\n\nfunction resolveValue(opts: PromptOptions): ResolvedValue {\n\tconst t = opts.valueTruncate\n\tconst custom = typeof t === 'function' ? (t as ValueTruncateFn) : undefined\n\tconst mode: TruncateMode = typeof t === 'string' ? t : 'end'\n\tconst maxChars = opts.valueMaxChars ?? 0\n\treturn {\n\t\tenabled: custom !== undefined || maxChars > 0,\n\t\tmaxChars,\n\t\tmode,\n\t\tmarker: opts.valueMarker ?? defaultMarker,\n\t\tcustom,\n\t}\n}\n\nfunction makeCtx(r: { maxChars: number; mode: TruncateMode; marker: TruncateMarker }): TruncateCtx {\n\treturn {\n\t\tmaxChars: r.maxChars,\n\t\tmode: r.mode,\n\t\tmarker: r.marker,\n\t\ttruncate: (text, mode) => builtinTruncate(text, mode ?? r.mode, r.maxChars, r.marker),\n\t}\n}\n\nfunction renderRaw(value: PromptValue, valueCfg: ResolvedValue): string {\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t\t\t.filter((v) => v !== null && v !== undefined && v !== false)\n\t\t\t.map((v) => flatten(v as PromptValue, valueCfg))\n\t\t\t.join('\\n')\n\t}\n\tif (value === null || value === undefined || value === false) return ''\n\tif (typeof value === 'object') {\n\t\tconst r = (value as Record<symbol, unknown>)[renderPrompt]\n\t\tif (typeof r === 'function') {\n\t\t\treturn flatten((r as () => PromptValue).call(value), valueCfg)\n\t\t}\n\t\tlet jsonValue: unknown\n\t\tif (value instanceof JsonValue) {\n\t\t\tjsonValue = value.value\n\t\t} else if (typeof (value as ZodLike).toJSONSchema === 'function') {\n\t\t\tjsonValue = (value as ZodLike).toJSONSchema({ io: 'input' })\n\t\t} else {\n\t\t\tjsonValue = value\n\t\t}\n\t\treturn '```json\\n' + JSON.stringify(jsonValue, null, 2) + '\\n```'\n\t}\n\treturn String(value).trim()\n}\n\nfunction flatten(value: PromptValue, valueCfg: ResolvedValue): string {\n\tconst rendered = renderRaw(value, valueCfg)\n\tif (!valueCfg.enabled) return rendered\n\tconst ctx = makeCtx(valueCfg)\n\tif (valueCfg.custom) return valueCfg.custom(rendered, value, ctx)\n\treturn builtinTruncate(rendered, valueCfg.mode, valueCfg.maxChars, valueCfg.marker)\n}\n\nfunction measureMinIndent(strings: readonly string[]): number {\n\t// Placeholder for interpolation slots so lines that contain only an indent\n\t// + a ${value} still count as content lines for indent measurement.\n\tconst joined = strings.join('\\x00')\n\tlet min = Infinity\n\tfor (const line of joined.split('\\n')) {\n\t\tif (!/\\S/.test(line)) continue\n\t\tconst m = /^[ \\t]*/.exec(line)\n\t\tconst ind = m ? m[0].length : 0\n\t\tif (ind < min) min = ind\n\t}\n\treturn min === Infinity ? 0 : min\n}\n\nfunction dedentStrings(strings: readonly string[]): string[] {\n\tconst n = measureMinIndent(strings)\n\tif (n === 0) return strings.slice()\n\tconst re = new RegExp(`^[ \\\\t]{0,${n}}`)\n\treturn strings.map((s, i) => {\n\t\tconst lines = s.split('\\n')\n\t\treturn lines\n\t\t\t.map((line, j) => {\n\t\t\t\tconst isLineStart = j > 0 || i === 0\n\t\t\t\treturn isLineStart ? line.replace(re, '') : line\n\t\t\t})\n\t\t\t.join('\\n')\n\t})\n}\n\nfunction assemble(\n\tstrings: readonly string[],\n\tvalues: readonly PromptValue[],\n\tvalueCfg: ResolvedValue,\n): string {\n\tconst out: string[] = []\n\tfor (let i = 0; i < strings.length; i++) {\n\t\tconst lines = strings[i]!.split('\\n')\n\t\tconst lastPrefix = lines.pop() ?? ''\n\t\tfor (const l of lines) out.push(l, '\\n')\n\t\tout.push(lastPrefix)\n\t\tif (i < values.length) {\n\t\t\tconst flat = flatten(values[i]!, valueCfg).split('\\n')\n\t\t\tout.push(flat[0]!)\n\t\t\tfor (let k = 1; k < flat.length; k++) out.push('\\n', lastPrefix, flat[k]!)\n\t\t}\n\t}\n\treturn out.join('')\n}\n\nfunction compose(\n\tstrings: readonly string[],\n\tvalues: readonly PromptValue[],\n\topts: PromptOptions,\n): string {\n\tconst dedent = opts.dedent !== false\n\tconst valueCfg = resolveValue(opts)\n\tconst outputCfg = resolveOutput(opts)\n\tconst prepared = dedent ? dedentStrings(strings) : strings.slice()\n\tlet result = assemble(prepared, values, valueCfg)\n\tresult = result.replace(/[ \\t]+\\n/g, '\\n').replace(/\\n{3,}/g, '\\n\\n').trim()\n\tif (outputCfg.enabled) {\n\t\tconst ctx = makeCtx(outputCfg)\n\t\tresult = outputCfg.custom\n\t\t\t? outputCfg.custom(result, ctx)\n\t\t\t: builtinTruncate(result, outputCfg.mode, outputCfg.maxChars, outputCfg.marker)\n\t}\n\treturn result\n}\n\n/**\n * Tagged template that assembles a clean LLM prompt string.\n *\n * Preserves the indentation/prefix of the line each `${value}` sits on so\n * lists, block quotes, and multi-line interpolations render correctly.\n */\nexport function prompt(strings: TemplateStringsArray, ...values: PromptValue[]): string {\n\treturn compose(strings, values, {})\n}\n\n/**\n * Returns a configured `prompt` tag. With no arguments it behaves identically\n * to bare {@link prompt}.\n */\nexport function promptCreate(options: PromptOptions = {}): typeof prompt {\n\treturn ((strings: TemplateStringsArray, ...values: PromptValue[]) =>\n\t\tcompose(strings, values, options)) as typeof prompt\n}\n\nexport const ai: typeof prompt = prompt\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@svara/prompts",
+	"version": "0.1.0",
+	"description": "Tiny ergonomic tagged-template utility for assembling LLM prompts",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run typecheck && bun run test && bun run build"
+	},
+	"keywords": [
+		"prompt",
+		"llm",
+		"template",
+		"anthropic",
+		"openai",
+		"tagged-template"
+	],
+	"license": "MIT",
+	"author": "Borut Svara <borut@svara.io>",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/svaraborut/prompts.git"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"tsup": "^8.3.5",
+		"typescript": "^5.7.2"
+	}
+}