@opengeni/artifact-tool 0.2.2

package/dist/inspection.d.ts

@@ -0,0 +1,12 @@
+export type HelpEntry = Record<string, unknown> & {
+    path: string;
+    summary: string;
+    examples: string[];
+};
+export declare function defineHelpEntries(entries: readonly (readonly [path: string, summary: string, ...examples: string[]])[]): HelpEntry[];
+export declare function filterHelpEntries(entries: readonly HelpEntry[], query: string, search?: string, stripQueryPrefix?: string): HelpEntry[];
+export declare function boundInspectionRecords(records: readonly Record<string, unknown>[], maxChars: number): {
+    records: Record<string, unknown>[];
+    ndjson: string;
+    truncated: boolean;
+};

package/dist/kernel.d.ts

@@ -0,0 +1,101 @@
+import { FileBlob } from "./file-blob.js";
+export type ArtifactModality = "spreadsheet" | "presentation" | "document";
+export type ArtifactKernelKind = "native" | "wasm" | "reference";
+export type ArtifactObjectId = string & {
+    readonly __artifactObjectId: unique symbol;
+};
+export type ArtifactKernelCapabilities = {
+    modality: ArtifactModality;
+    modelSchemaVersion: number;
+    operationSchemaVersion: number;
+    inspect: boolean;
+    calculate: boolean;
+    layout: boolean;
+    renderFormats: readonly string[];
+    importFormats: readonly string[];
+    exportFormats: readonly string[];
+    collaboration: boolean;
+};
+export type ArtifactCausalVector = Readonly<Record<string, number>>;
+export type ArtifactCommand = {
+    code: string;
+    targetId?: string;
+    precondition?: {
+        objectRevision?: number;
+        exists?: boolean;
+    };
+    payload?: unknown;
+};
+export type ArtifactCommandBatch = {
+    schemaVersion: 1;
+    artifactId: string;
+    modality: ArtifactModality;
+    transactionId: string;
+    actorId: string;
+    baseSequence: number;
+    baseVector: ArtifactCausalVector;
+    commands: readonly ArtifactCommand[];
+};
+export type ArtifactApplyResult = {
+    sequence: number;
+    vector: ArtifactCausalVector;
+    changedObjectIds: readonly string[];
+    inverse?: ArtifactCommandBatch;
+};
+export type ArtifactKernelOpenInput = {
+    modality: ArtifactModality;
+    snapshot?: Uint8Array;
+    operationTail?: readonly Uint8Array[];
+};
+export type ArtifactKernelDocument = {
+    readonly modality: ArtifactModality;
+    readonly revision: number;
+    apply(batch: ArtifactCommandBatch): ArtifactApplyResult;
+    snapshot(): Uint8Array;
+    inspect(options: Record<string, unknown>): Promise<readonly Record<string, unknown>[]>;
+    render(options: Record<string, unknown>): Promise<FileBlob>;
+    materialize(format: string, options?: Record<string, unknown>): Promise<FileBlob>;
+    close(): void;
+};
+export interface ArtifactKernel {
+    readonly kind: ArtifactKernelKind;
+    readonly version: string;
+    capabilities(modality: ArtifactModality): ArtifactKernelCapabilities;
+    open(input: ArtifactKernelOpenInput): Promise<ArtifactKernelDocument>;
+}
+export type ArtifactKernelSelection = {
+    kernel: ArtifactKernel;
+    capabilities: ArtifactKernelCapabilities;
+};
+/**
+ * Kernel registry used by the universal facade. Hosts register loaders without
+ * making application code depend on platform packages. Production selection is
+ * deliberately fail-closed: Node/Bun selects only native. Browser editing goes
+ * through the SDK's dedicated Worker/WASM session, and the reference backend is
+ * selected only when a development/conformance caller explicitly asks for it.
+ */
+export declare class ArtifactKernelRegistry {
+    private readonly kernels;
+    register(kernel: ArtifactKernel): () => void;
+    select(modality: ArtifactModality, required?: Partial<Pick<ArtifactKernelCapabilities, "calculate" | "layout" | "collaboration">>, order?: readonly ArtifactKernelKind[]): ArtifactKernelSelection;
+    available(): readonly ArtifactKernel[];
+}
+export declare const ARTIFACT_OPERATION_MAX_BYTES: number;
+export declare const ARTIFACT_OPERATION_MAX_COMMANDS = 10000;
+export declare const ARTIFACT_OPERATION_MAX_VECTOR_ACTORS = 1024;
+export declare const ARTIFACT_OPERATION_MAX_STRING_BYTES: number;
+export declare const ARTIFACT_OPERATION_MAX_JSON_DEPTH = 64;
+export declare const ARTIFACT_OPERATION_MAX_JSON_NODES = 100000;
+/**
+ * Deterministic codec retained only for historical TypeScript conformance
+ * fixtures.
+ *
+ * @deprecated OGAR duplicates authored identity/causality and must never be
+ * persisted, submitted, or lowered by a production runtime. Use the canonical
+ * OGATX001 envelope with an identity-free OGASC001 command payload from
+ * `@opengeni/contracts/editable-artifacts`.
+ */
+export declare const ArtifactCommandBatchCodec: {
+    encode(batch: ArtifactCommandBatch): Uint8Array;
+    decode(bytes: Uint8Array): ArtifactCommandBatch;
+};