@useatlas/create 0.0.1

package/templates/nextjs-standalone/data/demo-semantic/catalog.yml

@@ -0,0 +1,40 @@
+version: '1.0'
+entities:
+  - name: Accounts
+    file: entities/accounts.yml
+    grain: one row per account record
+    description: accounts (80 rows, 7 columns)
+    use_for:
+      - Segmentation by plan, status
+      - Aggregation on monthly_value
+      - Cross-entity analysis via companies
+    common_questions:
+      - How many accounts by plan?
+      - How many accounts by status?
+      - What is the average monthly_value across accounts?
+      - How are accounts distributed across companies?
+  - name: Companies
+    file: entities/companies.yml
+    grain: one row per company record
+    description: companies (50 rows, 8 columns)
+    use_for:
+      - Aggregation on employee_count, founded_year, revenue, valuation
+    common_questions:
+      - What is the average employee_count across companies?
+  - name: People
+    file: entities/people.yml
+    grain: one row per person record
+    description: people (198 rows, 8 columns)
+    use_for:
+      - Segmentation by department, seniority
+      - Cross-entity analysis via companies
+    common_questions:
+      - How many people by department?
+      - How many people by seniority?
+      - How are people distributed across companies?
+glossary: glossary.yml
+metrics:
+  - file: metrics/accounts.yml
+    description: Auto-generated metrics for accounts
+  - file: metrics/companies.yml
+    description: Auto-generated metrics for companies

package/templates/nextjs-standalone/data/demo-semantic/entities/accounts.yml

@@ -0,0 +1,170 @@
+name: Accounts
+type: fact_table
+table: accounts
+grain: one row per account record
+description: Auto-profiled schema for accounts (80 rows). Contains 7 columns, linked to companies.
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key
+    primary_key: true
+    unique_count: 80
+    sample_values:
+      - '1'
+      - '2'
+      - '3'
+      - '4'
+      - '5'
+      - '6'
+      - '7'
+      - '8'
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies
+    unique_count: 50
+    sample_values:
+      - '1'
+      - '2'
+      - '3'
+      - '4'
+      - '5'
+      - '6'
+      - '7'
+      - '8'
+  - name: plan
+    sql: plan
+    type: string
+    unique_count: 4
+    sample_values:
+      - Enterprise
+      - Free
+      - Pro
+      - Starter
+  - name: status
+    sql: status
+    type: string
+    unique_count: 4
+    sample_values:
+      - Active
+      - Churned
+      - Inactive
+      - Suspended
+  - name: monthly_value
+    sql: monthly_value
+    type: number
+    unique_count: 41
+    sample_values:
+      - '0'
+      - '49'
+      - '59'
+      - '69'
+      - '79'
+      - '89'
+      - '299'
+      - '350'
+  - name: contract_start
+    sql: contract_start
+    type: date
+    unique_count: 49
+    sample_values:
+      - Sat Jun 01 2019 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Thu Aug 01 2019 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Fri Nov 01 2019 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Wed Jan 01 2020 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Sat Feb 01 2020 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Sun Mar 01 2020 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Wed Apr 01 2020 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Fri May 01 2020 00:00:00 GMT-0400 (Eastern Daylight Time)
+  - name: contract_end
+    sql: contract_end
+    type: date
+    unique_count: 10
+    null_count: 70
+    sample_values:
+      - Fri Jan 01 2021 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Sat May 01 2021 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Wed Feb 01 2023 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Wed Mar 01 2023 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Sat Apr 01 2023 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Mon May 01 2023 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Thu Jun 01 2023 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Tue Aug 01 2023 00:00:00 GMT-0400 (Eastern Daylight Time)
+  - name: monthly_value_bucket
+    sql: |-
+      CASE
+        WHEN monthly_value < (SELECT PERCENTILE_CONT(0.33) WITHIN GROUP (ORDER BY monthly_value) FROM accounts) THEN 'Low'
+        WHEN monthly_value < (SELECT PERCENTILE_CONT(0.66) WITHIN GROUP (ORDER BY monthly_value) FROM accounts) THEN 'Medium'
+        ELSE 'High'
+      END
+    type: string
+    description: monthly value bucketed into Low/Medium/High terciles
+    virtual: true
+    sample_values:
+      - Low
+      - Medium
+      - High
+  - name: contract_start_year
+    sql: EXTRACT(YEAR FROM contract_start)
+    type: number
+    description: Year extracted from contract_start
+    virtual: true
+  - name: contract_start_month
+    sql: TO_CHAR(contract_start, 'YYYY-MM')
+    type: string
+    description: Year-month extracted from contract_start
+    virtual: true
+  - name: contract_end_year
+    sql: EXTRACT(YEAR FROM contract_end)
+    type: number
+    description: Year extracted from contract_end
+    virtual: true
+  - name: contract_end_month
+    sql: TO_CHAR(contract_end, 'YYYY-MM')
+    type: string
+    description: Year-month extracted from contract_end
+    virtual: true
+measures:
+  - name: account_count
+    sql: id
+    type: count_distinct
+  - name: total_monthly_value
+    sql: monthly_value
+    type: sum
+    description: Sum of monthly value
+  - name: avg_monthly_value
+    sql: monthly_value
+    type: avg
+    description: Average monthly value
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each account belongs to one company
+use_cases:
+  - Use for segmentation analysis by plan, status
+  - Use for aggregation and trends on monthly_value
+  - Use for time-series analysis using contract_start, contract_end
+  - Join with companies for cross-entity analysis
+query_patterns:
+  - description: Accounts by plan
+    sql: |-
+      SELECT plan, COUNT(*) as count
+      FROM accounts
+      GROUP BY plan
+      ORDER BY count DESC
+  - description: Accounts by status
+    sql: |-
+      SELECT status, COUNT(*) as count
+      FROM accounts
+      GROUP BY status
+      ORDER BY count DESC
+  - description: Total monthly_value by plan
+    sql: |-
+      SELECT plan, SUM(monthly_value) as total_monthly_value, COUNT(*) as count
+      FROM accounts
+      GROUP BY plan
+      ORDER BY total_monthly_value DESC

package/templates/nextjs-standalone/data/demo-semantic/entities/companies.yml

@@ -0,0 +1,207 @@
+name: Companies
+type: fact_table
+table: companies
+grain: one row per company record
+description: Auto-profiled schema for companies (50 rows). Contains 8 columns.
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key
+    primary_key: true
+    unique_count: 50
+    sample_values:
+      - '1'
+      - '2'
+      - '3'
+      - '4'
+      - '5'
+      - '6'
+      - '7'
+      - '8'
+  - name: name
+    sql: name
+    type: string
+    unique_count: 50
+    sample_values:
+      - Acme Corp
+      - AdTech Global
+      - AutoForge
+      - BioGenix
+      - BrightMinds
+      - CartFlow
+      - CastMedia
+      - CleanJoule
+  - name: industry
+    sql: industry
+    type: string
+    unique_count: 8
+    sample_values:
+      - Education
+      - Energy
+      - Finance
+      - Healthcare
+      - Manufacturing
+      - Media
+      - Retail
+      - Technology
+  - name: employee_count
+    sql: employee_count
+    type: number
+    unique_count: 46
+    sample_values:
+      - '50'
+      - '55'
+      - '60'
+      - '65'
+      - '70'
+      - '75'
+      - '80'
+      - '85'
+  - name: founded_year
+    sql: founded_year
+    type: number
+    unique_count: 19
+    sample_values:
+      - '2004'
+      - '2005'
+      - '2006'
+      - '2007'
+      - '2008'
+      - '2009'
+      - '2010'
+      - '2011'
+  - name: country
+    sql: country
+    type: string
+    unique_count: 10
+    sample_values:
+      - AU
+      - BR
+      - CA
+      - DE
+      - FR
+      - IN
+      - JP
+      - SG
+  - name: revenue
+    sql: revenue
+    type: number
+    unique_count: 50
+    sample_values:
+      - '2000000'
+      - '2500000'
+      - '3500000'
+      - '4000000'
+      - '5000000'
+      - '6000000'
+      - '6500000'
+      - '7000000'
+  - name: valuation
+    sql: valuation
+    type: number
+    unique_count: 46
+    sample_values:
+      - '16000000'
+      - '20000000'
+      - '25000000'
+      - '28000000'
+      - '30000000'
+      - '32000000'
+      - '35000000'
+      - '40000000'
+  - name: employee_count_bucket
+    sql: |-
+      CASE
+        WHEN employee_count < (SELECT PERCENTILE_CONT(0.33) WITHIN GROUP (ORDER BY employee_count) FROM companies) THEN 'Low'
+        WHEN employee_count < (SELECT PERCENTILE_CONT(0.66) WITHIN GROUP (ORDER BY employee_count) FROM companies) THEN 'Medium'
+        ELSE 'High'
+      END
+    type: string
+    description: employee count bucketed into Low/Medium/High terciles
+    virtual: true
+    sample_values:
+      - Low
+      - Medium
+      - High
+  - name: founded_year_bucket
+    sql: |-
+      CASE
+        WHEN founded_year < (SELECT PERCENTILE_CONT(0.33) WITHIN GROUP (ORDER BY founded_year) FROM companies) THEN 'Low'
+        WHEN founded_year < (SELECT PERCENTILE_CONT(0.66) WITHIN GROUP (ORDER BY founded_year) FROM companies) THEN 'Medium'
+        ELSE 'High'
+      END
+    type: string
+    description: founded year bucketed into Low/Medium/High terciles
+    virtual: true
+    sample_values:
+      - Low
+      - Medium
+      - High
+  - name: revenue_bucket
+    sql: |-
+      CASE
+        WHEN revenue < (SELECT PERCENTILE_CONT(0.33) WITHIN GROUP (ORDER BY revenue) FROM companies) THEN 'Low'
+        WHEN revenue < (SELECT PERCENTILE_CONT(0.66) WITHIN GROUP (ORDER BY revenue) FROM companies) THEN 'Medium'
+        ELSE 'High'
+      END
+    type: string
+    description: revenue bucketed into Low/Medium/High terciles
+    virtual: true
+    sample_values:
+      - Low
+      - Medium
+      - High
+  - name: valuation_bucket
+    sql: |-
+      CASE
+        WHEN valuation < (SELECT PERCENTILE_CONT(0.33) WITHIN GROUP (ORDER BY valuation) FROM companies) THEN 'Low'
+        WHEN valuation < (SELECT PERCENTILE_CONT(0.66) WITHIN GROUP (ORDER BY valuation) FROM companies) THEN 'Medium'
+        ELSE 'High'
+      END
+    type: string
+    description: valuation bucketed into Low/Medium/High terciles
+    virtual: true
+    sample_values:
+      - Low
+      - Medium
+      - High
+measures:
+  - name: company_count
+    sql: id
+    type: count_distinct
+  - name: total_employee_count
+    sql: employee_count
+    type: sum
+    description: Sum of employee count
+  - name: avg_employee_count
+    sql: employee_count
+    type: avg
+    description: Average employee count
+  - name: total_founded_year
+    sql: founded_year
+    type: sum
+    description: Sum of founded year
+  - name: avg_founded_year
+    sql: founded_year
+    type: avg
+    description: Average founded year
+  - name: total_revenue
+    sql: revenue
+    type: sum
+    description: Sum of revenue
+  - name: avg_revenue
+    sql: revenue
+    type: avg
+    description: Average revenue
+  - name: total_valuation
+    sql: valuation
+    type: sum
+    description: Sum of valuation
+  - name: avg_valuation
+    sql: valuation
+    type: avg
+    description: Average valuation
+use_cases:
+  - Use for aggregation and trends on employee_count, founded_year, revenue, valuation
+  - Avoid for row-level accounts/people queries — use those entities directly

package/templates/nextjs-standalone/data/demo-semantic/entities/people.yml

@@ -0,0 +1,145 @@
+name: People
+type: fact_table
+table: people
+grain: one row per person record
+description: Auto-profiled schema for people (198 rows). Contains 8 columns, linked to companies.
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key
+    primary_key: true
+    unique_count: 198
+    sample_values:
+      - '1'
+      - '2'
+      - '3'
+      - '4'
+      - '5'
+      - '6'
+      - '7'
+      - '8'
+  - name: name
+    sql: name
+    type: string
+    unique_count: 198
+    sample_values:
+      - Alex Brown
+      - Alex Chen
+      - Alex Garcia
+      - Alex Kim
+      - Alex Mueller
+      - Alex Patel
+      - Alex Silva
+      - Alex Smith
+  - name: email
+    sql: email
+    type: string
+    unique_count: 198
+    sample_values:
+      - alex.brown@company32.com
+      - alex.chen@company12.com
+      - alex.garcia@company42.com
+      - alex.kim@company32.com
+      - alex.mueller@company2.com
+      - alex.patel@company22.com
+      - alex.silva@company22.com
+      - alex.smith@company1.com
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies
+    unique_count: 50
+    sample_values:
+      - '1'
+      - '2'
+      - '3'
+      - '4'
+      - '5'
+      - '6'
+      - '7'
+      - '8'
+  - name: department
+    sql: department
+    type: string
+    unique_count: 6
+    sample_values:
+      - Engineering
+      - Finance
+      - Marketing
+      - Operations
+      - Product
+      - Sales
+  - name: seniority
+    sql: seniority
+    type: string
+    unique_count: 4
+    sample_values:
+      - Executive
+      - Junior
+      - Mid
+      - Senior
+  - name: title
+    sql: title
+    type: string
+    unique_count: 30
+    sample_values:
+      - Accountant
+      - Account Executive
+      - Backend Engineer
+      - Brand Manager
+      - CFO
+      - Content Strategist
+      - Controller
+      - Data Analyst
+  - name: start_date
+    sql: start_date
+    type: date
+    unique_count: 158
+    sample_values:
+      - Wed Jan 10 2018 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Mon Jan 15 2018 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Thu Feb 01 2018 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Sat Mar 10 2018 00:00:00 GMT-0500 (Eastern Standard Time)
+      - Tue Mar 20 2018 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Sun Apr 01 2018 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Sun Apr 15 2018 00:00:00 GMT-0400 (Eastern Daylight Time)
+      - Thu May 10 2018 00:00:00 GMT-0400 (Eastern Daylight Time)
+  - name: start_date_year
+    sql: EXTRACT(YEAR FROM start_date)
+    type: number
+    description: Year extracted from start_date
+    virtual: true
+  - name: start_date_month
+    sql: TO_CHAR(start_date, 'YYYY-MM')
+    type: string
+    description: Year-month extracted from start_date
+    virtual: true
+measures:
+  - name: person_count
+    sql: id
+    type: count_distinct
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each person belongs to one company
+use_cases:
+  - Use for segmentation analysis by department, seniority
+  - Use for time-series analysis using start_date
+  - Join with companies for cross-entity analysis
+query_patterns:
+  - description: People by department
+    sql: |-
+      SELECT department, COUNT(*) as count
+      FROM people
+      GROUP BY department
+      ORDER BY count DESC
+  - description: People by seniority
+    sql: |-
+      SELECT seniority, COUNT(*) as count
+      FROM people
+      GROUP BY seniority
+      ORDER BY count DESC

package/templates/nextjs-standalone/data/demo-semantic/glossary.yml

@@ -0,0 +1,22 @@
+terms:
+  name:
+    status: ambiguous
+    note: '"name" appears in multiple tables: companies, people. ASK the user which table they mean.'
+    possible_mappings:
+      - companies.name
+      - people.name
+  company:
+    status: defined
+    definition: Refers to the companies entity. Linked via accounts.company_id → companies.id.
+  plan:
+    status: defined
+    definition: 'Categorical field on accounts. Possible values: Enterprise, Free, Pro, Starter.'
+  status:
+    status: defined
+    definition: 'Categorical field on accounts. Possible values: Active, Churned, Inactive, Suspended.'
+  department:
+    status: defined
+    definition: 'Categorical field on people. Possible values: Engineering, Finance, Marketing, Operations, Product, Sales.'
+  seniority:
+    status: defined
+    definition: 'Categorical field on people. Possible values: Executive, Junior, Mid, Senior.'

package/templates/nextjs-standalone/data/demo-semantic/metrics/accounts.yml

@@ -0,0 +1,38 @@
+metrics:
+  - id: accounts_count
+    label: Total Accounts
+    description: Count of distinct accounts records.
+    type: atomic
+    sql: |-
+      SELECT COUNT(DISTINCT id) as count
+      FROM accounts
+    aggregation: count_distinct
+  - id: total_monthly_value
+    label: Total monthly value
+    description: Sum of monthly_value across all accounts.
+    type: atomic
+    source:
+      entity: Accounts
+      measure: total_monthly_value
+    sql: |-
+      SELECT SUM(monthly_value) as total_monthly_value
+      FROM accounts
+    aggregation: sum
+    objective: maximize
+  - id: avg_monthly_value
+    label: Average monthly value
+    description: Average monthly_value per account.
+    type: atomic
+    sql: |-
+      SELECT AVG(monthly_value) as avg_monthly_value
+      FROM accounts
+    aggregation: avg
+  - id: monthly_value_by_plan
+    label: monthly value by plan
+    description: monthly_value broken down by plan.
+    type: atomic
+    sql: |-
+      SELECT plan, SUM(monthly_value) as total_monthly_value, AVG(monthly_value) as avg_monthly_value, COUNT(*) as count
+      FROM accounts
+      GROUP BY plan
+      ORDER BY total_monthly_value DESC

package/templates/nextjs-standalone/data/demo-semantic/metrics/companies.yml

@@ -0,0 +1,89 @@
+metrics:
+  - id: companies_count
+    label: Total Companies
+    description: Count of distinct companies records.
+    type: atomic
+    sql: |-
+      SELECT COUNT(DISTINCT id) as count
+      FROM companies
+    aggregation: count_distinct
+  - id: total_employee_count
+    label: Total employee count
+    description: Sum of employee_count across all companies.
+    type: atomic
+    source:
+      entity: Companies
+      measure: total_employee_count
+    sql: |-
+      SELECT SUM(employee_count) as total_employee_count
+      FROM companies
+    aggregation: sum
+    objective: maximize
+  - id: avg_employee_count
+    label: Average employee count
+    description: Average employee_count per company.
+    type: atomic
+    sql: |-
+      SELECT AVG(employee_count) as avg_employee_count
+      FROM companies
+    aggregation: avg
+  - id: total_founded_year
+    label: Total founded year
+    description: Sum of founded_year across all companies.
+    type: atomic
+    source:
+      entity: Companies
+      measure: total_founded_year
+    sql: |-
+      SELECT SUM(founded_year) as total_founded_year
+      FROM companies
+    aggregation: sum
+    objective: maximize
+  - id: avg_founded_year
+    label: Average founded year
+    description: Average founded_year per company.
+    type: atomic
+    sql: |-
+      SELECT AVG(founded_year) as avg_founded_year
+      FROM companies
+    aggregation: avg
+  - id: total_revenue
+    label: Total revenue
+    description: Sum of revenue across all companies.
+    type: atomic
+    source:
+      entity: Companies
+      measure: total_revenue
+    sql: |-
+      SELECT SUM(revenue) as total_revenue
+      FROM companies
+    aggregation: sum
+    objective: maximize
+  - id: avg_revenue
+    label: Average revenue
+    description: Average revenue per company.
+    type: atomic
+    sql: |-
+      SELECT AVG(revenue) as avg_revenue
+      FROM companies
+    aggregation: avg
+  - id: total_valuation
+    label: Total valuation
+    description: Sum of valuation across all companies.
+    type: atomic
+    source:
+      entity: Companies
+      measure: total_valuation
+    sql: |-
+      SELECT SUM(valuation) as total_valuation
+      FROM companies
+    aggregation: sum
+    objective: maximize
+  - id: avg_valuation
+    label: Average valuation
+    description: Average valuation per company.
+    type: atomic
+    sql: |-
+      SELECT AVG(valuation) as avg_valuation
+      FROM companies
+    aggregation: avg