@graphenedata/cli 0.0.15 → 0.0.17

package/README.md

@@ -0,0 +1,174 @@
+<div align="center">
+  <br/>
+  <a href="https://graphenedata.com">
+      <img height="125" alt="Graphene Logo" src="./assets/logo.png" />
+  </a>
+  <br/>
+  <br/>
+</div>
+
+<p align="center">
+  <b>Graphene</b> is a data analytics framework built for agents.
+  <br/>
+  Ask questions and build visualizations 10x faster when agents do the work.
+</p>
+
+<div align="center">
+  <a href="https://graphenedata.com">Website</a>
+  &nbsp;•&nbsp;
+  <a href="https://github.com/graphene-data/example-flights">Demo Project</a>
+  &nbsp;•&nbsp;
+  <a href="/docs/setup.md">Setup</a>
+</div>
+
+<br/>
+
+## Why Graphene?
+
+Graphene is an everything-as-code analytics framework for SQL-based data exploration, visualization, and reporting. It is designed with coding agents in mind as the primary user persona.
+
+It provides two critical pieces that allow coding agents to do better data work:
+
+1. **A semantic layer**, which yields more accurate queries. GSQL combines the power of SQL with the governance of metrics and modeled joins.
+2. **A dashboard file type**, which yields more consistent and polished visuals compared to raw Python or Javascript.
+
+**Design goals**
+
+- Token efficiency. Languages are designed to be brief with minimal boilerplate.
+- Agent ergonomics. Graphene is controlled entirely via CLI. All documentation is inside our agent skill.
+- High ceilings. GSQL follows ANSI and supports over 170 functions; Graphene's visualizations support anything that can be expressed with ECharts.
+
+### Versus traditional BI
+
+We believe coding agents coupled with an everything-as-code analytics stack beats traditional BI in several ways:
+
+- Broad ecosystem of SOTA LLMs, harnesses, skills, and tools
+- Leverage business-wide context from other tools or repos
+- Perform end-to-end tasks across tools, where analytics is just one step
+- More graceful change management and bulk refactors
+- Easily promote/demote logic into or out of the semantic layer
+- Version control and CI. Revert agent mistakes. Run tests on mission-critical dashboards.
+- Tight, complete iteration loops. Agents can validate before running, view dashboards, and iterate locally
+- Leverage continuous agents for self-healing codebases
+
+### Open, forever
+
+Graphene is free to use, forever. Your business logic lives in your repo and is never locked into a contract with us.
+
+### Rich visualizations
+
+Graphene pages support visualizations, input components for filtering and dynamic behaviors, and layout modes for monitoring-oriented dashboards vs. narrative-oriented notebooks.
+
+<img alt="Graphene Screenshots" src="./assets/page_examples.png"/>
+
+### Powerful, next-generation semantic layer
+
+Traditional semantic layers give you governance at the expense of capability. They tend to expose niche query APIs that agents aren't familiar with.
+
+GSQL's goal is to bring governance _without_ sacrificing capability. It behaves like regular SQL—with CTEs, subqueries, window functions, set operators, and more—but also adds in the concepts of measures and modeled joins from semantic layers.
+
+GSQL is inspired by [Malloy](https://github.com/malloydata/malloy), from the creator of LookML Lloyd Tabb, but implements it as good old SQL for agent familiarity.
+
+## Get started
+
+- [Try the demo project](https://github.com/graphene-data/example-flights)
+- [Create a new Graphene project](/docs/setup.md)
+
+Graphene currently supports Snowflake, BigQuery, ClickHouse, and local data (via DuckDB) as data sources. It is easy for us to add more - just ask.
+
+Once your project is set up, simply start the dev server via `npm exec graphene serve` (or `pnpm graphene serve`, etc. based on your package manager) and then prompt your coding agent to do analytics work: answer a data question, build a dashboard, edit the model, etc.
+
+## How it works
+
+Graphene itself is a CLI which can be installed via npm (or pnpm, yarn, etc.). The CLI can run and compile GSQL queries, render pages in the browser, check syntax, print screenshots, and more.
+
+A Graphene project can either be a standalone repo or a directory within a larger codebase (such as dbt). It is comprised of _semantic models_ via .gsql files and _pages_ via .md files.
+
+### GSQL and Graphene markdown
+
+Semantic models are defined like so:
+
+```sql
+table orders (
+  id BIGINT
+  user_id BIGINT
+  amount FLOAT
+  status STRING
+
+  join one users on user_id = users.id  -- many orders per user
+
+  is_complete: status = 'Complete'      -- dimension (scalar expression)
+  revenue: sum(amount)                  -- measure (agg expression)
+  aov: revenue / count(*)               -- measures can compose
+)
+
+table users (
+  id BIGINT
+  name VARCHAR
+
+  join many orders on id = orders.user_id
+)
+```
+
+Models are then queried via `select`, either directly via CLI or inside a Graphene markdown page like this.
+
+````md
+```sql top_customers
+select
+  users.name as name,   -- Use the dot operator to traverse the modeled join relationship
+  revenue               -- Invokes the measure
+from orders             -- A join statement here is not needed
+group by 1
+order by 2 desc
+limit 10
+```
+
+<BigValue data="orders" value="revenue" />
+<BarChart data="top_customers" x="name" y="revenue" />
+````
+
+## Documentation
+
+Graphene's entire documentation ships as an agent skill in the Graphene npm package. The source files are available [here](/docs).
+
+## FAQ
+
+<details><summary><b>Why coding agents?</b></summary>
+  <br/>
+  Context, mostly. If your BI stack lives in a folder right next to the rest of your company’s data and code, an agent can make smarter decisions on what it should be analyzing and why it matters.
+  <br/><br/>
+  The reverse is also true. If you’re working on building out some new feature or a recommendation for a new client, the agent doing that work can ground it’s approach in real data and past analytical insights.
+  <br/><br/>
+  Lock-in is the other big reason we hear. Folks post-SaaS are wary of having their data and dashboards locked away in some proprietary tool, or forced to use a single LLM provider. With Graphene, you own all the files in your repo. You can use whatever agent or LLM you’d like.
+</details>
+
+<details><summary><b>How do you make money?</b></summary>
+  <br/>
+  We’re building out Graphene Cloud as a turnkey solution to host the dashboards and reports your agent builds. We also host an MCP server and Slack bot that you can use for quick questions. If you'd like to pilot it, contact us <a href="https://graphenedata.com/contact-us">here</a>.
+</details>
+
+<details><summary><b>So does everyone have to use git and a coding agent to use Graphene for BI?</b></summary>
+  <br/>
+  If you just want to use this project and nothing more, yes. Our managed service, Graphene Cloud, offers a Slack agent, MCP server, and browser-based SaaS experience.
+</details>
+
+<details><summary><b>Is my data team out of a job?</b></summary>
+  <br/>
+  No, but we think the nature of the work is going to change. Instead of manually building out reports, data experts are going to be shaping the skills, models, and tools that the rest of their team uses to answer data questions.
+  <br/><br/>
+  Data teams are going to be focused on guiding agents on how to approach the trickiest and most nebulous data questions at a company. Questions that still require a data expert’s taste to get a good solution.
+</details>
+
+<details><summary><b>Can’t I just vibe code dashboards?</b></summary>
+  <br/>
+  You could! In fact a lot of the folks we’ve talked to have started down this route. The main problem you’ll run into is consistency. The look and feel of your dashboards and reports are all over the place, and in the worst case they end up using different formula to compute the same key metric.
+  <br/><br/>
+  GSQL codifies metrics into deterministic objects you can directly invoke in queries. Not only does this ensure that every use of "EBITDA" will be the same, the metadata tags we attach can hint our charts into formatting data correctly.
+  <br/><br/>
+  Graphene raises the floor so that pages you generate with the help of an agent look beautiful by default, so you can move faster with less tokens.
+</details>
+
+<details><summary><b>What software license does this use?</b></summary>
+  <br/>
+  Graphene is licensed under the Elastic License 2.0 which allows you to use it for internal use cases for free, forever. If you would like to build your own commercial application with Graphene, please contact us <a href="https://graphenedata.com/contact-us">here</a>.
+</details>

package/dist/cli/bigQuery-OQUNH3VT.js

@@ -0,0 +1,75 @@
+import {
+  config
+} from "./chunk-56K2FF57.js";
+
+// connections/bigQuery.ts
+import { BigQuery, BigQueryDate, BigQueryTimestamp } from "@google-cloud/bigquery";
+function validateBigQueryIdent(ident) {
+  if (!/^[\w.-]+$/.test(ident)) throw new Error(`Invalid BigQuery identifier: ${ident}`);
+}
+var BigQueryConnection = class {
+  client;
+  projectId;
+  defaultNamespace;
+  constructor(options = {}) {
+    options.projectId ||= config.bigquery?.projectId;
+    if (!options.projectId) throw new Error("projectId must be set in config or provided in service account credentials");
+    this.projectId = options.projectId;
+    this.client = new BigQuery({ ...options, userAgent: "Graphene" });
+    this.defaultNamespace = config.defaultNamespace;
+  }
+  async runQuery(sql, params) {
+    let [job] = await this.client.createQueryJob({ query: sql, useLegacySql: false, params });
+    let [rows] = await job.getQueryResults({ maxResults: 1e4 });
+    let metadata = job.metadata || (await job.getMetadata())[0];
+    let totalRows = Number(metadata?.statistics?.query?.totalRows ?? rows.length);
+    rows.forEach((r) => {
+      Object.entries(r).forEach(([k, v]) => {
+        if (v instanceof BigQueryTimestamp) r[k] = v.value;
+        if (v instanceof BigQueryDate) r[k] = v.value;
+      });
+    });
+    return { rows, totalRows };
+  }
+  async listDatasets() {
+    let [datasets] = await this.client.getDatasets();
+    return datasets.map((d) => String(d.id || d.metadata.datasetReference?.datasetId || "").toLowerCase());
+  }
+  async listTables(dataset) {
+    if (!dataset) throw new Error("BigQuery requires a dataset");
+    validateBigQueryIdent(dataset);
+    let resolvedDataset = await this.resolveDatasetName(dataset);
+    let res = await this.runQuery(`select table_name as table_name
+      from \`${resolvedDataset}.INFORMATION_SCHEMA.TABLES\`
+      where table_type in ('BASE TABLE', 'VIEW') order by table_name`);
+    return res.rows.map((r) => `${resolvedDataset.toLowerCase()}.${String(r["table_name"]).toLowerCase()}`);
+  }
+  async describeTable(target) {
+    let parts = target.split(".");
+    let table = parts.pop() || "";
+    let dataset = parts.join(".") || this.defaultNamespace;
+    if (!dataset) throw new Error("No dataset specified and no default namespace configured");
+    validateBigQueryIdent(dataset);
+    let resolvedDataset = await this.resolveDatasetName(dataset);
+    let sql = `
+      select column_name as column_name, data_type as data_type, ordinal_position as ordinal_position
+      from \`${resolvedDataset}.INFORMATION_SCHEMA.COLUMNS\`
+      where lower(table_name) = lower(@table)
+      order by ordinal_position
+    `.trim();
+    let res = await this.runQuery(sql, { table });
+    return res.rows.map((row) => {
+      return { name: String(row["column_name"]).toLowerCase(), dataType: String(row["data_type"]) };
+    });
+  }
+  async resolveDatasetName(name) {
+    let datasets = await this.listDatasets();
+    return datasets.find((ds) => ds.toLowerCase() == name.toLowerCase()) || name;
+  }
+  async close() {
+  }
+};
+export {
+  BigQueryConnection
+};
+//# sourceMappingURL=bigQuery-OQUNH3VT.js.map

package/dist/cli/bigQuery-OQUNH3VT.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../connections/bigQuery.ts"],
+  "sourcesContent": ["import {BigQuery, BigQueryDate, BigQueryTimestamp, type BigQueryOptions} from '@google-cloud/bigquery'\n\nimport {config} from '../../lang/config.ts'\nimport {type QueryConnection, type QueryResult, type SchemaColumn, type QueryParams} from './types.ts'\n\n// BigQuery identifiers can contain letters, numbers, underscores, and hyphens\nfunction validateBigQueryIdent(ident: string) {\n  if (!/^[\\w.-]+$/.test(ident)) throw new Error(`Invalid BigQuery identifier: ${ident}`)\n}\n\nexport class BigQueryConnection implements QueryConnection {\n  private readonly client: BigQuery\n  private readonly projectId: string\n  private readonly defaultNamespace?: string\n\n  constructor(options: BigQueryOptions = {}) {\n    options.projectId ||= config.bigquery?.projectId\n    if (!options.projectId) throw new Error('projectId must be set in config or provided in service account credentials')\n    this.projectId = options.projectId\n    this.client = new BigQuery({...options, userAgent: 'Graphene'})\n    this.defaultNamespace = config.defaultNamespace\n  }\n\n  async runQuery(sql: string, params?: QueryParams): Promise<QueryResult> {\n    let [job] = await this.client.createQueryJob({query: sql, useLegacySql: false, params})\n    let [rows] = await job.getQueryResults({maxResults: 10000})\n    let metadata = job.metadata || (await job.getMetadata())[0]\n    let totalRows = Number(metadata?.statistics?.query?.totalRows ?? rows.length)\n\n    rows.forEach(r => {\n      Object.entries(r).forEach(([k, v]) => {\n        if (v instanceof BigQueryTimestamp) r[k] = v.value\n        if (v instanceof BigQueryDate) r[k] = v.value\n      })\n    })\n\n    return {rows, totalRows}\n  }\n\n  async listDatasets(): Promise<string[]> {\n    let [datasets] = await this.client.getDatasets()\n    return datasets.map(d => String(d.id || d.metadata.datasetReference?.datasetId || '').toLowerCase())\n  }\n\n  async listTables(dataset?: string): Promise<string[]> {\n    if (!dataset) throw new Error('BigQuery requires a dataset')\n    validateBigQueryIdent(dataset)\n\n    let resolvedDataset = await this.resolveDatasetName(dataset)\n    let res = await this.runQuery(`select table_name as table_name\n      from \\`${resolvedDataset}.INFORMATION_SCHEMA.TABLES\\`\n      where table_type in ('BASE TABLE', 'VIEW') order by table_name`)\n\n    return res.rows.map(r => `${resolvedDataset.toLowerCase()}.${String(r['table_name']).toLowerCase()}`)\n  }\n\n  async describeTable(target: string): Promise<SchemaColumn[]> {\n    let parts = target.split('.')\n    let table = parts.pop() || ''\n    let dataset = parts.join('.') || this.defaultNamespace\n    if (!dataset) throw new Error('No dataset specified and no default namespace configured')\n    validateBigQueryIdent(dataset)\n    let resolvedDataset = await this.resolveDatasetName(dataset)\n    let sql = `\n      select column_name as column_name, data_type as data_type, ordinal_position as ordinal_position\n      from \\`${resolvedDataset}.INFORMATION_SCHEMA.COLUMNS\\`\n      where lower(table_name) = lower(@table)\n      order by ordinal_position\n    `.trim()\n    let res = await this.runQuery(sql, {table})\n    return res.rows.map(row => {\n      return {name: String(row['column_name']).toLowerCase(), dataType: String(row['data_type'])}\n    })\n  }\n\n  async resolveDatasetName(name: string): Promise<string> {\n    let datasets = await this.listDatasets()\n    return datasets.find(ds => ds.toLowerCase() == name.toLowerCase()) || name\n  }\n\n  async close(): Promise<void> {}\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli/chunk-56K2FF57.js

@@ -0,0 +1,53 @@
+// ../lang/config.ts
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "path";
+var config = { dialect: "duckdb", root: "" };
+function setGlobalConfig(cfg) {
+  Object.keys(config).forEach((key) => delete config[key]);
+  Object.assign(config, normalizeConfig(cfg));
+}
+function normalizeConfig(input, defaultRoot = process.cwd()) {
+  let cfg = { ...input };
+  if (cfg.namespace && !cfg.defaultNamespace) cfg.defaultNamespace = cfg.namespace;
+  let dialect = cfg.dialect || "duckdb";
+  if (cfg.bigquery) dialect = "bigquery";
+  else if (cfg.snowflake) dialect = "snowflake";
+  else if (cfg.clickhouse) dialect = "clickhouse";
+  else if (cfg.duckdb) dialect = "duckdb";
+  let envFile = [".env"];
+  if (Array.isArray(cfg.envFile)) envFile = cfg.envFile;
+  else if (cfg.envFile) envFile = [cfg.envFile];
+  return {
+    ...cfg,
+    dialect,
+    root: path.resolve(cfg.root || defaultRoot),
+    port: cfg.port || Number(process.env.GRAPHENE_PORT) || 4e3,
+    ignoredFiles: cfg.ignoredFiles || ["**/agents.md", "**/claude.md"],
+    envFile
+  };
+}
+async function loadConfig(dir, envLoader) {
+  let configDir = path.resolve(dir);
+  while (!existsSync(path.join(configDir, "package.json"))) {
+    let parent = path.dirname(configDir);
+    if (parent == configDir) throw new Error(`No package.json found in ${path.resolve(dir)} or its parents`);
+    configDir = parent;
+  }
+  let txt = await readFile(path.join(configDir, "package.json"), "utf8");
+  let graphene = JSON.parse(txt).graphene;
+  if (!graphene || typeof graphene != "object" || Array.isArray(graphene)) {
+    throw new Error(`No graphene config found in ${path.join(configDir, "package.json")}`);
+  }
+  let envFiles = Array.isArray(graphene.envFile) ? graphene.envFile : [graphene.envFile || ".env"];
+  envLoader(envFiles.map((file) => path.resolve(configDir, file)));
+  let cfg = normalizeConfig({ ...graphene, root: configDir }, configDir);
+  return cfg;
+}
+
+export {
+  config,
+  setGlobalConfig,
+  loadConfig
+};
+//# sourceMappingURL=chunk-56K2FF57.js.map

package/dist/cli/chunk-56K2FF57.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../lang/config.ts"],
+  "sourcesContent": ["import {existsSync} from 'node:fs'\nimport {readFile} from 'node:fs/promises'\nimport path from 'path'\n\nexport interface Config {\n  root: string\n  dialect: string\n  defaultNamespace?: string\n  ignoredFiles: string[]\n  telemetry?: boolean\n  port?: number\n  host?: string\n  envFile: string[] // array of paths where we can look for the env file\n\n  bigquery?: {\n    projectId?: string\n    keyPath?: string\n  }\n\n  snowflake?: {\n    account: string\n    username: string\n    privateKeyPath: string\n    schema?: string\n    database?: string\n  }\n\n  clickhouse?: {\n    url?: string\n    username?: string\n    database?: string\n    requestTimeout?: number\n  }\n\n  duckdb?: {\n    path?: string\n  }\n}\n\nexport type ConfigInput = Omit<Config, 'root' | 'dialect' | 'ignoredFiles' | 'envFile'> & {\n  root?: string\n  dialect?: Config['dialect']\n  ignoredFiles?: Config['ignoredFiles']\n  envFile?: string | string[]\n  namespace?: string\n}\n\nexport let config: Config = {dialect: 'duckdb', root: ''} as Config\n\nexport function setGlobalConfig(cfg: ConfigInput) {\n  Object.keys(config).forEach(key => delete config[key])\n  Object.assign(config, normalizeConfig(cfg))\n}\n\nexport function normalizeConfig(input: ConfigInput, defaultRoot = process.cwd()): Config {\n  let cfg = {...input}\n  if (cfg.namespace && !cfg.defaultNamespace) cfg.defaultNamespace = cfg.namespace\n\n  let dialect = cfg.dialect || 'duckdb'\n  if (cfg.bigquery) dialect = 'bigquery'\n  else if (cfg.snowflake) dialect = 'snowflake'\n  else if (cfg.clickhouse) dialect = 'clickhouse'\n  else if (cfg.duckdb) dialect = 'duckdb'\n  let envFile = ['.env']\n  if (Array.isArray(cfg.envFile)) envFile = cfg.envFile\n  else if (cfg.envFile) envFile = [cfg.envFile]\n\n  return {\n    ...cfg,\n    dialect,\n    root: path.resolve(cfg.root || defaultRoot),\n    port: cfg.port || Number(process.env.GRAPHENE_PORT) || 4000,\n    ignoredFiles: cfg.ignoredFiles || ['**/agents.md', '**/claude.md'],\n    envFile,\n  } as Config\n}\n\n// Read graphene config from the nearest parent package.json.\nexport async function loadConfig(dir: string, envLoader: (envFiles: string[]) => void): Promise<Config> {\n  // seek upwards from dir looking for package.json\n  let configDir = path.resolve(dir)\n  while (!existsSync(path.join(configDir, 'package.json'))) {\n    let parent = path.dirname(configDir)\n    if (parent == configDir) throw new Error(`No package.json found in ${path.resolve(dir)} or its parents`)\n    configDir = parent\n  }\n\n  let txt = await readFile(path.join(configDir, 'package.json'), 'utf8')\n  let graphene = JSON.parse(txt).graphene\n  if (!graphene || typeof graphene != 'object' || Array.isArray(graphene)) {\n    throw new Error(`No graphene config found in ${path.join(configDir, 'package.json')}`)\n  }\n\n  // config can provide 1 or more env files that Graphene should load. Default to just `.env`\n  let envFiles = Array.isArray(graphene.envFile) ? graphene.envFile : [graphene.envFile || '.env']\n  envLoader(envFiles.map(file => path.resolve(configDir, file)))\n\n  let cfg = normalizeConfig({...graphene, root: configDir}, configDir)\n  return cfg\n}\n"],
+  "mappings": ";AAAA,SAAQ,kBAAiB;AACzB,SAAQ,gBAAe;AACvB,OAAO,UAAU;AA6CV,IAAI,SAAiB,EAAC,SAAS,UAAU,MAAM,GAAE;AAEjD,SAAS,gBAAgB,KAAkB;AAChD,SAAO,KAAK,MAAM,EAAE,QAAQ,SAAO,OAAO,OAAO,GAAG,CAAC;AACrD,SAAO,OAAO,QAAQ,gBAAgB,GAAG,CAAC;AAC5C;AAEO,SAAS,gBAAgB,OAAoB,cAAc,QAAQ,IAAI,GAAW;AACvF,MAAI,MAAM,EAAC,GAAG,MAAK;AACnB,MAAI,IAAI,aAAa,CAAC,IAAI,iBAAkB,KAAI,mBAAmB,IAAI;AAEvE,MAAI,UAAU,IAAI,WAAW;AAC7B,MAAI,IAAI,SAAU,WAAU;AAAA,WACnB,IAAI,UAAW,WAAU;AAAA,WACzB,IAAI,WAAY,WAAU;AAAA,WAC1B,IAAI,OAAQ,WAAU;AAC/B,MAAI,UAAU,CAAC,MAAM;AACrB,MAAI,MAAM,QAAQ,IAAI,OAAO,EAAG,WAAU,IAAI;AAAA,WACrC,IAAI,QAAS,WAAU,CAAC,IAAI,OAAO;AAE5C,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA,MAAM,KAAK,QAAQ,IAAI,QAAQ,WAAW;AAAA,IAC1C,MAAM,IAAI,QAAQ,OAAO,QAAQ,IAAI,aAAa,KAAK;AAAA,IACvD,cAAc,IAAI,gBAAgB,CAAC,gBAAgB,cAAc;AAAA,IACjE;AAAA,EACF;AACF;AAGA,eAAsB,WAAW,KAAa,WAA0D;AAEtG,MAAI,YAAY,KAAK,QAAQ,GAAG;AAChC,SAAO,CAAC,WAAW,KAAK,KAAK,WAAW,cAAc,CAAC,GAAG;AACxD,QAAI,SAAS,KAAK,QAAQ,SAAS;AACnC,QAAI,UAAU,UAAW,OAAM,IAAI,MAAM,4BAA4B,KAAK,QAAQ,GAAG,CAAC,iBAAiB;AACvG,gBAAY;AAAA,EACd;AAEA,MAAI,MAAM,MAAM,SAAS,KAAK,KAAK,WAAW,cAAc,GAAG,MAAM;AACrE,MAAI,WAAW,KAAK,MAAM,GAAG,EAAE;AAC/B,MAAI,CAAC,YAAY,OAAO,YAAY,YAAY,MAAM,QAAQ,QAAQ,GAAG;AACvE,UAAM,IAAI,MAAM,+BAA+B,KAAK,KAAK,WAAW,cAAc,CAAC,EAAE;AAAA,EACvF;AAGA,MAAI,WAAW,MAAM,QAAQ,SAAS,OAAO,IAAI,SAAS,UAAU,CAAC,SAAS,WAAW,MAAM;AAC/F,YAAU,SAAS,IAAI,UAAQ,KAAK,QAAQ,WAAW,IAAI,CAAC,CAAC;AAE7D,MAAI,MAAM,gBAAgB,EAAC,GAAG,UAAU,MAAM,UAAS,GAAG,SAAS;AACnE,SAAO;AACT;",
+  "names": []
+}