@piqit/resolvers 0.0.2

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @piqit/resolvers - Resolver implementations for piq v2
+ *
+ * Provides resolvers for querying structured content:
+ * - fileMarkdown: Query markdown files from filesystem (Node.js/Bun)
+ * - staticContent: Query pre-compiled content (Edge/Workers)
+ *
+ * @packageDocumentation
+ */
+export { fileMarkdown } from "./file-markdown";
+export type { FileMarkdownOptions, FileMarkdownResult } from "./file-markdown";
+export { staticContent, staticResolver } from "./static";
+export { compilePattern, createParamsSchema } from "./path-pattern";
+export type { CompiledPattern, ExtractParams, PathParams, } from "./path-pattern";
+export { parseFrontmatter, extractFrontmatterString, getFrontmatterEndOffset, readFrontmatter, readFrontmatterWithOffset, } from "./frontmatter";
+export { parseMarkdownBody, extractHeadings, slugify, markdownToHtml, readMarkdownBody, readParsedBody, } from "./markdown";
+export type { BodyOptions, BodyResult, BodyShape, Heading, } from "./markdown";
+//# 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;;;;;;;;GAQG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAM9E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMxD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnE,YAAY,EACV,eAAe,EACf,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AAMtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * @piqit/resolvers - Resolver implementations for piq v2
+ *
+ * Provides resolvers for querying structured content:
+ * - fileMarkdown: Query markdown files from filesystem (Node.js/Bun)
+ * - staticContent: Query pre-compiled content (Edge/Workers)
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Filesystem Resolver (Node.js/Bun only)
+// =============================================================================
+export { fileMarkdown } from "./file-markdown";
+// =============================================================================
+// Static Content Resolver (Edge/Workers compatible)
+// =============================================================================
+export { staticContent, staticResolver } from "./static";
+// =============================================================================
+// Path Pattern Utilities
+// =============================================================================
+export { compilePattern, createParamsSchema } from "./path-pattern";
+// =============================================================================
+// Frontmatter Utilities
+// =============================================================================
+export { parseFrontmatter, extractFrontmatterString, getFrontmatterEndOffset, readFrontmatter, readFrontmatterWithOffset, } from "./frontmatter";
+// =============================================================================
+// Markdown Utilities
+// =============================================================================
+export { parseMarkdownBody, extractHeadings, slugify, markdownToHtml, readMarkdownBody, readParsedBody, } from "./markdown";
+//# 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;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,yCAAyC;AACzC,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAExD,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAOnE,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AAEtB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/markdown.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Markdown Body Parsing
+ *
+ * Parses markdown body content to extract:
+ * - Raw markdown text
+ * - HTML (basic conversion)
+ * - Headings with slugs
+ */
+/**
+ * Options for parsing markdown body.
+ */
+export interface BodyOptions {
+    /** Include raw markdown text */
+    raw?: boolean;
+    /** Include HTML conversion */
+    html?: boolean;
+    /** Extract headings with depth and slugs */
+    headings?: boolean;
+}
+/**
+ * A heading extracted from markdown.
+ */
+export interface Heading {
+    /** Heading depth (1-6) */
+    depth: number;
+    /** Heading text content */
+    text: string;
+    /** URL-safe slug */
+    slug: string;
+}
+/**
+ * Result of parsing markdown body.
+ */
+export interface BodyResult {
+    /** Raw markdown text (if requested) */
+    raw?: string;
+    /** HTML content (if requested) */
+    html?: string;
+    /** Extracted headings (if requested) */
+    headings?: Heading[];
+}
+/**
+ * Type-level shape of body result based on options.
+ */
+export type BodyShape<T extends BodyOptions> = {
+    [K in keyof T as T[K] extends true ? K : never]: K extends "raw" ? string : K extends "html" ? string : K extends "headings" ? Heading[] : never;
+};
+/**
+ * Parse markdown body content.
+ *
+ * @param content - The full file content (including frontmatter if present)
+ * @param options - What to extract from the markdown
+ * @returns The requested body parts
+ */
+export declare function parseMarkdownBody(content: string, options: BodyOptions): BodyResult;
+/**
+ * Extract headings from markdown text.
+ *
+ * @param markdown - The raw markdown content
+ * @returns Array of headings with depth, text, and slug
+ */
+export declare function extractHeadings(markdown: string): Heading[];
+/**
+ * Convert text to a URL-safe slug.
+ *
+ * @param text - The text to slugify
+ * @returns A URL-safe slug
+ */
+export declare function slugify(text: string): string;
+/**
+ * Convert markdown to HTML.
+ *
+ * This is a basic implementation that handles common patterns.
+ * For production use, consider using a proper markdown parser.
+ *
+ * @param markdown - The raw markdown content
+ * @returns HTML string
+ */
+export declare function markdownToHtml(markdown: string): string;
+/**
+ * Read just the markdown body from a file (skipping frontmatter).
+ *
+ * @param path - Path to the markdown file
+ * @returns The raw markdown body
+ */
+export declare function readMarkdownBody(path: string): Promise<string>;
+/**
+ * Read and parse markdown body from a file.
+ *
+ * @param path - Path to the markdown file
+ * @param options - What to extract from the markdown
+ * @returns The requested body parts
+ */
+export declare function readParsedBody(path: string, options: BodyOptions): Promise<BodyResult>;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,WAAW,IAAI;KAC5C,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,SAAS,KAAK,GAC5D,MAAM,GACN,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,SAAS,UAAU,GAClB,OAAO,EAAE,GACT,KAAK;CACd,CAAA;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CAoBnF;AAWD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAc3D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2EvD;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAI5F"}

package/dist/markdown.js

@@ -0,0 +1,174 @@
+/**
+ * Markdown Body Parsing
+ *
+ * Parses markdown body content to extract:
+ * - Raw markdown text
+ * - HTML (basic conversion)
+ * - Headings with slugs
+ */
+import { getFrontmatterEndOffset } from "./frontmatter";
+// =============================================================================
+// Markdown Parsing
+// =============================================================================
+/**
+ * Parse markdown body content.
+ *
+ * @param content - The full file content (including frontmatter if present)
+ * @param options - What to extract from the markdown
+ * @returns The requested body parts
+ */
+export function parseMarkdownBody(content, options) {
+    // Strip frontmatter if present
+    const bodyOffset = getFrontmatterEndOffset(content);
+    const rawBody = content.slice(bodyOffset).replace(/^[\r\n]+/, "");
+    const result = {};
+    if (options.raw) {
+        result.raw = rawBody;
+    }
+    if (options.html) {
+        result.html = markdownToHtml(rawBody);
+    }
+    if (options.headings) {
+        result.headings = extractHeadings(rawBody);
+    }
+    return result;
+}
+// =============================================================================
+// Heading Extraction
+// =============================================================================
+/**
+ * Regex to match ATX-style headings (# Heading).
+ */
+const HEADING_REGEX = /^(#{1,6})\s+(.+)$/gm;
+/**
+ * Extract headings from markdown text.
+ *
+ * @param markdown - The raw markdown content
+ * @returns Array of headings with depth, text, and slug
+ */
+export function extractHeadings(markdown) {
+    const headings = [];
+    let match;
+    const regex = new RegExp(HEADING_REGEX.source, "gm");
+    while ((match = regex.exec(markdown)) !== null) {
+        const depth = match[1].length;
+        const text = match[2].trim();
+        const slug = slugify(text);
+        headings.push({ depth, text, slug });
+    }
+    return headings;
+}
+/**
+ * Convert text to a URL-safe slug.
+ *
+ * @param text - The text to slugify
+ * @returns A URL-safe slug
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, "") // Remove non-word chars
+        .replace(/\s+/g, "-") // Replace spaces with dashes
+        .replace(/--+/g, "-") // Replace multiple dashes
+        .replace(/^-|-$/g, ""); // Trim dashes from ends
+}
+// =============================================================================
+// Basic Markdown to HTML
+// =============================================================================
+/**
+ * Convert markdown to HTML.
+ *
+ * This is a basic implementation that handles common patterns.
+ * For production use, consider using a proper markdown parser.
+ *
+ * @param markdown - The raw markdown content
+ * @returns HTML string
+ */
+export function markdownToHtml(markdown) {
+    let html = markdown;
+    // Escape HTML entities first
+    html = html
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    // Headings (must be on their own line)
+    html = html.replace(/^######\s+(.+)$/gm, "<h6>$1</h6>");
+    html = html.replace(/^#####\s+(.+)$/gm, "<h5>$1</h5>");
+    html = html.replace(/^####\s+(.+)$/gm, "<h4>$1</h4>");
+    html = html.replace(/^###\s+(.+)$/gm, "<h3>$1</h3>");
+    html = html.replace(/^##\s+(.+)$/gm, "<h2>$1</h2>");
+    html = html.replace(/^#\s+(.+)$/gm, "<h1>$1</h1>");
+    // Code blocks (fenced)
+    html = html.replace(/```(\w*)\n([\s\S]*?)```/g, (_match, _lang, code) => {
+        return `<pre><code>${code.trim()}</code></pre>`;
+    });
+    // Inline code
+    html = html.replace(/`([^`]+)`/g, "<code>$1</code>");
+    // Bold
+    html = html.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    html = html.replace(/__([^_]+)__/g, "<strong>$1</strong>");
+    // Italic
+    html = html.replace(/\*([^*]+)\*/g, "<em>$1</em>");
+    html = html.replace(/_([^_]+)_/g, "<em>$1</em>");
+    // Links
+    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+    // Images
+    html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img src="$2" alt="$1">');
+    // Horizontal rules
+    html = html.replace(/^---+$/gm, "<hr>");
+    html = html.replace(/^\*\*\*+$/gm, "<hr>");
+    // Unordered lists (simplified)
+    html = html.replace(/^[-*+]\s+(.+)$/gm, "<li>$1</li>");
+    // Ordered lists (simplified)
+    html = html.replace(/^\d+\.\s+(.+)$/gm, "<li>$1</li>");
+    // Wrap consecutive <li> in <ul> or <ol>
+    html = html.replace(/((?:<li>.*<\/li>\n?)+)/g, "<ul>\n$1</ul>\n");
+    // Blockquotes
+    html = html.replace(/^>\s+(.+)$/gm, "<blockquote>$1</blockquote>");
+    // Paragraphs (wrap remaining text blocks)
+    // Split by double newlines and wrap non-block elements
+    const blocks = html.split(/\n\n+/);
+    html = blocks
+        .map((block) => {
+        const trimmed = block.trim();
+        if (!trimmed)
+            return "";
+        // Don't wrap if already a block element
+        if (/^<(h[1-6]|ul|ol|li|pre|blockquote|hr|p)/.test(trimmed) ||
+            /^<\/?(h[1-6]|ul|ol|li|pre|blockquote)>$/.test(trimmed)) {
+            return trimmed;
+        }
+        return `<p>${trimmed.replace(/\n/g, "<br>")}</p>`;
+    })
+        .filter(Boolean)
+        .join("\n");
+    return html;
+}
+// =============================================================================
+// File Reading Utilities
+// =============================================================================
+/**
+ * Read just the markdown body from a file (skipping frontmatter).
+ *
+ * @param path - Path to the markdown file
+ * @returns The raw markdown body
+ */
+export async function readMarkdownBody(path) {
+    const file = Bun.file(path);
+    const content = await file.text();
+    const bodyOffset = getFrontmatterEndOffset(content);
+    return content.slice(bodyOffset).replace(/^\r?\n/, "");
+}
+/**
+ * Read and parse markdown body from a file.
+ *
+ * @param path - Path to the markdown file
+ * @param options - What to extract from the markdown
+ * @returns The requested body parts
+ */
+export async function readParsedBody(path, options) {
+    const file = Bun.file(path);
+    const content = await file.text();
+    return parseMarkdownBody(content, options);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/path-pattern.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Path Pattern Parsing and Matching
+ *
+ * Parses patterns like `{year}/{slug}.md` and provides:
+ * - Type-level extraction of parameters
+ * - Glob pattern generation
+ * - Path matching to extract params
+ * - Path building from params
+ */
+/**
+ * Extract params from a path pattern string at the type level.
+ *
+ * @example
+ * type Params = ExtractParams<'{year}/{slug}.md'>
+ * // = { year: string } & { slug: string }
+ */
+export type ExtractParams<P extends string> = P extends `${string}{${infer Param}}${infer Rest}` ? {
+    [K in Param]: string;
+} & ExtractParams<Rest> : {};
+/**
+ * Simplify a type by flattening intersections.
+ * Converts { a: string } & { b: string } to { a: string; b: string }
+ */
+export type Simplify<T> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * Extract and simplify params from a path pattern.
+ */
+export type PathParams<P extends string> = Simplify<ExtractParams<P>>;
+/**
+ * A compiled path pattern that can match paths and generate globs.
+ */
+export interface CompiledPattern {
+    /**
+     * The original pattern string.
+     */
+    pattern: string;
+    /**
+     * The extracted parameter names.
+     */
+    paramNames: string[];
+    /**
+     * Generate a glob pattern, optionally constraining specific params.
+     *
+     * @param constraints - Optional param values to use instead of wildcards
+     * @returns A glob pattern string
+     *
+     * @example
+     * pattern.toGlob()  // '** / *.md' (with {year}/{slug}.md)
+     * pattern.toGlob({ year: '2024' })  // '2024/*.md'
+     */
+    toGlob(constraints?: Record<string, unknown>): string;
+    /**
+     * Match a path against this pattern and extract params.
+     *
+     * @param path - The file path to match (relative to base)
+     * @returns The extracted params, or null if no match
+     *
+     * @example
+     * pattern.match('2024/hello-world.md')  // { year: '2024', slug: 'hello-world' }
+     * pattern.match('invalid')  // null
+     */
+    match(path: string): Record<string, string> | null;
+    /**
+     * Build a path from params.
+     *
+     * @param params - The param values
+     * @returns The constructed path
+     *
+     * @example
+     * pattern.build({ year: '2024', slug: 'hello' })  // '2024/hello.md'
+     */
+    build(params: Record<string, string>): string;
+}
+/**
+ * Compile a path pattern string into a usable pattern object.
+ *
+ * @param pattern - The pattern string like '{year}/{slug}.md'
+ * @returns A CompiledPattern instance
+ *
+ * @example
+ * const pattern = compilePattern('{year}/{slug}.md')
+ * pattern.toGlob()  // '** / *.md'
+ * pattern.match('2024/hello.md')  // { year: '2024', slug: 'hello' }
+ */
+export declare function compilePattern(pattern: string): CompiledPattern;
+/**
+ * Create a StandardSchema for path params extracted from a pattern.
+ * This is used by the resolver to expose scanParams to piq core.
+ *
+ * @param pattern - The compiled pattern
+ * @returns A StandardSchema that validates param objects
+ */
+export declare function createParamsSchema(pattern: CompiledPattern): import("piqit").StandardSchema<Record<string, string>>;
+//# sourceMappingURL=path-pattern.d.ts.map

package/dist/path-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-pattern.d.ts","sourceRoot":"","sources":["../src/path-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GAC5F;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM;CAAE,GAAG,aAAa,CAAC,IAAI,CAAC,GAC9C,EAAE,CAAA;AAEN;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAElD;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;AAMrE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;IAErD;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAElD;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;CAC9C;AAiBD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAkE/D;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,GACvB,OAAO,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA4BxD"}

package/dist/path-pattern.js

@@ -0,0 +1,130 @@
+/**
+ * Path Pattern Parsing and Matching
+ *
+ * Parses patterns like `{year}/{slug}.md` and provides:
+ * - Type-level extraction of parameters
+ * - Glob pattern generation
+ * - Path matching to extract params
+ * - Path building from params
+ */
+// =============================================================================
+// Pattern Parsing
+// =============================================================================
+/**
+ * Regex to match parameter placeholders in patterns.
+ * Matches {paramName} where paramName is alphanumeric + underscores.
+ */
+const PARAM_REGEX = /\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+/**
+ * Characters that need escaping in regex.
+ */
+const REGEX_ESCAPE = /[.*+?^${}()|[\]\\]/g;
+/**
+ * Compile a path pattern string into a usable pattern object.
+ *
+ * @param pattern - The pattern string like '{year}/{slug}.md'
+ * @returns A CompiledPattern instance
+ *
+ * @example
+ * const pattern = compilePattern('{year}/{slug}.md')
+ * pattern.toGlob()  // '** / *.md'
+ * pattern.match('2024/hello.md')  // { year: '2024', slug: 'hello' }
+ */
+export function compilePattern(pattern) {
+    // Extract all parameter names in order
+    const paramNames = [];
+    let match;
+    const regex = new RegExp(PARAM_REGEX.source, "g");
+    while ((match = regex.exec(pattern)) !== null) {
+        paramNames.push(match[1]);
+    }
+    // Build the match regex by replacing {param} with capturing groups
+    // Each param can match anything except path separators
+    const regexPattern = pattern
+        .replace(REGEX_ESCAPE, (char) => {
+        // Don't escape our param placeholders - we'll handle them separately
+        if (char === "{" || char === "}")
+            return char;
+        return "\\" + char;
+    })
+        .replace(PARAM_REGEX, "([^/]+)");
+    const matchRegex = new RegExp(`^${regexPattern}$`);
+    return {
+        pattern,
+        paramNames,
+        toGlob(constraints) {
+            let glob = pattern;
+            // Replace each param with either its constrained value or a wildcard
+            for (const name of paramNames) {
+                const value = constraints?.[name];
+                if (value !== undefined && value !== null) {
+                    // Use the constrained value
+                    glob = glob.replace(`{${name}}`, String(value));
+                }
+                else {
+                    // Use a wildcard - * matches anything except /
+                    glob = glob.replace(`{${name}}`, "*");
+                }
+            }
+            return glob;
+        },
+        match(path) {
+            const result = matchRegex.exec(path);
+            if (!result)
+                return null;
+            const params = {};
+            for (let i = 0; i < paramNames.length; i++) {
+                params[paramNames[i]] = result[i + 1];
+            }
+            return params;
+        },
+        build(params) {
+            let result = pattern;
+            for (const name of paramNames) {
+                const value = params[name];
+                if (value === undefined) {
+                    throw new Error(`Missing required param: ${name}`);
+                }
+                result = result.replace(`{${name}}`, value);
+            }
+            return result;
+        },
+    };
+}
+// =============================================================================
+// Schema for Path Params
+// =============================================================================
+/**
+ * Create a StandardSchema for path params extracted from a pattern.
+ * This is used by the resolver to expose scanParams to piq core.
+ *
+ * @param pattern - The compiled pattern
+ * @returns A StandardSchema that validates param objects
+ */
+export function createParamsSchema(pattern) {
+    return {
+        "~standard": {
+            version: 1,
+            vendor: "piqit/resolvers",
+            validate(value) {
+                if (value === null || typeof value !== "object") {
+                    return {
+                        issues: [{ message: "Expected object" }],
+                    };
+                }
+                const obj = value;
+                // All params should be strings if present
+                for (const name of pattern.paramNames) {
+                    const val = obj[name];
+                    if (val !== undefined && typeof val !== "string") {
+                        return {
+                            issues: [{ message: `Param ${name} must be a string`, path: [name] }],
+                        };
+                    }
+                }
+                return { value: obj };
+            },
+        },
+    };
+}
+//# sourceMappingURL=path-pattern.js.map

package/dist/path-pattern.js.map

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

package/dist/static.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Static Content Resolver
+ *
+ * A resolver for querying pre-compiled content in edge environments
+ * like Cloudflare Workers where filesystem access is not available.
+ *
+ * Content is compiled at build time and bundled as a static module.
+ *
+ * @example
+ * // 1. Build script compiles content:
+ * // build-content.ts
+ * import { fileMarkdown } from "@piqit/resolvers";
+ * const posts = fileMarkdown({ ... });
+ * const allPosts = await posts.resolve({ scan: {}, filter: {}, select: ["params.*", "frontmatter.*", "body.*"] });
+ * await Bun.write("src/generated/content.ts", `export const posts = ${JSON.stringify(allPosts)};`);
+ *
+ * // 2. Worker imports and uses static resolver:
+ * // worker.ts
+ * import { posts } from "./generated/content";
+ * import { staticContent } from "@piqit/resolvers";
+ * import { piq } from "piqit";
+ *
+ * const postsResolver = staticContent(posts);
+ *
+ * const results = await piq.from(postsResolver)
+ *   .filter({ author: "John" })
+ *   .select("params.slug", "frontmatter.title")
+ *   .exec();
+ */
+import type { Resolver, StandardSchema } from "piqit";
+/**
+ * Create a static content resolver from pre-compiled data.
+ *
+ * This resolver is designed for edge environments like Cloudflare Workers
+ * where filesystem access is not available. Content is compiled at build
+ * time and bundled as a static module.
+ *
+ * @param data - Array of pre-compiled content items
+ * @returns A resolver that queries the static data
+ *
+ * @example
+ * // In your worker:
+ * import { posts } from "./generated/content";
+ * import { staticContent } from "@piqit/resolvers";
+ * import { piq } from "piqit";
+ *
+ * const postsResolver = staticContent(posts);
+ *
+ * export default {
+ *   async fetch(request: Request) {
+ *     const results = await piq.from(postsResolver)
+ *       .scan({ year: "2024" })
+ *       .select("params.slug", "frontmatter.title")
+ *       .exec();
+ *
+ *     return Response.json(results);
+ *   }
+ * };
+ */
+export declare function staticContent<T extends object>(data: T[]): Resolver<StandardSchema<Partial<Record<string, unknown>>>, StandardSchema<Partial<Record<string, unknown>>>, StandardSchema<T>>;
+/**
+ * Alias for staticContent - provides a more descriptive name for the use case.
+ */
+export declare const staticResolver: typeof staticContent;
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AA2HrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,IAAI,EAAE,CAAC,EAAE,GACR,QAAQ,CACT,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAChD,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAChD,cAAc,CAAC,CAAC,CAAC,CAClB,CAiCA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,sBAAgB,CAAA"}