@zlens/notebook 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 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
+      (an example is provided in the Appendix below).
+
+      "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. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "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. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "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
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   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, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   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.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   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 and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) 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. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   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 (such as deliberate and grossly
+      negligent acts) or agreed to in writing, 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 (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   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. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,5 @@
+DQL
+Copyright 2026 DuckCode AI Labs
+
+This product includes software developed by DuckCode AI Labs
+(https://github.com/duckcode-ai-labs/zlens).

package/dist/connector-forms.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectionConfig } from '@zlens/connectors';
+export interface ConnectorFieldSchema {
+    key: keyof ConnectionConfig | 'name';
+    label: string;
+    type: 'text' | 'number' | 'password' | 'checkbox' | 'select' | 'textarea';
+    placeholder?: string;
+    required?: boolean;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    helpText?: string;
+}
+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,mBAAmB,CAAC;AAE1D,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,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;AAsGD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D"}

package/dist/connector-forms.js

@@ -0,0 +1,103 @@
+const schemas = [
+    {
+        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: '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: 'authMethod',
+                label: 'Authentication',
+                type: 'select',
+                options: [
+                    { value: 'password', label: 'Password' },
+                    { value: 'mfa', label: 'Password + MFA' },
+                    { value: 'key_pair', label: 'Key pair / private key' },
+                    { value: 'external_browser', label: 'SSO / external browser' },
+                    { value: 'oauth', label: 'OAuth token' },
+                    { value: 'oauth_authorization_code', label: 'OAuth authorization code' },
+                    { value: 'oauth_client_credentials', label: 'OAuth client credentials' },
+                    { value: 'programmatic_access_token', label: 'Programmatic access token' },
+                    { value: 'workload_identity', label: 'Workload identity' },
+                ],
+            },
+            { key: 'password', label: 'Password', type: 'password' },
+            { key: 'token', label: 'Token', type: 'password', helpText: 'OAuth, programmatic access token, or OIDC workload identity token.' },
+            { key: 'privateKeyPath', label: 'Private key file path', type: 'text', placeholder: '~/.ssh/snowflake_key.p8' },
+            { key: 'privateKey', label: 'Private key PEM', type: 'textarea', helpText: 'Paste PEM only when a key file cannot be referenced.' },
+            { key: 'privateKeyPassphrase', label: 'Private key passphrase', type: 'password' },
+            { key: 'authenticator', label: 'Authenticator override', type: 'text', placeholder: 'EXTERNALBROWSER, OAUTH, WORKLOAD_IDENTITY, or Okta URL' },
+            { key: 'role', label: 'Role', type: 'text' },
+            { key: 'accessUrl', label: 'Access URL', type: 'text' },
+            { key: 'application', label: 'Application name', type: 'text', placeholder: 'DQL' },
+            { key: 'queryTag', label: 'Query tag', type: 'text', placeholder: 'team=analytics;app=dql' },
+            { key: 'passcode', label: 'MFA passcode', type: 'password' },
+            { key: 'passcodeInPassword', label: 'MFA passcode is appended to password', type: 'checkbox' },
+            { key: 'clientRequestMFAToken', label: 'Reuse cached MFA token', type: 'checkbox' },
+            { key: 'clientStoreTemporaryCredential', label: 'Cache SSO token locally', type: 'checkbox' },
+            { key: 'clientSessionKeepAlive', label: 'Keep session alive', type: 'checkbox' },
+            { key: 'clientSessionKeepAliveHeartbeatFrequency', label: 'Keep-alive heartbeat seconds', type: 'number', placeholder: '3600' },
+            { key: 'credentialCacheDir', label: 'Credential cache directory', type: 'text' },
+            { key: 'browserActionTimeout', label: 'Browser SSO timeout ms', type: 'number', placeholder: '120000' },
+            { key: 'keepAlive', label: 'Socket keep-alive', type: 'checkbox' },
+            { key: 'timeout', label: 'Connection timeout ms', type: 'number', placeholder: '60000' },
+            { key: 'proxyHost', label: 'Proxy host', type: 'text' },
+            { key: 'proxyPort', label: 'Proxy port', type: 'number' },
+            { key: 'proxyProtocol', label: 'Proxy protocol', type: 'text', placeholder: 'https' },
+            { key: 'proxyUser', label: 'Proxy user', type: 'text' },
+            { key: 'proxyPassword', label: 'Proxy password', type: 'password' },
+            { key: 'noProxy', label: 'No proxy hosts', type: 'text', placeholder: '*.amazonaws.com|*.internal' },
+            { key: 'oauthClientId', label: 'OAuth client ID', type: 'text' },
+            { key: 'oauthClientSecret', label: 'OAuth client secret', type: 'password' },
+            { key: 'oauthAuthorizationUrl', label: 'OAuth authorization URL', type: 'text' },
+            { key: 'oauthTokenRequestUrl', label: 'OAuth token request URL', type: 'text' },
+            { key: 'oauthScope', label: 'OAuth scope', type: 'text' },
+            { key: 'oauthRedirectUri', label: 'OAuth redirect URI', type: 'text' },
+            { key: 'workloadIdentityProvider', label: 'Workload identity provider', type: 'text', placeholder: 'AWS, AZURE, GCP, or OIDC' },
+            { key: 'workloadIdentityAzureClientId', label: 'Azure client ID', type: 'text' },
+        ],
+    },
+    {
+        driver: 'databricks',
+        label: 'Databricks SQL',
+        category: 'lakehouse',
+        description: 'Databricks workspace, SQL warehouse, and bearer token.',
+        fields: [
+            { key: 'host', label: 'Workspace URL', type: 'text', required: true, placeholder: 'https://adb-123.cloud.databricks.com' },
+            { key: 'database', label: 'Catalog / database', type: 'text' },
+            { key: 'schema', label: 'Schema', type: 'text' },
+            { key: 'warehouse', label: 'Warehouse ID', type: 'text', helpText: 'Use the SQL warehouse ID when you have it.' },
+            { key: 'httpPath', label: 'SQL warehouse ID or path', type: 'text', placeholder: '/sql/1.0/warehouses/abc123', helpText: 'Paste the warehouse ID or its JDBC/HTTP path.' },
+            {
+                key: 'authMethod',
+                label: 'Authentication',
+                type: 'select',
+                options: [
+                    { value: 'token', label: 'Access token' },
+                    { value: 'oauth', label: 'OAuth bearer token' },
+                ],
+            },
+            { key: 'token', label: 'Bearer token', type: 'password', required: true, helpText: 'Use an OAuth token for automation when possible, or a service-principal PAT.' },
+            { key: 'waitTimeout', label: 'Statement wait timeout', type: 'text', placeholder: '50s' },
+            { key: 'byteLimit', label: 'Inline byte limit', type: 'number', placeholder: '25000000' },
+        ],
+    },
+];
+export function getConnectorFormSchemas() {
+    return schemas;
+}
+//# 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,72 @@
+import { type ProductDomainContext } from "@zlens/core";
+export type NotebookCellType = "markdown" | "sql" | "dql" | "param" | "chart" | "pivot" | "single_value" | "filter" | "table" | "map" | "writeback" | "python" | "chat";
+export interface NotebookMetadata extends ProductDomainContext {
+    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;
+    executionTarget?: {
+        target: "connection" | "local";
+        connectionName?: string;
+    };
+    datasetRefs?: Array<{
+        id: string;
+        alias?: string;
+        role?: "source" | "staged" | "output";
+        fingerprint?: string;
+    }>;
+    dependencies?: Array<{
+        cellId: string;
+        output?: string;
+    }>;
+    annotations?: Array<{
+        id: string;
+        body: string;
+        createdAt: string;
+        updatedAt?: string;
+        author?: string;
+    }>;
+    mixedSourcePlan?: {
+        datasetId?: string;
+        datasetName?: string;
+        localDataset: string;
+        localAlias: string;
+        localKey: string;
+        warehouseKey: string;
+        warehouseExpression: string;
+        warehouseSql: string;
+        warehouseRelations?: string[];
+    };
+    dqlArtifact?: Record<string, unknown>;
+    chatConfig?: Record<string, unknown>;
+    kernel?: Record<string, unknown>;
+    /** Future cell metadata is intentionally retained by the document reader. */
+    [key: string]: unknown;
+}
+export interface NotebookDocument {
+    dqlnbVersion: 2;
+    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, driver?: 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":"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"}

package/dist/document.js

@@ -0,0 +1,159 @@
+import { canonicalizeNotebook } from "@zlens/core/format";
+import { normalizeProductDomainContext } from "@zlens/core";
+export function createNotebookDocument(title, cells, metadata = {}) {
+    return {
+        dqlnbVersion: 2,
+        version: 1,
+        metadata: {
+            title,
+            createdWith: 'dql',
+            ...metadata,
+            ...normalizeProductDomainContext(metadata),
+        },
+        cells,
+    };
+}
+export function serializeNotebook(document) {
+    const { title, ...metadata } = document.metadata;
+    return canonicalizeNotebook(JSON.stringify({
+        dqlnbVersion: 2,
+        version: 1,
+        title,
+        metadata,
+        cells: document.cells.map((cell) => {
+            const { source, title: cellTitle, config, ...rest } = cell;
+            return {
+                ...rest,
+                ...(cellTitle ? { name: cellTitle } : {}),
+                content: source,
+                ...(config ? { chartConfig: config } : {}),
+            };
+        }),
+    }));
+}
+export function deserializeNotebook(raw) {
+    const parsed = JSON.parse(raw);
+    const parsedRecord = parsed;
+    const documentTitle = parsed.metadata?.title ?? parsedRecord.title;
+    if (parsed.version !== 1 || !documentTitle || !Array.isArray(parsed.cells)) {
+        throw new Error("Invalid .dqlnb document.");
+    }
+    return {
+        dqlnbVersion: 2,
+        version: 1,
+        metadata: {
+            title: documentTitle,
+            description: parsed.metadata?.description,
+            createdWith: "dql",
+            template: parsed.metadata?.template,
+            ...normalizeProductDomainContext(parsed.metadata ?? {}, parsed.metadata?.ownerDomain),
+        },
+        cells: parsed.cells.map((cell, index) => {
+            const raw = cell;
+            return {
+                ...cell,
+                id: cell.id ?? `cell-${index + 1}`,
+                type: cell.type ?? "markdown",
+                title: cell.title ?? raw.name,
+                source: cell.source ?? raw.content ?? "",
+                config: cell.config ?? raw.chartConfig,
+            };
+        }),
+    };
+}
+function listTablesSQL(driver) {
+    if (!driver) {
+        return `SELECT 1 AS ready;`;
+    }
+    switch (driver.toLowerCase()) {
+        case 'duckdb':
+        case 'sqlite':
+        case 'file':
+            return `SHOW TABLES;`;
+        case 'postgresql':
+        case 'redshift':
+            return `SELECT table_schema, table_name FROM information_schema.tables\nWHERE table_schema NOT IN ('information_schema', 'pg_catalog')\nORDER BY table_schema, table_name LIMIT 20;`;
+        case 'mysql':
+            return `SELECT table_schema, table_name FROM information_schema.tables\nWHERE table_schema NOT IN ('information_schema', 'mysql', 'performance_schema', 'sys')\nORDER BY table_schema, table_name LIMIT 20;`;
+        case 'snowflake':
+        case 'mssql':
+        case 'databricks':
+        case 'trino':
+        case 'fabric':
+            return `SELECT table_schema, table_name FROM information_schema.tables\nWHERE table_schema NOT IN ('INFORMATION_SCHEMA')\nORDER BY table_schema, table_name LIMIT 20;`;
+        default:
+            return `SELECT table_schema, table_name FROM information_schema.tables\nLIMIT 20;`;
+    }
+}
+export function createWelcomeNotebook(template, projectTitle, driver) {
+    const normalized = template.toLowerCase();
+    const showTablesQuery = listTablesSQL(driver);
+    if (normalized === 'dbt') {
+        return createNotebookDocument(`${projectTitle} - ZLens Workbench`, [
+            {
+                id: 'intro',
+                type: 'markdown',
+                title: 'Welcome',
+                source: `# ${projectTitle}\n\nZLens is governed analytics written in DQL (**Domain Query Language**), its query language. DQL is the domain layer that turns dbt models, SQL, metrics, notebooks, dashboards, apps, and business definitions into one trusted analytics project.\n\n**Core path:** source data -> dbt model -> DQL block -> business_view -> dashboard/app/AI answer.\n\nThis notebook is your workbench. Explore the dbt-backed database below, then promote useful queries into blocks and business views so the compiler can write \`dql-manifest.json\` with both technical lineage and business lineage.`,
+            },
+            {
+                id: 'sql-tables',
+                type: 'sql',
+                title: 'Available Tables',
+                source: `-- List tables in your database\n${showTablesQuery}`,
+            },
+            {
+                id: 'sql-explore',
+                type: 'sql',
+                title: 'Explore Your Data',
+                source: `-- Replace 'your_table' with a table name from the results above\n-- SELECT * FROM your_table LIMIT 20;`,
+            },
+            {
+                id: 'dql-example',
+                type: 'dql',
+                title: 'Example Domain Layer',
+                source: `term "Customer" {\n  domain = "Customer"\n  type = "entity"\n  status = "draft"\n  description = "A person or account that can place orders or receive service."\n  owner = "customer-analytics"\n  identifiers = ["customer_id"]\n}\n\nblock "Example Customer Rollup" {\n  domain = "Customer"\n  type = "custom"\n  status = "draft"\n  description = "Starter customer summary block. Replace this query with a dbt model query."\n  owner = "analytics"\n  terms = ["Customer"]\n  businessOutcome = "Understand customer value and activity."\n  decisionUse = "Account planning and retention review."\n\n  query = """\n    SELECT 1 AS customer_count\n  """\n\n  tests {\n    assert row_count == 1\n  }\n}\n\nbusiness_view "Customer 360" {\n  domain = "Customer"\n  status = "draft"\n  description = "Business composition for account review and customer health."\n  owner = "customer-analytics"\n  terms = ["Customer"]\n  businessOutcome = "See customer identity, value, activity, and service risk in one lineage path."\n  decisionUse = "Account planning, churn review, and expansion targeting."\n  reviewCadence = "weekly"\n\n  includes {\n    block "Example Customer Rollup"\n  }\n}`,
+            },
+            {
+                id: 'next-steps',
+                type: 'markdown',
+                title: 'Next Steps',
+                source: `## Next steps\n\n1. Query a dbt model and save the useful logic as a DQL block.\n2. Add business terms under \`terms/\` for the vocabulary stakeholders use.\n3. Compose blocks into \`business_view\` files under \`business-views/\`.\n4. Run \`zlens compile .\` to refresh \`dql-manifest.json\`.\n5. Open Lineage to trace source -> model -> block -> business view -> consumption.`,
+            },
+        ], { description: 'ZLens workbench for turning a dbt project into business lineage.', template: 'dbt' });
+    }
+    // Default notebook for non-dbt projects
+    return createNotebookDocument(`${projectTitle} - ZLens Workbench`, [
+        {
+            id: 'intro',
+            type: 'markdown',
+            title: 'Welcome',
+            source: `# ${projectTitle}\n\nZLens is governed analytics written in DQL (**Domain Query Language**), its query language. Together they turn SQL, business terms, notebooks, dashboards, apps, and lineage into one trusted analytics project.\n\n**Core path:** source data -> DQL block -> business_view -> dashboard/app/AI answer.\n\nThis notebook is your workbench. Start with a table or local file, promote useful SQL into a block, then compose blocks into business views so the compiler can write \`dql-manifest.json\` with both technical lineage and business lineage.`,
+        },
+        {
+            id: 'sql-tables',
+            type: 'sql',
+            title: 'Available Tables',
+            source: `-- List tables in your database\n${showTablesQuery}`,
+        },
+        {
+            id: 'sql-starter',
+            type: 'sql',
+            title: 'Starter Query',
+            source: `-- Write your SQL here after connecting a warehouse or local DuckDB/file source\n-- Example: SELECT * FROM analytics.customers LIMIT 10;`,
+        },
+        {
+            id: 'dql-example',
+            type: 'dql',
+            title: 'Example Domain Layer',
+            source: `term "Customer" {\n  domain = "Customer"\n  type = "entity"\n  status = "draft"\n  description = "A person or account that can place orders or receive service."\n  owner = "customer-analytics"\n  identifiers = ["customer_id"]\n}\n\nblock "Example Customer Rollup" {\n  domain = "Customer"\n  type = "custom"\n  status = "draft"\n  description = "Starter customer summary block. Replace this query with your own source table."\n  owner = "analytics"\n  terms = ["Customer"]\n  businessOutcome = "Understand customer value and activity."\n  decisionUse = "Account planning and retention review."\n\n  query = """\n    SELECT 1 AS customer_count\n  """\n\n  tests {\n    assert row_count == 1\n  }\n}\n\nbusiness_view "Customer 360" {\n  domain = "Customer"\n  status = "draft"\n  description = "Business composition for account review and customer health."\n  owner = "customer-analytics"\n  terms = ["Customer"]\n  businessOutcome = "See customer identity, value, activity, and service risk in one lineage path."\n  decisionUse = "Account planning, churn review, and expansion targeting."\n  reviewCadence = "weekly"\n\n  includes {\n    block "Example Customer Rollup"\n  }\n}`,
+        },
+        {
+            id: 'next-steps',
+            type: 'markdown',
+            title: 'Next Steps',
+            source: `## Next steps\n\n1. Add data by connecting a warehouse or adding a local DuckDB/file source.\n2. Save repeated SQL as DQL blocks under \`blocks/\`.\n3. Add business terms under \`terms/\` for shared vocabulary.\n4. Compose blocks into \`business_view\` files under \`business-views/\`.\n5. Run \`zlens compile .\` and open Lineage to inspect the business and technical path.`,
+        },
+    ], { description: 'DQL workbench for building a domain-first analytics project.', template: 'default' });
+}
+//# 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,32 @@
+import { type SemanticLayer } from '@zlens/core';
+import type { SQLParamSpec } from '@zlens/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 interface BuildExecutionPlanOptions {
+    semanticLayer?: SemanticLayer;
+    /**
+     * SQL compiled by the already-selected semantic adapter. When present it is
+     * authoritative; notebook planning only adds chart, parameter, variable, and
+     * test metadata and must not try a second native semantic compilation.
+     */
+    semanticSql?: string;
+    /** Driver name for SQL dialect selection (e.g. 'snowflake', 'bigquery'). */
+    driver?: string;
+    /** Maps semantic table names to actual database table names, e.g. order_items -> dev.order_items. */
+    tableMapping?: Record<string, string>;
+    /** Resolved typed values from the shared block invocation contract. */
+    parameters?: Record<string, unknown>;
+}
+export declare function buildExecutionPlan(cell: NotebookCell, options?: BuildExecutionPlanOptions): 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":"AAAA,OAAO,EAQL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGvE,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,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,yBAAyB,GAClC,qBAAqB,GAAG,IAAI,CA+E9B"}