@artkit-ai/core 0.1.0 → 0.2.0

package/dist/adapter.d.ts

@@ -0,0 +1,119 @@
+import type { z } from 'zod';
+import type { ErrorIssue } from './errors.js';
+import type { Theme } from './theme.js';
+/** Contract every native format implements (spec §8). Adapters own all knowledge about their format. */
+export interface FormatAdapter<Content = unknown, Operation = unknown> {
+    /** Format name stored in the envelope: `markdown`, `univer-sheet`, `openui`. */
+    format: string;
+    /** Version of the native format or third-party library the content is written with (e.g. `univer-sheet@0.x`). */
+    formatVersion: string;
+    /** Format versions this adapter can read; `formatVersion` is the one it writes. */
+    readableVersions: string[];
+    label: string;
+    /** Smallest valid content, used when an artifact is created from operations only. */
+    empty(): Content;
+    /** Validates content (already parsed from the store or from the model). Throws nothing; reports issues. */
+    validate(content: unknown, ctx: AdapterContext): ValidationResult<Content>;
+    operationSchema: z.ZodType<Operation>;
+    /**
+     * Applies a run of content operations on a draft. The draft is a private copy; mutations are kept only when the
+     * whole batch succeeds. Must not read the clock, the network or randomness.
+     */
+    apply(content: Content, operations: Operation[], ctx: AdapterContext): Promise<ApplyResult<Content>>;
+    /** Compact reading for the model (outline, section, range, full), with budget and cursor. */
+    read(content: Content, request: ReadRequest): ReadResult;
+    diff(before: Content, after: Content, locale?: string): ChangeSummary[];
+    lint(content: Content, ctx: LintContext): LintIssue[];
+    /** Best-effort preview while the model streams; drops incomplete trailing items. Returns undefined when unusable. */
+    parsePartial(raw: string): Content | undefined;
+    migrations: FormatMigration[];
+    /** Counters checked against `limits` (same keys as `measure`). */
+    limits: FormatLimits;
+    measure?(content: Content): Record<string, number>;
+    instructions: FormatInstructions;
+}
+export interface AdapterContext {
+    locale: string;
+    theme: Theme;
+    /** Fails the batch with `OPERATION_FAILED`; the message and hint are written for the model to fix the call. */
+    fail(message: string, options?: {
+        hint?: string;
+        path?: string;
+    }): never;
+}
+export type ValidationResult<Content> = {
+    ok: true;
+    content: Content;
+} | {
+    ok: false;
+    issues: ErrorIssue[];
+};
+export interface ApplyResult<Content> {
+    content: Content;
+    /** Anchors, declarations, ranges or sheets created by the batch (e.g. `escopo`, `kpi1`, `Resumo!A1:D3`). */
+    createdRefs: string[];
+    warnings: LintIssue[];
+}
+export type ReadMode = 'outline' | 'section' | 'statements' | 'range' | 'full';
+export interface ReadRequest {
+    mode: ReadMode;
+    /** Format-specific selection: anchors, A1 range, declaration names. */
+    range?: string;
+    /** Token budget; text is cut at an item boundary and a cursor is returned. */
+    maxTokens?: number;
+    cursor?: string;
+    locale: string;
+    charsPerToken?: number;
+}
+export interface ReadResult {
+    text: string;
+    truncated: boolean;
+    /** Present when truncated: pass it back to continue reading. */
+    cursor?: string;
+}
+export type LintSeverity = 'warning' | 'info';
+export interface LintIssue {
+    code: string;
+    severity: LintSeverity;
+    /** `section:cronograma`, `cell:Resumo!D14`, `slide:cronograma`, `node:api`… */
+    target: string;
+    message: string;
+    hint?: string;
+}
+export interface LintContext {
+    locale: string;
+    theme: Theme;
+}
+export type ChangeType = 'added' | 'removed' | 'changed' | 'moved';
+export interface ChangeSummary {
+    type: ChangeType;
+    /** Same vocabulary as lint targets; the core compares these to detect rebase conflicts. */
+    target: string;
+    summary: string;
+}
+export interface FormatMigration {
+    from: string;
+    to: string;
+    migrate(content: unknown): unknown;
+}
+export type FormatLimits = Record<string, number>;
+export interface FormatExample {
+    title: string;
+    operations?: unknown[];
+    content?: unknown;
+}
+export interface FormatInstructions {
+    /** What the format is and when to use it. */
+    summary: string;
+    /** Short, verifiable rules. */
+    rules: string[];
+    examples: FormatExample[];
+}
+export type AnyFormatAdapter = FormatAdapter<any, any>;
+export declare class FormatDefinitionError extends Error {
+    constructor(format: string, problem: string);
+}
+/** Checks an adapter's shape. The registry runs it on `register`; third-party adapters can call it directly. */
+export declare function defineFormat<Content, Operation>(adapter: FormatAdapter<Content, Operation>): FormatAdapter<Content, Operation>;
+export declare function assertFormatContract(adapter: AnyFormatAdapter): void;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,45 @@
+export class FormatDefinitionError extends Error {
+    constructor(format, problem) {
+        super(`Invalid format "${format}": ${problem}`);
+        this.name = 'FormatDefinitionError';
+    }
+}
+const FORMAT_NAME = /^[a-z][a-z0-9-]{0,63}$/;
+const VERSION_NAME = /^[a-z0-9][a-z0-9.+@-]{0,63}$/i;
+/** Checks an adapter's shape. The registry runs it on `register`; third-party adapters can call it directly. */
+export function defineFormat(adapter) {
+    assertFormatContract(adapter);
+    return adapter;
+}
+export function assertFormatContract(adapter) {
+    const name = typeof adapter?.format === 'string' ? adapter.format : '<unnamed>';
+    if (!FORMAT_NAME.test(name))
+        throw new FormatDefinitionError(name, 'format must match /^[a-z][a-z0-9-]{0,63}$/');
+    if (typeof adapter.formatVersion !== 'string' || !VERSION_NAME.test(adapter.formatVersion)) {
+        throw new FormatDefinitionError(name, 'formatVersion must be a non-empty version string');
+    }
+    if (!Array.isArray(adapter.readableVersions) || !adapter.readableVersions.includes(adapter.formatVersion)) {
+        throw new FormatDefinitionError(name, 'readableVersions must include formatVersion');
+    }
+    if (!(adapter.operationSchema && typeof adapter.operationSchema.safeParse === 'function')) {
+        throw new FormatDefinitionError(name, 'operationSchema must be a zod schema');
+    }
+    for (const fn of ['empty', 'validate', 'apply', 'read', 'diff', 'lint', 'parsePartial']) {
+        if (typeof adapter[fn] !== 'function')
+            throw new FormatDefinitionError(name, `${fn} must be a function`);
+    }
+    if (!Array.isArray(adapter.migrations))
+        throw new FormatDefinitionError(name, 'migrations must be an array');
+    for (const migration of adapter.migrations) {
+        if (!adapter.readableVersions.includes(migration.from) ||
+            !adapter.readableVersions.includes(migration.to)) {
+            throw new FormatDefinitionError(name, `migration ${migration.from}→${migration.to} must use readable versions`);
+        }
+    }
+    if (!adapter.instructions ||
+        typeof adapter.instructions.summary !== 'string' ||
+        !Array.isArray(adapter.instructions.rules)) {
+        throw new FormatDefinitionError(name, 'instructions need summary, rules and examples');
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AA6HA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,mBAAmB,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAC7C,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD,gHAAgH;AAChH,MAAM,UAAU,YAAY,CAC1B,OAA0C;IAE1C,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,MAAM,IAAI,GAAG,OAAO,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IAChF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,4CAA4C,CAAC,CAAC;IACtF,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,kDAAkD,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1G,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,OAAO,CAAC,eAAe,CAAC,SAAS,KAAK,UAAU,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,sCAAsC,CAAC,CAAC;IAChF,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAU,EAAE,CAAC;QACjG,IAAI,OAAO,OAAO,CAAC,EAAE,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;QACpC,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;IACvE,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3C,IACE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;YAClD,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,EAChD,CAAC;YACD,MAAM,IAAI,qBAAqB,CAC7B,IAAI,EACJ,aAAa,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,6BAA6B,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IACE,CAAC,OAAO,CAAC,YAAY;QACrB,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,KAAK,QAAQ;QAChD,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAC1C,CAAC;QACD,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

package/dist/diff.d.ts

@@ -1,4 +1,4 @@
-import type { ChangeSummary } from './kind.js';
+import type { ChangeSummary } from './adapter.js';
 export interface CollectionDiffOptions<T> {
     /** Target prefix, e.g. `block`, `slide`, `node`. */
     prefix: string;

package/dist/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAC7B,kCAAkC;IAClC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7C,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEzD;AAID,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,aAAa,EAAE,CA8DjB;AAsCD,8DAA8D;AAC9D,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,EAAE,CAuBjB"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAC7B,kCAAkC;IAClC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7C,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEzD;AAID,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,aAAa,EAAE,CA8DjB;AAsCD,8DAA8D;AAC9D,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,EAAE,CAuBjB"}

package/dist/engine.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
+import type { AdapterContext, AnyFormatAdapter, ChangeSummary, LintIssue } from './adapter.js';
 import { type Artifact } from './envelope.js';
 import { formatPath } from './errors.js';
-import type { AnyArtifactKind, ChangeSummary, LintIssue } from './kind.js';
 import type { ArtifactRegistry } from './registry.js';
-/** Envelope operations, available for every kind and handled by the core (spec §8.4). */
+/** Envelope operations, available for every format and handled by the core (spec §9.3). */
 export declare const envelopeOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"set_title">;
     title: z.ZodString;
@@ -22,48 +22,54 @@ export declare const ENVELOPE_OPERATIONS: readonly ['set_title', 'set_theme', 's
 export declare function isEnvelopeOperation(op: unknown): boolean;
 /** Lists the `op` names of a discriminated union schema (best effort, used for hints). */
 export declare function operationNames(schema: z.ZodType): string[];
+/** Adapter validation + limits. Throws INVALID_CONTENT or LIMIT_EXCEEDED. Returns the normalized content. */
+export declare function validateContent(registry: ArtifactRegistry, adapter: AnyFormatAdapter, raw: unknown, ctx: AdapterContext): unknown;
+export declare function checkLimits(registry: ArtifactRegistry, adapter: AnyFormatAdapter, content: unknown, locale?: string): void;
 export interface PreparedContent<Content = unknown> {
     content: Content;
-    ids: string[];
     lint: LintIssue[];
 }
-export interface EngineOptions {
-    locale?: string;
-}
-/** Schema + integrity + unique ids + limits. Throws INVALID_CONTENT or LIMIT_EXCEEDED. */
-export declare function validateContent(registry: ArtifactRegistry, kind: AnyArtifactKind, raw: unknown, locale?: string): unknown;
-export declare function checkLimits(registry: ArtifactRegistry, kind: AnyArtifactKind, content: unknown, locale?: string): void;
 /**
  * Turns raw content (from the model, a user or an alternative input) into valid content:
- * sanitize → normalize ids → derive → validate → limits. Pure.
+ * sanitize → validate → limits → lint. Pure.
  */
-export declare function prepareContent(registry: ArtifactRegistry, kindName: string, raw: unknown, options?: EngineOptions & {
-    theme?: string;
+export declare function prepareContent(registry: ArtifactRegistry, formatName: string, raw: unknown, options?: {
+    locale?: string;
+    themeId?: string;
 }): PreparedContent;
+export type ParsedOperation = {
+    kind: 'envelope';
+    op: EnvelopeOperation;
+} | {
+    kind: 'content';
+    op: unknown;
+};
 export interface BatchResult<Content = unknown> {
     content: Content;
-    schemaVersion: number;
+    formatVersion: string;
     title: string;
     themeId: string;
     locale: string;
-    /** Ids that exist after the batch and did not exist before. */
-    createdIds: string[];
+    /** Anchors, declarations, ranges or sheets created by the batch. */
+    createdRefs: string[];
     diff: ChangeSummary[];
     lint: LintIssue[];
 }
 /** Parses and sanitizes a batch. Throws INVALID_OPERATION with the index of the first bad operation. */
-export declare function parseOperations(registry: ArtifactRegistry, kindName: string, operations: unknown, locale?: string): unknown[];
+export declare function parseOperations(registry: ArtifactRegistry, formatName: string, operations: unknown, locale?: string): ParsedOperation[];
 /**
- * Applies a batch atomically and purely (spec §8.2 steps 4–8): validate every operation, clone,
- * apply in sequence, derive, revalidate the whole content and limits, then diff and lint.
- * Any failure throws and leaves the input untouched.
+ * Applies a batch atomically (spec §9.1, steps 4–7). Operations run in order: runs of content operations go to the
+ * adapter, envelope operations and `replace_content` are handled here. Any failure throws and leaves the input
+ * untouched, since everything works on copies.
  */
-export declare function applyOperations(registry: ArtifactRegistry, artifact: Pick<Artifact, 'kind' | 'content' | 'title' | 'themeId' | 'locale'>, operations: unknown, options?: EngineOptions): BatchResult;
+export declare function applyOperations(registry: ArtifactRegistry, artifact: Pick<Artifact, 'format' | 'content' | 'title' | 'themeId' | 'locale'>, operations: unknown, options?: {
+    locale?: string;
+}): Promise<BatchResult>;
 /**
- * Targets an operation batch touches, for automatic rebase (spec §8.3). Uses the kind's `targets` when it
- * covers every operation, otherwise the diff produced by applying the batch on its base.
+ * Areas a batch touches, for automatic rebase (spec §9.2). Derived from the diff produced by applying the batch on
+ * its base, plus the envelope fields it sets. `replace_content` touches everything.
  */
-export declare function batchTargets(kind: AnyArtifactKind, operations: unknown[], baseDiff: ChangeSummary[]): Set<string>;
+export declare function batchTargets(operations: ParsedOperation[], baseDiff: ChangeSummary[]): Set<string>;
 /** True when two target sets overlap. `*` overlaps everything. */
 export declare function targetsOverlap(a: Set<string>, b: Set<string>): boolean;
 export { formatPath };

package/dist/engine.d.ts.map

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