@ekaone/prompt-kit 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eka Prasetia <ekaone3033@gmail.com> (https://prasetia.me)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,256 @@
+# @ekaone/prompt-kit
+
+A lightweight, zero-dependency prompt template engine for Node.js. Build dynamic AI prompts from inline strings or `.md` files with YAML frontmatter support.
+
+## Installation
+
+```bash
+npm install @ekaone/prompt-kit
+
+pnpm add @ekaone/prompt-kit
+
+yarn add @ekaone/prompt-kit
+
+bun add @ekaone/prompt-kit
+```
+
+## Features
+
+- `{{variable}}` injection with strict or passthrough mode
+- YAML frontmatter parser — zero dependencies, hand-rolled
+- File-based prompt loading from `.md` files
+- Minifier to strip comments and collapse whitespace
+- Lifecycle hooks — `onSuccess` and `onError`
+- Zero dependencies
+- ESM + CJS dual output
+- TypeScript-first
+
+## Quick Start
+
+```ts
+import { build } from "@ekaone/prompt-kit";
+
+const prompt = build(
+  "You are a {{role}} assistant. Help the user with {{topic}}.",
+  { role: "TypeScript", topic: "code review" }
+);
+
+console.log(prompt);
+// → "You are a TypeScript assistant. Help the user with code review."
+```
+
+## API
+
+### `build(template, vars, options?)`
+
+Injects variables into a template string and returns the built prompt.
+
+```ts
+import { build } from "@ekaone/prompt-kit";
+
+const prompt = build(
+  "Summarize {{topic}} in {{words}} words.",
+  { topic: "Rust", words: "100" }
+);
+```
+
+**Parameters**
+
+| Parameter  | Type          | Description                        |
+| ---------- | ------------- | ---------------------------------- |
+| `template` | `string`      | Prompt string with `{{var}}` placeholders |
+| `vars`     | `Vars`        | Key-value map of variable values   |
+| `options`  | `BuildOptions`| Optional config (see below)        |
+
+**BuildOptions**
+
+| Option      | Type                        | Default | Description                                      |
+| ----------- | --------------------------- | ------- | ------------------------------------------------ |
+| `strict`    | `boolean`                   | `true`  | Throw on undefined variables                     |
+| `onSuccess` | `(result: string) => void`  | —       | Called after a successful build                  |
+| `onError`   | `(error: Error) => void`    | —       | Called when build throws                         |
+
+#### Strict mode (default)
+
+Throws if a variable is referenced in the template but not provided in `vars`.
+
+```ts
+build("Hello {{name}}", {});
+// → Error: [prompt-kit] Undefined variable: "{{name}}"
+```
+
+#### Passthrough mode
+
+Leaves undefined `{{variables}}` intact in the output.
+
+```ts
+const prompt = build(
+  "Hello {{name}}, your score is {{score}}.",
+  { name: "Eka" },
+  { strict: false }
+);
+// → "Hello Eka, your score is {{score}}."
+```
+
+#### Lifecycle hooks
+
+```ts
+const prompt = build(
+  "Review {{language}} code.",
+  { language: "TypeScript" },
+  {
+    onSuccess: (result) => console.log("Built:", result.length, "chars"),
+    onError: (err) => console.error("Failed:", err.message),
+  }
+);
+```
+
+---
+
+### `buildFromFile(filePath, vars, options?)`
+
+Loads a `.md` file, parses the frontmatter, and builds the prompt from the body.
+
+```ts
+import { buildFromFile } from "@ekaone/prompt-kit";
+
+const prompt = await buildFromFile("./prompts/review.md", {
+  language: "TypeScript",
+  focus: "type safety",
+});
+```
+
+**Prompt file format** — `./prompts/review.md`
+
+```md
+---
+name: code-review
+version: 1
+tags: [typescript, review]
+---
+You are a senior {{language}} engineer.
+Review the code for correctness, performance, and style.
+Focus on: {{focus}}.
+```
+
+---
+
+### `loadPromptFile(filePath)`
+
+Reads and parses a `.md` file, returning `frontmatter` and `body` separately. Useful for reading metadata without triggering a build.
+
+```ts
+import { loadPromptFile } from "@ekaone/prompt-kit";
+
+const { frontmatter, body } = await loadPromptFile("./prompts/review.md");
+
+console.log(frontmatter.name);    // → "code-review"
+console.log(frontmatter.version); // → 1
+console.log(frontmatter.tags);    // → ["typescript", "review"]
+console.log(body);                // → "You are a senior {{language}} engineer..."
+```
+
+---
+
+### `parseFrontmatter(source)`
+
+Parses a raw markdown string into `{ frontmatter, body }`. Useful when you load file content yourself.
+
+```ts
+import { parseFrontmatter } from "@ekaone/prompt-kit";
+
+const source = `---
+name: summarizer
+model: claude-opus-4-5
+---
+Summarize the following: {{input}}`;
+
+const { frontmatter, body } = parseFrontmatter(source);
+```
+
+**Supported frontmatter value types**
+
+| Type    | Example                   |
+| ------- | ------------------------- |
+| String  | `name: code-review`       |
+| Number  | `version: 1`              |
+| Boolean | `strict: true`            |
+| Array   | `tags: [a, b, c]`         |
+
+---
+
+### `minify(input)`
+
+Strips Markdown comments and collapses excess blank lines. Useful for reducing token usage before sending to an AI SDK.
+
+```ts
+import { buildFromFile, minify } from "@ekaone/prompt-kit";
+
+const raw = await buildFromFile("./prompts/verbose.md", vars);
+const prompt = minify(raw);
+```
+
+Strips `[//]: # (internal note)` style comments and collapses 3+ blank lines into one.
+
+---
+
+## Types
+
+```ts
+type Vars = Record<string, string | number | boolean>;
+
+interface BuildOptions {
+  strict?: boolean;
+  onSuccess?: (result: string) => void;
+  onError?: (error: Error) => void;
+}
+
+interface FrontMatter {
+  [key: string]: string | number | boolean | string[];
+}
+
+interface ParsedPrompt {
+  frontmatter: FrontMatter;
+  body: string;
+}
+```
+
+---
+
+## Real-world pattern
+
+```ts
+import { buildFromFile, minify } from "@ekaone/prompt-kit";
+import Anthropic from "@anthropic-ai/sdk";
+
+const client = new Anthropic();
+
+const prompt = minify(
+  await buildFromFile("./prompts/review.md", {
+    language: "TypeScript",
+    focus: "type safety",
+  })
+);
+
+const response = await client.messages.create({
+  model: "claude-opus-4-5",
+  max_tokens: 1024,
+  messages: [{ role: "user", content: prompt }],
+});
+```
+
+---
+
+## License
+
+MIT © [Eka Prasetia](https://prasetia.me/)
+
+## Links
+
+- [npm Package](https://www.npmjs.com/package/@ekaone/prompt-kit)
+- [GitHub Repository](https://github.com/ekaone/prompt-kit)
+- [Issue Tracker](https://github.com/ekaone/prompt-kit/issues)
+
+---
+
+⭐ If this library helps you, please consider giving it a star on GitHub!

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+type Vars = Record<string, string | number | boolean>;
+interface BuildOptions {
+    /** Throw on undefined variables. Default: true */
+    strict?: boolean;
+    /** Called after a successful build */
+    onSuccess?: (result: string) => void;
+    /** Called when build throws */
+    onError?: (error: Error) => void;
+}
+interface FrontMatter {
+    [key: string]: string | number | boolean | string[];
+}
+interface ParsedPrompt {
+    frontmatter: FrontMatter;
+    body: string;
+}
+
+declare function build(template: string, vars?: Vars, options?: BuildOptions): string;
+
+declare function inject(template: string, vars: Vars, options?: BuildOptions): string;
+
+declare function loadPromptFile(filePath: string): Promise<ParsedPrompt>;
+declare function buildFromFile(filePath: string, vars?: Vars, options?: BuildOptions): Promise<string>;
+
+declare function parseFrontmatter(source: string): ParsedPrompt;
+
+declare function minify(input: string): string;
+
+export { type BuildOptions, type FrontMatter, type ParsedPrompt, type Vars, build, buildFromFile, inject, loadPromptFile, minify, parseFrontmatter };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+type Vars = Record<string, string | number | boolean>;
+interface BuildOptions {
+    /** Throw on undefined variables. Default: true */
+    strict?: boolean;
+    /** Called after a successful build */
+    onSuccess?: (result: string) => void;
+    /** Called when build throws */
+    onError?: (error: Error) => void;
+}
+interface FrontMatter {
+    [key: string]: string | number | boolean | string[];
+}
+interface ParsedPrompt {
+    frontmatter: FrontMatter;
+    body: string;
+}
+
+declare function build(template: string, vars?: Vars, options?: BuildOptions): string;
+
+declare function inject(template: string, vars: Vars, options?: BuildOptions): string;
+
+declare function loadPromptFile(filePath: string): Promise<ParsedPrompt>;
+declare function buildFromFile(filePath: string, vars?: Vars, options?: BuildOptions): Promise<string>;
+
+declare function parseFrontmatter(source: string): ParsedPrompt;
+
+declare function minify(input: string): string;
+
+export { type BuildOptions, type FrontMatter, type ParsedPrompt, type Vars, build, buildFromFile, inject, loadPromptFile, minify, parseFrontmatter };

package/dist/index.js

@@ -0,0 +1,10 @@
+'use strict';var promises=require('fs/promises'),path=require('path');var d=/\{\{(\s*[\w.]+\s*)\}\}/g;function m(t,o,r={}){let{strict:n=true}=r;return t.replace(d,(s,e)=>{let i=e.trim();if(i in o)return String(o[i]);if(n)throw new Error(`[prompt-kit] Undefined variable: "{{${i}}}"`);return s})}function p(t,o={},r={}){let{onSuccess:n,onError:s}=r;try{let e=m(t,o,r);return n?.(e),e}catch(e){let i=e instanceof Error?e:new Error(String(e));throw s?.(i),i}}var y=/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;function g(t){let o=t.indexOf(":");if(o===-1)return null;let r=t.slice(0,o).trim(),n=t.slice(o+1).trim();if(!r)return null;if(n==="true")return [r,true];if(n==="false")return [r,false];let s=Number(n);if(n!==""&&!isNaN(s))return [r,s];if(n.startsWith("[")&&n.endsWith("]")){let e=n.slice(1,-1).split(",").map(i=>i.trim().replace(/^['"]|['"]$/g,"")).filter(Boolean);return [r,e]}return [r,n.replace(/^['"]|['"]$/g,"")]}function a(t){let o=t.match(y);if(!o)return {frontmatter:{},body:t.trim()};let[,r,n]=o,s={};for(let e of r.split(/\r?\n/)){let i=e.trim();if(!i||i.startsWith("#"))continue;let c=g(i);if(c){let[f,l]=c;s[f]=l;}}return {frontmatter:s,body:n.trim()}}async function u(t){let o=path.resolve(t),r;try{r=await promises.readFile(o,"utf-8");}catch{throw new Error(`[prompt-kit] Cannot read file: "${t}"`)}return a(r)}async function E(t,o={},r={}){let{body:n}=await u(t);return p(n,o,r)}var P=/\[\/\/\]:\s*#\s*\(.*?\)\n?/g,w=/\n{3,}/g;function b(t){return t.replace(P,"").replace(w,`
+
+`).trim()}/**
+ * @file index.ts
+ * @description Core entry point for @ekaone/prompt-kit
+ * @author Eka Prasetia
+ * @website https://prasetia.me
+ * @license MIT
+ */exports.build=p;exports.buildFromFile=E;exports.inject=m;exports.loadPromptFile=u;exports.minify=b;exports.parseFrontmatter=a;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/injector.ts","../src/core/builder.ts","../src/parser/frontmatter.ts","../src/loader/file.ts","../src/utils/minify.ts"],"names":["VARIABLE_RE","inject","template","vars","options","strict","match","rawKey","key","build","onSuccess","onError","result","err","error","FRONTMATTER_RE","parseLine","line","colonIdx","raw","num","items","s","parseFrontmatter","source","rawFm","rawBody","frontmatter","trimmed","parsed","value","loadPromptFile","filePath","abs","resolve","readFile","buildFromFile","body","MD_COMMENT_RE","EXCESS_BLANK_RE","minify","input"],"mappings":"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","file":"index.js","sourcesContent":["import type { Vars, BuildOptions } from \"../types/index.js\";\r\n\r\nconst VARIABLE_RE = /\\{\\{(\\s*[\\w.]+\\s*)\\}\\}/g;\r\n\r\nexport function inject(\r\n  template: string,\r\n  vars: Vars,\r\n  options: BuildOptions = {},\r\n): string {\r\n  const { strict = true } = options;\r\n\r\n  return template.replace(VARIABLE_RE, (match, rawKey: string) => {\r\n    const key = rawKey.trim();\r\n    if (key in vars) {\r\n      return String(vars[key]);\r\n    }\r\n    if (strict) {\r\n      throw new Error(`[prompt-kit] Undefined variable: \"{{${key}}}\"`);\r\n    }\r\n    return match; // passthrough — leave {{var}} intact\r\n  });\r\n}\r\n","import { inject } from \"./injector.js\";\r\nimport type { Vars, BuildOptions } from \"../types/index.js\";\r\n\r\nexport function build(\r\n  template: string,\r\n  vars: Vars = {},\r\n  options: BuildOptions = {},\r\n): string {\r\n  const { onSuccess, onError } = options;\r\n\r\n  try {\r\n    const result = inject(template, vars, options);\r\n    onSuccess?.(result);\r\n    return result;\r\n  } catch (err) {\r\n    const error = err instanceof Error ? err : new Error(String(err));\r\n    onError?.(error);\r\n    throw error;\r\n  }\r\n}\r\n","import type { ParsedPrompt, FrontMatter } from \"../types/index.js\";\r\n\r\nconst FRONTMATTER_RE = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/;\r\n\r\n/** Parse a single YAML-like line: key: value */\r\nfunction parseLine(line: string): [string, FrontMatter[string]] | null {\r\n  const colonIdx = line.indexOf(\":\");\r\n  if (colonIdx === -1) return null;\r\n\r\n  const key = line.slice(0, colonIdx).trim();\r\n  const raw = line.slice(colonIdx + 1).trim();\r\n\r\n  if (!key) return null;\r\n\r\n  // Boolean\r\n  if (raw === \"true\") return [key, true];\r\n  if (raw === \"false\") return [key, false];\r\n\r\n  // Number\r\n  const num = Number(raw);\r\n  if (raw !== \"\" && !isNaN(num)) return [key, num];\r\n\r\n  // Inline array: [a, b, c]\r\n  if (raw.startsWith(\"[\") && raw.endsWith(\"]\")) {\r\n    const items = raw\r\n      .slice(1, -1)\r\n      .split(\",\")\r\n      .map((s) => s.trim().replace(/^['\"]|['\"]$/g, \"\"))\r\n      .filter(Boolean);\r\n    return [key, items];\r\n  }\r\n\r\n  // String — strip optional surrounding quotes\r\n  return [key, raw.replace(/^['\"]|['\"]$/g, \"\")];\r\n}\r\n\r\nexport function parseFrontmatter(source: string): ParsedPrompt {\r\n  const match = source.match(FRONTMATTER_RE);\r\n\r\n  if (!match) {\r\n    return { frontmatter: {}, body: source.trim() };\r\n  }\r\n\r\n  const [, rawFm, rawBody] = match;\r\n  const frontmatter: FrontMatter = {};\r\n\r\n  for (const line of rawFm!.split(/\\r?\\n/)) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith(\"#\")) continue;\r\n    const parsed = parseLine(trimmed);\r\n    if (parsed) {\r\n      const [key, value] = parsed;\r\n      frontmatter[key] = value;\r\n    }\r\n  }\r\n\r\n  return { frontmatter, body: rawBody!.trim() };\r\n}\r\n","import { readFile } from \"node:fs/promises\";\r\nimport { resolve } from \"node:path\";\r\nimport { parseFrontmatter } from \"../parser/frontmatter.js\";\r\nimport { build } from \"../core/builder.js\";\r\nimport type { Vars, BuildOptions, ParsedPrompt } from \"../types/index.js\";\r\n\r\nexport async function loadPromptFile(filePath: string): Promise<ParsedPrompt> {\r\n  const abs = resolve(filePath);\r\n  let source: string;\r\n\r\n  try {\r\n    source = await readFile(abs, \"utf-8\");\r\n  } catch {\r\n    throw new Error(`[prompt-kit] Cannot read file: \"${filePath}\"`);\r\n  }\r\n\r\n  return parseFrontmatter(source);\r\n}\r\n\r\nexport async function buildFromFile(\r\n  filePath: string,\r\n  vars: Vars = {},\r\n  options: BuildOptions = {},\r\n): Promise<string> {\r\n  const { body } = await loadPromptFile(filePath);\r\n  return build(body, vars, options);\r\n}\r\n","/** Strip [//]: # (comment) style Markdown comments */\r\nconst MD_COMMENT_RE = /\\[\\/\\/\\]:\\s*#\\s*\\(.*?\\)\\n?/g;\r\n\r\n/** Collapse 3+ blank lines down to a single blank line */\r\nconst EXCESS_BLANK_RE = /\\n{3,}/g;\r\n\r\nexport function minify(input: string): string {\r\n  return input\r\n    .replace(MD_COMMENT_RE, \"\")\r\n    .replace(EXCESS_BLANK_RE, \"\\n\\n\")\r\n    .trim();\r\n}\r\n"]}

package/dist/index.mjs

@@ -0,0 +1,10 @@
+import {readFile}from'fs/promises';import {resolve}from'path';var d=/\{\{(\s*[\w.]+\s*)\}\}/g;function m(t,o,r={}){let{strict:n=true}=r;return t.replace(d,(s,e)=>{let i=e.trim();if(i in o)return String(o[i]);if(n)throw new Error(`[prompt-kit] Undefined variable: "{{${i}}}"`);return s})}function p(t,o={},r={}){let{onSuccess:n,onError:s}=r;try{let e=m(t,o,r);return n?.(e),e}catch(e){let i=e instanceof Error?e:new Error(String(e));throw s?.(i),i}}var y=/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;function g(t){let o=t.indexOf(":");if(o===-1)return null;let r=t.slice(0,o).trim(),n=t.slice(o+1).trim();if(!r)return null;if(n==="true")return [r,true];if(n==="false")return [r,false];let s=Number(n);if(n!==""&&!isNaN(s))return [r,s];if(n.startsWith("[")&&n.endsWith("]")){let e=n.slice(1,-1).split(",").map(i=>i.trim().replace(/^['"]|['"]$/g,"")).filter(Boolean);return [r,e]}return [r,n.replace(/^['"]|['"]$/g,"")]}function a(t){let o=t.match(y);if(!o)return {frontmatter:{},body:t.trim()};let[,r,n]=o,s={};for(let e of r.split(/\r?\n/)){let i=e.trim();if(!i||i.startsWith("#"))continue;let c=g(i);if(c){let[f,l]=c;s[f]=l;}}return {frontmatter:s,body:n.trim()}}async function u(t){let o=resolve(t),r;try{r=await readFile(o,"utf-8");}catch{throw new Error(`[prompt-kit] Cannot read file: "${t}"`)}return a(r)}async function E(t,o={},r={}){let{body:n}=await u(t);return p(n,o,r)}var P=/\[\/\/\]:\s*#\s*\(.*?\)\n?/g,w=/\n{3,}/g;function b(t){return t.replace(P,"").replace(w,`
+
+`).trim()}/**
+ * @file index.ts
+ * @description Core entry point for @ekaone/prompt-kit
+ * @author Eka Prasetia
+ * @website https://prasetia.me
+ * @license MIT
+ */export{p as build,E as buildFromFile,m as inject,u as loadPromptFile,b as minify,a as parseFrontmatter};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/injector.ts","../src/core/builder.ts","../src/parser/frontmatter.ts","../src/loader/file.ts","../src/utils/minify.ts"],"names":["VARIABLE_RE","inject","template","vars","options","strict","match","rawKey","key","build","onSuccess","onError","result","err","error","FRONTMATTER_RE","parseLine","line","colonIdx","raw","num","items","s","parseFrontmatter","source","rawFm","rawBody","frontmatter","trimmed","parsed","value","loadPromptFile","filePath","abs","resolve","readFile","buildFromFile","body","MD_COMMENT_RE","EXCESS_BLANK_RE","minify","input"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { Vars, BuildOptions } from \"../types/index.js\";\r\n\r\nconst VARIABLE_RE = /\\{\\{(\\s*[\\w.]+\\s*)\\}\\}/g;\r\n\r\nexport function inject(\r\n  template: string,\r\n  vars: Vars,\r\n  options: BuildOptions = {},\r\n): string {\r\n  const { strict = true } = options;\r\n\r\n  return template.replace(VARIABLE_RE, (match, rawKey: string) => {\r\n    const key = rawKey.trim();\r\n    if (key in vars) {\r\n      return String(vars[key]);\r\n    }\r\n    if (strict) {\r\n      throw new Error(`[prompt-kit] Undefined variable: \"{{${key}}}\"`);\r\n    }\r\n    return match; // passthrough — leave {{var}} intact\r\n  });\r\n}\r\n","import { inject } from \"./injector.js\";\r\nimport type { Vars, BuildOptions } from \"../types/index.js\";\r\n\r\nexport function build(\r\n  template: string,\r\n  vars: Vars = {},\r\n  options: BuildOptions = {},\r\n): string {\r\n  const { onSuccess, onError } = options;\r\n\r\n  try {\r\n    const result = inject(template, vars, options);\r\n    onSuccess?.(result);\r\n    return result;\r\n  } catch (err) {\r\n    const error = err instanceof Error ? err : new Error(String(err));\r\n    onError?.(error);\r\n    throw error;\r\n  }\r\n}\r\n","import type { ParsedPrompt, FrontMatter } from \"../types/index.js\";\r\n\r\nconst FRONTMATTER_RE = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/;\r\n\r\n/** Parse a single YAML-like line: key: value */\r\nfunction parseLine(line: string): [string, FrontMatter[string]] | null {\r\n  const colonIdx = line.indexOf(\":\");\r\n  if (colonIdx === -1) return null;\r\n\r\n  const key = line.slice(0, colonIdx).trim();\r\n  const raw = line.slice(colonIdx + 1).trim();\r\n\r\n  if (!key) return null;\r\n\r\n  // Boolean\r\n  if (raw === \"true\") return [key, true];\r\n  if (raw === \"false\") return [key, false];\r\n\r\n  // Number\r\n  const num = Number(raw);\r\n  if (raw !== \"\" && !isNaN(num)) return [key, num];\r\n\r\n  // Inline array: [a, b, c]\r\n  if (raw.startsWith(\"[\") && raw.endsWith(\"]\")) {\r\n    const items = raw\r\n      .slice(1, -1)\r\n      .split(\",\")\r\n      .map((s) => s.trim().replace(/^['\"]|['\"]$/g, \"\"))\r\n      .filter(Boolean);\r\n    return [key, items];\r\n  }\r\n\r\n  // String — strip optional surrounding quotes\r\n  return [key, raw.replace(/^['\"]|['\"]$/g, \"\")];\r\n}\r\n\r\nexport function parseFrontmatter(source: string): ParsedPrompt {\r\n  const match = source.match(FRONTMATTER_RE);\r\n\r\n  if (!match) {\r\n    return { frontmatter: {}, body: source.trim() };\r\n  }\r\n\r\n  const [, rawFm, rawBody] = match;\r\n  const frontmatter: FrontMatter = {};\r\n\r\n  for (const line of rawFm!.split(/\\r?\\n/)) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith(\"#\")) continue;\r\n    const parsed = parseLine(trimmed);\r\n    if (parsed) {\r\n      const [key, value] = parsed;\r\n      frontmatter[key] = value;\r\n    }\r\n  }\r\n\r\n  return { frontmatter, body: rawBody!.trim() };\r\n}\r\n","import { readFile } from \"node:fs/promises\";\r\nimport { resolve } from \"node:path\";\r\nimport { parseFrontmatter } from \"../parser/frontmatter.js\";\r\nimport { build } from \"../core/builder.js\";\r\nimport type { Vars, BuildOptions, ParsedPrompt } from \"../types/index.js\";\r\n\r\nexport async function loadPromptFile(filePath: string): Promise<ParsedPrompt> {\r\n  const abs = resolve(filePath);\r\n  let source: string;\r\n\r\n  try {\r\n    source = await readFile(abs, \"utf-8\");\r\n  } catch {\r\n    throw new Error(`[prompt-kit] Cannot read file: \"${filePath}\"`);\r\n  }\r\n\r\n  return parseFrontmatter(source);\r\n}\r\n\r\nexport async function buildFromFile(\r\n  filePath: string,\r\n  vars: Vars = {},\r\n  options: BuildOptions = {},\r\n): Promise<string> {\r\n  const { body } = await loadPromptFile(filePath);\r\n  return build(body, vars, options);\r\n}\r\n","/** Strip [//]: # (comment) style Markdown comments */\r\nconst MD_COMMENT_RE = /\\[\\/\\/\\]:\\s*#\\s*\\(.*?\\)\\n?/g;\r\n\r\n/** Collapse 3+ blank lines down to a single blank line */\r\nconst EXCESS_BLANK_RE = /\\n{3,}/g;\r\n\r\nexport function minify(input: string): string {\r\n  return input\r\n    .replace(MD_COMMENT_RE, \"\")\r\n    .replace(EXCESS_BLANK_RE, \"\\n\\n\")\r\n    .trim();\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@ekaone/prompt-kit",
+  "version": "0.0.1",
+  "description": "TypeScript library for building prompts",
+  "keywords": [
+    "prompt",
+    "kit",
+    "typescript",
+    "library",
+    "prompt-builder"
+  ],
+  "author": {
+    "name": "Eka Prasetia",
+    "email": "ekaone3033@gmail.com",
+    "url": "https://prasetia.me"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ekaone/prompt-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ekaone/prompt-kit/issues"
+  },
+  "homepage": "https://github.com/ekaone/prompt-kit#readme",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/ui": "^4.1.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "pnpm typecheck && pnpm run test && pnpm run clean && tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage"
+  }
+}