react-semaphor 0.1.419 → 0.1.421

package/dist/data-app-codegen-node/index.cjs

@@ -1,55 +1,57 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Z=require("../chunks/analyze-result-contract-DwRzl7yJ.js"),R=require("../chunks/update-policy-VloD-0YM.js"),ge=require("node:crypto"),ke="src/semaphor/generated",K=`// Generated by Semaphor Agent Plugin. Do not hand-edit analytics wiring here.
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const L=require("../chunks/analyze-result-contract-B5Eeu7vD.js"),R=require("../chunks/update-policy-qpyAkOyO.js"),ge=require("node:crypto"),Re="src/semaphor/generated",T=`// Generated by Semaphor Agent Plugin. Do not hand-edit analytics wiring here.
 // Regenerate from the accepted semaphor_plan_data_app codegenSummary when the plan changes.
-`;function Me(e,n={}){R.assertValidCodegenSummary(e);const r=Ce(e);if(r.views.length===0&&!n.allowEmpty)throw new Error("Contract generation produced zero executable views. Stop and ask for a different domain/goal or semantic model improvement; pass --allow-empty only for an explicit model-gap report.");const t=Oe(r),o=Ee({contract:r,files:t,generatorName:n.generatorName||"react-semaphor/data-app-codegen/node",generatorVersion:n.generatorVersion||"unknown"}),a={...t,"contract.manifest.json":`${JSON.stringify(o,null,2)}
-`};return{schemaVersion:R.GENERATED_CONTRACT_SCHEMA_VERSION,files:a,manifest:o,contentHash:String(o.generatedContentHash||""),usageExample:Ge(r),warnings:r.warnings,stats:{inputCount:r.inputs.length,executableViewCount:r.views.length,presentationViewCount:r.presentationViews.length,queryCount:r.views.length,optionQueryCount:r.optionQueries.length}}}function Ce(e){var u,d,c,i,p,w,g,$,F,M,V,C;const n=[],r=[];for(const s of e.inputs){h(r,s.fieldRef);for(const I of s.bindings||[])h(r,I.fieldRef);h(r,(u=s.optionQuery)==null?void 0:u.valueFieldRef),h(r,(d=s.optionQuery)==null?void 0:d.labelFieldRef),h(r,(c=s.optionQuery)==null?void 0:c.filterFieldRef),Q(r,(i=s.optionQuery)==null?void 0:i.spec)}for(const s of e.filterContracts){h(r,s.fieldRef),h(r,(p=s.optionQuery)==null?void 0:p.valueFieldRef),h(r,(w=s.optionQuery)==null?void 0:w.labelFieldRef),h(r,(g=s.optionQuery)==null?void 0:g.filterFieldRef),Q(r,($=s.optionQuery)==null?void 0:$.spec);for(const I of s.bindings||[])h(r,I.fieldRef)}for(const s of e.views){for(const I of s.fields||[])h(r,I);Q(r,(F=s.sdkSpec)==null?void 0:F.spec),Q(r,s.visualSpec)}const t=e.implementationChecklist||{};for(const s of Object.values(t.bindingsByView||{}))for(const I of Array.isArray(s)?s:[])h(r,I.fieldRef),h(r,I.optionValueField),h(r,I.optionLabelField);for(const s of t.requiredInputOptions||[])h(r,s.visibleLabelField),h(r,s.optionValueField),h(r,s.runtimeFilterField);const o=dn([...e.sources.map(s=>({raw:s,key:Ie(s),aliases:Fe(s),name:""})),...r.map(s=>sn(s)).filter(G)]);H(o,s=>{const I=b(s.raw);return q(s.raw.label||(I==null?void 0:I.datasetName)||(I==null?void 0:I.datasetId)||(I==null?void 0:I.name)||s.raw.kind||"source")});const a=pn(o),l=ne(r.filter(s=>s.name).map(s=>({raw:s,key:J(s),name:""})),s=>s.key);H(l,s=>q([s.raw.sourceKey?fn(s.raw.sourceKey):"",s.raw.aggregate?s.raw.aggregate.toLowerCase():"",s.raw.name].filter(Boolean).join("_")));const y=new Map(l.map(s=>[s.key,s.name])),S=e.inputs.map(s=>({raw:s,name:q(s.id||s.label||"input")}));H(S,s=>s.name);const f=S.filter(s=>!!s.raw.optionQuery).map(s=>({input:s,name:`${s.name}Options`,raw:s.raw.optionQuery}));H(f,s=>s.name);for(const s of f)an(s.raw.labelFieldRef,s.raw.valueFieldRef)&&un(s.raw.valueFieldRef)&&n.push(`Input option query ${((M=s.raw.spec)==null?void 0:M.inputId)||s.input.raw.id||s.name} uses identifier field ${s.raw.valueFieldRef.name} as both label and value. It can execute, but the UI will show key values unless the semantic model exposes a human-readable label through a modeled relationship.`);const m=e.views.filter(s=>{var I,B;return!!((I=s.sdkSpec)!=null&&I.builder&&((B=s.sdkSpec)!=null&&B.spec))}).map(s=>({raw:s,name:q(s.id||s.title||"query")}));H(m,s=>s.name);const O=e.views.filter(s=>fe(s)&&!("sdkSpec"in s)).map(s=>on(s));for(const s of e.views)(!("sdkSpec"in s)||!((V=s.sdkSpec)!=null&&V.builder)||!((C=s.sdkSpec)!=null&&C.spec))&&!fe(s)&&n.push(`Skipped view ${s.id||s.title||"unknown"} because it has no sdkSpec.`);return Ne({inputs:S,views:m,filterContracts:e.filterContracts}),{summary:e,title:e.title||"Semaphor Data App",sources:o,fields:l,inputs:S,optionQueries:f,views:m,presentationViews:O,filterContracts:e.filterContracts,checklist:t,sourceNameByKey:a,fieldNameByKey:y,warnings:n}}function Ne({inputs:e,views:n,filterContracts:r}){const t=new Set(e.map(a=>a.raw.id).filter(Boolean)),o=new Set(n.map(a=>a.raw.id).filter(Boolean));for(const[a,l]of r.entries()){if(!t.has(l.inputId))throw new Error(`filterContracts.${a}.inputId must reference a generated input.`);const y=new Set(l.appliesToViewIds||[]),S=new Set(l.notAppliedToViewIds||[]);for(const[f,m]of(l.appliesToViewIds||[]).entries())if(!o.has(m))throw new Error(`filterContracts.${a}.appliesToViewIds.${f} must reference an executable generated view.`);for(const[f,m]of(l.notAppliedToViewIds||[]).entries())if(!o.has(m))throw new Error(`filterContracts.${a}.notAppliedToViewIds.${f} must reference an executable generated view.`);for(const[f,m]of(l.bindings||[]).entries()){if(!o.has(m.viewId))throw new Error(`filterContracts.${a}.bindings.${f}.viewId must reference an executable generated view.`);if(!y.has(m.viewId))throw new Error(`filterContracts.${a}.bindings.${f}.viewId must be included in appliesToViewIds.`);if(S.has(m.viewId))throw new Error(`filterContracts.${a}.bindings.${f}.viewId must not be listed in notAppliedToViewIds.`)}}}function Oe(e){return{"sources.ts":Ke(e),"fields.ts":ve(e),"inputs.ts":je(e),"queries.ts":Qe(e),"bindings.ts":Le(e),"accessors.ts":ze(e),"metadata.ts":We(e),"index.ts":Ze()}}function Ee({contract:e,files:n,generatorName:r,generatorVersion:t}){return{schemaVersion:R.CONTRACT_MANIFEST_SCHEMA_VERSION,generatedContractSchemaVersion:R.GENERATED_CONTRACT_SCHEMA_VERSION,generator:{name:r,version:t},generatedContentHash:xe(n),codegenSummaryValidatorVersion:R.CODEGEN_SUMMARY_VALIDATOR_VERSION,codegenSummaryHash:Ae(e.summary),codegenSummary:e.summary}}function xe(e){const n=ge.createHash("sha256");for(const r of Object.keys(e).sort())n.update(r),n.update("\0"),n.update(e[r]),n.update("\0");return`sha256:${n.digest("hex")}`}function Ae(e){return`sha256:${ge.createHash("sha256").update(ue(e)).digest("hex")}`}function ue(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(t=>ue(t)).join(",")}]`;const n=e;return`{${Object.keys(n).sort().filter(t=>n[t]!==void 0).map(t=>`${JSON.stringify(t)}:${ue(n[t])}`).join(",")}}`}function Ge(e){const n=e.views.find(f=>T(f)&&_(f));if(n)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const sortOption = recordsSortOptionsForView.${n.name}[0];`,'const sort = sortOption ? { key: sortOption.key, direction: "asc" as const } : undefined;',`const query = queries.${n.name}({ page, pageSize, sort });`,`const result = useSemaphorQuery(query, queryOptionsForView.${n.name}(inputHandles));`,`const rows = rowsForView.${n.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const r=e.views.find(f=>T(f));if(r)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const sortOption = recordsSortOptionsForView.${r.name}[0];`,'const sort = sortOption ? { key: sortOption.key, direction: "asc" as const } : undefined;',`const query = queries.${r.name}({ sort });`,`const result = useSemaphorQuery(query, queryOptionsForView.${r.name}(inputHandles));`,`const rows = rowsForView.${r.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const t=e.views.find(f=>X(f)&&_(f));if(t)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const query = queries.${t.name}({ page, pageSize });`,`const result = useSemaphorQuery(query, queryOptionsForView.${t.name}(inputHandles));`,`const rows = rowsForView.${t.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const o=e.views.find(f=>pe(f)&&_(f));if(o)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const query = queries.${o.name}({ page, pageSize });`,`const result = useSemaphorQuery(query, queryOptionsForView.${o.name}(inputHandles));`,`const rows = rowsForView.${o.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const a=e.views.find(f=>{var m;return cn((m=f.raw.sdkSpec)==null?void 0:m.builder)});if(a)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${a.name}(), queryOptionsForView.${a.name}(inputHandles));`,`const rows = rowsForView.${a.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const l=e.views.find(f=>Te(f));if(l)return['import { appInputSpecs, createInputHandleMap, metricValuesForView, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${l.name}(), queryOptionsForView.${l.name}(inputHandles));`,`const metrics = metricValuesForView.${l.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const y=e.views[0];return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",y?`const result = useSemaphorQuery(queries.${y.name}(), queryOptionsForView.${y.name}(inputHandles));`:"const result = undefined;","const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`)}function X(e){var n;return j((n=e.raw.sdkSpec)==null?void 0:n.builder)==="records"}function Te(e){var n;return j((n=e.raw.sdkSpec)==null?void 0:n.builder)==="metric"}function T(e){var n,r,t;return X(e)&&((t=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.sorting)==null?void 0:t.mode)==="server"}function pe(e){var n;return j((n=e.raw.sdkSpec)==null?void 0:n.builder)==="sql"}function _(e){var n,r,t;return((t=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.pagination)==null?void 0:t.mode)==="server"}function _e(e){return X(e)&&(_(e)||T(e))||pe(e)&&_(e)}function Ke(e){const n=e.sources.map(({name:t,raw:o})=>{const a=He(o);return`  ${t}: ${a},`}).join(`
-`),r=e.sources.some(t=>t.raw.kind==="semantic")?`import { semaphor } from "react-semaphor/data-app-sdk";
-
-`:"";return`${K}
-${r}export const sources = {
-${n}
+`;function Me(e,r={}){R.assertValidCodegenSummary(e);const n=Ne(e);if(n.views.length===0&&!r.allowEmpty)throw new Error("Contract generation produced zero executable views. Stop and ask for a different domain/goal or semantic model improvement; pass --allow-empty only for an explicit model-gap report.");const t=Oe(n),o=Ee({contract:n,files:t,generatorName:r.generatorName||"react-semaphor/data-app-codegen/node",generatorVersion:r.generatorVersion||"unknown"}),i={...t,"contract.manifest.json":`${JSON.stringify(o,null,2)}
+`};return{schemaVersion:R.GENERATED_CONTRACT_SCHEMA_VERSION,files:i,manifest:o,contentHash:String(o.generatedContentHash||""),usageExample:ve(n),warnings:n.warnings,stats:{inputCount:n.inputs.length,executableViewCount:n.views.length,presentationViewCount:n.presentationViews.length,queryCount:n.views.length,optionQueryCount:n.optionQueries.length}}}function Ne(e){var u,d,p,$,s,g,h,y,I,V,b,M;const r=[],n=[];for(const a of e.inputs){S(n,a.fieldRef);for(const w of a.bindings||[])S(n,w.fieldRef);S(n,(u=a.optionQuery)==null?void 0:u.valueFieldRef),S(n,(d=a.optionQuery)==null?void 0:d.labelFieldRef),S(n,(p=a.optionQuery)==null?void 0:p.filterFieldRef),D(n,($=a.optionQuery)==null?void 0:$.spec)}for(const a of e.filterContracts){S(n,a.fieldRef),S(n,(s=a.optionQuery)==null?void 0:s.valueFieldRef),S(n,(g=a.optionQuery)==null?void 0:g.labelFieldRef),S(n,(h=a.optionQuery)==null?void 0:h.filterFieldRef),D(n,(y=a.optionQuery)==null?void 0:y.spec);for(const w of a.bindings||[])S(n,w.fieldRef)}for(const a of e.views){for(const w of a.fields||[])S(n,w);D(n,(I=a.sdkSpec)==null?void 0:I.spec),D(n,a.visualSpec)}const t=e.implementationChecklist||{};for(const a of Object.values(t.bindingsByView||{}))for(const w of Array.isArray(a)?a:[])S(n,w.fieldRef),S(n,w.optionValueField),S(n,w.optionLabelField);for(const a of t.requiredInputOptions||[])S(n,a.visibleLabelField),S(n,a.optionValueField),S(n,a.runtimeFilterField);const o=dr([...e.sources.map(a=>({raw:a,key:Ie(a),aliases:Fe(a),name:""})),...n.map(a=>sr(a)).filter(A)]);_(o,a=>{const w=k(a.raw);return j(a.raw.label||(w==null?void 0:w.datasetName)||(w==null?void 0:w.datasetId)||(w==null?void 0:w.name)||a.raw.kind||"source")});const i=lr(o),l=re(n.filter(a=>a.name).map(a=>({raw:a,key:z(a),name:""})),a=>a.key);_(l,a=>j([a.raw.sourceKey?fr(a.raw.sourceKey):"",a.raw.aggregate?a.raw.aggregate.toLowerCase():"",a.raw.name].filter(Boolean).join("_")));const f=new Map(l.map(a=>[a.key,a.name])),F=e.inputs.map(a=>({raw:a,name:j(a.id||a.label||"input")}));_(F,a=>a.name);const m=F.filter(a=>!!a.raw.optionQuery).map(a=>({input:a,name:`${a.name}Options`,raw:a.raw.optionQuery}));_(m,a=>a.name);for(const a of m)ir(a.raw.labelFieldRef,a.raw.valueFieldRef)&&ur(a.raw.valueFieldRef)&&r.push(`Input option query ${((V=a.raw.spec)==null?void 0:V.inputId)||a.input.raw.id||a.name} uses identifier field ${a.raw.valueFieldRef.name} as both label and value. It can execute, but the UI will show key values unless the semantic model exposes a human-readable label through a modeled relationship.`);const c=e.views.filter(a=>{var w,P;return!!((w=a.sdkSpec)!=null&&w.builder&&((P=a.sdkSpec)!=null&&P.spec))}).map(a=>({raw:a,name:j(a.id||a.title||"query")}));_(c,a=>a.name);const O=e.views.filter(a=>fe(a)&&!("sdkSpec"in a)).map(a=>ar(a));for(const a of e.views)(!("sdkSpec"in a)||!((b=a.sdkSpec)!=null&&b.builder)||!((M=a.sdkSpec)!=null&&M.spec))&&!fe(a)&&r.push(`Skipped view ${a.id||a.title||"unknown"} because it has no sdkSpec.`);return Ce({inputs:F,views:c,filterContracts:e.filterContracts}),{summary:e,title:e.title||"Semaphor Data App",sources:o,fields:l,inputs:F,optionQueries:m,views:c,presentationViews:O,filterContracts:e.filterContracts,checklist:t,sourceNameByKey:i,fieldNameByKey:f,warnings:r}}function Ce({inputs:e,views:r,filterContracts:n}){const t=new Set(e.map(i=>i.raw.id).filter(Boolean)),o=new Set(r.map(i=>i.raw.id).filter(Boolean));for(const[i,l]of n.entries()){if(!t.has(l.inputId))throw new Error(`filterContracts.${i}.inputId must reference a generated input.`);const f=new Set(l.appliesToViewIds||[]),F=new Set(l.notAppliedToViewIds||[]);for(const[m,c]of(l.appliesToViewIds||[]).entries())if(!o.has(c))throw new Error(`filterContracts.${i}.appliesToViewIds.${m} must reference an executable generated view.`);for(const[m,c]of(l.notAppliedToViewIds||[]).entries())if(!o.has(c))throw new Error(`filterContracts.${i}.notAppliedToViewIds.${m} must reference an executable generated view.`);for(const[m,c]of(l.bindings||[]).entries()){if(!o.has(c.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must reference an executable generated view.`);if(!f.has(c.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must be included in appliesToViewIds.`);if(F.has(c.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must not be listed in notAppliedToViewIds.`)}}}function Oe(e){return{"sources.ts":_e(e),"fields.ts":je(e),"inputs.ts":Pe(e),"queries.ts":De(e),"bindings.ts":Je(e),"accessors.ts":Ye(e),"metadata.ts":Ze(e),"index.ts":Xe(),"USAGE.md":Ge(e)}}function Ee({contract:e,files:r,generatorName:n,generatorVersion:t}){return{schemaVersion:R.CONTRACT_MANIFEST_SCHEMA_VERSION,generatedContractSchemaVersion:R.GENERATED_CONTRACT_SCHEMA_VERSION,generator:{name:n,version:t},generatedContentHash:xe(r),codegenSummaryValidatorVersion:R.CODEGEN_SUMMARY_VALIDATOR_VERSION,codegenSummaryHash:Ae(e.summary),codegenSummary:e.summary}}function xe(e){const r=ge.createHash("sha256");for(const n of Object.keys(e).filter(t=>t.endsWith(".ts")).sort())r.update(n),r.update("\0"),r.update(e[n]),r.update("\0");return`sha256:${r.digest("hex")}`}function Ge(e){const r=["# Semaphor Generated Data App Contract","","Generated files in this directory are governed Semaphor analytics wiring. Do not hand-edit them.","","Use the app-facing exports from `index.ts`:","","- `queries`: generated governed query factories.","- `queryOptionsForView`: active-input wiring for each generated view.","- `rowsForView`: table/records row readers.","- `rowValuesForView`: friendly row object readers for chart/table views.","- `metricValuesForView`: friendly metric-value readers.","- `kpiPropsForView`: KPI component props derived from runtime metric results.","- `roleValuesForView`: canonical dimension/measure/date/id role readers.","- `appInputSpecs`: generated input/filter specs.","- `inputOptionQueries`: option-list query factories for generated inputs.","- `semaphorGeneratedContractMetadata`: generated view/input metadata and presentation-only views.","","Start with these exports before opening large generated internals such as `metadata.ts`.",""];return e.views.length>0&&(r.push("Generated executable views:"),e.views.forEach(n=>{r.push(`- \`${n.raw.id}\`: ${n.raw.title||n.name}`)}),r.push("")),e.inputs.length>0&&(r.push("Generated inputs:"),e.inputs.forEach(n=>{r.push(`- \`${n.raw.id}\`: ${n.raw.label||n.name}`)}),r.push("")),`${r.join(`
+`)}
+`}function Ae(e){return`sha256:${ge.createHash("sha256").update(ue(e)).digest("hex")}`}function ue(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(t=>ue(t)).join(",")}]`;const r=e;return`{${Object.keys(r).sort().filter(t=>r[t]!==void 0).map(t=>`${JSON.stringify(t)}:${ue(r[t])}`).join(",")}}`}function ve(e){const r=e.views.find(m=>v(m)&&K(m));if(r)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const sortOption = recordsSortOptionsForView.${r.name}[0];`,'const sort = sortOption ? { key: sortOption.key, direction: "asc" as const } : undefined;',`const query = queries.${r.name}({ page, pageSize, sort });`,`const result = useSemaphorQuery(query, queryOptionsForView.${r.name}(inputHandles));`,`const rows = rowsForView.${r.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const n=e.views.find(m=>v(m));if(n)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const sortOption = recordsSortOptionsForView.${n.name}[0];`,'const sort = sortOption ? { key: sortOption.key, direction: "asc" as const } : undefined;',`const query = queries.${n.name}({ sort });`,`const result = useSemaphorQuery(query, queryOptionsForView.${n.name}(inputHandles));`,`const rows = rowsForView.${n.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const t=e.views.find(m=>X(m)&&K(m));if(t)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const query = queries.${t.name}({ page, pageSize });`,`const result = useSemaphorQuery(query, queryOptionsForView.${t.name}(inputHandles));`,`const rows = rowsForView.${t.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const o=e.views.find(m=>le(m)&&K(m));if(o)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const query = queries.${o.name}({ page, pageSize });`,`const result = useSemaphorQuery(query, queryOptionsForView.${o.name}(inputHandles));`,`const rows = rowsForView.${o.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const i=e.views.find(m=>{var c;return cr((c=m.raw.sdkSpec)==null?void 0:c.builder)});if(i)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${i.name}(), queryOptionsForView.${i.name}(inputHandles));`,`const rows = rowsForView.${i.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const l=e.views.find(m=>Ke(m));if(l)return['import { appInputSpecs, createInputHandleMap, kpiPropsForView, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${l.name}(), queryOptionsForView.${l.name}(inputHandles));`,`const kpiProps = kpiPropsForView.${l.name}(result);`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const f=e.views[0];return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",f?`const result = useSemaphorQuery(queries.${f.name}(), queryOptionsForView.${f.name}(inputHandles));`:"const result = undefined;","const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`)}function X(e){var r;return q((r=e.raw.sdkSpec)==null?void 0:r.builder)==="records"}function Ke(e){var r;return q((r=e.raw.sdkSpec)==null?void 0:r.builder)==="metric"}function v(e){var r,n,t;return X(e)&&((t=(n=(r=e.raw.visualSpec)==null?void 0:r.tableBehavior)==null?void 0:n.sorting)==null?void 0:t.mode)==="server"}function le(e){var r;return q((r=e.raw.sdkSpec)==null?void 0:r.builder)==="sql"}function K(e){var r,n,t;return((t=(n=(r=e.raw.visualSpec)==null?void 0:r.tableBehavior)==null?void 0:n.pagination)==null?void 0:t.mode)==="server"}function Te(e){return X(e)&&(K(e)||v(e))||le(e)&&K(e)}function _e(e){const r=e.sources.map(({name:t,raw:o})=>{const i=He(o);return`  ${t}: ${i},`}).join(`
+`),n=e.sources.some(t=>t.raw.kind==="semantic")?`import { semaphor } from "react-semaphor/data-app-sdk";
+
+`:"";return`${T}
+${n}export const sources = {
+${r}
 } as const;
-`}function He(e){if(e.kind==="semantic"){const n={domainId:e.domainId,datasetId:e.datasetId,datasetName:e.datasetName,label:e.label};return`semaphor.source.semantic(${k(A(n))})`}return`${k(A({...e,sourceKey:void 0}))} as const`}function ve(e){const n=e.fields.map(({name:t,raw:o})=>{const a=qe(o,e);return`  ${t}: ${a},`}).join(`
-`),r=n.includes("sources.")?`import { sources } from "./sources";
+`}function He(e){if(e.kind==="semantic"){const r={domainId:e.domainId,datasetId:e.datasetId,datasetName:e.datasetName,label:e.label};return`semaphor.source.semantic(${N(G(r))})`}return`${N(G({...e,sourceKey:void 0}))} as const`}function je(e){const r=e.fields.map(({name:t,raw:o})=>{const i=qe(o,e);return`  ${t}: ${i},`}).join(`
+`),n=r.includes("sources.")?`import { sources } from "./sources";
 
-`:"";return`${K}
-${r}export const fields = {
-${n}
+`:"";return`${T}
+${n}export const fields = {
+${r}
 } as const;
-`}function qe(e,n){const r={name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate},t=ln(e),o=t?n.sourceNameByKey.get(t):void 0;if(t&&!o)throw new Error(`Field ${e.name} references source ${t}, but that source is not renderable. Include the source in codegenSummary.sources or provide field.source.`);const a=Object.entries(A(r)).map(([l,y])=>`${JSON.stringify(l)}: ${x(y,n)}`);return o&&a.push(`"source": sources.${o}`),`{ ${a.join(", ")} }`}function je(e){const n=e.inputs.map(c=>{const i=N(c.raw.fieldRef,e),p=[`id: ${JSON.stringify(c.raw.id)}`,`label: ${JSON.stringify(c.raw.label||c.raw.id)}`,`operator: ${JSON.stringify(mn(c.raw))}`];if(i&&p.push(`field: fields.${i}`),c.raw.relationshipHint&&p.push(`relationshipHint: ${k(c.raw.relationshipHint)}`),!i)throw new Error(`Input ${c.raw.id||c.name} is missing a generated field reference.`);return`  ${c.name}: semaphor.filter({ ${p.join(", ")} }),`}).join(`
-`),r=e.inputs.map(c=>`filterSpecs.${c.name}`).join(", "),t=e.inputs.map(c=>JSON.stringify(c.raw.id)).join(", "),o=e.optionQueries.map(c=>{const i=c.input.raw,p=c.raw,w=b(p.spec)||{},{id:g,inputId:$,source:F,sourceKey:M,valueField:V,labelField:C,population:s,dependencies:I,limit:B,...re}=w,z=p.sourceKey?{sourceKey:p.sourceKey}:p.source||F||(typeof M=="string"?{sourceKey:M}:void 0),te=$e(z,e),oe=N(p.valueFieldRef,e),se=N(p.labelFieldRef,e),ae=he(c),ie={...re,id:p.id||w.id||`${i.id}-options`,inputId:i.id,source:z,valueField:p.valueFieldRef,labelField:p.labelFieldRef,population:p.population||s,dependencies:ae,limit:p.limit||B||100};if(!te||!oe||!se)throw new Error(`Input option query ${p.id||`${i.id}-options`} is missing source, valueField, or labelField.`);const Ve=Object.entries(A(ie)).map(([be,Re])=>`${JSON.stringify(be)}: ${x(Re,e)}`);return`  ${c.name}: semaphor.inputOptions({ ${Ve.join(", ")} }),`}).join(`
-`),a=e.optionQueries.map(c=>{const i=Be(e,c),p=i.length>0?"inputHandles":"_inputHandles",w=i.map(g=>{const $=N(g.raw.fieldRef,e);if(!$)throw new Error(`Input option query ${c.raw.id||`${c.input.raw.id}-options`} references input ${g.raw.id} without a generated field reference.`);const F=`inputHandles[${JSON.stringify(g.raw.id)}]`;return`    if (${F}) {
-      inputs.push(semaphor.bindInput(${F}, { field: fields.${$} }));
+`}function qe(e,r){const n={name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate},t=pr(e),o=t?r.sourceNameByKey.get(t):void 0;if(t&&!o)throw new Error(`Field ${e.name} references source ${t}, but that source is not renderable. Include the source in codegenSummary.sources or provide field.source.`);const i=Object.entries(G(n)).map(([l,f])=>`${JSON.stringify(l)}: ${x(f,r)}`);return o&&i.push(`"source": sources.${o}`),`{ ${i.join(", ")} }`}function Pe(e){const r=e.inputs.map(p=>{const $=C(p.raw.fieldRef,e),s=[`id: ${JSON.stringify(p.raw.id)}`,`label: ${JSON.stringify(p.raw.label||p.raw.id)}`,`operator: ${JSON.stringify(mr(p.raw))}`];if($&&s.push(`field: fields.${$}`),p.raw.relationshipHint&&s.push(`relationshipHint: ${N(p.raw.relationshipHint)}`),!$)throw new Error(`Input ${p.raw.id||p.name} is missing a generated field reference.`);return`  ${p.name}: semaphor.filter({ ${s.join(", ")} }),`}).join(`
+`),n=e.inputs.map(p=>`filterSpecs.${p.name}`).join(", "),t=e.inputs.map(p=>JSON.stringify(p.raw.id)).join(", "),o=e.optionQueries.map(p=>{const $=p.input.raw,s=p.raw,g=k(s.spec)||{},{id:h,inputId:y,source:I,sourceKey:V,valueField:b,labelField:M,population:a,dependencies:w,limit:P,...ne}=g,Y=s.sourceKey?{sourceKey:s.sourceKey}:s.source||I||(typeof V=="string"?{sourceKey:V}:void 0),te=$e(Y,e),oe=C(s.valueFieldRef,e),ae=C(s.labelFieldRef,e),se=he(p),ie={...ne,id:s.id||g.id||`${$.id}-options`,inputId:$.id,source:Y,valueField:s.valueFieldRef,labelField:s.labelFieldRef,population:s.population||a,dependencies:se,limit:s.limit||P||100};if(!te||!oe||!ae)throw new Error(`Input option query ${s.id||`${$.id}-options`} is missing source, valueField, or labelField.`);const Ve=Object.entries(G(ie)).map(([be,ke])=>`${JSON.stringify(be)}: ${x(ke,e)}`);return`  ${p.name}: semaphor.inputOptions({ ${Ve.join(", ")} }),`}).join(`
+`),i=e.optionQueries.map(p=>{const $=Be(e,p),s=$.length>0?"inputHandles":"_inputHandles",g=$.map(h=>{const y=C(h.raw.fieldRef,e);if(!y)throw new Error(`Input option query ${p.raw.id||`${p.input.raw.id}-options`} references input ${h.raw.id} without a generated field reference.`);const I=`inputHandles[${JSON.stringify(h.raw.id)}]`;return`    if (${I}) {
+      inputs.push(semaphor.bindInput(${I}, { field: fields.${y} }));
     }`}).join(`
-`);return`  ${c.name}(${p}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
+`);return`  ${p.name}(${s}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
     const inputs: SemaphorInputReference[] = [];
-${w}
+${g}
     return inputs;
   },`}).join(`
 
-`),l=e.optionQueries.map(c=>`  ${c.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
+`),l=e.optionQueries.map(p=>`  ${p.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
     return {
-      inputs: inputsForInputOptionQuery.${c.name}(inputHandles),
+      inputs: inputsForInputOptionQuery.${p.name}(inputHandles),
     };
   },`).join(`
 
-`),y=e.optionQueries.map(c=>`    case ${JSON.stringify(c.raw.id||`${c.input.raw.id}-options`)}:
-      return queryOptionsForInputOptionQuery.${c.name}(inputHandles);`).join(`
-`),S=e.inputs.length>0,f=e.optionQueries.length>0,m=f?"inputOptionQueryId":"_inputOptionQueryId",O=f?"inputHandles":"_inputHandles",u=["SemaphorInputHandle",f?"SemaphorInputReference":void 0,"SemaphorQueryRuntimeOptions"].filter(G).join(", "),d=[S||f?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,`import type { ${u} } from "react-semaphor/data-app-sdk";`,S||f?'import { fields } from "./fields";':void 0,f?'import { sources } from "./sources";':void 0,'import type { SemaphorGeneratedInputId, SemaphorGeneratedInputOptionQueryId } from "./metadata";'].filter(G).join(`
-`);return`${K}
+`),f=e.optionQueries.map(p=>`    case ${JSON.stringify(p.raw.id||`${p.input.raw.id}-options`)}:
+      return queryOptionsForInputOptionQuery.${p.name}(inputHandles);`).join(`
+`),F=e.inputs.length>0,m=e.optionQueries.length>0,c=m?"inputOptionQueryId":"_inputOptionQueryId",O=m?"inputHandles":"_inputHandles",u=["SemaphorInputHandle",m?"SemaphorInputReference":void 0,"SemaphorQueryRuntimeOptions"].filter(A).join(", "),d=[F||m?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,`import type { ${u} } from "react-semaphor/data-app-sdk";`,F||m?'import { fields } from "./fields";':void 0,m?'import { sources } from "./sources";':void 0,'import type { SemaphorGeneratedInputId, SemaphorGeneratedInputOptionQueryId } from "./metadata";'].filter(A).join(`
+`);return`${T}
 ${d}
 
 export const filterSpecs = {
-${n}
+${r}
 } as const;
 
-export const appInputSpecs = [${r}] as const;
+export const appInputSpecs = [${n}] as const;
 export const appInputIds = [${t}] as const;
 
 export type SemaphorGeneratedInputHandleMap = Partial<Record<SemaphorGeneratedInputId, SemaphorInputHandle>>;
@@ -63,7 +65,7 @@ ${o}
 } as const;
 
 export const inputsForInputOptionQuery = {
-${a}
+${i}
 } as const;
 
 export const queryOptionsForInputOptionQuery = {
@@ -71,48 +73,48 @@ ${l}
 } as const;
 
 export function queryOptionsForInputOptionQueryId(
-  ${m}: SemaphorGeneratedInputOptionQueryId,
+  ${c}: SemaphorGeneratedInputOptionQueryId,
   ${O}: SemaphorGeneratedInputHandleMap,
 ): SemaphorQueryRuntimeOptions {
-  switch (${m}) {
-${y}
+  switch (${c}) {
+${f}
   }
-  throw new Error(\`Unknown generated Semaphor input option query id: \${${m}}\`);
+  throw new Error(\`Unknown generated Semaphor input option query id: \${${c}}\`);
 }
-`}function Be(e,n){const r=he(n);if(!r||r.mode==="independent")return[];if(r.mode!=="explicit")return[];const t=new Set(r.includeInputIds||[]),o=new Set([n.input.raw.id,...r.excludeInputIds||[]]);return e.inputs.filter(a=>o.has(a.raw.id)?!1:t.has(a.raw.id))}function he(e){var n;return e.raw.dependencies||((n=e.raw.spec)==null?void 0:n.dependencies)}function Qe(e){const n=e.views.map(d=>{var p,w,g,$,F,M;const c=j(d.raw.sdkSpec.builder),i=De(d);if(X(d)&&_e(d)){const V=(p=d.raw.visualSpec)==null?void 0:p.tableBehavior,C=b(i.pagination),s=_(d),I=T(d),B=((w=V==null?void 0:V.pagination)==null?void 0:w.pageSize)||Y(C==null?void 0:C.pageSize)||Y(i.limit)||100,re=I?W(d,e):[],z=I?Pe({view:d,contract:e,sortFields:re,defaultField:(g=V==null?void 0:V.sorting)==null?void 0:g.defaultField}):void 0,te=I?($=V==null?void 0:V.sorting)==null?void 0:$.defaultDirection:void 0,oe=Ue({viewName:d.name,supportsPagination:s,supportsSort:I}),se=I?`    const orderBy = resolveRecordsOrderBy(
+`}function Be(e,r){const n=he(r);if(!n||n.mode==="independent")return[];if(n.mode!=="explicit")return[];const t=new Set(n.includeInputIds||[]),o=new Set([r.input.raw.id,...n.excludeInputIds||[]]);return e.inputs.filter(i=>o.has(i.raw.id)?!1:t.has(i.raw.id))}function he(e){var r;return e.raw.dependencies||((r=e.raw.spec)==null?void 0:r.dependencies)}function De(e){const r=e.views.map(d=>{var s,g,h,y,I,V;const p=q(d.raw.sdkSpec.builder),$=Qe(d);if(X(d)&&Te(d)){const b=(s=d.raw.visualSpec)==null?void 0:s.tableBehavior,M=k($.pagination),a=K(d),w=v(d),P=((g=b==null?void 0:b.pagination)==null?void 0:g.pageSize)||W(M==null?void 0:M.pageSize)||W($.limit)||100,ne=w?Z(d,e):[],Y=w?Ue({view:d,contract:e,sortFields:ne,defaultField:(h=b==null?void 0:b.sorting)==null?void 0:h.defaultField}):void 0,te=w?(y=b==null?void 0:b.sorting)==null?void 0:y.defaultDirection:void 0,oe=Le({viewName:d.name,supportsPagination:a,supportsSort:w}),ae=w?`    const orderBy = resolveRecordsOrderBy(
       recordsSortFieldsForView.${d.name},
       params.sort,
-      ${x(z,e)},
+      ${x(Y,e)},
       ${x(te,e)},
     );
-`:"",ae=I?`      ...(orderBy ? { orderBy } : {}),
-`:"",ie=s?`      pagination: resolveServerTablePagination(params, ${JSON.stringify(B)}),
+`:"",se=w?`      ...(orderBy ? { orderBy } : {}),
+`:"",ie=a?`      pagination: resolveServerTablePagination(params, ${JSON.stringify(P)}),
 `:"";return`  ${d.name}(
     params: ${oe} = {},
   ) {
-${se}    return semaphor.${c}({
-      ...${x(i,e)},
-${ae}${ie}    });
-  },`}if(pe(d)&&_(d)){const V=(F=d.raw.visualSpec)==null?void 0:F.tableBehavior,C=b(i.pagination),s=((M=V==null?void 0:V.pagination)==null?void 0:M.pageSize)||Y(C==null?void 0:C.pageSize)||Y(i.limit)||100;return`  ${d.name}(
+${ae}    return semaphor.${p}({
+      ...${x($,e)},
+${se}${ie}    });
+  },`}if(le(d)&&K(d)){const b=(I=d.raw.visualSpec)==null?void 0:I.tableBehavior,M=k($.pagination),a=((V=b==null?void 0:b.pagination)==null?void 0:V.pageSize)||W(M==null?void 0:M.pageSize)||W($.limit)||100;return`  ${d.name}(
     params: SemaphorGeneratedServerPaginationParams = {},
   ) {
-    return semaphor.${c}({
-      ...${x(i,e)},
-      pagination: resolveServerTablePagination(params, ${JSON.stringify(s)}),
+    return semaphor.${p}({
+      ...${x($,e)},
+      pagination: resolveServerTablePagination(params, ${JSON.stringify(a)}),
     });
-  },`}return`  ${d.name}: () => semaphor.${c}(${x(i,e)}),`}).join(`
-`),r=e.views.filter(d=>T(d)).map(d=>{const i=W(d,e).map(p=>`    ${JSON.stringify(p.key)}: fields.${p.fieldName},`).join(`
+  },`}return`  ${d.name}: () => semaphor.${p}(${x($,e)}),`}).join(`
+`),n=e.views.filter(d=>v(d)).map(d=>{const $=Z(d,e).map(s=>`    ${JSON.stringify(s.key)}: fields.${s.fieldName},`).join(`
 `);return`  ${d.name}: {
-${i}
+${$}
   },`}).join(`
-`),t=e.views.filter(d=>T(d)).map(d=>{const i=W(d,e).map(p=>`    { key: ${JSON.stringify(p.key)}, label: ${JSON.stringify(p.label)}, field: fields.${p.fieldName} },`).join(`
+`),t=e.views.filter(d=>v(d)).map(d=>{const $=Z(d,e).map(s=>`    { key: ${JSON.stringify(s.key)}, label: ${JSON.stringify(s.label)}, field: fields.${s.fieldName} },`).join(`
 `);return`  ${d.name}: [
-${i}
+${$}
   ],`}).join(`
-`),o=e.views.some(d=>T(d)),a=e.views.some(d=>_(d)),l=[n,r,t].join(`
-`),y=[n?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,o?'import type { SemaphorFieldRef } from "react-semaphor/data-app-sdk";':void 0,l.includes("fields.")?'import { fields } from "./fields";':void 0,l.includes("sources.")?'import { sources } from "./sources";':void 0].filter(G).join(`
-`);return`${K}
-${y}
+`),o=e.views.some(d=>v(d)),i=e.views.some(d=>K(d)),l=[r,n,t].join(`
+`),f=[r?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,o?'import type { SemaphorFieldRef } from "react-semaphor/data-app-sdk";':void 0,l.includes("fields.")?'import { fields } from "./fields";':void 0,l.includes("sources.")?'import { sources } from "./sources";':void 0].filter(A).join(`
+`);return`${T}
+${f}
 ${o?`export type SemaphorGeneratedRecordsSortDirection = "asc" | "desc";
 
 export type SemaphorGeneratedRecordsSort<TSortKey extends string = string> = {
@@ -123,17 +125,17 @@ export type SemaphorGeneratedRecordsSort<TSortKey extends string = string> = {
 export type SemaphorGeneratedRecordsSortParams<TSortKey extends string = string> = {
   sort?: SemaphorGeneratedRecordsSort<TSortKey> | null;
 };
-`:""}${a?`export type SemaphorGeneratedServerPaginationParams = {
+`:""}${i?`export type SemaphorGeneratedServerPaginationParams = {
   page?: number;
   pageSize?: number;
 };
-`:""}${o&&a?`export type SemaphorGeneratedRecordsQueryParams<TSortKey extends string = string> =
+`:""}${o&&i?`export type SemaphorGeneratedRecordsQueryParams<TSortKey extends string = string> =
   SemaphorGeneratedServerPaginationParams &
   SemaphorGeneratedRecordsSortParams<TSortKey>;
 `:""}
 
 export const recordsSortFieldsForView = {
-${r}
+${n}
 } as const;
 
 export const recordsSortOptionsForView = {
@@ -141,7 +143,7 @@ ${t}
 } as const;
 
 export const queries = {
-${n}
+${r}
 } as const;
 
 ${o?`function resolveRecordsOrderBy<TSortKey extends string>(
@@ -164,7 +166,7 @@ ${o?`function resolveRecordsOrderBy<TSortKey extends string>(
   };
 }
 `:""}
-${a?`function resolveServerTablePagination(
+${i?`function resolveServerTablePagination(
   params: SemaphorGeneratedServerPaginationParams,
   defaultPageSize: number,
 ) {
@@ -174,29 +176,29 @@ ${a?`function resolveServerTablePagination(
   };
 }
 `:""}
-`}function De(e){var a,l;const n=b((a=e.raw.sdkSpec)==null?void 0:a.spec)||{},{kind:r,id:t,...o}=n;return{...o,id:e.raw.id,label:((l=e.raw.visualSpec)==null?void 0:l.title)||e.raw.title||o.label}}function W(e,n){var a,l;const r=[],t=b((a=e.raw.sdkSpec)==null?void 0:a.spec)||{};for(const y of v(t.fields))h(r,y);h(r,t.dateField),h(r,(l=b(t.orderBy))==null?void 0:l.field);for(const y of e.raw.fields||[])h(r,y);return ne(r.map(y=>{const S=N(y,n);if(!(!y.name||!S))return{key:S,fieldName:S,rawName:y.name,label:y.label||y.name}}).filter(G),y=>y.key)}function Pe({view:e,contract:n,sortFields:r,defaultField:t}){var S,f;const o=new Set(r.map(m=>m.key));if(t&&o.has(t))return t;const a=r.filter(m=>m.rawName===t);if(a.length===1)return a[0].key;const l=b((S=e.raw.sdkSpec)==null?void 0:S.spec),y=N((f=b(l==null?void 0:l.orderBy))==null?void 0:f.field,n);return y&&o.has(y)?y:void 0}function Ue({viewName:e,supportsPagination:n,supportsSort:r}){return n&&r?`SemaphorGeneratedRecordsQueryParams<Extract<keyof typeof recordsSortFieldsForView.${e}, string>>`:r?`SemaphorGeneratedRecordsSortParams<Extract<keyof typeof recordsSortFieldsForView.${e}, string>>`:"SemaphorGeneratedServerPaginationParams"}function Le(e){const n=e.views.map(m=>{const u=Je(e,m.raw.id).map(d=>{const c=d.inputId,i=N(d.fieldRef,e);if(!c||!i)return"";const p=[`field: fields.${i}`];if(d.relationshipHint)p.push(`relationshipHint: ${k(d.relationshipHint)}`);else if(Array.isArray(d.relationshipsUsed)&&d.relationshipsUsed.length>0){const g=d.relationshipsUsed.map($=>{var F;return(F=b($))==null?void 0:F.id}).filter($=>typeof $=="string"&&$.length>0);g.length>0&&p.push(`relationshipHint: ${k({relationshipIds:g})}`)}const w=`inputHandles[${JSON.stringify(c)}]`;return`    if (${w}) {
-      inputs.push(semaphor.bindInput(${w}, { ${p.join(", ")} }));
+`}function Qe(e){var i,l;const r=k((i=e.raw.sdkSpec)==null?void 0:i.spec)||{},{kind:n,id:t,...o}=r;return{...o,id:e.raw.id,label:((l=e.raw.visualSpec)==null?void 0:l.title)||e.raw.title||o.label}}function Z(e,r){var i,l;const n=[],t=k((i=e.raw.sdkSpec)==null?void 0:i.spec)||{};for(const f of H(t.fields))S(n,f);S(n,t.dateField),S(n,(l=k(t.orderBy))==null?void 0:l.field);for(const f of e.raw.fields||[])S(n,f);return re(n.map(f=>{const F=C(f,r);if(!(!f.name||!F))return{key:F,fieldName:F,rawName:f.name,label:f.label||f.name}}).filter(A),f=>f.key)}function Ue({view:e,contract:r,sortFields:n,defaultField:t}){var F,m;const o=new Set(n.map(c=>c.key));if(t&&o.has(t))return t;const i=n.filter(c=>c.rawName===t);if(i.length===1)return i[0].key;const l=k((F=e.raw.sdkSpec)==null?void 0:F.spec),f=C((m=k(l==null?void 0:l.orderBy))==null?void 0:m.field,r);return f&&o.has(f)?f:void 0}function Le({viewName:e,supportsPagination:r,supportsSort:n}){return r&&n?`SemaphorGeneratedRecordsQueryParams<Extract<keyof typeof recordsSortFieldsForView.${e}, string>>`:n?`SemaphorGeneratedRecordsSortParams<Extract<keyof typeof recordsSortFieldsForView.${e}, string>>`:"SemaphorGeneratedServerPaginationParams"}function Je(e){const r=e.views.map(c=>{const u=ze(e,c.raw.id).map(d=>{const p=d.inputId,$=C(d.fieldRef,e);if(!p||!$)return"";const s=[`field: fields.${$}`];if(d.relationshipHint)s.push(`relationshipHint: ${N(d.relationshipHint)}`);else if(Array.isArray(d.relationshipsUsed)&&d.relationshipsUsed.length>0){const h=d.relationshipsUsed.map(y=>{var I;return(I=k(y))==null?void 0:I.id}).filter(y=>typeof y=="string"&&y.length>0);h.length>0&&s.push(`relationshipHint: ${N({relationshipIds:h})}`)}const g=`inputHandles[${JSON.stringify(p)}]`;return`    if (${g}) {
+      inputs.push(semaphor.bindInput(${g}, { ${s.join(", ")} }));
     }`}).filter(Boolean).join(`
-`);return{view:m,renderedBindings:u}}),r=n.some(m=>m.renderedBindings.length>0),t=n.map(({view:m,renderedBindings:O})=>{const u=O?"inputHandles":"_inputHandles";return`  ${m.name}(${u}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
+`);return{view:c,renderedBindings:u}}),n=r.some(c=>c.renderedBindings.length>0),t=r.map(({view:c,renderedBindings:O})=>{const u=O?"inputHandles":"_inputHandles";return`  ${c.name}(${u}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
     const inputs: SemaphorInputReference[] = [];
 ${O}
     return inputs;
   },`}).join(`
 
-`),o=e.views.map(m=>`  ${m.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
+`),o=e.views.map(c=>`  ${c.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
     return {
-      inputs: inputsForView.${m.name}(inputHandles),
-      debug: queryDebugForView.${m.name},
+      inputs: inputsForView.${c.name}(inputHandles),
+      debug: queryDebugForView.${c.name},
     };
   },`).join(`
 
-`),a=e.views.map(m=>`    case ${JSON.stringify(m.raw.id)}:
-      return inputsForView.${m.name}(inputHandles);`).join(`
-`),l=e.views.map(m=>`    case ${JSON.stringify(m.raw.id)}:
-      return queryOptionsForView.${m.name}(inputHandles);`).join(`
-`),y=e.views.length>0,S=y?"inputHandles":"_inputHandles",f=[r?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,'import type { SemaphorInputReference, SemaphorQueryRuntimeOptions } from "react-semaphor/data-app-sdk";',r?'import { fields } from "./fields";':void 0,'import type { SemaphorGeneratedInputHandleMap } from "./inputs";',y?'import { queryDebugForView } from "./metadata";':void 0,'import type { SemaphorGeneratedQueryViewId } from "./metadata";'].filter(G).join(`
-`);return`${K}
-${f}
+`),i=e.views.map(c=>`    case ${JSON.stringify(c.raw.id)}:
+      return inputsForView.${c.name}(inputHandles);`).join(`
+`),l=e.views.map(c=>`    case ${JSON.stringify(c.raw.id)}:
+      return queryOptionsForView.${c.name}(inputHandles);`).join(`
+`),f=e.views.length>0,F=f?"inputHandles":"_inputHandles",m=[n?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,'import type { SemaphorInputReference, SemaphorQueryRuntimeOptions } from "react-semaphor/data-app-sdk";',n?'import { fields } from "./fields";':void 0,'import type { SemaphorGeneratedInputHandleMap } from "./inputs";',f?'import { queryDebugForView } from "./metadata";':void 0,'import type { SemaphorGeneratedQueryViewId } from "./metadata";'].filter(A).join(`
+`);return`${T}
+${m}
 
 export const inputsForView = {
 ${t}
@@ -208,91 +210,116 @@ ${o}
 
 export function inputsForViewId(
   viewId: SemaphorGeneratedQueryViewId,
-  ${S}: SemaphorGeneratedInputHandleMap,
+  ${F}: SemaphorGeneratedInputHandleMap,
 ): SemaphorInputReference[] {
   switch (viewId) {
-${a}
+${i}
   }
   throw new Error(\`Unknown generated Semaphor view id: \${viewId}\`);
 }
 
 export function queryOptionsForViewId(
   viewId: SemaphorGeneratedQueryViewId,
-  ${S}: SemaphorGeneratedInputHandleMap,
+  ${F}: SemaphorGeneratedInputHandleMap,
 ): SemaphorQueryRuntimeOptions {
   switch (viewId) {
 ${l}
   }
   throw new Error(\`Unknown generated Semaphor view id: \${viewId}\`);
 }
-`}function Je(e,n){return e.filterContracts.flatMap(r=>(r.bindings||[]).filter(t=>t.viewId===n).map(t=>({inputId:r.inputId,fieldRef:t.fieldRef,relationshipHint:t.relationshipHint,relationshipsUsed:t.relationshipsUsed})))}function ze(e){const n=e.views.map(i=>{const w=U(i,e).map(g=>{const $=N(g.raw,e);return $?`    ${g.name}: fields.${$},`:""}).filter(Boolean).join(`
-`);return`  ${i.name}: {
-${w}
+`}function ze(e,r){return e.filterContracts.flatMap(n=>(n.bindings||[]).filter(t=>t.viewId===r).map(t=>({inputId:n.inputId,fieldRef:t.fieldRef,relationshipHint:t.relationshipHint,relationshipsUsed:t.relationshipsUsed})))}function Ye(e){const r=e.views.map(s=>{const h=U(s,e).map(y=>{const I=C(y.raw,e);return I?`    ${y.name}: fields.${I},`:""}).filter(Boolean).join(`
+`);return`  ${s.name}: {
+${h}
   },`}).join(`
-`),r=e.views.map(i=>{const w=P(i,e).map(g=>{const $=N(g.raw,e);return $?`    ${g.name}: fields.${$},`:""}).filter(Boolean).join(`
-`);return`  ${i.name}: {
-${w}
+`),n=e.views.map(s=>{const h=B(s,e).map(y=>{const I=C(y.raw,e);return I?`    ${y.name}: fields.${I},`:""}).filter(Boolean).join(`
+`);return`  ${s.name}: {
+${h}
   },`}).join(`
-`),t=e.views.map(i=>{const p=P(i,e),w=rn(p),g=nn(p),$=p.map(F=>{const M=Array.from(new Set(Se(F.raw).filter(V=>g.has(V))));return`    ${F.name}: metricKeysForField(metricFieldsForView.${i.name}.${F.name}, { allowNameFallback: ${w.has(F.raw.name)?"false":"true"}, excludedKeys: ${k(M)} }),`}).join(`
-`);return`  ${i.name}: {
-${$}
+`),t=e.views.map(s=>{const g=B(s,e),h=tr(g),y=nr(g),I=g.map(V=>{const b=Array.from(new Set(Se(V.raw).filter(M=>y.has(M))));return`    ${V.name}: metricKeysForField(metricFieldsForView.${s.name}.${V.name}, { allowNameFallback: ${h.has(V.raw.name)?"false":"true"}, excludedKeys: ${N(b)} }),`}).join(`
+`);return`  ${s.name}: {
+${I}
   },`}).join(`
-`),o=e.views.map(i=>{const w=P(i,e).map((g,$)=>`    ${g.name}: ${JSON.stringify(Xe(i,g,$))},`).join(`
-`);return`  ${i.name}: {
-${w}
+`),o=e.views.map(s=>{const h=B(s,e).map((y,I)=>`    ${y.name}: ${JSON.stringify(er(s,y,I))},`).join(`
+`);return`  ${s.name}: {
+${h}
   },`}).join(`
-`),a=e.views.map(i=>{const p=P(i,e);if(p.length===0)return`  ${i.name}(): Record<keyof typeof metricFieldsForView.${i.name}, unknown> {
+`),i=e.views.map(s=>{const g=B(s,e);if(g.length===0)return`  ${s.name}(): Record<keyof typeof metricFieldsForView.${s.name}, unknown> {
     return {};
-  },`;const w=en(i,p),g=p.map($=>{const F=`metricMeasureKeysForView.${i.name}.${$.name}`,M=`metricMeasureBindingKeysForView.${i.name}.${$.name}`,V=w.has($.name)?`readMetricValueByBindingWithFallback(measures, measureBindings, ${M}, ${F}, primaryValue)`:`readMetricValueByBinding(measures, measureBindings, ${M}, ${F})`;return`      ${$.name}: ${V},`}).join(`
-`);return`  ${i.name}(result: SemaphorGeneratedMetricResult): Record<keyof typeof metricFieldsForView.${i.name}, unknown> {
+  },`;const h=rr(s,g),y=g.map(I=>{const V=`metricMeasureKeysForView.${s.name}.${I.name}`,b=`metricMeasureBindingKeysForView.${s.name}.${I.name}`,M=h.has(I.name)?`readMetricValueByBindingWithFallback(measures, measureBindings, ${b}, ${V}, primaryValue)`:`readMetricValueByBinding(measures, measureBindings, ${b}, ${V})`;return`      ${I.name}: ${M},`}).join(`
+`);return`  ${s.name}(result: SemaphorGeneratedMetricResult): Record<keyof typeof metricFieldsForView.${s.name}, unknown> {
     const measures = result?.measures;
     const measureBindings = result?.measureBindings;
     const primaryValue = result?.primaryValue;
     return {
-${g}
+${y}
     };
   },`}).join(`
 
-`),l=e.views.map(i=>{const p=P(i,e);if(p.length===0)return`  ${i.name}(): Array<keyof typeof metricFieldsForView.${i.name}> {
+`),l=e.views.map(s=>{const g=B(s,e);if(g.length===0)return`  ${s.name}(): Array<keyof typeof metricFieldsForView.${s.name}> {
     return [];
-  },`;const w=p.map(g=>`    ...(missing.has(metricMeasureBindingKeysForView.${i.name}.${g.name}) ? [${JSON.stringify(g.name)} as keyof typeof metricFieldsForView.${i.name}] : []),`).join(`
-`);return`  ${i.name}(result: SemaphorGeneratedMetricResult): Array<keyof typeof metricFieldsForView.${i.name}> {
+  },`;const h=g.map(y=>`    ...(missing.has(metricMeasureBindingKeysForView.${s.name}.${y.name}) ? [${JSON.stringify(y.name)} as keyof typeof metricFieldsForView.${s.name}] : []),`).join(`
+`);return`  ${s.name}(result: SemaphorGeneratedMetricResult): Array<keyof typeof metricFieldsForView.${s.name}> {
     const missing = new Set(result?.missingMeasures || []);
     return [
-${w}
+${h}
     ];
   },`}).join(`
 
-`),y=e.views.map(i=>{const p=Ye(i,e);return`  ${i.name}: ${k(p)},`}).join(`
-`),S=e.views.map(i=>{const w=U(i,e).map(g=>`      ${g.name}: resolveColumnKey(columns, fieldsForView.${i.name}.${g.name}),`).join(`
-`);return`  ${i.name}(columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${i.name}, string | undefined> {
+`),f=e.views.map(s=>{const g=B(s,e);if(g.length===0)return"";const h=g[0],y=g.map(V=>`{ key: ${JSON.stringify(V.name)}, label: ${JSON.stringify(V.raw.label||V.raw.name)} }`).join(", "),I=g.filter(V=>V.name!==h.name).map(V=>`    if (missing.includes(${JSON.stringify(V.name)})) delete values.${V.name};`).join(`
+`);return`  ${s.name}(result: SemaphorGeneratedMetricResult): SemaphorGeneratedKpiProps {
+    const values = mapMetricDisplayValues(metricValuesForView.${s.name}(result));
+    const missing = missingMetricMeasuresForView.${s.name}(result).map((key) => String(key));
+    const primaryMissing = missing.includes(${JSON.stringify(h.name)});
+    const primaryValue = primaryMissing ? result?.primaryValue : values.${h.name};
+    if (primaryMissing) values.${h.name} = metricDisplayValue(result?.primaryValue);
+${I}
+    return {
+      result: {
+        ...(result || {}),
+        value: metricDisplayValue(result?.value),
+        primaryValue: metricDisplayValue(result?.primaryValue),
+        comparisonValue: metricDisplayValue(result?.comparisonValue),
+        measures: values,
+      },
+      title: ${JSON.stringify(s.raw.title||s.raw.id)},
+      label: ${JSON.stringify(h.raw.label||h.raw.name)},
+      value: metricDisplayValue(primaryValue),
+      measures: [${y}],
+      missingMeasures: missing,
+      showComparison: Boolean(result?.comparisonKind),
+    };
+  },`}).filter(Boolean).join(`
+
+`),F=e.views.map(s=>{const g=We(s,e);return`  ${s.name}: ${N(g)},`}).join(`
+`),m=e.views.map(s=>{const h=U(s,e).map(y=>`      ${y.name}: resolveColumnKey(columns, fieldsForView.${s.name}.${y.name}),`).join(`
+`);return`  ${s.name}(columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${s.name}, string | undefined> {
     return {
-${w}
+${h}
     };
   },`}).join(`
 
-`),f=e.views.map(i=>{const w=U(i,e).map(g=>`      ${g.name}: readCell(row, columns, fieldsForView.${i.name}.${g.name}),`).join(`
-`);return`  ${i.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${i.name}, unknown> {
+`),c=e.views.map(s=>{const h=U(s,e).map(y=>`      ${y.name}: readCell(row, columns, fieldsForView.${s.name}.${y.name}),`).join(`
+`);return`  ${s.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${s.name}, unknown> {
     return {
-${w}
+${h}
     };
   },`}).join(`
 
-`),m=e.views.map(i=>`  ${i.name}(result: SemaphorGeneratedRecordsResult): Array<Record<keyof typeof fieldsForView.${i.name}, unknown>> {
-    return (result?.records || []).map((row) => rowValuesForView.${i.name}(row, result?.columns));
+`),O=e.views.map(s=>`  ${s.name}(result: SemaphorGeneratedRecordsResult): Array<Record<keyof typeof fieldsForView.${s.name}, unknown>> {
+    return (result?.records || []).map((row) => rowValuesForView.${s.name}(row, result?.columns));
   },`).join(`
 
-`),O=e.views.map(i=>{const p=U(i,e),w=p.filter(s=>s.raw.role==="dimension"),g=p.filter(s=>s.raw.role==="measure"),$=w[0],F=w[1],M=g[0],V=g[1],C=[$?`      primaryDimension: values.${$.name},`:"      primaryDimension: undefined,",F?`      secondaryDimension: values.${F.name},`:"      secondaryDimension: undefined,",M?`      primaryMeasure: values.${M.name},`:"      primaryMeasure: undefined,",V?`      secondaryMeasure: values.${V.name},`:"      secondaryMeasure: undefined,"].join(`
-`);return`  ${i.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): SemaphorGeneratedRoleValues {
-    const values = rowValuesForView.${i.name}(row, columns);
+`),u=e.views.map(s=>{const g=U(s,e),h=g.filter(w=>w.raw.role==="dimension"),y=g.filter(w=>w.raw.role==="measure"),I=h[0],V=h[1],b=y[0],M=y[1],a=[I?`      primaryDimension: values.${I.name},`:"      primaryDimension: undefined,",V?`      secondaryDimension: values.${V.name},`:"      secondaryDimension: undefined,",b?`      primaryMeasure: values.${b.name},`:"      primaryMeasure: undefined,",M?`      secondaryMeasure: values.${M.name},`:"      secondaryMeasure: undefined,"].join(`
+`);return`  ${s.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): SemaphorGeneratedRoleValues {
+    const values = rowValuesForView.${s.name}(row, columns);
     return {
-${C}
+${a}
     };
   },`}).join(`
 
-`),u=n.includes("fields.")||r.includes("fields."),c=[`import { ${["type SemaphorFieldRef","type SemaphorResultColumn","semaphorMetricMeasureBindingKey"].filter(G).join(", ")} } from "react-semaphor/data-app-sdk";`,u?'import { fields } from "./fields";':void 0].filter(G).join(`
-`);return`${K}
-${c}
+`),d=r.includes("fields.")||n.includes("fields."),$=[`import { ${["type SemaphorFieldRef","type SemaphorResultColumn"].filter(A).join(", ")} } from "react-semaphor/data-app-sdk";`,d?'import { fields } from "./fields";':void 0].filter(A).join(`
+`);return`${T}
+${$}
 
 export type SemaphorGeneratedRow = Record<string, unknown>;
 export type SemaphorGeneratedColumns = readonly SemaphorResultColumn[] | null | undefined;
@@ -302,12 +329,17 @@ export type SemaphorGeneratedRecordsResult = {
 } | null | undefined;
 export type SemaphorGeneratedMetricMeasures = Record<string, unknown> | null | undefined;
 export type SemaphorGeneratedMetricMeasureBindings = Record<string, string> | null | undefined;
+export type SemaphorGeneratedMetricValue = number | string | null;
 export type SemaphorGeneratedMetricResult = {
   readonly measures?: SemaphorGeneratedMetricMeasures;
   readonly measureBindings?: SemaphorGeneratedMetricMeasureBindings;
   readonly missingMeasures?: readonly string[];
   readonly primaryValue: unknown;
   readonly value?: unknown;
+  readonly comparisonKind?: string;
+  readonly comparisonValue?: unknown;
+  readonly delta?: number | null;
+  readonly deltaPercent?: number | null;
 } | null | undefined;
 export type SemaphorGeneratedRoleValues = {
   readonly primaryDimension: unknown;
@@ -322,13 +354,36 @@ export type SemaphorGeneratedTableColumn = {
   readonly sortable?: boolean;
   readonly sortKey?: string;
 };
+export type SemaphorGeneratedKpiResult<TValues extends Record<string, SemaphorGeneratedMetricValue> = Record<string, SemaphorGeneratedMetricValue>> =
+  Record<string, unknown> & {
+    readonly value?: SemaphorGeneratedMetricValue;
+    readonly primaryValue?: SemaphorGeneratedMetricValue;
+    readonly comparisonValue?: SemaphorGeneratedMetricValue;
+    readonly comparisonKind?: string;
+    readonly delta?: number | null;
+    readonly deltaPercent?: number | null;
+    readonly measures: TValues;
+  };
+export type SemaphorGeneratedKpiMeasureConfig = {
+  key: string;
+  label: string;
+};
+export type SemaphorGeneratedKpiProps = {
+  readonly result: SemaphorGeneratedKpiResult;
+  readonly title: string;
+  readonly label: string;
+  readonly value: SemaphorGeneratedMetricValue;
+  readonly measures: SemaphorGeneratedKpiMeasureConfig[];
+  readonly missingMeasures: readonly string[];
+  readonly showComparison: boolean;
+};
 
 export const fieldsForView = {
-${n}
+${r}
 } as const;
 
 export const metricFieldsForView = {
-${r}
+${n}
 } as const;
 
 export const metricMeasureKeysForView = {
@@ -340,33 +395,37 @@ ${o}
 } as const;
 
 export const tableColumnsForView = {
-${y}
+${F}
 } as const;
 
 export const columnKeysForView = {
-${S}
+${m}
 } as const;
 
 export const rowValuesForView = {
-${f}
+${c}
 } as const;
 
 export const rowsForView = {
-${m}
+${O}
 } as const;
 
 export const roleValuesForView = {
-${O}
+${u}
 } as const;
 
 export const metricValuesForView = {
-${a}
+${i}
 } as const;
 
 export const missingMetricMeasuresForView = {
 ${l}
 } as const;
 
+export const kpiPropsForView = {
+${f}
+} as const;
+
 export function resolveColumnKey(
   columns: SemaphorGeneratedColumns,
   field: SemaphorFieldRef,
@@ -486,6 +545,26 @@ export function readStringMetricValue(
   return value === null || value === undefined ? "" : String(value);
 }
 
+export function mapMetricDisplayValues(
+  values: Record<string, unknown>,
+): Record<string, SemaphorGeneratedMetricValue> {
+  return Object.fromEntries(
+    Object.entries(values)
+      .map(([key, value]) => [key, metricDisplayValue(value)] as const)
+      .filter(([key]) => values[key] !== undefined),
+  );
+}
+
+export function metricDisplayValue(value: unknown): SemaphorGeneratedMetricValue {
+  if (value === null || value === undefined) {
+    return null;
+  }
+  if (typeof value === "number" || typeof value === "string") {
+    return value;
+  }
+  return String(value);
+}
+
 export function metricKeysForField(
   field: SemaphorFieldRef,
   options: { allowNameFallback?: boolean; excludedKeys?: readonly string[] } = {},
@@ -505,11 +584,15 @@ export function metricKeysForField(
 }
 
 function metricQualifiedKeyForField(field: SemaphorFieldRef): string {
-  return semaphorMetricMeasureBindingKey(field);
+  return [
+    field.source ? sourceIdentityKey(field.source as Record<string, unknown>) : "unknown",
+    metricAggregateForField(field),
+    field.name,
+  ].filter(Boolean).join(":");
 }
 
 function metricAggregateForField(field: SemaphorFieldRef): string {
-  return stringProperty(field as Record<string, unknown>, "aggregate")?.toUpperCase() || "SUM";
+  return (field.aggregate || "SUM").toUpperCase();
 }
 
 function metricKeyPrefixesForSource(
@@ -550,6 +633,35 @@ function metricKeyPrefixesForSource(
   return [];
 }
 
+function sourceIdentityKey(source: Record<string, unknown>): string {
+  const kind = stringProperty(source, "kind");
+  if (kind === "semantic") {
+    const datasetId = stringProperty(source, "datasetId");
+    return [
+      kind,
+      stringProperty(source, "domainId") || "",
+      datasetId
+        ? \`datasetId:\${datasetId}\`
+        : \`datasetName:\${stringProperty(source, "datasetName") || ""}\`,
+    ].join(":");
+  }
+  if (kind === "physical") {
+    return [
+      kind,
+      stringProperty(source, "connectionId") || "",
+      stringProperty(source, "databaseName") || "",
+      stringProperty(source, "schemaName") || "",
+      stringProperty(source, "tableName") || "",
+    ].join(":");
+  }
+  return [
+    kind || "unknown",
+    stringProperty(source, "connectionId") || "",
+    stringProperty(source, "dialect") || "",
+    stringProperty(source, "label") || "",
+  ].join(":");
+}
+
 function stringProperty(record: Record<string, unknown>, key: string): string | undefined {
   const value = record[key];
   return typeof value === "string" && value.length > 0 ? value : undefined;
@@ -661,13 +773,13 @@ function sourcesReferToSameDataset(
   }
   return false;
 }
-`}function Ye(e,n){const r=U(e,n),t=new Map((T(e)?W(e,n):[]).map(o=>[o.fieldName,o.key]));return r.map(o=>{const a=N(o.raw,n),l=a?t.get(a):void 0;return A({key:o.name,label:o.raw.label||o.raw.name,dataType:o.raw.dataType,sortable:!!l,sortKey:l})})}function We(e){const n=e.checklist.filterScopeByInput||[],r=e.checklist.requiredDevtools||{},t=e.summary.views.map(u=>u.id).filter(Boolean),o=e.views.map(u=>u.raw.id).filter(Boolean),a=e.inputs.map(u=>u.raw.id).filter(Boolean),l=e.optionQueries.map(u=>u.raw.id||`${u.input.raw.id}-options`).filter(Boolean),y=Object.fromEntries(o.map(u=>[u,e.filterContracts.filter(d=>Array.isArray(d.appliesToViewIds)&&d.appliesToViewIds.includes(u)).map(d=>d.inputId)])),S=Object.fromEntries(e.views.map(u=>[u.raw.id,{title:u.raw.title,visual:u.raw.visual,visualSpec:u.raw.visualSpec,queryKind:u.raw.queryKind,sdkBuilder:u.raw.sdkBuilder}])),f=Object.fromEntries(e.views.map(u=>{var d;return[u.raw.id,A({viewId:u.raw.id,queryId:u.name,title:u.raw.title,visualType:((d=u.raw.visualSpec)==null?void 0:d.visualType)||u.raw.visual,suggestedComponentName:ye(u.raw.title||u.raw.id||u.name),marker:{attribute:"data-semaphor-view-id",value:u.raw.id}})]})),m=Object.fromEntries(e.inputs.map(u=>{var d;return[u.raw.id,A({inputId:u.raw.id,label:u.raw.label,type:u.raw.type,optionQueryId:((d=u.raw.optionQuery)==null?void 0:d.id)||(u.raw.optionQuery?`${u.raw.id}-options`:void 0),suggestedComponentName:ye(u.raw.label||u.raw.id||u.name),marker:{attribute:"data-semaphor-input-id",value:u.raw.id}})]})),O=Object.fromEntries(e.views.map(u=>{var d,c,i;return[u.name,A({viewId:u.raw.id,viewTitle:((d=u.raw.visualSpec)==null?void 0:d.title)||u.raw.title,visualType:(c=u.raw.visualSpec)==null?void 0:c.visualType,title:((i=u.raw.visualSpec)==null?void 0:i.title)||u.raw.title})]}));return`${K}
-export const generatedViewIds = ${k(t)} as const;
-export const generatedQueryViewIds = ${k(o)} as const;
-export const generatedInputIds = ${k(a)} as const;
-export const generatedInputOptionQueryIds = ${k(l)} as const;
-export const generatedViewAuthoring = ${k(f)} as const;
-export const generatedInputAuthoring = ${k(m)} as const;
+`}function We(e,r){const n=U(e,r),t=new Map((v(e)?Z(e,r):[]).map(o=>[o.fieldName,o.key]));return n.map(o=>{const i=C(o.raw,r),l=i?t.get(i):void 0;return G({key:o.name,label:o.raw.label||o.raw.name,dataType:o.raw.dataType,sortable:!!l,sortKey:l})})}function Ze(e){const r=e.checklist.filterScopeByInput||[],n=e.checklist.requiredDevtools||{},t=e.summary.views.map(u=>u.id).filter(Boolean),o=e.views.map(u=>u.raw.id).filter(Boolean),i=e.inputs.map(u=>u.raw.id).filter(Boolean),l=e.optionQueries.map(u=>u.raw.id||`${u.input.raw.id}-options`).filter(Boolean),f=Object.fromEntries(o.map(u=>[u,e.filterContracts.filter(d=>Array.isArray(d.appliesToViewIds)&&d.appliesToViewIds.includes(u)).map(d=>d.inputId)])),F=Object.fromEntries(e.views.map(u=>[u.raw.id,{title:u.raw.title,visual:u.raw.visual,visualSpec:u.raw.visualSpec,queryKind:u.raw.queryKind,sdkBuilder:u.raw.sdkBuilder}])),m=Object.fromEntries(e.views.map(u=>{var d;return[u.raw.id,G({viewId:u.raw.id,queryId:u.name,title:u.raw.title,visualType:((d=u.raw.visualSpec)==null?void 0:d.visualType)||u.raw.visual,suggestedComponentName:ye(u.raw.title||u.raw.id||u.name),marker:{attribute:"data-semaphor-view-id",value:u.raw.id}})]})),c=Object.fromEntries(e.inputs.map(u=>{var d;return[u.raw.id,G({inputId:u.raw.id,label:u.raw.label,type:u.raw.type,optionQueryId:((d=u.raw.optionQuery)==null?void 0:d.id)||(u.raw.optionQuery?`${u.raw.id}-options`:void 0),suggestedComponentName:ye(u.raw.label||u.raw.id||u.name),marker:{attribute:"data-semaphor-input-id",value:u.raw.id}})]})),O=Object.fromEntries(e.views.map(u=>{var d,p,$;return[u.name,G({viewId:u.raw.id,viewTitle:((d=u.raw.visualSpec)==null?void 0:d.title)||u.raw.title,visualType:(p=u.raw.visualSpec)==null?void 0:p.visualType,title:(($=u.raw.visualSpec)==null?void 0:$.title)||u.raw.title})]}));return`${T}
+export const generatedViewIds = ${N(t)} as const;
+export const generatedQueryViewIds = ${N(o)} as const;
+export const generatedInputIds = ${N(i)} as const;
+export const generatedInputOptionQueryIds = ${N(l)} as const;
+export const generatedViewAuthoring = ${N(m)} as const;
+export const generatedInputAuthoring = ${N(c)} as const;
 
 export type SemaphorGeneratedViewId = typeof generatedViewIds[number];
 export type SemaphorGeneratedQueryViewId = typeof generatedQueryViewIds[number];
@@ -686,8 +798,8 @@ export type SemaphorGeneratedFilterContract = {
   readonly [key: string]: unknown;
 };
 
-export const generatedInputIdsForView = ${k(y)} as const;
-export const generatedFilterContracts: readonly SemaphorGeneratedFilterContract[] = ${k(e.filterContracts)} as const;
+export const generatedInputIdsForView = ${N(f)} as const;
+export const generatedFilterContracts: readonly SemaphorGeneratedFilterContract[] = ${N(e.filterContracts)} as const;
 
 export function semaphorViewMarkerProps(viewId: SemaphorGeneratedViewId) {
   return {
@@ -707,10 +819,10 @@ export function filterContractsForView(viewId: SemaphorGeneratedQueryViewId) {
   );
 }
 
-export const queryDebugForView = ${k(O)} as const;
+export const queryDebugForView = ${N(O)} as const;
 
-export const semaphorGeneratedContractMetadata = ${k({schemaVersion:"semaphor-generated-data-app-contract/v1",title:e.title,requiredDevtools:r,filterContracts:e.filterContracts,filterScopeByInput:n,generatedViewIds:t,generatedQueryViewIds:o,generatedInputIds:a,generatedInputOptionQueryIds:l,generatedInputIdsForView:y,generatedViewAuthoring:f,generatedInputAuthoring:m,visualSpecs:S,presentationViews:e.presentationViews})} as const;
-`}function Ze(){return`${K}
+export const semaphorGeneratedContractMetadata = ${N({schemaVersion:"semaphor-generated-data-app-contract/v1",title:e.title,requiredDevtools:n,filterContracts:e.filterContracts,filterScopeByInput:r,generatedViewIds:t,generatedQueryViewIds:o,generatedInputIds:i,generatedInputOptionQueryIds:l,generatedInputIdsForView:f,generatedViewAuthoring:m,generatedInputAuthoring:c,visualSpecs:F,presentationViews:e.presentationViews})} as const;
+`}function Xe(){return`${T}
 export * from "./sources";
 export * from "./fields";
 export * from "./inputs";
@@ -718,4 +830,4 @@ export * from "./queries";
 export * from "./bindings";
 export * from "./accessors";
 export * from "./metadata";
-`}function Q(e,n){if(!(!n||typeof n!="object")){if(Array.isArray(n)){for(const r of n)Q(e,r);return}E(n)&&h(e,L(n));for(const r of Object.values(n))Q(e,r)}}function U(e,n){const r=[];if(tn(r,e.raw.sdkSpec),r.length===0)for(const o of e.raw.fields||[])h(r,o);const t=ne(r.filter(o=>o.name&&N(o,n)).map(o=>({raw:o,key:J(o),name:""})),o=>o.key);return H(t,o=>q(o.raw.label||o.raw.name||"field")),t}function P(e,n){if(j(e.raw.sdkSpec.builder)!=="metric")return[];const r=b(e.raw.sdkSpec.spec),t=[];h(t,r==null?void 0:r.primaryMeasure);for(const a of v(r==null?void 0:r.measures))h(t,a);const o=ne(t.filter(a=>a.name&&N(a,n)).map(a=>({raw:a,key:J(a),name:""})),a=>a.key);return H(o,a=>q(a.raw.label||a.raw.name||"metric")),o}function Xe(e,n,r){var o;const t=(o=e.raw.metricBindingKeys)==null?void 0:o[r];if(typeof t=="string"&&t.trim())return t;throw new Error(`views.${e.raw.id}.metricBindingKeys must include a binding key for metric field ${n.raw.name}.`)}function en(e,n){if(n.length===1)return new Set([n[0].name]);const r=b(e.raw.sdkSpec.spec);if(!E(r==null?void 0:r.primaryMeasure))return new Set;const t=J(L(r.primaryMeasure)),o=n.find(a=>a.key===t);return o?new Set([o.name]):new Set}function nn(e){const n=new Map;for(const r of e)for(const t of new Set(Se(r.raw)))n.set(t,(n.get(t)||0)+1);return new Set(Array.from(n.entries()).filter(([,r])=>r>1).map(([r])=>r))}function Se(e){const n=(e.aggregate||"SUM").toUpperCase();return D([`${n.toLowerCase()}_${e.name}`,`${n}_${e.name}`,`${e.name}_${n.toLowerCase()}`,`${e.name}_${n}`,e.name])}function rn(e){const n=new Map;for(const r of e)n.set(r.raw.name,(n.get(r.raw.name)||0)+1);return new Set(Array.from(n.entries()).filter(([,r])=>r>1).map(([r])=>r))}function tn(e,n){const r=b(n.spec);if(!r)return;const t=j(n.builder);if(t==="records"){for(const o of v(r.fields))h(e,o);return}if(t==="sql"){for(const o of v(r.fields))h(e,o);return}if(t==="analysis"||t==="metric"){h(e,r.primaryMeasure);for(const o of v(r.measures))h(e,o);for(const o of v(r.dimensions))h(e,o);h(e,r.dateField);return}if(t==="matrix"){const o=ce(r.rows),a=ce(r.columns),l=v(r.values);for(const y of o)me(e,y);for(const y of a)me(e,y);for(const y of l){const S=b(y);h(e,S==null?void 0:S.field),h(e,S==null?void 0:S.measure)}}}function ce(e){if(Array.isArray(e))return e;const n=b(e);return Array.isArray(n==null?void 0:n.levels)?n.levels:[]}function me(e,n){var r;if(E(n)){h(e,n);return}h(e,(r=b(n))==null?void 0:r.field)}function fe(e){var n,r,t,o;return((n=e==null?void 0:e.computation)==null?void 0:n.kind)==="presentation_only"||((r=e==null?void 0:e.computation)==null?void 0:r.kind)==="derived"||((t=e==null?void 0:e.computation)==null?void 0:t.kind)==="unsupported"||(e==null?void 0:e.visual)==="text_block"||((o=e==null?void 0:e.visualSpec)==null?void 0:o.visualType)==="text_block"}function on(e){const n=b(e)||{};return A({id:e.id,title:e.title,purpose:e.purpose,visual:e.visual,visualSpec:e.visualSpec,computation:e.computation,uxExpectations:e.uxExpectations,validation:e.validation,sourceViewIds:n.sourceViewIds,content:n.content,description:n.description})}function h(e,n){E(n)&&e.push(L(n))}function L(e){return{name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate,sourceKey:e.sourceKey||(e.source?le(e.source):void 0),...e.source?{source:e.source}:{}}}function sn(e){if(!e.source)return;const n={...e.source,...e.sourceKey?{sourceKey:e.sourceKey}:{}},r=Ie(n);if(r)return{raw:n,key:r,aliases:Fe(n),name:""}}function E(e){const n=b(e);return!!(n&&typeof n.name=="string"&&(typeof n.role=="string"||typeof n.dataType=="string"||typeof n.aggregate=="string"||n.source||n.sourceKey))}function we(e){const n=b(e);return!!(n&&(typeof n.sourceKey=="string"||n.kind==="semantic"||typeof n.datasetName=="string"&&typeof n.domainId=="string"))}function x(e,n){if(e===void 0)return"undefined";if(e===null||typeof e=="number"||typeof e=="boolean"||typeof e=="string")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(o=>x(o,n)).join(", ")}]`;if(E(e)){const o=N(L(e),n);if(o)return`fields.${o}`}if(we(e)){const o=$e(e,n);if(o)return`sources.${o}`}const r=b(e);return r?`{ ${Object.entries(r).filter(([,o])=>o!==void 0).map(([o,a])=>`${JSON.stringify(o)}: ${x(a,n)}`).join(", ")} }`:JSON.stringify(e)}function k(e){return JSON.stringify(e,null,2)}function N(e,n){if(E(e))return n.fieldNameByKey.get(J(L(e)))}function $e(e,n){if(we(e))for(const r of ee(e)){const t=n.sourceNameByKey.get(r);if(t)return t}}function J(e){return[e.sourceKey||"",e.name||"",e.role||"",e.aggregate||""].join("|")}function an(e,n){return!E(e)||!E(n)||e.name!==n.name?!1:de(e).some(r=>de(n).includes(r))}function un(e){return E(e)&&e.role==="id"}function dn(e){const n=[],r=new Map;for(const t of e){const o=D(t.aliases.length?t.aliases:[t.key]),a=o.map(l=>r.get(l)).find(G);if(a){a.aliases=D([...a.aliases,...o]);continue}t.aliases=o,n.push(t);for(const l of o)r.set(l,t)}return n}function pn(e){const n=new Map;for(const r of e)for(const t of D([r.key,...r.aliases])){const o=n.get(t);if(o&&o!==r.name)throw new Error(`Source identity ${t} resolves to multiple generated sources.`);n.set(t,r.name)}return n}function D(e){return Array.from(new Set(e.filter(Boolean)))}function Ie(e){return ee(e)[0]||le(e)}function ee(e){const n=b(e);if(!n)return[];const r=[];if(typeof n.sourceKey=="string"&&r.push(n.sourceKey),n.kind==="semantic"||n.datasetName){const t=typeof n.domainId=="string"?n.domainId:"";t&&typeof n.datasetId=="string"&&r.push(`semantic:${t}:datasetId:${n.datasetId}`),t&&typeof n.datasetName=="string"&&r.push(`semantic:${t}:datasetName:${n.datasetName}`)}return r.length===0&&r.push(le(e)),D(r)}function Fe(e){return ee(e)}function le(e){const n=b(e);return n?typeof n.sourceKey=="string"?n.sourceKey:JSON.stringify(n):""}function ln(e){return E(e)&&de(e)[0]||""}function de(e){return E(e)?D([...typeof e.sourceKey=="string"?[e.sourceKey]:[],...e.source?ee(e.source):[]]):[]}function j(e){const n=String(e||"").replace(/^semaphor\./,"");if(!["metric","records","analysis","matrix","sql"].includes(n))throw new Error(`Unsupported sdkSpec builder: ${e}`);return n}function cn(e){const n=j(e);return n==="records"||n==="sql"}function mn(e){const n=b(e);return typeof(n==null?void 0:n.operator)=="string"?n.operator:e.type==="date_range"?"between":e.type==="multi_select"||e.type==="select"?"in":"="}function H(e,n){const r=new Map;for(const t of e){const o=n(t)||"item",a=r.get(o)||0;r.set(o,a+1),t.name=a===0?o:`${o}${a+1}`}}function ne(e,n){const r=new Set,t=[];for(const o of e){const a=n(o);!a||r.has(a)||(r.add(a),t.push(o))}return t}function q(e){const n=String(e||"").replace(/[^A-Za-z0-9]+/g," ").trim().split(/\s+/).filter(Boolean);if(n.length===0)return"item";const[r,...t]=n,o=[r.toLowerCase(),...t.map(a=>a.charAt(0).toUpperCase()+a.slice(1).toLowerCase())].join("");return/^[A-Za-z_$]/.test(o)?o:`item${o}`}function ye(e){const n=q(e);return n.charAt(0).toUpperCase()+n.slice(1)}function fn(e){const n=String(e).split(":");return n[n.length-1]||String(e)}function A(e){return Object.fromEntries(Object.entries(e).filter(([,n])=>n!==void 0))}function b(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function v(e){return Array.isArray(e)?e:[]}function Y(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function G(e){return e!==void 0}exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION=Z.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION=Z.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.isSemaphorDataAppCodegenSummary=Z.isSemaphorDataAppCodegenSummary;exports.validateSemaphorDataAppCodegenSummary=Z.validateSemaphorDataAppCodegenSummary;exports.CODEGEN_SUMMARY_SCHEMA_VERSION=R.CODEGEN_SUMMARY_SCHEMA_VERSION;exports.CODEGEN_SUMMARY_VALIDATOR_VERSION=R.CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.CONTRACT_MANIFEST_SCHEMA_VERSION=R.CONTRACT_MANIFEST_SCHEMA_VERSION;exports.GENERATED_CONTRACT_SCHEMA_VERSION=R.GENERATED_CONTRACT_SCHEMA_VERSION;exports.GENERATED_CONTRACT_TYPESCRIPT_FILES=R.GENERATED_CONTRACT_TYPESCRIPT_FILES;exports.REQUIRED_GENERATED_CONTRACT_FILES=R.REQUIRED_GENERATED_CONTRACT_FILES;exports.assertValidCodegenSummary=R.assertValidCodegenSummary;exports.buildSemaphorGeneratedActiveInput=R.buildSemaphorGeneratedActiveInput;exports.buildSemaphorGeneratedInputOptionIntent=R.buildSemaphorGeneratedInputOptionIntent;exports.buildSemaphorGeneratedViewExecutionRequest=R.buildSemaphorGeneratedViewExecutionRequest;exports.buildSemaphorGeneratedViewExecutionRequests=R.buildSemaphorGeneratedViewExecutionRequests;exports.evaluateSemaphorDataAppContractUpdatePolicy=R.evaluateSemaphorDataAppContractUpdatePolicy;exports.validateCodegenSummary=R.validateCodegenSummary;exports.validateSemaphorGeneratedContract=R.validateSemaphorGeneratedContract;exports.DEFAULT_GENERATED_CONTRACT_OUTPUT_DIR=ke;exports.generateSemaphorDataAppContract=Me;
+`}function D(e,r){if(!(!r||typeof r!="object")){if(Array.isArray(r)){for(const n of r)D(e,n);return}E(r)&&S(e,J(r));for(const n of Object.values(r))D(e,n)}}function U(e,r){const n=[];if(or(n,e.raw.sdkSpec),n.length===0)for(const o of e.raw.fields||[])S(n,o);const t=re(n.filter(o=>o.name&&C(o,r)).map(o=>({raw:o,key:z(o),name:""})),o=>o.key);return _(t,o=>j(o.raw.label||o.raw.name||"field")),t}function B(e,r){if(q(e.raw.sdkSpec.builder)!=="metric")return[];const n=k(e.raw.sdkSpec.spec),t=[];S(t,n==null?void 0:n.primaryMeasure);for(const i of H(n==null?void 0:n.measures))S(t,i);const o=re(t.filter(i=>i.name&&C(i,r)).map(i=>({raw:i,key:z(i),name:""})),i=>i.key);return _(o,i=>j(i.raw.label||i.raw.name||"metric")),o}function er(e,r,n){var o;const t=(o=e.raw.metricBindingKeys)==null?void 0:o[n];if(typeof t=="string"&&t.trim())return t;throw new Error(`views.${e.raw.id}.metricBindingKeys must include a binding key for metric field ${r.raw.name}.`)}function rr(e,r){if(r.length===1)return new Set([r[0].name]);const n=k(e.raw.sdkSpec.spec);if(!E(n==null?void 0:n.primaryMeasure))return new Set;const t=z(J(n.primaryMeasure)),o=r.find(i=>i.key===t);return o?new Set([o.name]):new Set}function nr(e){const r=new Map;for(const n of e)for(const t of new Set(Se(n.raw)))r.set(t,(r.get(t)||0)+1);return new Set(Array.from(r.entries()).filter(([,n])=>n>1).map(([n])=>n))}function Se(e){const r=L.semaphorMetricAggregate(e);return Q([`${r.toLowerCase()}_${e.name}`,`${r}_${e.name}`,`${e.name}_${r.toLowerCase()}`,`${e.name}_${r}`,e.name])}function tr(e){const r=new Map;for(const n of e)r.set(n.raw.name,(r.get(n.raw.name)||0)+1);return new Set(Array.from(r.entries()).filter(([,n])=>n>1).map(([n])=>n))}function or(e,r){const n=k(r.spec);if(!n)return;const t=q(r.builder);if(t==="records"){for(const o of H(n.fields))S(e,o);return}if(t==="sql"){for(const o of H(n.fields))S(e,o);return}if(t==="analysis"||t==="metric"){S(e,n.primaryMeasure);for(const o of H(n.measures))S(e,o);for(const o of H(n.dimensions))S(e,o);S(e,n.dateField);return}if(t==="matrix"){const o=ce(n.rows),i=ce(n.columns),l=H(n.values);for(const f of o)me(e,f);for(const f of i)me(e,f);for(const f of l){const F=k(f);S(e,F==null?void 0:F.field),S(e,F==null?void 0:F.measure)}}}function ce(e){if(Array.isArray(e))return e;const r=k(e);return Array.isArray(r==null?void 0:r.levels)?r.levels:[]}function me(e,r){var n;if(E(r)){S(e,r);return}S(e,(n=k(r))==null?void 0:n.field)}function fe(e){var r,n,t,o;return((r=e==null?void 0:e.computation)==null?void 0:r.kind)==="presentation_only"||((n=e==null?void 0:e.computation)==null?void 0:n.kind)==="derived"||((t=e==null?void 0:e.computation)==null?void 0:t.kind)==="unsupported"||(e==null?void 0:e.visual)==="text_block"||((o=e==null?void 0:e.visualSpec)==null?void 0:o.visualType)==="text_block"}function ar(e){const r=k(e)||{};return G({id:e.id,title:e.title,purpose:e.purpose,visual:e.visual,visualSpec:e.visualSpec,computation:e.computation,uxExpectations:e.uxExpectations,validation:e.validation,sourceViewIds:r.sourceViewIds,content:r.content,description:r.description})}function S(e,r){E(r)&&e.push(J(r))}function J(e){return{name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate,sourceKey:e.sourceKey||(e.source?pe(e.source):void 0),...e.source?{source:e.source}:{}}}function sr(e){if(!e.source)return;const r={...e.source,...e.sourceKey?{sourceKey:e.sourceKey}:{}},n=Ie(r);if(n)return{raw:r,key:n,aliases:Fe(r),name:""}}function E(e){const r=k(e);return!!(r&&typeof r.name=="string"&&(typeof r.role=="string"||typeof r.dataType=="string"||typeof r.aggregate=="string"||r.source||r.sourceKey))}function we(e){const r=k(e);return!!(r&&(typeof r.sourceKey=="string"||r.kind==="semantic"||typeof r.datasetName=="string"&&typeof r.domainId=="string"))}function x(e,r){if(e===void 0)return"undefined";if(e===null||typeof e=="number"||typeof e=="boolean"||typeof e=="string")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(o=>x(o,r)).join(", ")}]`;if(E(e)){const o=C(J(e),r);if(o)return`fields.${o}`}if(we(e)){const o=$e(e,r);if(o)return`sources.${o}`}const n=k(e);return n?`{ ${Object.entries(n).filter(([,o])=>o!==void 0).map(([o,i])=>`${JSON.stringify(o)}: ${x(i,r)}`).join(", ")} }`:JSON.stringify(e)}function N(e){return JSON.stringify(e,null,2)}function C(e,r){if(E(e))return r.fieldNameByKey.get(z(J(e)))}function $e(e,r){if(we(e))for(const n of ee(e)){const t=r.sourceNameByKey.get(n);if(t)return t}}function z(e){return[e.sourceKey||"",e.name||"",e.role||"",e.aggregate||""].join("|")}function ir(e,r){return!E(e)||!E(r)||e.name!==r.name?!1:de(e).some(n=>de(r).includes(n))}function ur(e){return E(e)&&e.role==="id"}function dr(e){const r=[],n=new Map;for(const t of e){const o=Q(t.aliases.length?t.aliases:[t.key]),i=o.map(l=>n.get(l)).find(A);if(i){i.aliases=Q([...i.aliases,...o]);continue}t.aliases=o,r.push(t);for(const l of o)n.set(l,t)}return r}function lr(e){const r=new Map;for(const n of e)for(const t of Q([n.key,...n.aliases])){const o=r.get(t);if(o&&o!==n.name)throw new Error(`Source identity ${t} resolves to multiple generated sources.`);r.set(t,n.name)}return r}function Q(e){return Array.from(new Set(e.filter(Boolean)))}function Ie(e){return ee(e)[0]||pe(e)}function ee(e){const r=k(e);if(!r)return[];const n=[];if(typeof r.sourceKey=="string"&&n.push(r.sourceKey),r.kind==="semantic"||r.datasetName){const t=typeof r.domainId=="string"?r.domainId:"";t&&typeof r.datasetId=="string"&&n.push(`semantic:${t}:datasetId:${r.datasetId}`),t&&typeof r.datasetName=="string"&&n.push(`semantic:${t}:datasetName:${r.datasetName}`)}return n.length===0&&n.push(pe(e)),Q(n)}function Fe(e){return ee(e)}function pe(e){const r=k(e);return r?typeof r.sourceKey=="string"?r.sourceKey:JSON.stringify(r):""}function pr(e){return E(e)&&de(e)[0]||""}function de(e){return E(e)?Q([...typeof e.sourceKey=="string"?[e.sourceKey]:[],...e.source?ee(e.source):[]]):[]}function q(e){const r=String(e||"").replace(/^semaphor\./,"");if(!["metric","records","analysis","matrix","sql"].includes(r))throw new Error(`Unsupported sdkSpec builder: ${e}`);return r}function cr(e){const r=q(e);return r==="records"||r==="sql"}function mr(e){const r=k(e);return typeof(r==null?void 0:r.operator)=="string"?r.operator:e.type==="date_range"?"between":e.type==="multi_select"||e.type==="select"?"in":"="}function _(e,r){const n=new Map;for(const t of e){const o=r(t)||"item",i=n.get(o)||0;n.set(o,i+1),t.name=i===0?o:`${o}${i+1}`}}function re(e,r){const n=new Set,t=[];for(const o of e){const i=r(o);!i||n.has(i)||(n.add(i),t.push(o))}return t}function j(e){const r=String(e||"").replace(/[^A-Za-z0-9]+/g," ").trim().split(/\s+/).filter(Boolean);if(r.length===0)return"item";const[n,...t]=r,o=[n.toLowerCase(),...t.map(i=>i.charAt(0).toUpperCase()+i.slice(1).toLowerCase())].join("");return/^[A-Za-z_$]/.test(o)?o:`item${o}`}function ye(e){const r=j(e);return r.charAt(0).toUpperCase()+r.slice(1)}function fr(e){const r=String(e).split(":");return r[r.length-1]||String(e)}function G(e){return Object.fromEntries(Object.entries(e).filter(([,r])=>r!==void 0))}function k(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function H(e){return Array.isArray(e)?e:[]}function W(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function A(e){return e!==void 0}exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION=L.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION;exports.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION=L.SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.isSemaphorDataAppCodegenSummary=L.isSemaphorDataAppCodegenSummary;exports.validateSemaphorDataAppCodegenSummary=L.validateSemaphorDataAppCodegenSummary;exports.CODEGEN_SUMMARY_SCHEMA_VERSION=R.CODEGEN_SUMMARY_SCHEMA_VERSION;exports.CODEGEN_SUMMARY_VALIDATOR_VERSION=R.CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.CONTRACT_MANIFEST_SCHEMA_VERSION=R.CONTRACT_MANIFEST_SCHEMA_VERSION;exports.GENERATED_CONTRACT_SCHEMA_VERSION=R.GENERATED_CONTRACT_SCHEMA_VERSION;exports.GENERATED_CONTRACT_TYPESCRIPT_FILES=R.GENERATED_CONTRACT_TYPESCRIPT_FILES;exports.REQUIRED_GENERATED_CONTRACT_FILES=R.REQUIRED_GENERATED_CONTRACT_FILES;exports.assertValidCodegenSummary=R.assertValidCodegenSummary;exports.buildSemaphorGeneratedActiveInput=R.buildSemaphorGeneratedActiveInput;exports.buildSemaphorGeneratedInputOptionIntent=R.buildSemaphorGeneratedInputOptionIntent;exports.buildSemaphorGeneratedViewExecutionRequest=R.buildSemaphorGeneratedViewExecutionRequest;exports.buildSemaphorGeneratedViewExecutionRequests=R.buildSemaphorGeneratedViewExecutionRequests;exports.evaluateSemaphorDataAppContractUpdatePolicy=R.evaluateSemaphorDataAppContractUpdatePolicy;exports.validateCodegenSummary=R.validateCodegenSummary;exports.validateSemaphorGeneratedContract=R.validateSemaphorGeneratedContract;exports.DEFAULT_GENERATED_CONTRACT_OUTPUT_DIR=Re;exports.generateSemaphorDataAppContract=Me;