@duckcodeailabs/dql-notebook 0.1.1

package/LICENSE

@@ -0,0 +1,123 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner.
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the Work and such
+Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable patent license to make, have made, use, offer to sell, sell, import,
+and otherwise transfer the Work.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof
+in any medium, with or without modifications, and in Source or Object form,
+provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted
+for inclusion in the Work by You to the Licensor shall be under the terms and
+conditions of this License, without any additional terms or conditions.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the
+Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+PURPOSE.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence),
+contract, or otherwise, unless required by applicable law, shall any Contributor
+be liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a result of this
+License or out of the use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to
+offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+other liability obligations and/or rights consistent with this License.
+
+END OF TERMS AND CONDITIONS

package/dist/connector-forms.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectionConfig } from '@duckcodeailabs/dql-connectors';
+export interface ConnectorFieldSchema {
+    key: keyof ConnectionConfig | 'name';
+    label: string;
+    type: 'text' | 'number' | 'password' | 'checkbox';
+    placeholder?: string;
+    required?: boolean;
+}
+export interface ConnectorFormSchema {
+    driver: ConnectionConfig['driver'];
+    label: string;
+    category: 'local' | 'warehouse' | 'lakehouse';
+    description: string;
+    fields: ConnectorFieldSchema[];
+}
+export declare function getConnectorFormSchemas(): ConnectorFormSchema[];
+//# sourceMappingURL=connector-forms.d.ts.map

package/dist/connector-forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-forms.d.ts","sourceRoot":"","sources":["../src/connector-forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,gBAAgB,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAiJD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D"}

package/dist/connector-forms.js

@@ -0,0 +1,157 @@
+const schemas = [
+    {
+        driver: 'file',
+        label: 'Files / DuckDB memory',
+        category: 'local',
+        description: 'Query CSV, Parquet, and JSON files with DuckDB locally.',
+        fields: [
+            { key: 'filepath', label: 'DuckDB file path', type: 'text', placeholder: ':memory:' },
+        ],
+    },
+    {
+        driver: 'duckdb',
+        label: 'DuckDB',
+        category: 'local',
+        description: 'Connect directly to a local DuckDB database file.',
+        fields: [
+            { key: 'filepath', label: 'DuckDB file path', type: 'text', placeholder: './local/dev.duckdb', required: true },
+        ],
+    },
+    {
+        driver: 'sqlite',
+        label: 'SQLite',
+        category: 'local',
+        description: 'Connect to a local SQLite database file.',
+        fields: [
+            { key: 'filepath', label: 'SQLite file path', type: 'text', placeholder: './local/dev.sqlite', required: true },
+        ],
+    },
+    {
+        driver: 'postgresql',
+        label: 'PostgreSQL',
+        category: 'warehouse',
+        description: 'Standard PostgreSQL analytics databases and services.',
+        fields: warehouseFields(5432),
+    },
+    {
+        driver: 'mysql',
+        label: 'MySQL',
+        category: 'warehouse',
+        description: 'MySQL-compatible databases and managed services.',
+        fields: warehouseFields(3306),
+    },
+    {
+        driver: 'mssql',
+        label: 'SQL Server',
+        category: 'warehouse',
+        description: 'Microsoft SQL Server over the TDS protocol.',
+        fields: warehouseFields(1433),
+    },
+    {
+        driver: 'fabric',
+        label: 'Microsoft Fabric',
+        category: 'lakehouse',
+        description: 'Fabric warehouse and lakehouse SQL endpoints.',
+        fields: warehouseFields(1433),
+    },
+    {
+        driver: 'redshift',
+        label: 'Amazon Redshift',
+        category: 'warehouse',
+        description: 'Redshift clusters and serverless endpoints.',
+        fields: warehouseFields(5439),
+    },
+    {
+        driver: 'snowflake',
+        label: 'Snowflake',
+        category: 'warehouse',
+        description: 'Snowflake account, warehouse, database, and role.',
+        fields: [
+            { key: 'account', label: 'Account', type: 'text', required: true },
+            { key: 'warehouse', label: 'Warehouse', type: 'text', required: true },
+            { key: 'database', label: 'Database', type: 'text', required: true },
+            { key: 'schema', label: 'Schema', type: 'text', required: true },
+            { key: 'username', label: 'Username', type: 'text', required: true },
+            { key: 'password', label: 'Password', type: 'password', required: true },
+            { key: 'role', label: 'Role', type: 'text' },
+        ],
+    },
+    {
+        driver: 'bigquery',
+        label: 'BigQuery',
+        category: 'warehouse',
+        description: 'Google BigQuery project-level connection.',
+        fields: [
+            { key: 'projectId', label: 'Project ID', type: 'text', required: true },
+        ],
+    },
+    {
+        driver: 'clickhouse',
+        label: 'ClickHouse',
+        category: 'warehouse',
+        description: 'ClickHouse HTTP or cloud service endpoints.',
+        fields: [
+            { key: 'host', label: 'Host', type: 'text', required: true },
+            { key: 'port', label: 'Port', type: 'number', placeholder: '8443' },
+            { key: 'database', label: 'Database', type: 'text' },
+            { key: 'username', label: 'Username', type: 'text' },
+            { key: 'password', label: 'Password', type: 'password' },
+            { key: 'ssl', label: 'Use TLS', type: 'checkbox' },
+        ],
+    },
+    {
+        driver: 'databricks',
+        label: 'Databricks SQL',
+        category: 'lakehouse',
+        description: 'Databricks SQL warehouse hostname, path, and personal access token.',
+        fields: [
+            { key: 'host', label: 'Server hostname', type: 'text', required: true },
+            { key: 'database', label: 'Catalog / database', type: 'text' },
+            { key: 'schema', label: 'Schema', type: 'text' },
+            { key: 'warehouse', label: 'HTTP path / warehouse', type: 'text', required: true },
+            { key: 'password', label: 'Access token', type: 'password', required: true },
+        ],
+    },
+    {
+        driver: 'athena',
+        label: 'Amazon Athena',
+        category: 'lakehouse',
+        description: 'Athena workgroup-backed query execution via AWS.',
+        fields: [
+            { key: 'host', label: 'Region', type: 'text', placeholder: 'us-east-1', required: true },
+            { key: 'database', label: 'Database', type: 'text', required: true },
+            { key: 'schema', label: 'S3 output location', type: 'text', placeholder: 's3://bucket/query-results/', required: true },
+            { key: 'warehouse', label: 'Workgroup', type: 'text' },
+        ],
+    },
+    {
+        driver: 'trino',
+        label: 'Trino',
+        category: 'lakehouse',
+        description: 'Trino / Starburst clusters exposed over HTTP.',
+        fields: [
+            { key: 'host', label: 'Host', type: 'text', required: true },
+            { key: 'port', label: 'Port', type: 'number', placeholder: '8080' },
+            { key: 'database', label: 'Catalog', type: 'text', required: true },
+            { key: 'schema', label: 'Schema', type: 'text', required: true },
+            { key: 'username', label: 'Username', type: 'text' },
+            { key: 'password', label: 'Password', type: 'password' },
+            { key: 'ssl', label: 'Use TLS', type: 'checkbox' },
+        ],
+    },
+];
+export function getConnectorFormSchemas() {
+    return schemas;
+}
+function warehouseFields(defaultPort) {
+    return [
+        { key: 'host', label: 'Host', type: 'text', required: true },
+        { key: 'port', label: 'Port', type: 'number', placeholder: String(defaultPort) },
+        { key: 'database', label: 'Database', type: 'text', required: true },
+        { key: 'username', label: 'Username', type: 'text' },
+        { key: 'password', label: 'Password', type: 'password' },
+        { key: 'ssl', label: 'Use TLS', type: 'checkbox' },
+        { key: 'connectionString', label: 'Connection string', type: 'text' },
+    ];
+}
+//# sourceMappingURL=connector-forms.js.map

package/dist/connector-forms.js.map

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

package/dist/document.d.ts

@@ -0,0 +1,33 @@
+export type NotebookCellType = 'markdown' | 'sql' | 'dql' | 'chart';
+export interface NotebookMetadata {
+    title: string;
+    description?: string;
+    createdWith: 'dql';
+    template?: string;
+}
+export interface NotebookChartConfig {
+    sourceCellId?: string;
+    chart?: string;
+    x?: string;
+    y?: string;
+    y2?: string;
+    color?: string;
+    title?: string;
+}
+export interface NotebookCell {
+    id: string;
+    type: NotebookCellType;
+    title?: string;
+    source: string;
+    config?: NotebookChartConfig;
+}
+export interface NotebookDocument {
+    version: 1;
+    metadata: NotebookMetadata;
+    cells: NotebookCell[];
+}
+export declare function createNotebookDocument(title: string, cells: NotebookCell[], metadata?: Partial<NotebookMetadata>): NotebookDocument;
+export declare function serializeNotebook(document: NotebookDocument): string;
+export declare function deserializeNotebook(raw: string): NotebookDocument;
+export declare function createWelcomeNotebook(template: string, projectTitle: string): NotebookDocument;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACvC,gBAAgB,CAUlB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAsBjE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAmI9F"}

package/dist/document.js

@@ -0,0 +1,165 @@
+export function createNotebookDocument(title, cells, metadata = {}) {
+    return {
+        version: 1,
+        metadata: {
+            title,
+            createdWith: 'dql',
+            ...metadata,
+        },
+        cells,
+    };
+}
+export function serializeNotebook(document) {
+    return JSON.stringify(document, null, 2);
+}
+export function deserializeNotebook(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || !parsed.metadata?.title || !Array.isArray(parsed.cells)) {
+        throw new Error('Invalid .dqlnb document.');
+    }
+    return {
+        version: 1,
+        metadata: {
+            title: parsed.metadata.title,
+            description: parsed.metadata.description,
+            createdWith: 'dql',
+            template: parsed.metadata.template,
+        },
+        cells: parsed.cells.map((cell, index) => ({
+            id: cell.id ?? `cell-${index + 1}`,
+            type: cell.type ?? 'markdown',
+            title: cell.title,
+            source: cell.source ?? '',
+            config: cell.config,
+        })),
+    };
+}
+export function createWelcomeNotebook(template, projectTitle) {
+    const normalized = template.toLowerCase();
+    if (normalized === 'ecommerce') {
+        return createNotebookDocument(`${projectTitle} Welcome`, [
+            {
+                id: 'intro',
+                type: 'markdown',
+                title: 'Welcome',
+                source: `# ${projectTitle}\n\nThis notebook gives you a browser-first tour of DQL using the bundled e-commerce sample data. Run the cells below to explore revenue, funnel health, and repeat purchase behavior.`,
+            },
+            {
+                id: 'dql-revenue',
+                type: 'dql',
+                title: 'Revenue by Channel',
+                source: `block "Revenue by Channel" {\n    domain = "commerce"\n    type = "custom"\n    description = "Starter DQL block for channel-level revenue"\n\n    query = """\n        SELECT channel, ROUND(SUM(order_total), 2) AS revenue\n        FROM read_csv_auto('./data/orders.csv')\n        GROUP BY channel\n        ORDER BY revenue DESC\n    """\n\n    visualization {\n        chart = "bar"\n        x = channel\n        y = revenue\n    }\n\n    tests {\n        assert row_count > 0\n    }\n}`,
+            },
+            {
+                id: 'sql-funnel',
+                type: 'sql',
+                title: 'Checkout Funnel',
+                source: `SELECT step, users\nFROM read_csv_auto('./data/funnel.csv')\nORDER BY sort_order;`,
+            },
+            {
+                id: 'chart-funnel',
+                type: 'chart',
+                title: 'Funnel View',
+                source: '',
+                config: {
+                    sourceCellId: 'sql-funnel',
+                    chart: 'bar',
+                    x: 'step',
+                    y: 'users',
+                    title: 'Funnel conversion by step',
+                },
+            },
+        ], { description: 'Guided walkthrough for the e-commerce template.', template: 'ecommerce' });
+    }
+    if (normalized === 'saas') {
+        return createNotebookDocument(`${projectTitle} Welcome`, [
+            {
+                id: 'intro',
+                type: 'markdown',
+                title: 'Welcome',
+                source: `# ${projectTitle}\n\nThis notebook highlights MRR, churn, and expansion revenue using the bundled SaaS sample data.`,
+            },
+            {
+                id: 'dql-mrr',
+                type: 'dql',
+                title: 'MRR by Plan',
+                source: `block "MRR by Plan" {\n    domain = "saas"\n    type = "custom"\n    description = "Monthly recurring revenue by plan tier"\n\n    query = """\n        SELECT plan_tier, ROUND(SUM(mrr), 2) AS mrr\n        FROM read_csv_auto('./data/subscriptions.csv')\n        WHERE status = 'active'\n        GROUP BY plan_tier\n        ORDER BY mrr DESC\n    """\n\n    visualization {\n        chart = "bar"\n        x = plan_tier\n        y = mrr\n    }\n}`,
+            },
+            {
+                id: 'sql-cohort',
+                type: 'sql',
+                title: 'Logo Retention',
+                source: `SELECT cohort_month, retained_accounts\nFROM read_csv_auto('./data/cohorts.csv')\nORDER BY cohort_month;`,
+            },
+            {
+                id: 'chart-cohort',
+                type: 'chart',
+                title: 'Retention Trend',
+                source: '',
+                config: {
+                    sourceCellId: 'sql-cohort',
+                    chart: 'line',
+                    x: 'cohort_month',
+                    y: 'retained_accounts',
+                    title: 'Retained accounts by cohort',
+                },
+            },
+        ], { description: 'Guided walkthrough for the SaaS template.', template: 'saas' });
+    }
+    if (normalized === 'taxi') {
+        return createNotebookDocument(`${projectTitle} Welcome`, [
+            {
+                id: 'intro',
+                type: 'markdown',
+                title: 'Welcome',
+                source: `# ${projectTitle}\n\nThis notebook explores trip volume, fares, and pickup patterns using the bundled taxi dataset.`,
+            },
+            {
+                id: 'dql-borough',
+                type: 'dql',
+                title: 'Trips by Borough',
+                source: `block "Trips by Borough" {\n    domain = "mobility"\n    type = "custom"\n    description = "Trip count by pickup borough"\n\n    query = """\n        SELECT pickup_borough, COUNT(*) AS trip_count\n        FROM read_csv_auto('./data/trips.csv')\n        GROUP BY pickup_borough\n        ORDER BY trip_count DESC\n    """\n\n    visualization {\n        chart = "bar"\n        x = pickup_borough\n        y = trip_count\n    }\n}`,
+            },
+            {
+                id: 'sql-fare',
+                type: 'sql',
+                title: 'Average Fare by Hour',
+                source: `SELECT pickup_hour, ROUND(AVG(fare_amount), 2) AS avg_fare\nFROM read_csv_auto('./data/trips.csv')\nGROUP BY pickup_hour\nORDER BY pickup_hour;`,
+            },
+            {
+                id: 'chart-fare',
+                type: 'chart',
+                title: 'Hourly Fare Trend',
+                source: '',
+                config: {
+                    sourceCellId: 'sql-fare',
+                    chart: 'line',
+                    x: 'pickup_hour',
+                    y: 'avg_fare',
+                    title: 'Average fare by pickup hour',
+                },
+            },
+        ], { description: 'Guided walkthrough for the NYC taxi template.', template: 'taxi' });
+    }
+    return createNotebookDocument(`${projectTitle} Welcome`, [
+        {
+            id: 'intro',
+            type: 'markdown',
+            title: 'Welcome',
+            source: `# ${projectTitle}\n\nWelcome to the browser-first DQL notebook. Use this notebook to edit DQL, run raw SQL, and compare chart configurations without leaving the browser.`,
+        },
+        {
+            id: 'dql-starter',
+            type: 'dql',
+            title: 'Starter DQL Block',
+            source: `block "Revenue by Segment" {\n    domain = "revenue"\n    type = "custom"\n    description = "Starter block for segment revenue analysis"\n\n    query = """\n        SELECT segment_tier AS segment, SUM(amount) AS revenue\n        FROM read_csv_auto('./data/revenue.csv')\n        GROUP BY segment_tier\n        ORDER BY revenue DESC\n    """\n\n    visualization {\n        chart = "bar"\n        x = segment\n        y = revenue\n    }\n}`,
+        },
+        {
+            id: 'markdown-next',
+            type: 'markdown',
+            title: 'Next Steps',
+            source: `## What to try next\n\n- Edit the SQL in the DQL cell and run it again\n- Add a new SQL or markdown cell from the toolbar\n- Export this notebook as a \`.dqlnb\` file for git-friendly review`,
+        },
+    ], { description: 'Guided walkthrough for the starter template.', template: 'starter' });
+}
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

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

package/dist/execute.d.ts

@@ -0,0 +1,16 @@
+import type { SQLParamSpec } from '@duckcodeailabs/dql-connectors';
+import type { NotebookCell, NotebookChartConfig } from './document.js';
+export interface NotebookExecutionPlan {
+    title: string;
+    sql: string;
+    sqlParams: SQLParamSpec[];
+    variables: Record<string, unknown>;
+    chartConfig?: NotebookChartConfig;
+    tests: Array<{
+        field: string;
+        operator: string;
+        expected: unknown;
+    }>;
+}
+export declare function buildExecutionPlan(cell: NotebookCell): NotebookExecutionPlan | null;
+//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CA+CnF"}

package/dist/execute.js

@@ -0,0 +1,113 @@
+import { NodeKind, parse, } from '@duckcodeailabs/dql-core';
+export function buildExecutionPlan(cell) {
+    if (cell.type === 'markdown' || cell.type === 'chart') {
+        return null;
+    }
+    if (cell.type === 'sql') {
+        return {
+            title: cell.title || 'SQL cell',
+            sql: cell.source,
+            sqlParams: [],
+            variables: {},
+            chartConfig: cell.config,
+            tests: [],
+        };
+    }
+    const program = parse(cell.source);
+    const block = program.statements.find((statement) => statement.kind === NodeKind.BlockDecl);
+    if (!block) {
+        throw new Error('DQL notebook cells must contain a block declaration.');
+    }
+    if (block.blockType !== 'custom') {
+        throw new Error('Only custom DQL blocks can run inside the notebook today.');
+    }
+    if (!block.query) {
+        throw new Error('DQL notebook block is missing a query field.');
+    }
+    const processed = processSQL(block.query.rawSQL, block.query.interpolations);
+    const chartConfig = block.visualization ? lowerChartConfig(block.visualization.properties) : undefined;
+    const variables = Object.fromEntries((block.params?.params ?? []).map((param) => [param.name, evaluateExpression(param.initializer)]));
+    return {
+        title: block.name,
+        sql: processed.sql,
+        sqlParams: processed.params,
+        variables,
+        chartConfig,
+        tests: (block.tests ?? []).map((test) => ({
+            field: test.field,
+            operator: test.operator,
+            expected: evaluateExpression(test.expected),
+        })),
+    };
+}
+function lowerChartConfig(properties) {
+    const config = {};
+    for (const property of properties) {
+        const value = evaluateExpression(property.value);
+        switch (property.name) {
+            case 'chart':
+                config.chart = String(value);
+                break;
+            case 'x':
+                config.x = String(value);
+                break;
+            case 'y':
+                config.y = String(value);
+                break;
+            case 'y2':
+                config.y2 = String(value);
+                break;
+            case 'color':
+                config.color = String(value);
+                break;
+        }
+    }
+    return config;
+}
+function processSQL(rawSQL, interpolations) {
+    if (interpolations.length === 0) {
+        return { sql: rawSQL, params: [] };
+    }
+    let sql = rawSQL;
+    const params = [];
+    const sorted = [...interpolations].sort((a, b) => b.offsetInSQL - a.offsetInSQL);
+    let position = interpolations.length;
+    for (const interpolation of sorted) {
+        const placeholder = `$${position}`;
+        const from = interpolation.offsetInSQL;
+        const rest = sql.slice(from);
+        const pattern = new RegExp(`^\\$\\{${interpolation.variableName}\\}|^\\{${interpolation.variableName}\\}`);
+        const match = rest.match(pattern);
+        if (!match) {
+            position -= 1;
+            continue;
+        }
+        sql = sql.slice(0, from) + placeholder + sql.slice(from + match[0].length);
+        params.unshift({ name: interpolation.variableName, position });
+        position -= 1;
+    }
+    return { sql, params };
+}
+function evaluateExpression(node) {
+    switch (node.kind) {
+        case NodeKind.StringLiteral:
+            return node.value;
+        case NodeKind.NumberLiteral:
+            return node.value;
+        case NodeKind.BooleanLiteral:
+            return node.value;
+        case NodeKind.Identifier:
+            return node.name;
+        case NodeKind.ArrayLiteral:
+            return node.elements.map((element) => evaluateExpression(element));
+        case NodeKind.IntervalExpr:
+            return node.value;
+        case NodeKind.BinaryExpr:
+            return `${evaluateExpression(node.left)} ${node.operator} ${evaluateExpression(node.right)}`;
+        case NodeKind.FunctionCall:
+            return node.callee;
+        case NodeKind.TemplateString:
+            return node.parts.map((part) => (typeof part === 'string' ? part : String(evaluateExpression(part)))).join('');
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './document.js';
+export * from './execute.js';
+export * from './connector-forms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './document.js';
+export * from './execute.js';
+export * from './connector-forms.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@duckcodeailabs/dql-notebook",
+  "version": "0.1.1",
+  "description": "Notebook document model and execution helpers for DQL",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/duckcode-ai/dql.git",
+    "directory": "packages/dql-notebook"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@duckcodeailabs/dql-core": "0.1.1",
+    "@duckcodeailabs/dql-connectors": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  }
+}