@anydocs/core 1.0.0

package/dist/types/project.d.ts

@@ -0,0 +1,85 @@
+import { type DocsLang } from './docs.ts';
+export declare const SUPPORTED_DOCS_LANGUAGES: readonly ["zh", "en"];
+export declare const DEFAULT_DOCS_THEME_ID = "classic-docs";
+export declare const SUPPORTED_DOCS_CODE_THEMES: readonly ["github-light", "github-dark"];
+export declare const DEFAULT_DOCS_CODE_THEME = "github-dark";
+export type DocsLanguage = DocsLang;
+export type DocsCodeTheme = (typeof SUPPORTED_DOCS_CODE_THEMES)[number];
+export type ProjectSiteThemeBranding = {
+    siteTitle?: string;
+    homeLabel?: string;
+    logoSrc?: string;
+    logoAlt?: string;
+};
+export type ProjectSiteThemeChrome = {
+    showSearch?: boolean;
+};
+export type ProjectSiteThemeColors = {
+    primary?: string;
+    primaryForeground?: string;
+    accent?: string;
+    accentForeground?: string;
+    sidebarActive?: string;
+    sidebarActiveForeground?: string;
+};
+export type ProjectSiteTheme = {
+    id: string;
+    branding?: ProjectSiteThemeBranding;
+    chrome?: ProjectSiteThemeChrome;
+    colors?: ProjectSiteThemeColors;
+    codeTheme?: DocsCodeTheme;
+};
+export type ProjectSiteTopNavLabel = string | Partial<Record<DocsLanguage, string>>;
+export type ProjectSiteTopNavItem = {
+    id: string;
+    type: 'nav-group';
+    groupId: string;
+    label: ProjectSiteTopNavLabel;
+} | {
+    id: string;
+    type: 'external';
+    href: string;
+    openInNewTab?: boolean;
+    label: ProjectSiteTopNavLabel;
+};
+export type ProjectSiteNavigation = {
+    topNav?: ProjectSiteTopNavItem[];
+};
+export type ProjectSiteConfig = {
+    theme: ProjectSiteTheme;
+    navigation?: ProjectSiteNavigation;
+};
+export type ProjectConfig = {
+    version: 1;
+    projectId: string;
+    name: string;
+    defaultLanguage: DocsLanguage;
+    languages: DocsLanguage[];
+    site: ProjectSiteConfig;
+    build?: {
+        outputDir?: string;
+    };
+};
+export type ProjectPathContract = {
+    repoRoot: string;
+    projectRoot: string;
+    configFile: string;
+    workflowFile: string;
+    importsRoot: string;
+    apiSourcesRoot: string;
+    pagesRoot: string;
+    navigationRoot: string;
+    artifactRoot: string;
+    llmsFile: string;
+    machineReadableRoot: string;
+    languageRoots: Record<DocsLanguage, {
+        pagesDir: string;
+        navigationFile: string;
+        searchIndexFile: string;
+    }>;
+};
+export type ProjectContract = {
+    config: ProjectConfig;
+    paths: ProjectPathContract;
+};
+//# sourceMappingURL=project.d.ts.map

package/dist/types/project.d.ts.map

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

package/dist/types/project.js

@@ -0,0 +1,5 @@
+import { DOCS_LANGUAGES } from "./docs.js";
+export const SUPPORTED_DOCS_LANGUAGES = DOCS_LANGUAGES;
+export const DEFAULT_DOCS_THEME_ID = 'classic-docs';
+export const SUPPORTED_DOCS_CODE_THEMES = ['github-light', 'github-dark'];
+export const DEFAULT_DOCS_CODE_THEME = 'github-dark';

package/dist/types/workflow-standard.d.ts

@@ -0,0 +1,51 @@
+import type { PageStatus } from './docs.ts';
+import type { DocsLanguage, ProjectContract } from './project.ts';
+export type WorkflowStandardFile = {
+    id: 'projectConfig' | 'workflowStandard' | 'navigation' | 'page' | 'apiSource' | 'llms' | 'llmsFull' | 'machineReadableRoot' | 'machineReadableIndex' | 'openApiRoot' | 'openApiIndex' | 'searchIndex' | 'chunkIndex';
+    path: string;
+    format: 'json' | 'text' | 'directory';
+    required: boolean;
+    writable: boolean;
+    generated: boolean;
+    description: string;
+};
+export type WorkflowStandardStep = 'loadConfig' | 'loadContent' | 'validate' | 'persistSources' | 'filterPublished' | 'generateArtifacts' | 'reportResult';
+export type WorkflowStandardDefinition = {
+    version: 1;
+    standardId: 'anydocs-phase-1';
+    projectContractVersion: ProjectContract['config']['version'];
+    localFirst: true;
+    uiIndependent: true;
+    supportedLanguages: DocsLanguage[];
+    enabledLanguages: DocsLanguage[];
+    publicationStatuses: PageStatus[];
+    publishedStatuses: Extract<PageStatus, 'published'>[];
+    sourceFiles: WorkflowStandardFile[];
+    generatedArtifacts: WorkflowStandardFile[];
+    contentModel: {
+        projectConfigFields: Array<keyof ProjectContract['config']>;
+        pageRequiredFields: string[];
+        pageOptionalFields: string[];
+        navigationRequiredFields: string[];
+    };
+    orchestration: {
+        workflowSteps: WorkflowStandardStep[];
+        publicationRule: 'published-only';
+        futureCompatibleWithoutReinitialization: true;
+        externalAutomationReady: true;
+    };
+};
+export type WorkflowStandardExport = {
+    definition: WorkflowStandardDefinition;
+    markdownGuide: string;
+};
+export type WorkflowCompatibilityAssessment = {
+    compatible: true;
+    standardId: WorkflowStandardDefinition['standardId'];
+    projectContractVersion: WorkflowStandardDefinition['projectContractVersion'];
+    reusableAcrossProjects: true;
+    futureCompatibleWithoutReinitialization: true;
+    externalAutomationReady: true;
+    validatedAt: string;
+};
+//# sourceMappingURL=workflow-standard.d.ts.map

package/dist/types/workflow-standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-standard.d.ts","sourceRoot":"","sources":["../../src/types/workflow-standard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EACE,eAAe,GACf,kBAAkB,GAClB,YAAY,GACZ,MAAM,GACN,WAAW,GACX,MAAM,GACN,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,aAAa,GACb,cAAc,GACd,aAAa,GACb,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,aAAa,GACb,UAAU,GACV,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;IAC9B,sBAAsB,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,UAAU,EAAE,IAAI,CAAC;IACjB,aAAa,EAAE,IAAI,CAAC;IACpB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;IACtD,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;IAC3C,YAAY,EAAE;QACZ,mBAAmB,EAAE,KAAK,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5D,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,wBAAwB,EAAE,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,aAAa,EAAE;QACb,aAAa,EAAE,oBAAoB,EAAE,CAAC;QACtC,eAAe,EAAE,gBAAgB,CAAC;QAClC,uCAAuC,EAAE,IAAI,CAAC;QAC9C,uBAAuB,EAAE,IAAI,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,0BAA0B,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IACrD,sBAAsB,EAAE,0BAA0B,CAAC,wBAAwB,CAAC,CAAC;IAC7E,sBAAsB,EAAE,IAAI,CAAC;IAC7B,uCAAuC,EAAE,IAAI,CAAC;IAC9C,uBAAuB,EAAE,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/types/workflow-standard.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './slug.ts';
+export * from './yoopta-content.ts';
+export * from './yoopta-render.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export * from "./slug.js";
+export * from "./yoopta-content.js";
+export * from "./yoopta-render.js";

package/dist/utils/slug.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeSlug(slug?: string[] | string): string;
+export declare function assertValidPageId(pageId: string): void;
+//# sourceMappingURL=slug.d.ts.map

package/dist/utils/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/utils/slug.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAQ9D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAStD"}

package/dist/utils/slug.js

@@ -0,0 +1,21 @@
+import { ValidationError } from "../errors/validation-error.js";
+export function normalizeSlug(slug) {
+    if (!slug)
+        return '';
+    const raw = Array.isArray(slug) ? slug.join('/') : slug;
+    return raw
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter(Boolean)
+        .join('/');
+}
+export function assertValidPageId(pageId) {
+    if (!pageId || pageId.includes('/') || pageId.includes('..')) {
+        throw new ValidationError(`Invalid page id "${pageId}".`, {
+            entity: 'page-doc',
+            rule: 'page-id-safe-filename',
+            remediation: 'Use a non-empty page id without path separators or parent-directory traversal.',
+            metadata: { pageId },
+        });
+    }
+}

package/dist/utils/yoopta-content.d.ts

@@ -0,0 +1,13 @@
+export declare const DOCS_YOOPTA_ALLOWED_TYPES: readonly ["Paragraph", "HeadingOne", "HeadingTwo", "HeadingThree", "BulletedList", "NumberedList", "TodoList", "Blockquote", "Code", "CodeGroup", "Divider", "Callout", "Image", "Table", "Link"];
+export declare const DOCS_YOOPTA_ALLOWED_MARKS: readonly ["bold", "italic", "underline", "strike", "code"];
+export declare const DOCS_YOOPTA_AUTHORING_GUIDANCE: readonly ["Prefer structured Yoopta blocks over empty content objects or markdown-only placeholders.", "Use HeadingTwo and HeadingThree to create meaningful section hierarchy for reader TOC extraction.", "Mix paragraphs with lists, callouts, code blocks, tables, images, and links when the source material warrants structure.", "Reserve HeadingOne for title-like leading content only; the reader already has the page title separately.", "Use CodeGroup when presenting the same example in multiple languages or package managers."];
+type YooptaValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateYooptaContentValue(value: unknown): YooptaValidationResult;
+export declare function assertValidYooptaContentValue(value: unknown): void;
+export {};
+//# sourceMappingURL=yoopta-content.d.ts.map

package/dist/utils/yoopta-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yoopta-content.d.ts","sourceRoot":"","sources":["../../src/utils/yoopta-content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,mMAgB5B,CAAC;AAEX,eAAO,MAAM,yBAAyB,4DAM5B,CAAC;AAEX,eAAO,MAAM,8BAA8B,mhBAMjC,CAAC;AAEX,KAAK,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ1E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAwBjF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAOlE"}

package/dist/utils/yoopta-content.js

@@ -0,0 +1,73 @@
+export const DOCS_YOOPTA_ALLOWED_TYPES = [
+    'Paragraph',
+    'HeadingOne',
+    'HeadingTwo',
+    'HeadingThree',
+    'BulletedList',
+    'NumberedList',
+    'TodoList',
+    'Blockquote',
+    'Code',
+    'CodeGroup',
+    'Divider',
+    'Callout',
+    'Image',
+    'Table',
+    'Link',
+];
+export const DOCS_YOOPTA_ALLOWED_MARKS = [
+    'bold',
+    'italic',
+    'underline',
+    'strike',
+    'code',
+];
+export const DOCS_YOOPTA_AUTHORING_GUIDANCE = [
+    'Prefer structured Yoopta blocks over empty content objects or markdown-only placeholders.',
+    'Use HeadingTwo and HeadingThree to create meaningful section hierarchy for reader TOC extraction.',
+    'Mix paragraphs with lists, callouts, code blocks, tables, images, and links when the source material warrants structure.',
+    'Reserve HeadingOne for title-like leading content only; the reader already has the page title separately.',
+    'Use CodeGroup when presenting the same example in multiple languages or package managers.',
+];
+function isRecord(x) {
+    return !!x && typeof x === 'object' && !Array.isArray(x);
+}
+const allowedTypeSet = new Set(DOCS_YOOPTA_ALLOWED_TYPES);
+export function validateYooptaContentValue(value) {
+    if (value == null)
+        return { ok: true };
+    if (!isRecord(value))
+        return { ok: false, error: 'content must be an object' };
+    for (const [key, raw] of Object.entries(value)) {
+        if (!isRecord(raw))
+            return { ok: false, error: `content.${key} must be an object` };
+        const type = raw.type;
+        const id = raw.id;
+        const blockValue = raw.value;
+        if (typeof type !== 'string')
+            return { ok: false, error: `content.${key}.type must be a string` };
+        if (!allowedTypeSet.has(type))
+            return { ok: false, error: `content contains disallowed block type: ${type}` };
+        if (typeof id !== 'string')
+            return { ok: false, error: `content.${key}.id must be a string` };
+        if (!Array.isArray(blockValue))
+            return { ok: false, error: `content.${key}.value must be an array` };
+        const meta = raw.meta;
+        if (meta != null) {
+            if (!isRecord(meta))
+                return { ok: false, error: `content.${key}.meta must be an object` };
+            if (typeof meta.order !== 'number')
+                return { ok: false, error: `content.${key}.meta.order must be a number` };
+            if (typeof meta.depth !== 'number')
+                return { ok: false, error: `content.${key}.meta.depth must be a number` };
+        }
+    }
+    return { ok: true };
+}
+export function assertValidYooptaContentValue(value) {
+    const result = validateYooptaContentValue(value);
+    if (result.ok) {
+        return;
+    }
+    throw new Error(result.error);
+}

package/dist/utils/yoopta-render.d.ts

@@ -0,0 +1,7 @@
+type YooptaRenderResult = {
+    markdown: string;
+    plainText: string;
+};
+export declare function renderYooptaContent(value: unknown): YooptaRenderResult;
+export {};
+//# sourceMappingURL=yoopta-render.d.ts.map

package/dist/utils/yoopta-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yoopta-render.d.ts","sourceRoot":"","sources":["../../src/utils/yoopta-render.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AA0KF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAiBtE"}

package/dist/utils/yoopta-render.js

@@ -0,0 +1,155 @@
+import { assertValidYooptaContentValue } from "./yoopta-content.js";
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function extractText(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(extractText).join('');
+    }
+    if (!isRecord(value)) {
+        return '';
+    }
+    if (typeof value.text === 'string') {
+        return value.text;
+    }
+    if (Array.isArray(value.value)) {
+        return value.value.map(extractText).join('');
+    }
+    if (Array.isArray(value.children)) {
+        return value.children.map(extractText).join('');
+    }
+    return '';
+}
+function normalizeWhitespace(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+function getBlockOrder(value) {
+    if (!isRecord(value) || !isRecord(value.meta) || typeof value.meta.order !== 'number') {
+        return Number.POSITIVE_INFINITY;
+    }
+    return value.meta.order;
+}
+function getFirstValueEntry(block) {
+    if (!isRecord(block) || !Array.isArray(block.value)) {
+        return null;
+    }
+    const entry = block.value[0];
+    return isRecord(entry) ? entry : null;
+}
+function getStringProp(value, key) {
+    if (!isRecord(value) || !isRecord(value.props) || typeof value.props[key] !== 'string') {
+        return undefined;
+    }
+    return value.props[key];
+}
+function getBooleanProp(value, key) {
+    if (!isRecord(value) || !isRecord(value.props) || typeof value.props[key] !== 'boolean') {
+        return undefined;
+    }
+    return value.props[key];
+}
+function renderCodeGroupMarkdown(blockEntry) {
+    if (!Array.isArray(blockEntry.children)) {
+        return '```text\n\n```';
+    }
+    const rendered = blockEntry.children
+        .filter(isRecord)
+        .map((child) => {
+        const title = getStringProp(child, 'title');
+        const language = getStringProp(child, 'language') ?? '';
+        const code = extractText(child.children ?? []).trim();
+        const heading = title ? `#### ${title}\n\n` : '';
+        return `${heading}\`\`\`${language}\n${code}\n\`\`\``;
+    })
+        .filter(Boolean);
+    return rendered.join('\n\n');
+}
+function renderTableMarkdown(blockEntry) {
+    if (!Array.isArray(blockEntry.children)) {
+        return '| |\n| --- |\n| |';
+    }
+    const rows = blockEntry.children
+        .filter(isRecord)
+        .map((row) => Array.isArray(row.children)
+        ? row.children
+            .filter(isRecord)
+            .map((cell) => normalizeWhitespace(extractText(cell.children ?? [])))
+        : [])
+        .filter((cells) => cells.length > 0);
+    if (rows.length === 0) {
+        return '| |\n| --- |\n| |';
+    }
+    const header = rows[0];
+    const separator = header.map(() => '---');
+    const body = rows.slice(1);
+    return [
+        `| ${header.join(' | ')} |`,
+        `| ${separator.join(' | ')} |`,
+        ...body.map((row) => `| ${row.join(' | ')} |`),
+    ].join('\n');
+}
+function renderBlockMarkdown(block) {
+    const type = typeof block.type === 'string' ? block.type : '';
+    const valueEntry = getFirstValueEntry(block);
+    const text = normalizeWhitespace(extractText(block.value));
+    switch (type) {
+        case 'HeadingOne':
+            return text ? `# ${text}` : '#';
+        case 'HeadingTwo':
+            return text ? `## ${text}` : '##';
+        case 'HeadingThree':
+            return text ? `### ${text}` : '###';
+        case 'BulletedList':
+            return text ? `- ${text}` : '-';
+        case 'NumberedList':
+            return text ? `1. ${text}` : '1.';
+        case 'TodoList': {
+            const checked = getBooleanProp(valueEntry, 'checked') === true;
+            return `- [${checked ? 'x' : ' '}] ${text}`;
+        }
+        case 'Blockquote':
+        case 'Callout':
+            return text ? `> ${text}` : '>';
+        case 'Code': {
+            const language = getStringProp(valueEntry, 'language') ?? '';
+            const code = extractText(valueEntry?.children ?? []).trim();
+            return `\`\`\`${language}\n${code}\n\`\`\``;
+        }
+        case 'CodeGroup':
+            return valueEntry ? renderCodeGroupMarkdown(valueEntry) : '```text\n\n```';
+        case 'Divider':
+            return '---';
+        case 'Image': {
+            const src = getStringProp(valueEntry, 'src') ?? '';
+            const alt = getStringProp(valueEntry, 'alt') ?? '';
+            return `![${alt}](${src})`;
+        }
+        case 'Table':
+            return valueEntry ? renderTableMarkdown(valueEntry) : '| |\n| --- |\n| |';
+        case 'Link': {
+            const href = getStringProp(valueEntry, 'href');
+            return href ? `[${text}](${href})` : text;
+        }
+        case 'Paragraph':
+        default:
+            return text;
+    }
+}
+export function renderYooptaContent(value) {
+    assertValidYooptaContentValue(value);
+    if (!isRecord(value)) {
+        return { markdown: '', plainText: '' };
+    }
+    const blocks = Object.values(value).filter(isRecord).sort((left, right) => getBlockOrder(left) - getBlockOrder(right));
+    const markdownBlocks = blocks.map(renderBlockMarkdown).map((block) => block.trim()).filter(Boolean);
+    const plainTextBlocks = blocks
+        .map((block) => normalizeWhitespace(extractText(block.value)))
+        .filter(Boolean);
+    return {
+        markdown: markdownBlocks.join('\n\n'),
+        plainText: plainTextBlocks.join('\n\n'),
+    };
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@anydocs/core",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "pnpm build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.19.1",
+    "typescript": "^5.0.0"
+  }
+}