prose-writer 0.1.1 → 0.1.2

package/README.md

@@ -2,6 +2,33 @@
 
 A zero-dependency, chainable TypeScript library for building formatted text and markdown strings. Perfect for constructing LLM prompts, generating documentation, or any scenario where you need to programmatically build structured text.
 
+## In one sentence
+
+Prose Writer is a fluent builder for producing markdown-friendly strings without template literal sprawl.
+
+## When to use it
+
+- You need readable, composable prompt or document builders in code
+- You want conditionals, loops, and reusable pieces without `.map().join()` or manual concatenation
+- You need safe handling of untrusted input or structured output sections (JSON/YAML)
+
+## How it works (3 steps)
+
+1. `write()` creates a builder (optionally with initial text).
+2. Chain block helpers like `.section()`, `.list()`, `.tag()`, `.codeblock()`, `.json()`.
+3. Call `.toString()` or `String(writer)` to get the final text.
+
+```typescript
+import { write } from 'prose-writer';
+
+const prompt = write('You are a helpful assistant.')
+  .section('Guidelines', (w) => w.list('Be concise', 'Cite sources'))
+  .tag('input', userText)
+  .toString();
+```
+
+Each `write()` call ends with a newline, so chained calls become separate paragraphs (a blank line between). To keep content on the same line, pass multiple strings to a single `write()` call. Most block helpers add blank lines around themselves so the output reads like markdown paragraphs. Use `write()` with no args to insert an extra blank line.
+
 ## Why Prose Writer?
 
 Building prompts for LLMs in code is _painful_. You end up with wild stuff like this.
@@ -23,7 +50,27 @@ ${context}
 
 Template literals become unreadable. String concatenation is worse. And when you need conditionals, variables, or reusable pieces? Good luck.
 
-**prose-writer** fixes this:
+Compared to concatenating arrays of strings, Prose Writer keeps structure and spacing inside the builder instead of scattering `join()` logic, manual newlines, and nested maps across your code. Compared to giant template strings, it avoids brittle whitespace and makes conditional or reusable sections readable and composable.
+
+Array concatenation version:
+
+```typescript
+const prompt = [
+  `You are a ${role}.`,
+  '',
+  '## Guidelines',
+  ...guidelines.map((g) => `- ${g}`),
+  '',
+  '## Examples',
+  ...examples.map((ex, i) => `### Example ${i + 1}\n${ex}`),
+  '',
+  '<context>',
+  context,
+  '</context>',
+].join('\n');
+```
+
+Prose Writer version:
 
 ```typescript
 const prompt = write(`You are a ${role}.`)
@@ -42,7 +89,6 @@ const prompt = write(`You are a ${role}.`)
 - **Composable** - Build prompts from reusable pieces with `.append()` and `.clone()`
 - **Logical grouping** - Use `.with(builder)` to group related operations
 - **Conditional logic** - Add sections conditionally with `.when(condition, builder)`
-- **Template variables** - Use `{{placeholders}}` and `.fill()` for dynamic content
 - **LLM-optimized** - Built-in `.tag()` for XML delimiters (Claude loves these), `.json()` and `.yaml()` for structured output instructions
 - **Batch operations** - Iterate with `.each()` instead of awkward `.map().join()` chains
 - **Token awareness** - Estimate prompt size with `.tokens()`
@@ -66,6 +112,9 @@ const outputFormat = write('').definitions({
   suggestions: 'Recommended improvements',
 });
 
+const language = 'TypeScript';
+const framework = 'React';
+
 // Build the prompt
 const reviewPrompt = write('')
   .append(codeReviewPersona)
@@ -79,7 +128,8 @@ const reviewPrompt = write('')
   .when(strictMode, (w) => w.write('Be extremely thorough. Miss nothing.'))
   .section('Output Format', (w) => w.append(outputFormat))
   .tag('code', userCode)
-  .fill({ language: 'TypeScript', framework: 'React' });
+  .write('Language:', language)
+  .write('Framework:', framework);
 ```
 
 Stop fighting with template strings. Start writing prompts that are readable, maintainable, and composable.
@@ -182,17 +232,8 @@ Creates a `ProseWriter` that escapes untrusted input. Safe mode:
 - Wraps inline code with a backtick fence that can't be broken by user input
 
 Use this when inserting user-generated content. To intentionally include raw Markdown, pass a `ProseWriter` instance or call `.raw()` to bypass escaping.
-In safe mode, `fill()` also escapes variable values.
-If your template string is trusted (authored by you), use `write.safe.template(...)` to prevent the template itself from being escaped.
 You can also import a safe-first writer: `import { write } from 'prose-writer/safe'`.
 
-```typescript
-const prompt = write.safe
-  .template('You are {{role}}!')
-  .fill({ role: userRole })
-  .toString();
-```
-
 ```typescript
 const prompt = write
   .safe('User input:', userInput)
@@ -218,20 +259,21 @@ Hello **World**
 ```
 
 ```typescript
-const multiLine = write('First line').write('Second line').toString();
+const multiParagraph = write('First line').write('Second line').toString();
 ```
 
 Output:
 
 ```markdown
 First line
+
 Second line
 ```
 
-Adding a blank line between paragraphs:
+Adding an extra blank line between paragraphs:
 
 ```typescript
-const multiParagraph = write('Paragraph 1').write().write('Paragraph 2').toString();
+const spacedParagraphs = write('Paragraph 1').write().write('Paragraph 2').toString();
 ```
 
 Output:
@@ -244,7 +286,7 @@ Paragraph 2
 
 ### `.write(...content: string[])`
 
-Appends content to the prose. Multiple arguments are joined with a space, and a newline is added at the end. Returns `this` for chaining.
+Appends content to the prose. Multiple arguments are joined with a space, and a newline is added at the end. Each chained call starts a new paragraph (blank line), so use a single `write()` call when you want one line.
 
 ```typescript
 write('User:').write('Hello', 'Assistant').toString();
@@ -257,6 +299,18 @@ User:
 Hello Assistant
 ```
 
+Same line by passing multiple strings:
+
+```typescript
+write('User:', 'Hello', 'Assistant').toString();
+```
+
+Output:
+
+```markdown
+User: Hello Assistant
+```
+
 ### Inline Utilities
 
 The following utilities return formatted strings and can be used within `write()` calls or anywhere else.
@@ -287,21 +341,6 @@ write(
 
 Obviously, you can just write regular Markdown here as well.
 
-### `.nextLine()`
-
-Prevents the next block element or `write()` call from adding a paragraph break. Useful for placing content on consecutive lines.
-
-```typescript
-write('Line 1').nextLine().write('Line 2').toString();
-```
-
-Output:
-
-```markdown
-Line 1
-Line 2
-```
-
 ### `.unorderedList(...items: string[] | number[] | boolean[] | ProseWriter[])`
 
 ### `.list(...items: string[] | number[] | boolean[] | ProseWriter[])`
@@ -785,21 +824,6 @@ Output:
 Use the `calculateTotal` function.
 ```
 
-### `.fill(variables: Record<string, string>)`
-
-Replaces template variables in the format `{{variableName}}` with provided values. Returns a new `ProseWriter` with the substitutions applied (does not modify the original).
-
-```typescript
-const template = write('Hello, {{name}}! Welcome to {{place}}.');
-const result = template.fill({ name: 'Alice', place: 'Wonderland' }).toString();
-```
-
-Output:
-
-```markdown
-Hello, Alice! Welcome to Wonderland.
-```
-
 ### `.section(name: string, builder: (writer) => void, level?: 1-6)`
 
 Creates a semantic section with a heading and content built by the builder function. The optional `level` parameter defaults to 2.
@@ -1265,17 +1289,6 @@ const conclusion = write('').heading(2, 'Conclusion').write('Summary');
 const document = ProseWriter.join(intro, body, conclusion);
 ```
 
-### `ProseWriter.fromTemplate(template: string)`
-
-Static method that creates a ProseWriter from a template string.
-
-```typescript
-const prompt = ProseWriter.fromTemplate('Hello {{name}}, your role is {{role}}.').fill({
-  name: 'Alice',
-  role: 'developer',
-});
-```
-
 ### `.toString()`
 
 Converts the accumulated prose to a string.
@@ -1402,48 +1415,13 @@ const userPrompt = write('Please review the following code:')
   .toString();
 ```
 
-## Prompt Templates and Variations
+## Prompt Variations
 
-Use `fill()` for variable interpolation and `clone()` to create prompt variations:
+Use `clone()` to create variations without mutating the original prompt:
 
 ```typescript
 import { write } from 'prose-writer';
 
-// Create a reusable template
-const promptTemplate = write('You are a {{role}}.')
-  .section('Task', (w) => {
-    w.write('Help the user with {{task}}.');
-  })
-  .section('Guidelines', (w) => {
-    w.list('Be {{style}}', 'Focus on {{focus}}');
-  })
-  .section('Output', (w) => {
-    w.table(
-      ['Format', 'When to use'],
-      [
-        ['Code blocks', 'For code examples'],
-        ['Bullet points', 'For lists of items'],
-        ['Tables', 'For structured data'],
-      ],
-    );
-  });
-
-// Create variations for different use cases
-const codeReviewPrompt = promptTemplate.fill({
-  role: 'senior software engineer',
-  task: 'code review',
-  style: 'thorough and constructive',
-  focus: 'code quality and best practices',
-});
-
-const debuggingPrompt = promptTemplate.fill({
-  role: 'debugging expert',
-  task: 'finding and fixing bugs',
-  style: 'systematic and methodical',
-  focus: 'root cause analysis',
-});
-
-// Or use clone() for structural variations
 const basePrompt = write('You are an AI assistant.').section('Core Guidelines', (w) => {
   w.list('Be helpful', 'Be accurate');
 });

package/dist/index.js

@@ -1,46 +1,46 @@
 // @bun
 class T{value;constructor(F){this.value=F}toString(){return this.value}valueOf(){return this.value}}var k=(F)=>F.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;"),S=(F)=>{if(/^\s*#{1,6}\s/.test(F))return F.replace(/^(\s*)(#{1,6})/,"$1\\$2");if(/^\s*>/.test(F))return F.replace(/^(\s*)>/,"$1\\>");if(/^\s*([-+*])\s/.test(F))return F.replace(/^(\s*)([-+*])/,"$1\\$2");if(/^\s*\d+\.\s/.test(F))return F.replace(/^(\s*)(\d+)\./,"$1$2\\.");return F},Z=(F)=>{return k(F).replace(/([\\`*_~()|!])/g,"\\$1").replace(/\[/g,"\\[").replace(/\]/g,"\\]").split(`
 `).map((G)=>S(G)).join(`
-`)},W=(F)=>{let H=F.match(/`+/g),G=(H?Math.max(...H.map((O)=>O.length)):0)+1,J="`".repeat(G),K=/^\s|\s$/.test(F)?` ${F} `:F;return`${J}${K}${J}`},P=(F)=>{return encodeURI(F).replace(/[()]/g,"\\$&")},q=(F,H="none")=>{if(F instanceof T)return{value:F.toString(),isTrusted:!0};if(F instanceof Q){let G=F.toString();if(H==="end")return{value:G.trimEnd(),isTrusted:!0};if(H==="both")return{value:G.trim(),isTrusted:!0};return{value:G,isTrusted:!0}}return{value:String(F),isTrusted:!1}},b=(F)=>{let{value:H,isTrusted:G}=q(F,"both");return G?H:Z(H)},z=(F)=>new T(F),X=(F)=>z(`**${b(F)}**`),D=(F)=>z(`*${b(F)}*`),j=(F)=>z(`~~${b(F)}~~`),A=(F)=>{let{value:H}=q(F,"both");return z(W(H))},E=(F,H)=>{let{value:G,isTrusted:J}=q(F,"both"),N=J?G:Z(G),K=P(H);return z(`[${N}](${K})`)},L=(F,H)=>{let{value:G,isTrusted:J}=q(F,"both"),N=J?G:Z(G),K=P(H);return z(`![${N}](${K})`)},v=(F)=>{if(F.length===0)return"No validation issues were provided.";return F.map((H,G)=>{let J=H.path?`${H.path}: `:"";return`${G+1}. ${J}${H.message}`}).join(`
+`)},W=(F)=>{let H=F.match(/`+/g),G=(H?Math.max(...H.map((O)=>O.length)):0)+1,J="`".repeat(G),N=/^\s|\s$/.test(F)?` ${F} `:F;return`${J}${N}${J}`},h=(F)=>{return encodeURI(F).replace(/[()]/g,"\\$&")},q=(F,H="none")=>{if(F instanceof T)return{value:F.toString(),isTrusted:!0};if(F instanceof Q){let G=F.toString();if(H==="end")return{value:G.trimEnd(),isTrusted:!0};if(H==="both")return{value:G.trim(),isTrusted:!0};return{value:G,isTrusted:!0}}return{value:String(F),isTrusted:!1}},b=(F)=>{let{value:H,isTrusted:G}=q(F,"both");return G?H:Z(H)},z=(F)=>new T(F),X=(F)=>z(`**${b(F)}**`),D=(F)=>z(`*${b(F)}*`),j=(F)=>z(`~~${b(F)}~~`),A=(F)=>{let{value:H}=q(F,"both");return z(W(H))},E=(F,H)=>{let{value:G,isTrusted:J}=q(F,"both"),K=J?G:Z(G),N=h(H);return z(`[${K}](${N})`)},L=(F,H)=>{let{value:G,isTrusted:J}=q(F,"both"),K=J?G:Z(G),N=h(H);return z(`![${K}](${N})`)},v=(F)=>{if(F.length===0)return"No validation issues were provided.";return F.map((H,G)=>{let J=H.path?`${H.path}: `:"";return`${G+1}. ${J}${H.message}`}).join(`
 `)};class R extends Error{format;issues;constructor(F,H,G){let J=G??`${F.toUpperCase()} validation failed`;super(`${J}
 ${v(H)}`);this.name="ValidationError",this.format=F,this.issues=H}}var p=(F)=>{return({format:H,data:G,schema:J})=>{if(H!=="json"||J===void 0)return{valid:!0};return F(J,G)}},m=(F)=>{return(H)=>F(H)};class Q{parts=[];_skipNextPadding=!1;safeMode;constructor(F,H={}){if(this.safeMode=H.safe??!1,F!==void 0)this.parts.push(F.endsWith(`
 `)?F:F+`
-`)}createChildWriter(){return new Q(void 0,{safe:this.safeMode})}write(...F){let H=F.map((J)=>{let{value:N,isTrusted:K}=q(J,"end");if(this.safeMode&&!K)return Z(N);return N}).join(" ");if(this.parts.length===0&&H.length===0)return this;let G=this.padding;return this.parts.push(G+H+`
-`),this}nextLine(){return this._skipNextPadding=!0,this}unorderedList(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:J,getItems:N}=this.createListBuilder();F[0](J);let O=N().map((Y)=>{if(Y instanceof Q)return Y.toString().trimEnd().split(`
+`)}createChildWriter(){return new Q(void 0,{safe:this.safeMode})}write(...F){let H=F.map((J)=>{let{value:K,isTrusted:N}=q(J,"end");if(this.safeMode&&!N)return Z(K);return K}).join(" ");if(this.parts.length===0&&H.length===0)return this;let G=this.padding;return this.parts.push(G+H+`
+`),this}unorderedList(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:J,getItems:K}=this.createListBuilder();F[0](J);let O=K().map((Y)=>{if(Y instanceof Q)return Y.toString().trimEnd().split(`
 `).map((_)=>`  ${_}`).join(`
 `);return`- ${Y}`}).join(`
 `);return this.parts.push(`${this.padding}${O}
 
 `),this}let G=F.map((J)=>{if(J instanceof Q)return J.toString().trimEnd().split(`
 `).map((Y)=>`  ${Y}`).join(`
-`);let{value:N,isTrusted:K}=q(J);return`- ${this.safeMode&&!K?Z(N):N}`}).join(`
+`);let{value:K,isTrusted:N}=q(J);return`- ${this.safeMode&&!N?Z(K):K}`}).join(`
 `);return this.parts.push(`${this.padding}${G}
 
-`),this}list(...F){if(F.length===1&&typeof F[0]==="function")return this.unorderedList(F[0]);return this.unorderedList(...F)}orderedList(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:N,getItems:K}=this.createListBuilder();F[0](N);let O=1,_=K().map(($)=>{if($ instanceof Q)return $.toString().trimEnd().split(`
+`),this}list(...F){if(F.length===1&&typeof F[0]==="function")return this.unorderedList(F[0]);return this.unorderedList(...F)}orderedList(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:K,getItems:N}=this.createListBuilder();F[0](K);let O=1,_=N().map(($)=>{if($ instanceof Q)return $.toString().trimEnd().split(`
 `).map((U)=>`  ${U}`).join(`
 `);return`${O++}. ${$}`}).join(`
 `);return this.parts.push(`${this.padding}${_}
 
-`),this}let H=1,J=F.map((N)=>{if(N instanceof Q)return N.toString().trimEnd().split(`
+`),this}let H=1,J=F.map((K)=>{if(K instanceof Q)return K.toString().trimEnd().split(`
 `).map((_)=>`  ${_}`).join(`
-`);let{value:K,isTrusted:O}=q(N),Y=this.safeMode&&!O?Z(K):K;return`${H++}. ${Y}`}).join(`
+`);let{value:N,isTrusted:O}=q(K),Y=this.safeMode&&!O?Z(N):N;return`${H++}. ${Y}`}).join(`
 `);return this.parts.push(`${this.padding}${J}
 
-`),this}tasks(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:J,getItems:N}=this.createListBuilder();F[0](J);let O=N().map((Y)=>{if(Y instanceof Q)return Y.toString().trimEnd().split(`
+`),this}tasks(...F){if(F.length===1&&typeof F[0]==="function"){let{builder:J,getItems:K}=this.createListBuilder();F[0](J);let O=K().map((Y)=>{if(Y instanceof Q)return Y.toString().trimEnd().split(`
 `).map((_)=>`  ${_}`).join(`
 `);return`- ${Y}`}).join(`
 `);return this.parts.push(`${this.padding}${O}
 
-`),this}let G=F.map((J)=>{if(Array.isArray(J)&&J.length===2&&typeof J[1]==="boolean"){let[O,Y]=J,_=Y?"[x] ":"[ ] ",$=this.createChildWriter().write(O).toString().trimEnd();return _+$}let N="[ ] ",K=this.createChildWriter().write(J).toString().trimEnd();return N+K}).map((J)=>`- ${J}`).join(`
+`),this}let G=F.map((J)=>{if(Array.isArray(J)&&J.length===2&&typeof J[1]==="boolean"){let[O,Y]=J,_=Y?"[x] ":"[ ] ",$=this.createChildWriter().write(O).toString().trimEnd();return _+$}let K="[ ] ",N=this.createChildWriter().write(J).toString().trimEnd();return K+N}).map((J)=>`- ${J}`).join(`
 `);return this.parts.push(`${this.padding}${G}
 
 `),this}callout(F,H){let G;if(typeof H==="function"){let O=this.createChildWriter();H(O.enhanced),G=O.toString().trimEnd()}else{let{value:O,isTrusted:Y}=q(H);G=this.safeMode&&!Y?Z(O):O}let J=G.split(`
-`),K=[`[!${F.toUpperCase()}]`,...J].map((O)=>`> ${O}`).join(`
-`);return this.parts.push(`${this.padding}${K}
+`),N=[`[!${F.toUpperCase()}]`,...J].map((O)=>`> ${O}`).join(`
+`);return this.parts.push(`${this.padding}${N}
 
-`),this}heading(F,...H){let G="#".repeat(F),J=H.map((N)=>{let{value:K,isTrusted:O}=q(N);if(this.safeMode&&!O)return Z(K);return K}).join(" ");return this.parts.push(`${this.padding}${G} ${J}
+`),this}heading(F,...H){let G="#".repeat(F),J=H.map((K)=>{let{value:N,isTrusted:O}=q(K);if(this.safeMode&&!O)return Z(N);return N}).join(" ");return this.parts.push(`${this.padding}${G} ${J}
 
-`),this}blockquote(...F){let H=F.map((G)=>{let{value:J,isTrusted:N}=q(G);if(this.safeMode&&!N)return Z(J);return J}).map((G)=>`> ${G}`).join(`
+`),this}blockquote(...F){let H=F.map((G)=>{let{value:J,isTrusted:K}=q(G);if(this.safeMode&&!K)return Z(J);return J}).map((G)=>`> ${G}`).join(`
 >
 `);return this.parts.push(`${this.padding}${H}
 
@@ -50,31 +50,31 @@ ${G}
 
 `),this}get separator(){return this.parts.push(`${this.padding}---
 
-`),this}json(F,H={}){this.validateOutput("json",F,H);let G=typeof F==="string"?F:JSON.stringify(F,null,2);return this.codeblock("json",G)}append(F){let H=F.toString();if(H.length>0)this.parts.push(this.padding+H);return this}get enhanced(){let F=this.safeMode?{bold:X,italic:D,code:A,inline:A,link:E,strike:j,image:L}:{bold:y,italic:V,code:B,inline:h,link:M,strike:I,image:C};return new Proxy(this,{get(H,G){if(typeof G==="string"&&G in F)return F[G];let J=Reflect.get(H,G,H);if(typeof J==="function")return J.bind(H);return J}})}when(F,H){if(F)H(this.enhanced);return this}with(F){return F(this.enhanced),this}tag(F,H){let G;if(typeof H==="function"){let J=this.createChildWriter();H(J.enhanced),G=J.toString()}else{let{value:J,isTrusted:N}=q(H);if(this.safeMode&&!N)G=k(J);else G=J}return this.parts.push(`${this.padding}<${F}>
+`),this}json(F,H={}){this.validateOutput("json",F,H);let G=typeof F==="string"?F:JSON.stringify(F,null,2);return this.codeblock("json",G)}append(F){let H=F.toString();if(H.length>0)this.parts.push(this.padding+H);return this}get enhanced(){let F=this.safeMode?{bold:X,italic:D,code:A,inline:A,link:E,strike:j,image:L}:{bold:y,italic:M,code:B,inline:P,link:I,strike:V,image:C};return new Proxy(this,{get(H,G){if(typeof G==="string"&&G in F)return F[G];let J=Reflect.get(H,G,H);if(typeof J==="function")return J.bind(H);return J}})}when(F,H){if(F)H(this.enhanced);return this}with(F){return F(this.enhanced),this}tag(F,H){let G;if(typeof H==="function"){let J=this.createChildWriter();H(J.enhanced),G=J.toString()}else{let{value:J,isTrusted:K}=q(H);if(this.safeMode&&!K)G=k(J);else G=J}return this.parts.push(`${this.padding}<${F}>
 ${G.trimEnd()}
 </${F}>
 `),this}code(F){let H=this.safeMode?A(F):B(F);return this.parts.push(this.padding+H+`
-`),this}fill(F){let G=this.toString().replace(/\{\{(\w+)\}\}/g,(J,N)=>{let K=F[N];if(K===void 0)return J;return this.safeMode?Z(K):K});return new Q(G,{safe:this.safeMode})}section(F,H,G=2){let J=this.createChildWriter();H(J.enhanced);let N="#".repeat(G),K=this.safeMode?Z(F):F;return this.parts.push(`${this.padding}${N} ${K}
+`),this}section(F,H,G=2){let J=this.createChildWriter();H(J.enhanced);let K="#".repeat(G),N=this.safeMode?Z(F):F;return this.parts.push(`${this.padding}${K} ${N}
 
-${J.toString()}`),this}clone(){let F=new Q(void 0,{safe:this.safeMode});return F.parts=[...this.parts],F}table(F,H){let J=`| ${(this.safeMode?F.map((O)=>Z(O)):F).join(" | ")} |`,N=`| ${F.map(()=>"---").join(" | ")} |`,K=H.map((O)=>{return`| ${(Array.isArray(O)?O.map((_)=>{let $=String(_??"");return this.safeMode?Z($):$}):F.map((_)=>{let $=O[_];if($ instanceof Q)return $.toPlainText();let U=String($??"");return this.safeMode?Z(U):U})).join(" | ")} |`}).join(`
+${J.toString()}`),this}clone(){let F=new Q(void 0,{safe:this.safeMode});return F.parts=[...this.parts],F}table(F,H){let J=`| ${(this.safeMode?F.map((O)=>Z(O)):F).join(" | ")} |`,K=`| ${F.map(()=>"---").join(" | ")} |`,N=H.map((O)=>{return`| ${(Array.isArray(O)?O.map((_)=>{let $=String(_??"");return this.safeMode?Z($):$}):F.map((_)=>{let $=O[_];if($ instanceof Q)return $.toPlainText();let U=String($??"");return this.safeMode?Z(U):U})).join(" | ")} |`}).join(`
 `);return this.parts.push(`${this.padding}${J}
-${N}
 ${K}
+${N}
 
 `),this}definitions(F){let H=Object.entries(F).map(([G,J])=>{if(this.safeMode)return`${X(G)}: ${Z(J)}`;return`**${G}**: ${J}`}).join(`
 `);return this.parts.push(`${this.padding}${H}
 
-`),this}schema(F,H={}){let{format:G="json",title:J,level:N=2,tag:K}=H;if(J)this.heading(N,J);if(K){let O=this.createChildWriter();if(G==="json")O.json(F);else O.yaml(F);return this.tag(K,O)}if(G==="json")return this.json(F);return this.yaml(F)}bold(F){let H=this.safeMode?X(F):y(F);return this.parts.push(this.padding+H+`
-`),this}italic(F){let H=this.safeMode?D(F):V(F);return this.parts.push(this.padding+H+`
-`),this}strike(F){let H=this.safeMode?j(F):I(F);return this.parts.push(this.padding+H+`
-`),this}raw(F){return this.parts.push(F),this}link(F,H){let G=this.safeMode?E(F,H):M(F,H);return this.parts.push(this.padding+G+`
+`),this}schema(F,H={}){let{format:G="json",title:J,level:K=2,tag:N}=H;if(J)this.heading(K,J);if(N){let O=this.createChildWriter();if(G==="json")O.json(F);else O.yaml(F);return this.tag(N,O)}if(G==="json")return this.json(F);return this.yaml(F)}bold(F){let H=this.safeMode?X(F):y(F);return this.parts.push(this.padding+H+`
+`),this}italic(F){let H=this.safeMode?D(F):M(F);return this.parts.push(this.padding+H+`
+`),this}strike(F){let H=this.safeMode?j(F):V(F);return this.parts.push(this.padding+H+`
+`),this}raw(F){return this.parts.push(F),this}link(F,H){let G=this.safeMode?E(F,H):I(F,H);return this.parts.push(this.padding+G+`
 `),this}image(F,H){let G=this.safeMode?L(F,H):C(F,H);return this.parts.push(this.padding+G+`
 `),this}comment(F){return this.parts.push(`${this.padding}<!-- ${F} -->
 
 `),this}yaml(F,H={}){this.validateOutput("yaml",F,H);let G=typeof F==="string"?F:this.toYamlString(F);return this.codeblock("yaml",G)}toYamlString(F,H=0){let G="  ".repeat(H);if(F===null||F===void 0)return"null";if(typeof F==="string"){if(/[:\n#"']/.test(F)||F==="")return`"${F.replace(/"/g,"\\\"")}"`;return F}if(typeof F==="number"||typeof F==="boolean")return String(F);if(Array.isArray(F)){if(F.length===0)return"[]";return F.map((J)=>`${G}- ${this.toYamlString(J,H+1)}`).join(`
-`)}if(typeof F==="object"){let J=Object.entries(F);if(J.length===0)return"{}";return J.map(([N,K])=>{let O=this.toYamlString(K,H+1);if(typeof K==="object"&&K!==null&&!Array.isArray(K))return`${G}${N}:
-${O}`;if(Array.isArray(K))return`${G}${N}:
-${O}`;return`${G}${N}: ${O}`}).join(`
+`)}if(typeof F==="object"){let J=Object.entries(F);if(J.length===0)return"{}";return J.map(([K,N])=>{let O=this.toYamlString(N,H+1);if(typeof N==="object"&&N!==null&&!Array.isArray(N))return`${G}${K}:
+${O}`;if(Array.isArray(N))return`${G}${K}:
+${O}`;return`${G}${K}: ${O}`}).join(`
 `)}return JSON.stringify(F)??"null"}delimit(F,H,G){let J=G instanceof Q?G.toString():G;return this.parts.push(`${this.padding}${F}
 ${J}
 ${H}
@@ -84,12 +84,12 @@ ${H}
 `).slice(1,-1).join(`
 `)}),F=F.replace(/`([^`]+)`/g,"$1"),F=F.replace(/^#{1,6}\s+(.*)$/gm,"$1"),F=F.replace(/\*\*([^*]+)\*\*/g,"$1"),F=F.replace(/\*([^*]+)\*/g,"$1"),F=F.replace(/\[([^\]]+)\]\([^)]+\)/g,"$1"),F=F.replace(/^>\s?/gm,""),F=F.replace(/^---$/gm,""),F=F.replace(/^[-*]\s+/gm,""),F=F.replace(/^\d+\.\s+/gm,""),F=F.replace(/<[^>]+>/g,""),F=F.replace(/\|/g," "),F=F.replace(/^[\s-]+$/gm,""),F=F.replace(/ {2,}/g," "),F=F.replace(/\n{3,}/g,`
 
-`),F.trim()}validateOutput(F,H,G){if(!G.validate)return;let J=H;if(F==="json"&&typeof H==="string")try{J=JSON.parse(H)}catch(K){let O=K instanceof Error?K.message:"Invalid JSON string";throw new R(F,[{path:"$",message:`Invalid JSON string: ${O}`}],G.label)}if(F==="yaml"&&typeof H==="string"&&G.parseYaml)try{J=G.parseYaml(H)}catch(K){let O=K instanceof Error?K.message:"Invalid YAML string";throw new R(F,[{path:"$",message:`Invalid YAML string: ${O}`}],G.label)}let N=G.validate({format:F,data:J,schema:G.schema});if(N.valid)return;throw new R(F,N.issues??[],G.label)}get padding(){if(this._skipNextPadding||this.parts.length===0)return this._skipNextPadding=!1,"";let F=this.parts[this.parts.length-1];if(F.endsWith(`
+`),F.trim()}validateOutput(F,H,G){if(!G.validate)return;let J=H;if(F==="json"&&typeof H==="string")try{J=JSON.parse(H)}catch(N){let O=N instanceof Error?N.message:"Invalid JSON string";throw new R(F,[{path:"$",message:`Invalid JSON string: ${O}`}],G.label)}if(F==="yaml"&&typeof H==="string"&&G.parseYaml)try{J=G.parseYaml(H)}catch(N){let O=N instanceof Error?N.message:"Invalid YAML string";throw new R(F,[{path:"$",message:`Invalid YAML string: ${O}`}],G.label)}let K=G.validate({format:F,data:J,schema:G.schema});if(K.valid)return;throw new R(F,K.issues??[],G.label)}get padding(){if(this._skipNextPadding||this.parts.length===0)return this._skipNextPadding=!1,"";let F=this.parts[this.parts.length-1];if(F.endsWith(`
 
 `))return"";if(F.endsWith(`
 `))return`
 `;return`
 
-`}createListBuilder(){let F=[],H={item:(...G)=>{return F.push(this.createChildWriter().write(...G).toString().trimEnd()),H},task:(G,...J)=>{let N=G?"[x] ":"[ ] ",K=this.createChildWriter().write(...J).toString().trimEnd();return F.push(N+K),H},todo:(...G)=>H.task(!1,...G),done:(...G)=>H.task(!0,...G),unorderedList:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.unorderedList(G[0]);else J.unorderedList(...G);return F.push(J),H},list:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.list(G[0]);else J.list(...G);return F.push(J),H},orderedList:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.orderedList(G[0]);else J.orderedList(...G);return F.push(J),H},comment:(G)=>{let J=this.createChildWriter();return J.comment(G),F.push(J),H},bold:this.safeMode?X:y,italic:this.safeMode?D:V,code:this.safeMode?A:B,inline:this.safeMode?A:h,strike:this.safeMode?j:I,link:this.safeMode?E:M,image:this.safeMode?L:C};return{builder:H,getItems:()=>F}}static empty(){return new Q}static join(...F){let H=new Q;for(let G of F)H.parts.push(G.toString());return H}static fromTemplate(F){return new Q(F)}toString(){return this.parts.join("")}[Symbol.toPrimitive](F){if(F==="number")return Number.NaN;return this.toString()}get[Symbol.toStringTag](){return"ProseWriter"}}var w=(F)=>{let H=()=>new Q(void 0,{safe:F});return Object.assign((...G)=>{return H().write(...G)},{with:(G)=>{return H().with(G)},template:(G)=>{if(F)return H().write(z(G));return H().write(G)},unorderedList:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.unorderedList(G[0]);return J.unorderedList(...G)},list:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.list(G[0]);return J.list(...G)},orderedList:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.orderedList(G[0]);return J.orderedList(...G)},tasks:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.tasks(G[0]);return J.tasks(...G)},callout:(G,J)=>{return H().callout(G,J)},schema:(G,J)=>{return H().schema(G,J)}})},f=w(!0),x=Object.assign(w(!1),{safe:f}),y=(F)=>`**${F instanceof Q?F.toString().trim():F}**`,V=(F)=>`*${F instanceof Q?F.toString().trim():F}*`,B=(F)=>`\`${F instanceof Q?F.toString().trim():F}\``,h=B,I=(F)=>`~~${F instanceof Q?F.toString().trim():F}~~`,M=(F,H)=>`[${F instanceof Q?F.toString().trim():F}](${H})`,C=(F,H)=>`![${F instanceof Q?F.toString().trim():F}](${H})`;export{x as write,Q as ProseWriter};
+`}createListBuilder(){let F=[],H={item:(...G)=>{return F.push(this.createChildWriter().write(...G).toString().trimEnd()),H},task:(G,...J)=>{let K=G?"[x] ":"[ ] ",N=this.createChildWriter().write(...J).toString().trimEnd();return F.push(K+N),H},todo:(...G)=>H.task(!1,...G),done:(...G)=>H.task(!0,...G),unorderedList:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.unorderedList(G[0]);else J.unorderedList(...G);return F.push(J),H},list:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.list(G[0]);else J.list(...G);return F.push(J),H},orderedList:(...G)=>{let J=this.createChildWriter();if(G.length===1&&typeof G[0]==="function")J.orderedList(G[0]);else J.orderedList(...G);return F.push(J),H},comment:(G)=>{let J=this.createChildWriter();return J.comment(G),F.push(J),H},bold:this.safeMode?X:y,italic:this.safeMode?D:M,code:this.safeMode?A:B,inline:this.safeMode?A:P,strike:this.safeMode?j:V,link:this.safeMode?E:I,image:this.safeMode?L:C};return{builder:H,getItems:()=>F}}static empty(){return new Q}static join(...F){let H=new Q;for(let G of F)H.parts.push(G.toString());return H}toString(){return this.parts.join("")}[Symbol.toPrimitive](F){if(F==="number")return Number.NaN;return this.toString()}get[Symbol.toStringTag](){return"ProseWriter"}}var w=(F)=>{let H=()=>new Q(void 0,{safe:F});return Object.assign((...G)=>{return H().write(...G)},{with:(G)=>{return H().with(G)},unorderedList:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.unorderedList(G[0]);return J.unorderedList(...G)},list:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.list(G[0]);return J.list(...G)},orderedList:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.orderedList(G[0]);return J.orderedList(...G)},tasks:(...G)=>{let J=H();if(G.length===1&&typeof G[0]==="function")return J.tasks(G[0]);return J.tasks(...G)},callout:(G,J)=>{return H().callout(G,J)},schema:(G,J)=>{return H().schema(G,J)}})},f=w(!0),x=Object.assign(w(!1),{safe:f}),y=(F)=>`**${F instanceof Q?F.toString().trim():F}**`,M=(F)=>`*${F instanceof Q?F.toString().trim():F}*`,B=(F)=>`\`${F instanceof Q?F.toString().trim():F}\``,P=B,V=(F)=>`~~${F instanceof Q?F.toString().trim():F}~~`,I=(F,H)=>`[${F instanceof Q?F.toString().trim():F}](${H})`,C=(F,H)=>`![${F instanceof Q?F.toString().trim():F}](${H})`;export{x as write,Q as ProseWriter};
 
-//# debugId=ECE9ECE86506912164756E2164756E21
+//# debugId=D534BE926E580A2464756E2164756E21