@artkit-ai/format-openui 0.0.0-stage → 0.2.0

package/dist/operations.d.ts

@@ -0,0 +1,41 @@
+import type { AdapterContext } from '@artkit-ai/core';
+import { z } from 'zod';
+import { formatStatement, type Statement } from './syntax.js';
+export declare const openuiOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"set_statement">;
+    name: z.ZodString;
+    expr: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove_statement">;
+    name: z.ZodString;
+    cascade: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"rename_statement">;
+    name: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"insert_child">;
+    name: z.ZodString;
+    child: z.ZodString;
+    position: z.ZodOptional<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove_child">;
+    name: z.ZodString;
+    child: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"move_child">;
+    name: z.ZodString;
+    child: z.ZodString;
+    position: z.ZodNumber;
+}, z.core.$strict>], "op">;
+export type OpenUIOperation = z.infer<typeof openuiOperationSchema>;
+export declare const OPENUI_OPERATION_NAMES: readonly ['set_statement', 'remove_statement', 'rename_statement', 'insert_child', 'remove_child', 'move_child'];
+export interface OpenUIApplyState {
+    statements: Statement[];
+    createdRefs: string[];
+}
+/** Applies one declaration operation on the list of statements. Order is kept; new statements are appended. */
+export declare function applyOpenUIOperation(state: OpenUIApplyState, op: OpenUIOperation, ctx: AdapterContext): void;
+export { formatStatement };
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,eAAe,EAIf,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AAYrB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAehC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB,YACjC,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,YAAY,CACJ,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAwBD,+GAA+G;AAC/G,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,eAAe,EACnB,GAAG,EAAE,cAAc,GAClB,IAAI,CAsFN;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/operations.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { childrenOf, componentOf, formatStatement, references, removeReferences, renameReferences, setChildren, } from './syntax.js';
+const name = z
+    .string()
+    .regex(/^[a-z][A-Za-z0-9_]{0,63}$/, 'Declaration names start with a lowercase letter (e.g. "capa").');
+const expr = z
+    .string()
+    .min(3)
+    .max(4000)
+    .refine((text) => !text.includes('\n'), 'One declaration per line.')
+    .describe('Right-hand side, e.g. Slide("title", [Title("Portal")]).');
+export const openuiOperationSchema = z.discriminatedUnion('op', [
+    z.object({ op: z.literal('set_statement'), name, expr }).strict(),
+    z.object({ op: z.literal('remove_statement'), name, cascade: z.boolean().default(false) }).strict(),
+    z.object({ op: z.literal('rename_statement'), name, to: name }).strict(),
+    z
+        .object({
+        op: z.literal('insert_child'),
+        name,
+        child: name,
+        position: z.number().int().min(0).optional().describe('0-based position; omit to append.'),
+        after: name.optional().describe('Insert after this child name.'),
+    })
+        .strict(),
+    z.object({ op: z.literal('remove_child'), name, child: name }).strict(),
+    z.object({ op: z.literal('move_child'), name, child: name, position: z.number().int().min(0) }).strict(),
+]);
+export const OPENUI_OPERATION_NAMES = [
+    'set_statement',
+    'remove_statement',
+    'rename_statement',
+    'insert_child',
+    'remove_child',
+    'move_child',
+];
+function indexOfStatement(statements, target, ctx, path) {
+    const index = statements.findIndex((statement) => statement.name === target);
+    if (index < 0) {
+        ctx.fail(`A declaração "${target}" não existe.`, {
+            path,
+            hint: 'Leia o outline e use um nome declarado nele.',
+        });
+    }
+    return index;
+}
+function referrersOf(statements, target) {
+    return statements
+        .filter((statement) => statement.name !== target && references(statement.expr).includes(target))
+        .map((statement) => statement.name);
+}
+/** Applies one declaration operation on the list of statements. Order is kept; new statements are appended. */
+export function applyOpenUIOperation(state, op, ctx) {
+    const statements = state.statements;
+    switch (op.op) {
+        case 'set_statement': {
+            if (!componentOf(op.expr) || !op.expr.includes('(')) {
+                ctx.fail(`A declaração "${op.name}" precisa chamar um componente, como Title("texto").`, {
+                    path: 'expr',
+                    hint: 'Escreva o componente com seus argumentos entre parênteses.',
+                });
+            }
+            const at = statements.findIndex((statement) => statement.name === op.name);
+            if (at >= 0)
+                statements[at] = { name: op.name, expr: op.expr };
+            else {
+                statements.push({ name: op.name, expr: op.expr });
+                state.createdRefs.push(op.name);
+            }
+            return;
+        }
+        case 'remove_statement': {
+            const at = indexOfStatement(statements, op.name, ctx, 'name');
+            const referrers = referrersOf(statements, op.name);
+            if (referrers.length > 0 && !op.cascade) {
+                ctx.fail(`"${op.name}" ainda é usada por ${referrers.join(', ')}.`, {
+                    path: 'cascade',
+                    hint: 'Remova ou troque a referência antes, ou envie cascade: true para remover as referências junto.',
+                });
+            }
+            statements.splice(at, 1);
+            for (const statement of statements)
+                statement.expr = removeReferences(statement.expr, op.name);
+            return;
+        }
+        case 'rename_statement': {
+            const at = indexOfStatement(statements, op.name, ctx, 'name');
+            if (statements.some((statement) => statement.name === op.to)) {
+                ctx.fail(`Já existe uma declaração chamada "${op.to}".`, { path: 'to', hint: 'Escolha outro nome.' });
+            }
+            statements[at].name = op.to;
+            for (const statement of statements)
+                statement.expr = renameReferences(statement.expr, op.name, op.to);
+            state.createdRefs.push(op.to);
+            return;
+        }
+        case 'insert_child': {
+            const at = indexOfStatement(statements, op.name, ctx, 'name');
+            indexOfStatement(statements, op.child, ctx, 'child');
+            const current = childrenOf(statements[at].expr);
+            if (!/\[/.test(statements[at].expr)) {
+                ctx.fail(`A declaração "${op.name}" não tem lista de filhos.`, {
+                    path: 'name',
+                    hint: 'Escolha um componente que aceite filhos, como Slide ou Card.',
+                });
+            }
+            const items = current.filter((item) => item !== op.child);
+            let position = op.position ?? items.length;
+            if (op.after !== undefined) {
+                const index = items.indexOf(op.after);
+                if (index < 0)
+                    ctx.fail(`"${op.after}" não está na lista de filhos de "${op.name}".`, { path: 'after' });
+                position = index + 1;
+            }
+            items.splice(Math.min(position, items.length), 0, op.child);
+            statements[at].expr = setChildren(statements[at].expr, items);
+            return;
+        }
+        case 'remove_child': {
+            const at = indexOfStatement(statements, op.name, ctx, 'name');
+            const items = childrenOf(statements[at].expr);
+            if (!items.includes(op.child)) {
+                ctx.fail(`"${op.child}" não está na lista de filhos de "${op.name}".`, { path: 'child' });
+            }
+            statements[at].expr = setChildren(statements[at].expr, items.filter((item) => item !== op.child));
+            return;
+        }
+        case 'move_child': {
+            const at = indexOfStatement(statements, op.name, ctx, 'name');
+            const items = childrenOf(statements[at].expr);
+            if (!items.includes(op.child))
+                ctx.fail(`"${op.child}" não está na lista de filhos de "${op.name}".`, { path: 'child' });
+            const rest = items.filter((item) => item !== op.child);
+            rest.splice(Math.min(op.position, rest.length), 0, op.child);
+            statements[at].expr = setChildren(statements[at].expr, rest);
+            return;
+        }
+    }
+}
+export { formatStatement };
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/read.d.ts

@@ -0,0 +1,4 @@
+import { type ReadRequest, type ReadResult } from '@artkit-ai/core';
+/** Compact reading (spec §12.4): `outline` from the root, `statements` by name, and `full`. */
+export declare function readOpenUI(content: string, request: ReadRequest): ReadResult;
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkB7G,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CAuC5E"}

package/dist/read.js

@@ -0,0 +1,58 @@
+import { ellipsis, paginate } from '@artkit-ai/core';
+import { childrenOf, componentOf, formatStatement, parseStatements } from './syntax.js';
+function labelOf(expr) {
+    const match = /"((?:[^"\\]|\\.)*)"/.exec(expr);
+    return match ? ellipsis(match[1], 60) : '';
+}
+function outlineLine(statement) {
+    const component = componentOf(statement.expr) ?? '?';
+    const children = childrenOf(statement.expr);
+    const parts = [`- ${statement.name}: ${component}`];
+    const label = labelOf(statement.expr);
+    if (label)
+        parts.push(`"${label}"`);
+    if (children.length > 0)
+        parts.push(`(${children.length} filhos: ${children.join(', ')})`);
+    return parts.join(' ');
+}
+/** Compact reading (spec §12.4): `outline` from the root, `statements` by name, and `full`. */
+export function readOpenUI(content, request) {
+    const { statements } = parseStatements(content);
+    const budget = {
+        ...(request.maxTokens === undefined ? {} : { maxTokens: request.maxTokens }),
+        ...(request.cursor === undefined ? {} : { cursor: request.cursor }),
+        ...(request.charsPerToken === undefined ? {} : { charsPerToken: request.charsPerToken }),
+    };
+    if (request.mode === 'outline') {
+        const items = statements.map((statement) => {
+            const line = outlineLine(statement);
+            return { id: statement.name, text: line, outline: line };
+        });
+        const projection = paginate(items, {
+            header: 'Declarações (raiz primeiro):',
+            ...budget,
+            outlineOnly: true,
+        });
+        return {
+            text: projection.text,
+            truncated: projection.truncated,
+            ...(projection.cursor ? { cursor: projection.cursor } : {}),
+        };
+    }
+    const wanted = request.mode === 'statements' && request.range
+        ? new Set(request.range.split(',').map((part) => part.trim()))
+        : undefined;
+    const items = statements
+        .filter((statement) => !wanted || wanted.has(statement.name))
+        .map((statement) => {
+        const line = formatStatement(statement);
+        return { id: statement.name, text: line, outline: ellipsis(line, 80) };
+    });
+    const projection = paginate(items, budget);
+    return {
+        text: projection.text,
+        truncated: projection.truncated,
+        ...(projection.cursor ? { cursor: projection.cursor } : {}),
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

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

package/dist/syntax.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Line-based OpenUI Lang syntax (spec §12.1): one declaration per line, `name = Component(args)`. This module only
+ * tokenizes and edits text; schema checks belong to the parser of `@openuidev/lang-core`.
+ */
+export interface Statement {
+    name: string;
+    expr: string;
+}
+export interface ParsedLines {
+    statements: Statement[];
+    /** 1-based numbers of non-empty lines that are not declarations. */
+    invalidLines: number[];
+}
+export declare function parseStatements(content: string): ParsedLines;
+export declare function serializeStatements(statements: readonly Statement[]): string;
+export declare function formatStatement(statement: Statement): string;
+export type Token = {
+    kind: 'string';
+    text: string;
+    start: number;
+    end: number;
+} | {
+    kind: 'ident';
+    text: string;
+    start: number;
+    end: number;
+} | {
+    kind: 'punct';
+    text: string;
+    start: number;
+    end: number;
+} | {
+    kind: 'other';
+    text: string;
+    start: number;
+    end: number;
+};
+/** Tokenizes an expression. Strings keep their quotes and escapes; identifiers may contain dots (e.g. `Q1.total`). */
+export declare function tokenize(expr: string): Token[];
+/** Names a declaration refers to: identifiers that are not component calls, literals or function calls. */
+export declare function references(expr: string): string[];
+/** Component name of a declaration (`Slide` for `Slide("title", [...])`), or undefined when there is none. */
+export declare function componentOf(expr: string): string | undefined;
+/** Replaces every reference to `from` with `to`, keeping the rest of the text untouched. */
+export declare function renameReferences(expr: string, from: string, to: string): string;
+/** Removes every reference to `name` inside array items (cascade). Items that are whole references are dropped. */
+export declare function removeReferences(expr: string, name: string): string;
+/** Position of the first `[ ... ]` argument of the outer call, or undefined. */
+export declare function firstArraySpan(expr: string): {
+    start: number;
+    end: number;
+} | undefined;
+/** Splits the inside of an array into top-level items (commas inside calls and strings do not split). Items keep their text. */
+export declare function splitItems(inner: string): string[];
+/** Children of the first array argument (names and inline components), in order. */
+export declare function childrenOf(expr: string): string[];
+/** Replaces the children of the first array argument with `items`. */
+export declare function setChildren(expr: string, items: string[]): string | undefined;
+export interface ComponentCall {
+    component: string;
+    /** Text between the parentheses of this call. */
+    inner: string;
+}
+/** Every component call in an expression, outer and inline ones (`Slide(…, [Bullets([…])])` yields both). */
+export declare function callsOf(expr: string): ComponentCall[];
+/** Top-level arguments of a call's inside text (commas inside nested calls and arrays do not split). */
+export declare function argsOf(inner: string): string[];
+//# sourceMappingURL=syntax.d.ts.map

package/dist/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../src/syntax.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oEAAoE;IACpE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAU5D;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAE5E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,sHAAsH;AACtH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAmC9C;AAID,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjD;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAcvF;AAED,gIAAgI;AAChI,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBlD;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGjD;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAI7E;AAkBD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6GAA6G;AAC7G,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBrD;AAED,wGAAwG;AACxG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C"}

package/dist/syntax.js

@@ -0,0 +1,204 @@
+/**
+ * Line-based OpenUI Lang syntax (spec §12.1): one declaration per line, `name = Component(args)`. This module only
+ * tokenizes and edits text; schema checks belong to the parser of `@openuidev/lang-core`.
+ */
+const DECLARATION = /^([a-z][A-Za-z0-9_]{0,63})\s*=\s*(.+)$/;
+export function parseStatements(content) {
+    const statements = [];
+    const invalidLines = [];
+    content.split('\n').forEach((line, index) => {
+        if (line.trim() === '')
+            return;
+        const match = DECLARATION.exec(line.trim());
+        if (match)
+            statements.push({ name: match[1], expr: match[2].trim() });
+        else
+            invalidLines.push(index + 1);
+    });
+    return { statements, invalidLines };
+}
+export function serializeStatements(statements) {
+    return `${statements.map((statement) => `${statement.name} = ${statement.expr}`).join('\n')}\n`;
+}
+export function formatStatement(statement) {
+    return `${statement.name} = ${statement.expr}`;
+}
+/** Tokenizes an expression. Strings keep their quotes and escapes; identifiers may contain dots (e.g. `Q1.total`). */
+export function tokenize(expr) {
+    const tokens = [];
+    let i = 0;
+    while (i < expr.length) {
+        const char = expr[i];
+        if (/\s/.test(char)) {
+            i += 1;
+            continue;
+        }
+        if (char === '"') {
+            let j = i + 1;
+            while (j < expr.length && expr[j] !== '"')
+                j += expr[j] === '\\' ? 2 : 1;
+            const end = Math.min(j + 1, expr.length);
+            tokens.push({ kind: 'string', text: expr.slice(i, end), start: i, end });
+            i = end;
+            continue;
+        }
+        if (/[A-Za-z_]/.test(char)) {
+            let j = i + 1;
+            while (j < expr.length && /[A-Za-z0-9_.]/.test(expr[j]))
+                j += 1;
+            tokens.push({ kind: 'ident', text: expr.slice(i, j), start: i, end: j });
+            i = j;
+            continue;
+        }
+        if ('()[],'.includes(char)) {
+            tokens.push({ kind: 'punct', text: char, start: i, end: i + 1 });
+            i += 1;
+            continue;
+        }
+        let j = i + 1;
+        while (j < expr.length && !/[\sA-Za-z_"()[\],]/.test(expr[j]))
+            j += 1;
+        tokens.push({ kind: 'other', text: expr.slice(i, j), start: i, end: j });
+        i = j;
+    }
+    return tokens;
+}
+const LITERALS = new Set(['true', 'false', 'null']);
+/** Names a declaration refers to: identifiers that are not component calls, literals or function calls. */
+export function references(expr) {
+    const tokens = tokenize(expr);
+    const refs = [];
+    tokens.forEach((token, index) => {
+        if (token.kind !== 'ident' || LITERALS.has(token.text))
+            return;
+        const next = tokens[index + 1];
+        if (next?.kind === 'punct' && next.text === '(')
+            return;
+        refs.push(token.text);
+    });
+    return refs;
+}
+/** Component name of a declaration (`Slide` for `Slide("title", [...])`), or undefined when there is none. */
+export function componentOf(expr) {
+    const first = tokenize(expr)[0];
+    return first?.kind === 'ident' ? first.text : undefined;
+}
+/** Replaces every reference to `from` with `to`, keeping the rest of the text untouched. */
+export function renameReferences(expr, from, to) {
+    return rewriteTokens(expr, (token, next) => {
+        if (token.kind === 'ident' && token.text === from && !(next?.kind === 'punct' && next.text === '('))
+            return to;
+        return undefined;
+    });
+}
+/** Removes every reference to `name` inside array items (cascade). Items that are whole references are dropped. */
+export function removeReferences(expr, name) {
+    const span = firstArraySpan(expr);
+    if (!span)
+        return expr;
+    const items = splitItems(expr.slice(span.start + 1, span.end));
+    const kept = items.filter((item) => item !== name);
+    return `${expr.slice(0, span.start)}[${kept.join(', ')}]${expr.slice(span.end + 1)}`;
+}
+/** Position of the first `[ ... ]` argument of the outer call, or undefined. */
+export function firstArraySpan(expr) {
+    let depth = 0;
+    let start = -1;
+    const tokens = tokenize(expr);
+    for (const token of tokens) {
+        if (token.kind === 'punct' && (token.text === '(' || token.text === '[')) {
+            if (token.text === '[' && depth === 1 && start < 0)
+                start = token.start;
+            depth += 1;
+        }
+        else if (token.kind === 'punct' && (token.text === ')' || token.text === ']')) {
+            depth -= 1;
+            if (token.text === ']' && start >= 0 && depth === 1)
+                return { start, end: token.start };
+        }
+    }
+    return undefined;
+}
+/** Splits the inside of an array into top-level items (commas inside calls and strings do not split). Items keep their text. */
+export function splitItems(inner) {
+    const items = [];
+    let depth = 0;
+    let first;
+    let last;
+    const flush = () => {
+        if (first && last)
+            items.push(inner.slice(first.start, last.end));
+        first = undefined;
+        last = undefined;
+    };
+    for (const token of tokenize(inner)) {
+        if (token.kind === 'punct' && token.text === ',' && depth === 0) {
+            flush();
+            continue;
+        }
+        if (token.kind === 'punct' && (token.text === '(' || token.text === '['))
+            depth += 1;
+        if (token.kind === 'punct' && (token.text === ')' || token.text === ']'))
+            depth -= 1;
+        first ??= token;
+        last = token;
+    }
+    flush();
+    return items;
+}
+/** Children of the first array argument (names and inline components), in order. */
+export function childrenOf(expr) {
+    const span = firstArraySpan(expr);
+    return span ? splitItems(expr.slice(span.start + 1, span.end)) : [];
+}
+/** Replaces the children of the first array argument with `items`. */
+export function setChildren(expr, items) {
+    const span = firstArraySpan(expr);
+    if (!span)
+        return undefined;
+    return `${expr.slice(0, span.start)}[${items.join(', ')}]${expr.slice(span.end + 1)}`;
+}
+function rewriteTokens(expr, replace) {
+    const tokens = tokenize(expr);
+    let out = '';
+    let cursor = 0;
+    tokens.forEach((token, index) => {
+        const replacement = replace(token, tokens[index + 1]);
+        if (replacement === undefined)
+            return;
+        out += expr.slice(cursor, token.start) + replacement;
+        cursor = token.end;
+    });
+    return out + expr.slice(cursor);
+}
+/** Every component call in an expression, outer and inline ones (`Slide(…, [Bullets([…])])` yields both). */
+export function callsOf(expr) {
+    const tokens = tokenize(expr);
+    const calls = [];
+    tokens.forEach((token, index) => {
+        const next = tokens[index + 1];
+        if (token.kind !== 'ident' || next?.kind !== 'punct' || next.text !== '(')
+            return;
+        let depth = 0;
+        for (let j = index + 1; j < tokens.length; j++) {
+            const current = tokens[j];
+            if (current.kind !== 'punct')
+                continue;
+            if (current.text === '(')
+                depth += 1;
+            if (current.text === ')') {
+                depth -= 1;
+                if (depth === 0) {
+                    calls.push({ component: token.text, inner: expr.slice(next.end, current.start) });
+                    return;
+                }
+            }
+        }
+    });
+    return calls;
+}
+/** Top-level arguments of a call's inside text (commas inside nested calls and arrays do not split). */
+export function argsOf(inner) {
+    return splitItems(inner);
+}
+//# sourceMappingURL=syntax.js.map

package/dist/syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.js","sourceRoot":"","sources":["../src/syntax.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAQ7D,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO;QAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;;YACnE,YAAY,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAgC;IAClE,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,GAAG,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAQD,sHAAsH;AACtH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YACzE,CAAC,GAAG,GAAG,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;gBAAE,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC,GAAG,CAAC,CAAC;YACN,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpD,2GAA2G;AAC3G,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG;YAAE,OAAO;QACxD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,EAAU;IACrE,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC;YACjG,OAAO,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AACvF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzE,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACxE,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAChF,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gIAAgI;AAChI,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAwB,CAAC;IAC7B,IAAI,IAAuB,CAAC;IAC5B,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,KAAK,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,KAAK,GAAG,SAAS,CAAC;QAClB,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChE,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACrF,KAAK,KAAK,KAAK,CAAC;QAChB,IAAI,GAAG,KAAK,CAAC;IACf,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAe;IACvD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,aAAa,CACpB,IAAY,EACZ,OAAsE;IAEtE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QACtC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC;QACrD,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAQD,6GAA6G;AAC7G,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG;YAAE,OAAO;QAClF,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YACvC,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG;gBAAE,KAAK,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,CAAC;gBACX,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAClF,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@artkit-ai/format-openui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "OpenUI Lang native format for artkit: declarations, validation against the artkit component library, compact reading, operations, lint and diff.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "keywords": [
+    "artkit",
+    "ai",
+    "agents",
+    "artifacts",
+    "openui"
+  ],
+  "exports": {
+    ".": {
+      "@artkit/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gustavonpco/artkit.git",
+    "directory": "packages/format-openui"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@openuidev/lang-core": "1.1.0",
+    "zod": "^4.6.7",
+    "@artkit-ai/openui-components": "^0.2.0",
+    "@artkit-ai/core": "^0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
 }

package/src/diff.ts

@@ -0,0 +1,22 @@
+import type { ChangeSummary } from '@artkit-ai/core';
+import { parseStatements } from './syntax.js';
+
+/** Changes between two OpenUI documents, targeted by declaration name (`node:capa`). */
+export function diffOpenUI(before: string, after: string): ChangeSummary[] {
+  if (before === after) return [];
+  const a = new Map(parseStatements(before).statements.map((statement) => [statement.name, statement.expr]));
+  const b = new Map(parseStatements(after).statements.map((statement) => [statement.name, statement.expr]));
+  const changes: ChangeSummary[] = [];
+  for (const [name, expr] of b) {
+    if (!a.has(name)) changes.push({ type: 'added', target: `node:${name}`, summary: expr.slice(0, 80) });
+    else if (a.get(name) !== expr)
+      changes.push({
+        type: 'changed',
+        target: `node:${name}`,
+        summary: `${a.get(name)!.slice(0, 40)} → ${expr.slice(0, 40)}`,
+      });
+  }
+  for (const name of a.keys())
+    if (!b.has(name)) changes.push({ type: 'removed', target: `node:${name}`, summary: name });
+  return changes;
+}