@duckcodeailabs/dql-core 0.10.2 → 0.11.0

package/dist/format/diff.d.ts

@@ -0,0 +1,46 @@
+import type { ProgramNode } from '../ast/nodes.js';
+export type DiffChange = {
+    kind: 'block-added';
+    name: string;
+} | {
+    kind: 'block-removed';
+    name: string;
+} | {
+    kind: 'block-changed';
+    name: string;
+    fields: FieldChange[];
+} | {
+    kind: 'dashboard-added';
+    title: string;
+} | {
+    kind: 'dashboard-removed';
+    title: string;
+} | {
+    kind: 'dashboard-changed';
+    title: string;
+    fields: FieldChange[];
+} | {
+    kind: 'workbook-added';
+    title: string;
+} | {
+    kind: 'workbook-removed';
+    title: string;
+} | {
+    kind: 'workbook-changed';
+    title: string;
+    fields: FieldChange[];
+};
+export interface FieldChange {
+    path: string;
+    before: string | null;
+    after: string | null;
+}
+export interface DiffReport {
+    changes: DiffChange[];
+    /** True when `before` and `after` are semantically identical at the AST level. */
+    identical: boolean;
+}
+export declare function diffDQL(beforeSource: string, afterSource: string): DiffReport;
+export declare function diffProgram(before: ProgramNode, after: ProgramNode): DiffReport;
+export declare function renderDiffText(report: DiffReport): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/format/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/format/diff.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAOV,WAAW,EAGZ,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,kFAAkF;IAClF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAE7E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,UAAU,CAqC/E;AA2JD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAsCzD"}

package/dist/format/diff.js

@@ -0,0 +1,231 @@
+// v0.11 semantic diff for `.dql` files.
+//
+// `diffProgram` compares two parsed programs by top-level identity
+// (block name, dashboard title, workbook title) and returns a structured
+// report of added / removed / changed entities. For changed entities we
+// descend into the properties that actually matter for review: SQL query,
+// parameters, visualization, tests, tags, metadata.
+//
+// The output is intentionally lossy relative to a textual diff — it's
+// meant to answer "what changed *semantically*?", not "which bytes moved".
+import { parse } from '../parser/parser.js';
+import { NodeKind } from '../ast/nodes.js';
+import { formatProgram } from '../formatter/formatter.js';
+export function diffDQL(beforeSource, afterSource) {
+    return diffProgram(parse(beforeSource), parse(afterSource));
+}
+export function diffProgram(before, after) {
+    const changes = [];
+    const beforeBlocks = indexBy(before.statements.filter(isBlock), (b) => b.name);
+    const afterBlocks = indexBy(after.statements.filter(isBlock), (b) => b.name);
+    diffKeyed(beforeBlocks, afterBlocks, {
+        onAdded: (name) => changes.push({ kind: 'block-added', name }),
+        onRemoved: (name) => changes.push({ kind: 'block-removed', name }),
+        onChanged: (name, a, b) => {
+            const fields = diffBlock(a, b);
+            if (fields.length > 0)
+                changes.push({ kind: 'block-changed', name, fields });
+        },
+    });
+    const beforeDashboards = indexBy(before.statements.filter(isDashboard), (d) => d.title);
+    const afterDashboards = indexBy(after.statements.filter(isDashboard), (d) => d.title);
+    diffKeyed(beforeDashboards, afterDashboards, {
+        onAdded: (title) => changes.push({ kind: 'dashboard-added', title }),
+        onRemoved: (title) => changes.push({ kind: 'dashboard-removed', title }),
+        onChanged: (title, a, b) => {
+            const fields = diffDashboard(a, b);
+            if (fields.length > 0)
+                changes.push({ kind: 'dashboard-changed', title, fields });
+        },
+    });
+    const beforeWorkbooks = indexBy(before.statements.filter(isWorkbook), (w) => w.title);
+    const afterWorkbooks = indexBy(after.statements.filter(isWorkbook), (w) => w.title);
+    diffKeyed(beforeWorkbooks, afterWorkbooks, {
+        onAdded: (title) => changes.push({ kind: 'workbook-added', title }),
+        onRemoved: (title) => changes.push({ kind: 'workbook-removed', title }),
+        onChanged: (title, a, b) => {
+            const fields = diffWorkbook(a, b);
+            if (fields.length > 0)
+                changes.push({ kind: 'workbook-changed', title, fields });
+        },
+    });
+    return { changes, identical: changes.length === 0 };
+}
+// ---- Block ----
+function diffBlock(a, b) {
+    const out = [];
+    scalar(out, 'domain', a.domain, b.domain);
+    scalar(out, 'type', a.blockType, b.blockType);
+    scalar(out, 'description', a.description, b.description);
+    scalar(out, 'owner', a.owner, b.owner);
+    scalar(out, 'tags', a.tags?.join(', '), b.tags?.join(', '));
+    scalar(out, 'metricRef', a.metricRef, b.metricRef);
+    scalar(out, 'metricsRef', a.metricsRef?.join(', '), b.metricsRef?.join(', '));
+    scalar(out, 'query', normalizeSQL(a.query?.rawSQL), normalizeSQL(b.query?.rawSQL));
+    diffParams(out, a.params?.params ?? [], b.params?.params ?? []);
+    diffNamedArgs(out, 'visualization', a.visualization?.properties ?? [], b.visualization?.properties ?? []);
+    diffTests(out, a.tests ?? [], b.tests ?? []);
+    return out;
+}
+function diffParams(out, a, b) {
+    const am = new Map(a.map((p) => [p.name, formatExpr(p.initializer)]));
+    const bm = new Map(b.map((p) => [p.name, formatExpr(p.initializer)]));
+    for (const name of union(am, bm)) {
+        scalar(out, `params.${name}`, am.get(name), bm.get(name));
+    }
+}
+function diffNamedArgs(out, prefix, a, b) {
+    const am = new Map(a.map((p) => [p.name, formatExpr(p.value)]));
+    const bm = new Map(b.map((p) => [p.name, formatExpr(p.value)]));
+    for (const name of union(am, bm)) {
+        scalar(out, `${prefix}.${name}`, am.get(name), bm.get(name));
+    }
+}
+function diffTests(out, a, b) {
+    const key = (t) => `${t.field} ${t.operator}`;
+    const am = new Map(a.map((t) => [key(t), formatExpr(t.expected)]));
+    const bm = new Map(b.map((t) => [key(t), formatExpr(t.expected)]));
+    for (const k of union(am, bm)) {
+        scalar(out, `tests[${k}]`, am.get(k), bm.get(k));
+    }
+}
+// ---- Dashboard / Workbook ----
+// For dashboards/workbooks we reduce the body to its formatted text and
+// diff that as a single field; an AST-level diff of charts/filters/layouts
+// is possible but pays off less than block-level diffing.
+function diffDashboard(a, b) {
+    const out = [];
+    scalar(out, 'body', formatBody(a), formatBody(b));
+    return out;
+}
+function diffWorkbook(a, b) {
+    const out = [];
+    scalar(out, 'body', formatBody(a), formatBody(b));
+    return out;
+}
+function formatBody(node) {
+    const program = {
+        kind: NodeKind.Program,
+        span: node.span,
+        statements: [node],
+    };
+    return formatProgram(program);
+}
+// ---- Helpers ----
+function scalar(out, path, before, after) {
+    const b = before ?? null;
+    const a = after ?? null;
+    if (b !== a)
+        out.push({ path, before: b, after: a });
+}
+function normalizeSQL(sql) {
+    if (sql == null)
+        return undefined;
+    return sql.trim().replace(/\s+/g, ' ');
+}
+function formatExpr(node) {
+    switch (node.kind) {
+        case NodeKind.StringLiteral:
+            return JSON.stringify(node.value);
+        case NodeKind.NumberLiteral:
+            return String(node.value);
+        case NodeKind.BooleanLiteral:
+            return node.value ? 'true' : 'false';
+        case NodeKind.Identifier:
+            return node.name;
+        case NodeKind.ArrayLiteral:
+            return `[${node.elements.map(formatExpr).join(', ')}]`;
+        case NodeKind.BinaryExpr:
+            return `${formatExpr(node.left)} ${node.operator} ${formatExpr(node.right)}`;
+        case NodeKind.IntervalExpr:
+            return `INTERVAL ${JSON.stringify(node.value)}`;
+        case NodeKind.FunctionCall:
+            return `${node.callee}(${node.arguments.map(formatExpr).join(', ')})`;
+        case NodeKind.TemplateString:
+            return node.parts
+                .map((p) => (typeof p === 'string' ? p : `{${formatExpr(p)}}`))
+                .join('');
+        default:
+            return '';
+    }
+}
+function isBlock(s) {
+    return s.kind === NodeKind.BlockDecl;
+}
+function isDashboard(s) {
+    return s.kind === NodeKind.Dashboard;
+}
+function isWorkbook(s) {
+    return s.kind === NodeKind.Workbook;
+}
+function indexBy(items, key) {
+    const out = new Map();
+    for (const item of items)
+        out.set(key(item), item);
+    return out;
+}
+function diffKeyed(before, after, handlers) {
+    for (const key of before.keys()) {
+        if (!after.has(key))
+            handlers.onRemoved(key);
+    }
+    for (const [key, a] of after.entries()) {
+        const b = before.get(key);
+        if (b === undefined)
+            handlers.onAdded(key);
+        else
+            handlers.onChanged(key, b, a);
+    }
+}
+function union(a, b) {
+    return Array.from(new Set([...a.keys(), ...b.keys()]));
+}
+// ---- Text rendering ----
+export function renderDiffText(report) {
+    if (report.identical)
+        return 'No changes.';
+    const lines = [];
+    for (const c of report.changes) {
+        switch (c.kind) {
+            case 'block-added':
+                lines.push(`+ block "${c.name}"`);
+                break;
+            case 'block-removed':
+                lines.push(`- block "${c.name}"`);
+                break;
+            case 'block-changed':
+                lines.push(`~ block "${c.name}"`);
+                for (const f of c.fields) {
+                    lines.push(`    ${f.path}: ${fmtVal(f.before)} → ${fmtVal(f.after)}`);
+                }
+                break;
+            case 'dashboard-added':
+                lines.push(`+ dashboard "${c.title}"`);
+                break;
+            case 'dashboard-removed':
+                lines.push(`- dashboard "${c.title}"`);
+                break;
+            case 'dashboard-changed':
+                lines.push(`~ dashboard "${c.title}" (body changed)`);
+                break;
+            case 'workbook-added':
+                lines.push(`+ workbook "${c.title}"`);
+                break;
+            case 'workbook-removed':
+                lines.push(`- workbook "${c.title}"`);
+                break;
+            case 'workbook-changed':
+                lines.push(`~ workbook "${c.title}" (body changed)`);
+                break;
+        }
+    }
+    return lines.join('\n');
+}
+function fmtVal(v) {
+    if (v === null)
+        return '∅';
+    if (v.length > 80)
+        return `${v.slice(0, 77)}…`;
+    return v;
+}
+//# sourceMappingURL=diff.js.map

package/dist/format/diff.js.map

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

package/dist/format/index.d.ts

@@ -0,0 +1,29 @@
+import { type FormatOptions } from '../formatter/index.js';
+export * from './diff.js';
+export declare const FORMAT_VERSION = 1;
+export declare const FORMAT_HEADER_PREFIX = "// dql-format:";
+export interface CanonicalizeOptions extends FormatOptions {
+    /** Override the emitted format version. Defaults to FORMAT_VERSION. */
+    version?: number;
+}
+/**
+ * Return the declared format version of a `.dql` source, or `null` if the
+ * header is absent. Only the first non-empty line is inspected.
+ */
+export declare function readFormatVersion(source: string): number | null;
+export declare function hasCanonicalHeader(source: string): boolean;
+/**
+ * Produce the canonical on-disk representation of a `.dql` source:
+ *   1. Drop any existing format header
+ *   2. Reformat via `formatDQL` (deterministic key order, spacing)
+ *   3. Prepend the current format header
+ *
+ * Idempotent: `canonicalize(canonicalize(x)) === canonicalize(x)`.
+ */
+export declare function canonicalize(source: string, options?: CanonicalizeOptions): string;
+/**
+ * True when `canonicalize(source) === source` — i.e. the file is already
+ * byte-identical to its canonical form and needs no rewrite.
+ */
+export declare function isCanonical(source: string): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/format/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtE,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAIrD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAmBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAKtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/format/index.js

@@ -0,0 +1,74 @@
+// v0.11 canonical `.dql` serializer.
+//
+// Adds a stable format-version header and routes all writes through the
+// formatter so that files produced by the CLI, notebook, and block studio
+// byte-identical — the precondition for clean git diffs, `dql diff`, and
+// a safe file-format migration path.
+//
+// Format:
+//   // dql-format: <N>
+//   <formatted body>
+//
+// Readers that don't recognise a header treat it as an ordinary comment.
+// Writers always emit the current version.
+import { formatDQL } from '../formatter/index.js';
+export * from './diff.js';
+export const FORMAT_VERSION = 1;
+export const FORMAT_HEADER_PREFIX = '// dql-format:';
+const HEADER_RE = /^\s*\/\/\s*dql-format:\s*(\d+)\s*$/;
+/**
+ * Return the declared format version of a `.dql` source, or `null` if the
+ * header is absent. Only the first non-empty line is inspected.
+ */
+export function readFormatVersion(source) {
+    for (const line of source.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        const match = HEADER_RE.exec(line);
+        return match ? Number(match[1]) : null;
+    }
+    return null;
+}
+export function hasCanonicalHeader(source) {
+    return readFormatVersion(source) !== null;
+}
+/**
+ * Strip any leading `// dql-format:` header (plus a single trailing blank
+ * line) so the remainder can be re-parsed by the existing formatter, which
+ * does not yet preserve comments.
+ */
+function stripHeader(source) {
+    const lines = source.split('\n');
+    let i = 0;
+    while (i < lines.length && lines[i].trim() === '')
+        i++;
+    if (i < lines.length && HEADER_RE.test(lines[i])) {
+        i++;
+        if (i < lines.length && lines[i].trim() === '')
+            i++;
+        return lines.slice(i).join('\n');
+    }
+    return source;
+}
+/**
+ * Produce the canonical on-disk representation of a `.dql` source:
+ *   1. Drop any existing format header
+ *   2. Reformat via `formatDQL` (deterministic key order, spacing)
+ *   3. Prepend the current format header
+ *
+ * Idempotent: `canonicalize(canonicalize(x)) === canonicalize(x)`.
+ */
+export function canonicalize(source, options = {}) {
+    const version = options.version ?? FORMAT_VERSION;
+    const body = formatDQL(stripHeader(source), options);
+    const header = `${FORMAT_HEADER_PREFIX} ${version}`;
+    return `${header}\n\n${body.startsWith('\n') ? body.slice(1) : body}`;
+}
+/**
+ * True when `canonicalize(source) === source` — i.e. the file is already
+ * byte-identical to its canonical form and needs no rewrite.
+ */
+export function isCanonical(source) {
+    return canonicalize(source) === source;
+}
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/format/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,qCAAqC;AACrC,EAAE;AACF,UAAU;AACV,uBAAuB;AACvB,qBAAqB;AACrB,EAAE;AACF,yEAAyE;AACzE,2CAA2C;AAE3C,OAAO,EAAE,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AAEtE,cAAc,WAAW,CAAC;AAE1B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAOvD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,CAAC;IACvD,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,CAAC,EAAE,CAAC;QACJ,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAA+B,EAAE;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,GAAG,oBAAoB,IAAI,OAAO,EAAE,CAAC;IACpD,OAAO,GAAG,MAAM,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './parser/index.js';
 export * from './semantic/index.js';
 export * from './errors/index.js';
 export * from './formatter/index.js';
+export * from './format/index.js';
 export * from './lineage/index.js';
 export * from './manifest/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './parser/index.js';
 export * from './semantic/index.js';
 export * from './errors/index.js';
 export * from './formatter/index.js';
+export * from './format/index.js';
 export * from './lineage/index.js';
 export * from './manifest/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wCAAwC;AAExC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wCAAwC;AAExC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-core",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "description": "DQL language core: lexer, parser, AST, semantic analysis",
   "license": "Apache-2.0",
   "type": "module",