@fastpaca/cria 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fastpaca
+
+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,165 @@
+<h1 align="center">Cria</h1>
+
+<p align="center">
+  Cria is a tiny library for building LLM prompts as reusable components.
+</p>
+
+<p align="center">
+  <i>Debug, view, and save your prompts easily. Swap out components without major rewrites and test your prompts.</i>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@fastpaca/cria"><img src="https://img.shields.io/npm/v/@fastpaca/cria?logo=npm&logoColor=white" alt="npm"></a>
+  <a href="https://opensource.org/license/mit"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/fastpaca/cria/stargazers">
+    <img src="https://img.shields.io/badge/Give%20a%20Star-Support%20the%20project-orange?style=for-the-badge" alt="Give a Star">
+  </a>
+</p>
+
+Most prompt construction is string concatenation. Append everything to some buffer, hope the important parts survive when you hit limits or want to save cost.
+
+Cria lets you declare what's expendable and what is not, and makes your prompts failure mode explicit.
+
+Cria treats memory layout as a first-class concern. You declare priorities upfront, and the library handles eviction when needed. Components let you test retrieval logic separately from system prompts, swap implementations without rewrites, and debug exactly which content got cut when quality degrades.
+
+```tsx
+const prompt = (
+  <Region priority={0}>
+    You are a helpful assistant.
+
+    {/* Only preserve 80k tokens of history */}
+    <Truncate budget={80000} priority={2}>
+      {conversationHistory}
+    </Truncate>
+
+    {/* Only preserve 20k tokens of tool calls. It gets dropped
+        first in case we need to. */}
+    <Truncate budget={20000} priority={3}>
+      {toolCalls}
+    </Truncate>
+
+    {/* Skip examples in case we are bad on budget */}
+    <Omit priority={3}>{examples}</Omit>
+
+    {userMessage}
+  </Region>
+);
+
+render(prompt, { tokenizer, budget: 128000 });
+```
+
+Cria will drop lower priority sections or truncate them in case it hits your prompt limits.
+## Features
+
+- **Composable** — Build prompts from reusable components. Test and optimize each part independently.
+- **Priority-based** — Declare what's sacred (priority 0) and what's expendable (priority 3). No more guessing what gets cut.
+- **Flexible strategies** — Truncate content progressively, omit entire sections, or write custom eviction logic.
+- **Tiny** — Zero dependencies.
+
+## Getting Started
+
+```bash
+npm install @fastpaca/cria
+```
+
+Add to your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "@fastpaca/cria"
+  }
+}
+```
+
+## Documentation
+
+### Components
+
+**`<Region>`** — The basic building block. Groups content with a priority level.
+
+```jsx
+<Region>
+  <Region priority={0}>System instructions</Region>
+  <Region priority={2}>Retrieved context</Region>
+</Region>
+```
+
+**`<Truncate>`** — Progressively shortens content when over budget.
+
+```jsx
+<Truncate budget={10000} from="start" priority={2}>
+  {longConversation}
+</Truncate>
+```
+
+**`<Omit>`** — Drops entirely when space is needed.
+
+```jsx
+<Omit priority={3}>{optionalExamples}</Omit>
+```
+
+### Priority Levels
+
+Lower number = higher importance.
+
+| Priority | Use for |
+|----------|---------|
+| 0 | System prompt, safety rules |
+| 1 | Current user message, tool outputs |
+| 2 | Conversation history, retrieved docs |
+| 3 | Examples, optional context |
+
+### Tokenizer
+
+Pass any function that counts tokens:
+
+```tsx
+import { encoding_for_model } from "tiktoken";
+
+const enc = encoding_for_model("gpt-4");
+const tokenizer = (text: string) => enc.encode(text).length;
+
+render(prompt, { tokenizer, budget: 128000 });
+```
+
+### Custom Strategies
+
+Write your own eviction logic:
+
+```tsx
+import type { Strategy } from "@fastpaca/cria";
+
+const summarize: Strategy = ({ target, tokenizer }) => {
+  const summary = createSummary(target.content);
+  return [{ ...target, content: summary, tokens: tokenizer(summary) }];
+};
+
+<Region priority={2} strategy={summarize}>{document}</Region>
+```
+
+### Error Handling
+
+```tsx
+import { FitError } from "@fastpaca/cria";
+
+try {
+  render(prompt, { tokenizer, budget: 1000 });
+} catch (e) {
+  if (e instanceof FitError) {
+    console.log(`Over budget by ${e.overBudgetBy} tokens`);
+  }
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © [Fastpaca](https://fastpaca.com)

package/dist/components.d.ts

@@ -0,0 +1,78 @@
+import type { PromptChildren, PromptElement, Strategy } from "./types";
+/** Props for the Region component. */
+interface RegionProps {
+    /** Lower number = higher importance. Default: 0 (highest priority) */
+    priority?: number;
+    /** Optional strategy to apply when this region needs to shrink */
+    strategy?: Strategy;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content of this region */
+    children?: PromptChildren;
+}
+/**
+ * The fundamental building block of Cria prompts—think of it as `<div>`.
+ *
+ * Regions define sections of your prompt with a priority level. During fitting,
+ * regions with higher priority numbers (less important) are reduced first.
+ *
+ * @example
+ * ```tsx
+ * <Region priority={0}>You are a helpful assistant.</Region>
+ * <Region priority={2}>{documents}</Region>
+ * <Region priority={1}>{userMessage}</Region>
+ * ```
+ */
+export declare function Region({ priority, strategy, id, children, }: RegionProps): PromptElement;
+/** Props for the Truncate component. */
+interface TruncateProps {
+    /** Maximum token count for this region's content */
+    budget: number;
+    /** Which end to truncate from. Default: "start" */
+    from?: "start" | "end";
+    /** Lower number = higher importance. Default: 0 */
+    priority?: number;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content to truncate */
+    children?: PromptChildren;
+}
+/**
+ * A region that truncates its content to fit within a token budget.
+ *
+ * When the overall prompt exceeds budget, Truncate regions progressively
+ * remove content from the specified direction until they meet their budget.
+ *
+ * @example
+ * ```tsx
+ * <Truncate budget={20000} priority={2}>
+ *   {conversationHistory}
+ * </Truncate>
+ * ```
+ */
+export declare function Truncate({ budget, from, priority, id, children, }: TruncateProps): PromptElement;
+/** Props for the Omit component. */
+interface OmitProps {
+    /** Lower number = higher importance. Default: 0 */
+    priority?: number;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content that may be omitted */
+    children?: PromptChildren;
+}
+/**
+ * A region that is entirely removed when the prompt needs to shrink.
+ *
+ * Use Omit for "nice to have" content that can be dropped entirely if needed.
+ * When the prompt exceeds budget, Omit regions are removed (lowest priority first).
+ *
+ * @example
+ * ```tsx
+ * <Omit priority={3}>
+ *   {optionalExamples}
+ * </Omit>
+ * ```
+ */
+export declare function Omit({ priority, id, children, }: OmitProps): PromptElement;
+export {};
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,QAAQ,EAET,MAAM,SAAS,CAAC;AAEjB,sCAAsC;AACtC,UAAU,WAAW;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EACrB,QAAY,EACZ,QAAQ,EACR,EAAE,EACF,QAAa,GACd,EAAE,WAAW,GAAG,aAAa,CAO7B;AAED,wCAAwC;AACxC,UAAU,aAAa;IACrB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,IAAc,EACd,QAAY,EACZ,EAAE,EACF,QAAa,GACd,EAAE,aAAa,GAAG,aAAa,CA4C/B;AAED,oCAAoC;AACpC,UAAU,SAAS;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,EACnB,QAAY,EACZ,EAAE,EACF,QAAa,GACd,EAAE,SAAS,GAAG,aAAa,CAS3B"}

package/dist/components.js

@@ -0,0 +1,98 @@
+/**
+ * The fundamental building block of Cria prompts—think of it as `<div>`.
+ *
+ * Regions define sections of your prompt with a priority level. During fitting,
+ * regions with higher priority numbers (less important) are reduced first.
+ *
+ * @example
+ * ```tsx
+ * <Region priority={0}>You are a helpful assistant.</Region>
+ * <Region priority={2}>{documents}</Region>
+ * <Region priority={1}>{userMessage}</Region>
+ * ```
+ */
+export function Region({ priority = 0, strategy, id, children = [], }) {
+    return {
+        priority,
+        children: children,
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+/**
+ * A region that truncates its content to fit within a token budget.
+ *
+ * When the overall prompt exceeds budget, Truncate regions progressively
+ * remove content from the specified direction until they meet their budget.
+ *
+ * @example
+ * ```tsx
+ * <Truncate budget={20000} priority={2}>
+ *   {conversationHistory}
+ * </Truncate>
+ * ```
+ */
+export function Truncate({ budget, from = "start", priority = 0, id, children = [], }) {
+    const strategy = (input) => {
+        const { target, tokenizer } = input;
+        if (target.tokens <= budget) {
+            return [target];
+        }
+        let content = target.content;
+        let tokens = target.tokens;
+        // TODO(v1): Optimize - this calls tokenizer O(n) times. Consider:
+        // - Estimate chars/token ratio, binary search to target
+        // - Cache intermediate token counts
+        while (tokens > budget && content.length > 0) {
+            const charsToRemove = Math.max(1, Math.floor(content.length * 0.1));
+            if (from === "start") {
+                content = content.slice(charsToRemove);
+            }
+            else {
+                content = content.slice(0, -charsToRemove);
+            }
+            tokens = tokenizer(content);
+        }
+        if (content.length === 0) {
+            return [];
+        }
+        return [
+            {
+                content,
+                tokens,
+                priority: target.priority,
+                regionId: target.regionId,
+                index: target.index,
+            },
+        ];
+    };
+    return {
+        priority,
+        children: children,
+        strategy,
+        ...(id && { id }),
+    };
+}
+/**
+ * A region that is entirely removed when the prompt needs to shrink.
+ *
+ * Use Omit for "nice to have" content that can be dropped entirely if needed.
+ * When the prompt exceeds budget, Omit regions are removed (lowest priority first).
+ *
+ * @example
+ * ```tsx
+ * <Omit priority={3}>
+ *   {optionalExamples}
+ * </Omit>
+ * ```
+ */
+export function Omit({ priority = 0, id, children = [], }) {
+    const strategy = () => [];
+    return {
+        priority,
+        children: children,
+        strategy,
+        ...(id && { id }),
+    };
+}
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAC,EACrB,QAAQ,GAAG,CAAC,EACZ,QAAQ,EACR,EAAE,EACF,QAAQ,GAAG,EAAE,GACD;IACZ,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,QAAsC;QAChD,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7B,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,MAAM,EACN,IAAI,GAAG,OAAO,EACd,QAAQ,GAAG,CAAC,EACZ,EAAE,EACF,QAAQ,GAAG,EAAE,GACC;IACd,MAAM,QAAQ,GAAa,CAAC,KAAoB,EAAoB,EAAE;QACpE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE3B,kEAAkE;QAClE,wDAAwD;QACxD,oCAAoC;QACpC,OAAO,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;YACpE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL;gBACE,OAAO;gBACP,MAAM;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,QAAsC;QAChD,QAAQ;QACR,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAYD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,IAAI,CAAC,EACnB,QAAQ,GAAG,CAAC,EACZ,EAAE,EACF,QAAQ,GAAG,EAAE,GACH;IACV,MAAM,QAAQ,GAAa,GAAqB,EAAE,CAAC,EAAE,CAAC;IAEtD,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,QAAsC;QAChD,QAAQ;QACR,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cria - JSX-based prompt renderer with automatic token budget fitting.
+ *
+ * @example
+ * ```tsx
+ * import { render, Region, Truncate, Omit } from "@fastpaca/cria";
+ *
+ * const prompt = (
+ *   <Region priority={0}>
+ *     You are a helpful assistant.
+ *     <Truncate budget={20000} direction="start" priority={2}>
+ *       {conversationHistory}
+ *     </Truncate>
+ *     <Omit priority={3}>
+ *       {optionalContext}
+ *     </Omit>
+ *   </Region>
+ * );
+ *
+ * const result = render(prompt, { tokenizer, budget: 128000 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Omit, Region, Truncate } from "./components";
+export { render } from "./render";
+export type { PromptChildren, PromptElement, PromptFragment, Strategy, StrategyInput, Tokenizer, } from "./types";
+export { FitError } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * Cria - JSX-based prompt renderer with automatic token budget fitting.
+ *
+ * @example
+ * ```tsx
+ * import { render, Region, Truncate, Omit } from "@fastpaca/cria";
+ *
+ * const prompt = (
+ *   <Region priority={0}>
+ *     You are a helpful assistant.
+ *     <Truncate budget={20000} direction="start" priority={2}>
+ *       {conversationHistory}
+ *     </Truncate>
+ *     <Omit priority={3}>
+ *       {optionalContext}
+ *     </Omit>
+ *   </Region>
+ * );
+ *
+ * const result = render(prompt, { tokenizer, budget: 128000 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// biome-ignore lint/performance/noBarrelFile: Entry point for package exports
+export { Omit, Region, Truncate } from "./components";
+export { render } from "./render";
+export { FitError } from "./types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,18 @@
+import type { PromptElement } from "./types";
+type ComponentFn = (props: Props) => PromptElement;
+type Child = PromptElement | string | number | boolean | null | undefined | Child[];
+type Props = Record<string, unknown> & {
+    children?: Child | Child[];
+};
+export declare const Fragment: unique symbol;
+export declare function jsx(type: ComponentFn | typeof Fragment, props: Props): PromptElement;
+export declare function jsxs(type: ComponentFn | typeof Fragment, props: Props): PromptElement;
+export declare namespace JSX {
+    type Element = PromptElement;
+    type IntrinsicElements = {};
+    interface ElementChildrenAttribute {
+        children: unknown;
+    }
+}
+export {};
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;AACnD,KAAK,KAAK,GACN,aAAa,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,EAAE,CAAC;AACZ,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAA;CAAE,CAAC;AAgCtE,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAGpD,wBAAgB,GAAG,CACjB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,aAAa,CASf;AAGD,wBAAgB,IAAI,CAClB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,aAAa,CAEf;AAGD,yBAAiB,GAAG,CAAC;IACnB,KAAY,OAAO,GAAG,aAAa,CAAC;IAEpC,KAAY,iBAAiB,GAAG,EAAE,CAAC;IACnC,UAAiB,wBAAwB;QACvC,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF"}

package/dist/jsx-runtime.js

@@ -0,0 +1,40 @@
+// Normalize children: flatten arrays, filter nullish, coerce numbers to strings
+function normalizeChildren(children) {
+    if (children === undefined || children === null) {
+        return [];
+    }
+    if (typeof children === "boolean") {
+        return [];
+    }
+    if (typeof children === "string") {
+        return [children];
+    }
+    if (typeof children === "number") {
+        return [String(children)];
+    }
+    if (Array.isArray(children)) {
+        const result = [];
+        for (const child of children) {
+            result.push(...normalizeChildren(child));
+        }
+        return result;
+    }
+    // It's a PromptElement
+    return [children];
+}
+// Fragment: just returns children (inlined into parent)
+export const Fragment = Symbol.for("cria.fragment");
+// jsx: called by TypeScript for single child
+export function jsx(type, props) {
+    const children = normalizeChildren(props.children);
+    if (type === Fragment) {
+        // Fragment returns a wrapper element that just holds children
+        return { priority: 0, children };
+    }
+    return type({ ...props, children });
+}
+// jsxs: called by TypeScript for multiple children (same behavior)
+export function jsxs(type, props) {
+    return jsx(type, props);
+}
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAaA,gFAAgF;AAChF,SAAS,iBAAiB,CACxB,QAAqC;IAErC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEpD,6CAA6C;AAC7C,MAAM,UAAU,GAAG,CACjB,IAAmC,EACnC,KAAY;IAEZ,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,8DAA8D;QAC9D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,IAAI,CAClB,IAAmC,EACnC,KAAY;IAEZ,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,44 @@
+import { type PromptElement, type Tokenizer } from "./types";
+/** Options for the render function. */
+interface RenderOptions {
+    /** Function to count tokens in a string (e.g., tiktoken) */
+    tokenizer: Tokenizer;
+    /** Maximum token count for the final output */
+    budget: number;
+}
+/**
+ * Renders a PromptElement tree to a fitted string.
+ *
+ * This is the main entry point for Cria. Takes a JSX tree and returns a string
+ * that fits within the specified token budget.
+ *
+ * **Pipeline:**
+ * 1. `flatten`: Walks the tree, collects text into ordered PromptFragment[]
+ * 2. `fitToBudget`: Applies strategies starting from lowest priority until under budget
+ * 3. `join`: Concatenates fragment content into final string
+ *
+ * @param element - The root PromptElement (from JSX)
+ * @param options - Tokenizer and budget configuration
+ * @returns The fitted prompt string
+ * @throws {FitError} When the prompt cannot fit within budget
+ *
+ * @example
+ * ```tsx
+ * import { render, Region, Omit } from "@fastpaca/cria";
+ *
+ * const prompt = (
+ *   <Region priority={0}>
+ *     System prompt
+ *     <Omit priority={2}>Optional context</Omit>
+ *   </Region>
+ * );
+ *
+ * const result = render(prompt, {
+ *   tokenizer: (text) => Math.ceil(text.length / 4),
+ *   budget: 1000,
+ * });
+ * ```
+ */
+export declare function render(element: PromptElement, { tokenizer, budget }: RenderOptions): string;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAIlB,KAAK,SAAS,EACf,MAAM,SAAS,CAAC;AAEjB,uCAAuC;AACvC,UAAU,aAAa;IACrB,4DAA4D;IAC5D,SAAS,EAAE,SAAS,CAAC;IACrB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,aAAa,EACtB,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,GACnC,MAAM,CAQR"}

package/dist/render.js

@@ -0,0 +1,171 @@
+import { FitError, } from "./types";
+/**
+ * Renders a PromptElement tree to a fitted string.
+ *
+ * This is the main entry point for Cria. Takes a JSX tree and returns a string
+ * that fits within the specified token budget.
+ *
+ * **Pipeline:**
+ * 1. `flatten`: Walks the tree, collects text into ordered PromptFragment[]
+ * 2. `fitToBudget`: Applies strategies starting from lowest priority until under budget
+ * 3. `join`: Concatenates fragment content into final string
+ *
+ * @param element - The root PromptElement (from JSX)
+ * @param options - Tokenizer and budget configuration
+ * @returns The fitted prompt string
+ * @throws {FitError} When the prompt cannot fit within budget
+ *
+ * @example
+ * ```tsx
+ * import { render, Region, Omit } from "@fastpaca/cria";
+ *
+ * const prompt = (
+ *   <Region priority={0}>
+ *     System prompt
+ *     <Omit priority={2}>Optional context</Omit>
+ *   </Region>
+ * );
+ *
+ * const result = render(prompt, {
+ *   tokenizer: (text) => Math.ceil(text.length / 4),
+ *   budget: 1000,
+ * });
+ * ```
+ */
+export function render(element, { tokenizer, budget }) {
+    if (budget <= 0) {
+        return "";
+    }
+    const fragments = flatten(element, tokenizer, { counter: 0 });
+    const fitted = fitToBudget(fragments, budget, tokenizer);
+    return fitted.map((f) => f.content).join("");
+}
+/**
+ * Turns a PromptElement tree into an ordered list of PromptFragment.
+ *
+ * - Preserves text order (flush text buffer before descending into child elements).
+ * - Inherits priority/strategy from the emitting element.
+ * - Assigns regionId: explicit id if provided, else auto-incrementing counter.
+ * - Computes token counts with the provided tokenizer.
+ */
+function flatten(element, tokenizer, ctx, fragments = []) {
+    let buffer = "";
+    const flushBuffer = () => {
+        if (buffer.length === 0) {
+            return;
+        }
+        const tokens = tokenizer(buffer);
+        if (tokens > 0) {
+            const fragment = {
+                content: buffer,
+                tokens,
+                priority: element.priority,
+                regionId: element.id ?? `r${ctx.counter++}`,
+                index: fragments.length,
+            };
+            if (element.strategy) {
+                fragment.strategy = element.strategy;
+            }
+            fragments.push(fragment);
+        }
+        buffer = "";
+    };
+    for (const child of element.children) {
+        if (!child) {
+            continue;
+        }
+        if (typeof child === "string") {
+            buffer += child;
+        }
+        else {
+            // Flush current text before descending to maintain order
+            flushBuffer();
+            flatten(child, tokenizer, ctx, fragments);
+        }
+    }
+    // Flush any trailing text
+    flushBuffer();
+    return fragments;
+}
+/**
+ * Finds the highest priority number (least important) among fragments with strategies.
+ */
+function findLowestImportancePriority(fragments) {
+    const priorities = fragments
+        .filter((f) => f.strategy !== undefined)
+        .map((f) => f.priority);
+    if (priorities.length === 0) {
+        return null;
+    }
+    return Math.max(...priorities);
+}
+/**
+ * Applies a single strategy to its target fragment.
+ * Splices replacements in-place and recomputes token counts.
+ */
+function applyStrategy(result, target, budget, tokenizer, iteration) {
+    const strategy = target.strategy;
+    const targetIndex = result.findIndex((f) => f.regionId === target.regionId);
+    if (targetIndex === -1) {
+        return;
+    }
+    const currentTarget = result[targetIndex];
+    if (!currentTarget) {
+        return;
+    }
+    const input = {
+        fragments: result,
+        target: currentTarget,
+        budget,
+        tokenizer,
+        totalTokens: result.reduce((sum, f) => sum + f.tokens, 0),
+        iteration,
+    };
+    const replacement = strategy(input);
+    // Splice replacement at target position
+    result.splice(targetIndex, 1, ...replacement);
+    // Recompute tokens for modified fragments
+    for (const frag of replacement) {
+        frag.tokens = tokenizer(frag.content);
+    }
+}
+/**
+ * Repeatedly applies strategies starting from the least-important priority
+ * until the total token count is within budget.
+ *
+ * Throws FitError if:
+ * - No progress is made in an iteration (strategies didn't reduce tokens)
+ * - No strategies remain but still over budget
+ */
+function fitToBudget(fragments, budget, tokenizer) {
+    const result = [...fragments];
+    let iteration = 0;
+    const maxIterations = 1000;
+    while (true) {
+        const totalTokens = result.reduce((sum, f) => sum + f.tokens, 0);
+        if (totalTokens <= budget) {
+            return result;
+        }
+        iteration++;
+        if (iteration > maxIterations) {
+            throw new FitError(totalTokens - budget, -1, iteration);
+        }
+        const lowestImportancePriority = findLowestImportancePriority(result);
+        if (lowestImportancePriority === null) {
+            throw new FitError(totalTokens - budget, -1, iteration);
+        }
+        // Collect all targets at this priority
+        const targets = result.filter((f) => f.strategy !== undefined && f.priority === lowestImportancePriority);
+        const tokensBefore = totalTokens;
+        // Apply strategies in stable order
+        for (const target of targets) {
+            applyStrategy(result, target, budget, tokenizer, iteration);
+        }
+        // Check progress
+        const tokensAfter = result.reduce((sum, f) => sum + f.tokens, 0);
+        if (tokensAfter >= tokensBefore) {
+            throw new FitError(tokensAfter - budget, lowestImportancePriority, iteration);
+        }
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/render.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render.test.d.ts.map

package/dist/render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.d.ts","sourceRoot":"","sources":["../src/render.test.tsx"],"names":[],"mappings":""}

package/dist/render.test.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@fastpaca/cria/jsx-runtime";
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { Omit, Region, render, Truncate } from "./index";
+// Simple tokenizer: 1 token per 4 characters (approximates real tokenizers)
+const tokenizer = (text) => Math.ceil(text.length / 4);
+const FIT_ERROR_PATTERN = /Cannot fit prompt/;
+test("render: basic text output", () => {
+    const element = _jsx(Region, { priority: 0, children: "Hello, world!" });
+    const result = render(element, { tokenizer, budget: 100 });
+    assert.strictEqual(result, "Hello, world!");
+});
+test("render: nested regions", () => {
+    const element = (_jsxs(Region, { priority: 0, children: ["Start ", _jsx(Region, { priority: 1, children: "Middle" }), " End"] }));
+    const result = render(element, { tokenizer, budget: 100 });
+    assert.strictEqual(result, "Start Middle End");
+});
+test("render: omit removes region when over budget", () => {
+    const element = (_jsxs(Region, { priority: 0, children: ["Important", " ", _jsx(Omit, { priority: 1, children: "Less important content that should be removed" }), "Also important"] }));
+    const resultLarge = render(element, { tokenizer, budget: 100 });
+    assert.ok(resultLarge.includes("Less important"));
+    const resultSmall = render(element, { tokenizer, budget: 10 });
+    assert.ok(!resultSmall.includes("Less important"));
+    assert.ok(resultSmall.includes("Important"));
+});
+test("render: truncate reduces content", () => {
+    const longContent = "A".repeat(100);
+    const element = (_jsxs(Region, { priority: 0, children: ["Header", " ", _jsx(Truncate, { budget: 5, priority: 1, children: longContent })] }));
+    const result = render(element, { tokenizer, budget: 10 });
+    assert.ok(result.length < 100);
+    assert.ok(result.includes("Header"));
+});
+test("render: priority ordering - lower priority removed first", () => {
+    const element = (_jsxs(Region, { priority: 0, children: [_jsx(Region, { priority: 0, children: "Critical" }), _jsx(Omit, { priority: 1, children: "Medium importance" }), _jsx(Omit, { priority: 2, children: "Low importance" })] }));
+    const result = render(element, { tokenizer, budget: 5 });
+    assert.ok(result.includes("Critical"));
+    assert.ok(!result.includes("Medium"));
+    assert.ok(!result.includes("Low"));
+});
+test("render: throws FitError when cannot fit", () => {
+    const element = (_jsx(Region, { priority: 0, children: "This content has no strategy and cannot be reduced" }));
+    assert.throws(() => render(element, { tokenizer, budget: 1 }), FIT_ERROR_PATTERN);
+});
+test("render: multiple strategies at same priority applied together", () => {
+    const element = (_jsxs(Region, { priority: 0, children: [_jsx(Omit, { id: "a", priority: 1, children: "AAA" }), _jsx(Omit, { id: "b", priority: 1, children: "BBB" })] }));
+    const result = render(element, { tokenizer, budget: 0 });
+    assert.strictEqual(result, "");
+});
+//# sourceMappingURL=render.test.js.map

package/dist/render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../src/render.test.tsx"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * What can be passed as children to a Cria component.
+ *
+ * Includes all JSX-compatible values: elements, strings, numbers, booleans,
+ * null/undefined (ignored), and arrays (flattened). The jsx-runtime normalizes
+ * these into `(PromptElement | string)[]` before storing in the element.
+ *
+ * @example
+ * ```tsx
+ * <Region>
+ *   {"Hello"}
+ *   {123}
+ *   {items.map(item => <Region>{item}</Region>)}
+ * </Region>
+ * ```
+ */
+export type PromptChildren = PromptElement | string | number | boolean | null | undefined | readonly PromptChildren[];
+/**
+ * The core IR node type. All Cria components return a PromptElement.
+ *
+ * This is the normalized representation after JSX transformation.
+ * The render pipeline traverses this tree to produce fragments for fitting.
+ *
+ * @property priority - Lower number = higher importance (kept longer during fitting)
+ * @property strategy - Optional function to reduce this region when over budget
+ * @property id - Optional stable identifier for caching/debugging
+ * @property children - Normalized array of child elements and text
+ *
+ * @example
+ * ```tsx
+ * // Created via JSX:
+ * <Region priority={0}>System prompt</Region>
+ *
+ * // Produces:
+ * { priority: 0, children: ["System prompt"] }
+ * ```
+ */
+export interface PromptElement {
+    priority: number;
+    strategy?: Strategy;
+    id?: string;
+    children: (PromptElement | string)[];
+}
+/**
+ * A flattened text fragment produced by the render pipeline.
+ *
+ * The render step walks the PromptElement tree and emits an ordered list of
+ * fragments. The fit loop then applies strategies to reduce token count.
+ *
+ * @property content - The text content of this fragment
+ * @property tokens - Token count (computed via the provided tokenizer)
+ * @property priority - Inherited from the emitting element
+ * @property regionId - Stable identifier (from element.id or auto-generated)
+ * @property strategy - If present, this fragment can be reduced during fitting
+ * @property index - Position in the fragment list (for stable ordering)
+ */
+export interface PromptFragment {
+    content: string;
+    tokens: number;
+    priority: number;
+    regionId: string;
+    strategy?: Strategy;
+    index: number;
+}
+/**
+ * A strategy function that reduces a fragment when the prompt is over budget.
+ *
+ * Strategies are called during the fit loop, starting with the least important
+ * priority (highest number). They receive context about the current state and
+ * must return replacement fragments (or empty array to remove entirely).
+ *
+ * Strategies must be:
+ * - **Pure**: Don't mutate the input fragments
+ * - **Deterministic**: Same input = same output
+ * - **Idempotent**: Applying twice has no additional effect
+ *
+ * @example
+ * ```typescript
+ * // A strategy that removes the fragment entirely
+ * const omitStrategy: Strategy = () => [];
+ *
+ * // A strategy that truncates from the end
+ * const truncateStrategy: Strategy = ({ target, tokenizer }) => {
+ *   let content = target.content.slice(0, 100);
+ *   return [{ ...target, content, tokens: tokenizer(content) }];
+ * };
+ * ```
+ */
+export type Strategy = (input: StrategyInput) => PromptFragment[];
+/**
+ * Context passed to strategy functions during the fit loop.
+ *
+ * @property fragments - All current fragments (readonly, don't mutate)
+ * @property target - The specific fragment this strategy should reduce
+ * @property budget - The total token budget we're trying to fit within
+ * @property tokenizer - Function to count tokens in a string
+ * @property totalTokens - Current total token count across all fragments
+ * @property iteration - Which iteration of the fit loop (for debugging)
+ */
+export interface StrategyInput {
+    fragments: readonly PromptFragment[];
+    target: PromptFragment;
+    budget: number;
+    tokenizer: Tokenizer;
+    totalTokens: number;
+    iteration: number;
+}
+/**
+ * A function that counts tokens in a string.
+ *
+ * Cria doesn't bundle a tokenizer—you provide one. Common choices:
+ * - `tiktoken` for OpenAI models (cl100k_base for GPT-4)
+ * - Simple approximation: `text => Math.ceil(text.length / 4)`
+ *
+ * @example
+ * ```typescript
+ * import { encoding_for_model } from "tiktoken";
+ *
+ * const enc = encoding_for_model("gpt-4");
+ * const tokenizer: Tokenizer = (text) => enc.encode(text).length;
+ * ```
+ */
+export type Tokenizer = (text: string) => number;
+/**
+ * Error thrown when the prompt cannot be fit within the budget.
+ *
+ * This happens when:
+ * - No strategies remain but still over budget
+ * - Strategies made no progress (possible infinite loop)
+ *
+ * @property overBudgetBy - How many tokens over budget
+ * @property priority - The priority level where fitting failed (-1 if no strategies)
+ * @property iteration - Which iteration of the fit loop failed
+ */
+export declare class FitError extends Error {
+    overBudgetBy: number;
+    priority: number;
+    iteration: number;
+    constructor(overBudgetBy: number, priority: number, iteration: number);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,cAAc,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,cAAc,EAAE,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;gBAEN,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAStE"}

package/dist/types.js

@@ -0,0 +1,24 @@
+/**
+ * Error thrown when the prompt cannot be fit within the budget.
+ *
+ * This happens when:
+ * - No strategies remain but still over budget
+ * - Strategies made no progress (possible infinite loop)
+ *
+ * @property overBudgetBy - How many tokens over budget
+ * @property priority - The priority level where fitting failed (-1 if no strategies)
+ * @property iteration - Which iteration of the fit loop failed
+ */
+export class FitError extends Error {
+    overBudgetBy;
+    priority;
+    iteration;
+    constructor(overBudgetBy, priority, iteration) {
+        super(`Cannot fit prompt: ${overBudgetBy} tokens over budget at priority ${priority} (iteration ${iteration})`);
+        this.name = "FitError";
+        this.overBudgetBy = overBudgetBy;
+        this.priority = priority;
+        this.iteration = iteration;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwIA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,CAAS;IACrB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAElB,YAAY,YAAoB,EAAE,QAAgB,EAAE,SAAiB;QACnE,KAAK,CACH,sBAAsB,YAAY,mCAAmC,QAAQ,eAAe,SAAS,GAAG,CACzG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fastpaca/cria",
+  "version": "0.0.1",
+  "description": "Lightweight, fast, and tiny LLM Context & Memory layout renderer to enforce token budgets in long running agents.",
+  "license": "MIT",
+  "author": "seb@fastpaca.com",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "check": "ultracite check",
+    "fix": "ultracite fix",
+    "test": "tsx --test src/**/*.test.tsx",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.10",
+    "@types/node": "^22.0.0",
+    "husky": "^9.1.7",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "ultracite": "^6.5.0"
+  }
+}