react-semaphor 0.1.407 → 0.1.409

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

@@ -1,48 +1,49 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const z=require("../chunks/analyze-result-contract-8nxUOWp8.js"),w=require("../chunks/update-policy-2M0canB_.js"),fe=require("node:crypto"),$e="src/semaphor/generated",M=`// Generated by Semaphor Agent Plugin. Do not hand-edit analytics wiring here.
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Z=require("../chunks/analyze-result-contract-8nxUOWp8.js"),$=require("../chunks/update-policy-CWg9c08k.js"),ye=require("node:crypto"),Ve="src/semaphor/generated",_=`// 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 Fe(e,n={}){w.assertValidCodegenSummary(e);const r=Ve(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 o=be(r),t=Ce({contract:r,files:o,generatorName:n.generatorName||"react-semaphor/data-app-codegen/node",generatorVersion:n.generatorVersion||"unknown"}),i={...o,"contract.manifest.json":`${JSON.stringify(t,null,2)}
-`};return{schemaVersion:w.GENERATED_CONTRACT_SCHEMA_VERSION,files:i,manifest:t,contentHash:String(t.generatedContentHash||""),usageExample:Ne(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 Ve(e){var b,d,c,S,f,F,C,V,N,T,I,O;const n=[],r=[];for(const s of e.inputs){y(r,s.fieldRef);for(const h of s.bindings||[])y(r,h.fieldRef);y(r,(b=s.optionQuery)==null?void 0:b.valueFieldRef),y(r,(d=s.optionQuery)==null?void 0:d.labelFieldRef),y(r,(c=s.optionQuery)==null?void 0:c.filterFieldRef),Q(r,(S=s.optionQuery)==null?void 0:S.spec)}for(const s of e.filterContracts){y(r,s.fieldRef),y(r,(f=s.optionQuery)==null?void 0:f.valueFieldRef),y(r,(F=s.optionQuery)==null?void 0:F.labelFieldRef),y(r,(C=s.optionQuery)==null?void 0:C.filterFieldRef),Q(r,(V=s.optionQuery)==null?void 0:V.spec);for(const h of s.bindings||[])y(r,h.fieldRef)}for(const s of e.views){for(const h of s.fields||[])y(r,h);Q(r,(N=s.sdkSpec)==null?void 0:N.spec),Q(r,s.visualSpec)}const o=e.implementationChecklist||{};for(const s of Object.values(o.bindingsByView||{}))for(const h of Array.isArray(s)?s:[])y(r,h.fieldRef),y(r,h.optionValueField),y(r,h.optionLabelField);for(const s of o.requiredInputOptions||[])y(r,s.visibleLabelField),y(r,s.optionValueField),y(r,s.runtimeFilterField);const t=We([...e.sources.map(s=>({raw:s,key:Se(s),aliases:ge(s),name:""})),...r.map(s=>ze(s)).filter(x)]);v(t,s=>{const h=g(s.raw);return D(s.raw.label||(h==null?void 0:h.datasetName)||(h==null?void 0:h.datasetId)||(h==null?void 0:h.name)||s.raw.kind||"source")});const i=Xe(t),u=de(r.filter(s=>s.name).map(s=>({raw:s,key:ue(s),name:""})),s=>s.key);v(u,s=>D([s.raw.sourceKey?tn(s.raw.sourceKey):"",s.raw.aggregate?s.raw.aggregate.toLowerCase():"",s.raw.name].filter(Boolean).join("_")));const l=new Map(u.map(s=>[s.key,s.name])),p=e.inputs.map(s=>({raw:s,name:D(s.id||s.label||"input")}));v(p,s=>s.name);const m=p.filter(s=>!!s.raw.optionQuery).map(s=>({input:s,name:`${s.name}Options`,raw:s.raw.optionQuery}));v(m,s=>s.name);for(const s of m)Ye(s.raw.labelFieldRef,s.raw.valueFieldRef)&&Ze(s.raw.valueFieldRef)&&n.push(`Input option query ${((T=s.raw.spec)==null?void 0:T.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 a=e.views.filter(s=>{var h,q;return!!((h=s.sdkSpec)!=null&&h.builder&&((q=s.sdkSpec)!=null&&q.spec))}).map(s=>({raw:s,name:D(s.id||s.title||"query")}));v(a,s=>s.name);const $=e.views.filter(s=>me(s)&&!("sdkSpec"in s)).map(s=>Je(s));for(const s of e.views)(!("sdkSpec"in s)||!((I=s.sdkSpec)!=null&&I.builder)||!((O=s.sdkSpec)!=null&&O.spec))&&!me(s)&&n.push(`Skipped view ${s.id||s.title||"unknown"} because it has no sdkSpec.`);return Re({inputs:p,views:a,filterContracts:e.filterContracts}),{summary:e,title:e.title||"Semaphor Data App",sources:t,fields:u,inputs:p,optionQueries:m,views:a,presentationViews:$,filterContracts:e.filterContracts,checklist:o,sourceNameByKey:i,fieldNameByKey:l,warnings:n}}function Re({inputs:e,views:n,filterContracts:r}){const o=new Set(e.map(i=>i.raw.id).filter(Boolean)),t=new Set(n.map(i=>i.raw.id).filter(Boolean));for(const[i,u]of r.entries()){if(!o.has(u.inputId))throw new Error(`filterContracts.${i}.inputId must reference a generated input.`);const l=new Set(u.appliesToViewIds||[]),p=new Set(u.notAppliedToViewIds||[]);for(const[m,a]of(u.appliesToViewIds||[]).entries())if(!t.has(a))throw new Error(`filterContracts.${i}.appliesToViewIds.${m} must reference an executable generated view.`);for(const[m,a]of(u.notAppliedToViewIds||[]).entries())if(!t.has(a))throw new Error(`filterContracts.${i}.notAppliedToViewIds.${m} must reference an executable generated view.`);for(const[m,a]of(u.bindings||[]).entries()){if(!t.has(a.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must reference an executable generated view.`);if(!l.has(a.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must be included in appliesToViewIds.`);if(p.has(a.viewId))throw new Error(`filterContracts.${i}.bindings.${m}.viewId must not be listed in notAppliedToViewIds.`)}}}function be(e){return{"sources.ts":ke(e),"fields.ts":Ge(e),"inputs.ts":xe(e),"queries.ts":He(e),"bindings.ts":Qe(e),"accessors.ts":Ke(e),"metadata.ts":Be(e),"index.ts":Ue()}}function Ce({contract:e,files:n,generatorName:r,generatorVersion:o}){return{schemaVersion:w.CONTRACT_MANIFEST_SCHEMA_VERSION,generatedContractSchemaVersion:w.GENERATED_CONTRACT_SCHEMA_VERSION,generator:{name:r,version:o},generatedContentHash:Oe(n),codegenSummaryValidatorVersion:w.CODEGEN_SUMMARY_VALIDATOR_VERSION,codegenSummaryHash:Ee(e.summary),codegenSummary:e.summary}}function Oe(e){const n=fe.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 Ee(e){return`sha256:${fe.createHash("sha256").update(se(e)).digest("hex")}`}function se(e){if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(o=>se(o)).join(",")}]`;const n=e;return`{${Object.keys(n).sort().filter(o=>n[o]!==void 0).map(o=>`${JSON.stringify(o)}:${se(n[o])}`).join(",")}}`}function Ne(e){const n=e.views.find(p=>G(p)&&_(p));if(n)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${n.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const r=e.views.find(p=>G(p));if(r)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${r.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const o=e.views.find(p=>Y(p)&&_(p));if(o)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${o.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const t=e.views.find(p=>ae(p)&&_(p));if(t)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${t.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const i=e.views.find(p=>{var m;return nn((m=p.raw.sdkSpec)==null?void 0:m.builder)});if(i)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${i.name}(), queryOptionsForView.${i.name}(inputHandles));`,`const rows = result.records.map((row) => rowValuesForView.${i.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`);const u=e.views[0];return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",u?`const result = useSemaphorQuery(queries.${u.name}(), queryOptionsForView.${u.name}(inputHandles));`:"const result = undefined;","const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
-`)}function Y(e){var n;return P((n=e.raw.sdkSpec)==null?void 0:n.builder)==="records"}function G(e){var n,r,o;return Y(e)&&((o=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.sorting)==null?void 0:o.mode)==="server"}function ae(e){var n;return P((n=e.raw.sdkSpec)==null?void 0:n.builder)==="sql"}function _(e){var n,r,o;return((o=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.pagination)==null?void 0:o.mode)==="server"}function Ae(e){return Y(e)&&(_(e)||G(e))||ae(e)&&_(e)}function ke(e){const n=e.sources.map(({name:o,raw:t})=>{const i=Te(t);return`  ${o}: ${i},`}).join(`
+`;function be(e,n={}){$.assertValidCodegenSummary(e);const r=Re(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 o=Ce(r),t=Ne({contract:r,files:o,generatorName:n.generatorName||"react-semaphor/data-app-codegen/node",generatorVersion:n.generatorVersion||"unknown"}),a={...o,"contract.manifest.json":`${JSON.stringify(t,null,2)}
+`};return{schemaVersion:$.GENERATED_CONTRACT_SCHEMA_VERSION,files:a,manifest:t,contentHash:String(t.generatedContentHash||""),usageExample:Ee(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 Re(e){var c,u,d,m,l,w,b,V,O,A,R,N;const n=[],r=[];for(const s of e.inputs){g(r,s.fieldRef);for(const S of s.bindings||[])g(r,S.fieldRef);g(r,(c=s.optionQuery)==null?void 0:c.valueFieldRef),g(r,(u=s.optionQuery)==null?void 0:u.labelFieldRef),g(r,(d=s.optionQuery)==null?void 0:d.filterFieldRef),j(r,(m=s.optionQuery)==null?void 0:m.spec)}for(const s of e.filterContracts){g(r,s.fieldRef),g(r,(l=s.optionQuery)==null?void 0:l.valueFieldRef),g(r,(w=s.optionQuery)==null?void 0:w.labelFieldRef),g(r,(b=s.optionQuery)==null?void 0:b.filterFieldRef),j(r,(V=s.optionQuery)==null?void 0:V.spec);for(const S of s.bindings||[])g(r,S.fieldRef)}for(const s of e.views){for(const S of s.fields||[])g(r,S);j(r,(O=s.sdkSpec)==null?void 0:O.spec),j(r,s.visualSpec)}const o=e.implementationChecklist||{};for(const s of Object.values(o.bindingsByView||{}))for(const S of Array.isArray(s)?s:[])g(r,S.fieldRef),g(r,S.optionValueField),g(r,S.optionLabelField);for(const s of o.requiredInputOptions||[])g(r,s.visibleLabelField),g(r,s.optionValueField),g(r,s.runtimeFilterField);const t=on([...e.sources.map(s=>({raw:s,key:we(s),aliases:Ie(s),name:""})),...r.map(s=>nn(s)).filter(x)]);K(t,s=>{const S=I(s.raw);return Q(s.raw.label||(S==null?void 0:S.datasetName)||(S==null?void 0:S.datasetId)||(S==null?void 0:S.name)||s.raw.kind||"source")});const a=sn(t),p=ne(r.filter(s=>s.name).map(s=>({raw:s,key:U(s),name:""})),s=>s.key);K(p,s=>Q([s.raw.sourceKey?ln(s.raw.sourceKey):"",s.raw.aggregate?s.raw.aggregate.toLowerCase():"",s.raw.name].filter(Boolean).join("_")));const f=new Map(p.map(s=>[s.key,s.name])),h=e.inputs.map(s=>({raw:s,name:Q(s.id||s.label||"input")}));K(h,s=>s.name);const y=h.filter(s=>!!s.raw.optionQuery).map(s=>({input:s,name:`${s.name}Options`,raw:s.raw.optionQuery}));K(y,s=>s.name);for(const s of y)rn(s.raw.labelFieldRef,s.raw.valueFieldRef)&&tn(s.raw.valueFieldRef)&&n.push(`Input option query ${((A=s.raw.spec)==null?void 0:A.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 i=e.views.filter(s=>{var S,B;return!!((S=s.sdkSpec)!=null&&S.builder&&((B=s.sdkSpec)!=null&&B.spec))}).map(s=>({raw:s,name:Q(s.id||s.title||"query")}));K(i,s=>s.name);const F=e.views.filter(s=>fe(s)&&!("sdkSpec"in s)).map(s=>en(s));for(const s of e.views)(!("sdkSpec"in s)||!((R=s.sdkSpec)!=null&&R.builder)||!((N=s.sdkSpec)!=null&&N.spec))&&!fe(s)&&n.push(`Skipped view ${s.id||s.title||"unknown"} because it has no sdkSpec.`);return ke({inputs:h,views:i,filterContracts:e.filterContracts}),{summary:e,title:e.title||"Semaphor Data App",sources:t,fields:p,inputs:h,optionQueries:y,views:i,presentationViews:F,filterContracts:e.filterContracts,checklist:o,sourceNameByKey:a,fieldNameByKey:f,warnings:n}}function ke({inputs:e,views:n,filterContracts:r}){const o=new Set(e.map(a=>a.raw.id).filter(Boolean)),t=new Set(n.map(a=>a.raw.id).filter(Boolean));for(const[a,p]of r.entries()){if(!o.has(p.inputId))throw new Error(`filterContracts.${a}.inputId must reference a generated input.`);const f=new Set(p.appliesToViewIds||[]),h=new Set(p.notAppliedToViewIds||[]);for(const[y,i]of(p.appliesToViewIds||[]).entries())if(!t.has(i))throw new Error(`filterContracts.${a}.appliesToViewIds.${y} must reference an executable generated view.`);for(const[y,i]of(p.notAppliedToViewIds||[]).entries())if(!t.has(i))throw new Error(`filterContracts.${a}.notAppliedToViewIds.${y} must reference an executable generated view.`);for(const[y,i]of(p.bindings||[]).entries()){if(!t.has(i.viewId))throw new Error(`filterContracts.${a}.bindings.${y}.viewId must reference an executable generated view.`);if(!f.has(i.viewId))throw new Error(`filterContracts.${a}.bindings.${y}.viewId must be included in appliesToViewIds.`);if(h.has(i.viewId))throw new Error(`filterContracts.${a}.bindings.${y}.viewId must not be listed in notAppliedToViewIds.`)}}}function Ce(e){return{"sources.ts":Ge(e),"fields.ts":_e(e),"inputs.ts":He(e),"queries.ts":qe(e),"bindings.ts":Pe(e),"accessors.ts":Ue(e),"metadata.ts":Je(e),"index.ts":ze()}}function Ne({contract:e,files:n,generatorName:r,generatorVersion:o}){return{schemaVersion:$.CONTRACT_MANIFEST_SCHEMA_VERSION,generatedContractSchemaVersion:$.GENERATED_CONTRACT_SCHEMA_VERSION,generator:{name:r,version:o},generatedContentHash:Me(n),codegenSummaryValidatorVersion:$.CODEGEN_SUMMARY_VALIDATOR_VERSION,codegenSummaryHash:Oe(e.summary),codegenSummary:e.summary}}function Me(e){const n=ye.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 Oe(e){return`sha256:${ye.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(o=>ue(o)).join(",")}]`;const n=e;return`{${Object.keys(n).sort().filter(o=>n[o]!==void 0).map(o=>`${JSON.stringify(o)}:${ue(n[o])}`).join(",")}}`}function Ee(e){const n=e.views.find(y=>G(y)&&T(y));if(n)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${n.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const r=e.views.find(y=>G(y));if(r)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, recordsSortOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${r.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const o=e.views.find(y=>X(y)&&T(y));if(o)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${o.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const t=e.views.find(y=>le(y)&&T(y));if(t)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, 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 = result.records.map((row) => rowValuesForView.${t.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const a=e.views.find(y=>{var i;return un((i=y.raw.sdkSpec)==null?void 0:i.builder)});if(a)return['import { appInputSpecs, createInputHandleMap, queries, queryOptionsForView, rowValuesForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${a.name}(), queryOptionsForView.${a.name}(inputHandles));`,`const rows = result.records.map((row) => rowValuesForView.${a.name}(row, result.columns));`,"const presentationViews = semaphorGeneratedContractMetadata.presentationViews;"].join(`
+`);const p=e.views.find(y=>xe(y));if(p)return['import { appInputSpecs, createInputHandleMap, metricValuesForView, queries, queryOptionsForView, semaphorGeneratedContractMetadata } from "./semaphor/generated";',"const handles = useSemaphorInputs(appInputSpecs);","const inputHandles = createInputHandleMap(handles);",`const result = useSemaphorQuery(queries.${p.name}(), queryOptionsForView.${p.name}(inputHandles));`,`const metrics = metricValuesForView.${p.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 n;return q((n=e.raw.sdkSpec)==null?void 0:n.builder)==="records"}function xe(e){var n;return q((n=e.raw.sdkSpec)==null?void 0:n.builder)==="metric"}function G(e){var n,r,o;return X(e)&&((o=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.sorting)==null?void 0:o.mode)==="server"}function le(e){var n;return q((n=e.raw.sdkSpec)==null?void 0:n.builder)==="sql"}function T(e){var n,r,o;return((o=(r=(n=e.raw.visualSpec)==null?void 0:n.tableBehavior)==null?void 0:r.pagination)==null?void 0:o.mode)==="server"}function Ae(e){return X(e)&&(T(e)||G(e))||le(e)&&T(e)}function Ge(e){const n=e.sources.map(({name:o,raw:t})=>{const a=Te(t);return`  ${o}: ${a},`}).join(`
 `),r=e.sources.some(o=>o.raw.kind==="semantic")?`import { semaphor } from "react-semaphor/data-app-sdk";
 
-`:"";return`${M}
+`:"";return`${_}
 ${r}export const sources = {
 ${n}
 } as const;
-`}function Te(e){if(e.kind==="semantic"){const n={domainId:e.domainId,datasetId:e.datasetId,datasetName:e.datasetName,label:e.label};return`semaphor.source.semantic(${R(H(n))})`}return`${R(H({...e,sourceKey:void 0}))} as const`}function Ge(e){const n=e.fields.map(({name:o,raw:t})=>{const i=_e(t,e);return`  ${o}: ${i},`}).join(`
+`}function Te(e){if(e.kind==="semantic"){const n={domainId:e.domainId,datasetId:e.datasetId,datasetName:e.datasetName,label:e.label};return`semaphor.source.semantic(${k(v(n))})`}return`${k(v({...e,sourceKey:void 0}))} as const`}function _e(e){const n=e.fields.map(({name:o,raw:t})=>{const a=Ke(t,e);return`  ${o}: ${a},`}).join(`
 `),r=n.includes("sources.")?`import { sources } from "./sources";
 
-`:"";return`${M}
+`:"";return`${_}
 ${r}export const fields = {
 ${n}
 } as const;
-`}function _e(e,n){const r={name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate},o=en(e),t=o?n.sourceNameByKey.get(o):void 0;if(o&&!t)throw new Error(`Field ${e.name} references source ${o}, but that source is not renderable. Include the source in codegenSummary.sources or provide field.source.`);const i=Object.entries(H(r)).map(([u,l])=>`${JSON.stringify(u)}: ${k(l,n)}`);return t&&i.push(`"source": sources.${t}`),`{ ${i.join(", ")} }`}function xe(e){const n=e.inputs.map(c=>{const S=E(c.raw.fieldRef,e),f=[`id: ${JSON.stringify(c.raw.id)}`,`label: ${JSON.stringify(c.raw.label||c.raw.id)}`,`operator: ${JSON.stringify(rn(c.raw))}`];if(S&&f.push(`field: fields.${S}`),c.raw.relationshipHint&&f.push(`relationshipHint: ${R(c.raw.relationshipHint)}`),!S)throw new Error(`Input ${c.raw.id||c.name} is missing a generated field reference.`);return`  ${c.name}: semaphor.filter({ ${f.join(", ")} }),`}).join(`
-`),r=e.inputs.map(c=>`filterSpecs.${c.name}`).join(", "),o=e.inputs.map(c=>JSON.stringify(c.raw.id)).join(", "),t=e.optionQueries.map(c=>{const S=c.input.raw,f=c.raw,F=g(f.spec)||{},{id:C,inputId:V,source:N,sourceKey:T,valueField:I,labelField:O,population:s,dependencies:h,limit:q,...X}=F,B=f.sourceKey?{sourceKey:f.sourceKey}:f.source||N||(typeof T=="string"?{sourceKey:T}:void 0),ee=he(B,e),ne=E(f.valueFieldRef,e),re=E(f.labelFieldRef,e),te={...X,id:f.id||F.id||`${S.id}-options`,inputId:S.id,source:B,valueField:f.valueFieldRef,labelField:f.labelFieldRef,population:f.population||s,dependencies:f.dependencies||h,limit:f.limit||q||100};if(!ee||!ne||!re)throw new Error(`Input option query ${f.id||`${S.id}-options`} is missing source, valueField, or labelField.`);const oe=Object.entries(H(te)).map(([we,Ie])=>`${JSON.stringify(we)}: ${k(Ie,e)}`);return`  ${c.name}: semaphor.inputOptions({ ${oe.join(", ")} }),`}).join(`
-`),i=e.optionQueries.map(c=>{const f=Me(e,c).map(F=>{const C=E(F.raw.fieldRef,e);if(!C)throw new Error(`Input option query ${c.raw.id||`${c.input.raw.id}-options`} references input ${F.raw.id} without a generated field reference.`);const V=`inputHandles[${JSON.stringify(F.raw.id)}]`;return`    if (${V}) {
-      inputs.push(semaphor.bindInput(${V}, { field: fields.${C} }));
+`}function Ke(e,n){const r={name:e.name,label:e.label,role:e.role,dataType:e.dataType,aggregate:e.aggregate},o=an(e),t=o?n.sourceNameByKey.get(o):void 0;if(o&&!t)throw new Error(`Field ${e.name} references source ${o}, but that source is not renderable. Include the source in codegenSummary.sources or provide field.source.`);const a=Object.entries(v(r)).map(([p,f])=>`${JSON.stringify(p)}: ${E(f,n)}`);return t&&a.push(`"source": sources.${t}`),`{ ${a.join(", ")} }`}function He(e){const n=e.inputs.map(d=>{const m=C(d.raw.fieldRef,e),l=[`id: ${JSON.stringify(d.raw.id)}`,`label: ${JSON.stringify(d.raw.label||d.raw.id)}`,`operator: ${JSON.stringify(dn(d.raw))}`];if(m&&l.push(`field: fields.${m}`),d.raw.relationshipHint&&l.push(`relationshipHint: ${k(d.raw.relationshipHint)}`),!m)throw new Error(`Input ${d.raw.id||d.name} is missing a generated field reference.`);return`  ${d.name}: semaphor.filter({ ${l.join(", ")} }),`}).join(`
+`),r=e.inputs.map(d=>`filterSpecs.${d.name}`).join(", "),o=e.inputs.map(d=>JSON.stringify(d.raw.id)).join(", "),t=e.optionQueries.map(d=>{const m=d.input.raw,l=d.raw,w=I(l.spec)||{},{id:b,inputId:V,source:O,sourceKey:A,valueField:R,labelField:N,population:s,dependencies:S,limit:B,...re}=w,L=l.sourceKey?{sourceKey:l.sourceKey}:l.source||O||(typeof A=="string"?{sourceKey:A}:void 0),te=Se(L,e),oe=C(l.valueFieldRef,e),se=C(l.labelFieldRef,e),ae={...re,id:l.id||w.id||`${m.id}-options`,inputId:m.id,source:L,valueField:l.valueFieldRef,labelField:l.labelFieldRef,population:l.population||s,dependencies:l.dependencies||S,limit:l.limit||B||100};if(!te||!oe||!se)throw new Error(`Input option query ${l.id||`${m.id}-options`} is missing source, valueField, or labelField.`);const ie=Object.entries(v(ae)).map(([$e,Fe])=>`${JSON.stringify($e)}: ${E(Fe,e)}`);return`  ${d.name}: semaphor.inputOptions({ ${ie.join(", ")} }),`}).join(`
+`),a=e.optionQueries.map(d=>{const l=ve(e,d).map(w=>{const b=C(w.raw.fieldRef,e);if(!b)throw new Error(`Input option query ${d.raw.id||`${d.input.raw.id}-options`} references input ${w.raw.id} without a generated field reference.`);const V=`inputHandles[${JSON.stringify(w.raw.id)}]`;return`    if (${V}) {
+      inputs.push(semaphor.bindInput(${V}, { field: fields.${b} }));
     }`}).join(`
-`);return`  ${c.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
+`);return`  ${d.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
     const inputs: SemaphorInputReference[] = [];
-${f}
+${l}
     return inputs;
   },`}).join(`
 
-`),u=e.optionQueries.map(c=>`  ${c.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
+`),p=e.optionQueries.map(d=>`  ${d.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
     return {
-      inputs: inputsForInputOptionQuery.${c.name}(inputHandles),
+      inputs: inputsForInputOptionQuery.${d.name}(inputHandles),
     };
   },`).join(`
 
-`),l=e.optionQueries.map(c=>`    case ${JSON.stringify(c.raw.id||`${c.input.raw.id}-options`)}:
-      return queryOptionsForInputOptionQuery.${c.name}(inputHandles);`).join(`
-`),p=e.inputs.length>0,m=e.optionQueries.length>0,a=m?"inputOptionQueryId":"_inputOptionQueryId",$=m?"inputHandles":"_inputHandles",b=["SemaphorInputHandle",m?"SemaphorInputReference":void 0,"SemaphorQueryRuntimeOptions"].filter(x).join(", "),d=[p||m?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,`import type { ${b} } from "react-semaphor/data-app-sdk";`,p||m?'import { fields } from "./fields";':void 0,m?'import { sources } from "./sources";':void 0,'import type { SemaphorGeneratedInputId, SemaphorGeneratedInputOptionQueryId } from "./metadata";'].filter(x).join(`
-`);return`${M}
-${d}
+`),f=e.optionQueries.map(d=>`    case ${JSON.stringify(d.raw.id||`${d.input.raw.id}-options`)}:
+      return queryOptionsForInputOptionQuery.${d.name}(inputHandles);`).join(`
+`),h=e.inputs.length>0,y=e.optionQueries.length>0,i=y?"inputOptionQueryId":"_inputOptionQueryId",F=y?"inputHandles":"_inputHandles",c=["SemaphorInputHandle",y?"SemaphorInputReference":void 0,"SemaphorQueryRuntimeOptions"].filter(x).join(", "),u=[h||y?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,`import type { ${c} } from "react-semaphor/data-app-sdk";`,h||y?'import { fields } from "./fields";':void 0,y?'import { sources } from "./sources";':void 0,'import type { SemaphorGeneratedInputId, SemaphorGeneratedInputOptionQueryId } from "./metadata";'].filter(x).join(`
+`);return`${_}
+${u}
 
 export const filterSpecs = {
 ${n}
@@ -62,56 +63,56 @@ ${t}
 } as const;
 
 export const inputsForInputOptionQuery = {
-${i}
+${a}
 } as const;
 
 export const queryOptionsForInputOptionQuery = {
-${u}
+${p}
 } as const;
 
 export function queryOptionsForInputOptionQueryId(
-  ${a}: SemaphorGeneratedInputOptionQueryId,
-  ${$}: SemaphorGeneratedInputHandleMap,
+  ${i}: SemaphorGeneratedInputOptionQueryId,
+  ${F}: SemaphorGeneratedInputHandleMap,
 ): SemaphorQueryRuntimeOptions {
-  switch (${a}) {
-${l}
+  switch (${i}) {
+${f}
   }
-  throw new Error(\`Unknown generated Semaphor input option query id: \${${a}}\`);
+  throw new Error(\`Unknown generated Semaphor input option query id: \${${i}}\`);
 }
-`}function Me(e,n){const r=n.raw.dependencies;if((r==null?void 0:r.mode)==="independent")return[];const o=new Set([n.input.raw.id,...(r==null?void 0:r.excludeInputIds)||[]]),t=(r==null?void 0:r.mode)==="explicit"?new Set(r.includeInputIds||[]):void 0;return e.inputs.filter(i=>o.has(i.raw.id)?!1:t?t.has(i.raw.id):!!i.raw.fieldRef)}function He(e){const n=e.views.map(d=>{var f,F,C,V,N,T;const c=P(d.raw.sdkSpec.builder),S=qe(d);if(Y(d)&&Ae(d)){const I=(f=d.raw.visualSpec)==null?void 0:f.tableBehavior,O=g(S.pagination),s=_(d),h=G(d),q=((F=I==null?void 0:I.pagination)==null?void 0:F.pageSize)||U(O==null?void 0:O.pageSize)||U(S.limit)||100,X=h?L(d,e):[],B=h?ve({view:d,contract:e,sortFields:X,defaultField:(C=I==null?void 0:I.sorting)==null?void 0:C.defaultField}):void 0,ee=h?(V=I==null?void 0:I.sorting)==null?void 0:V.defaultDirection:void 0,ne=je({viewName:d.name,supportsPagination:s,supportsSort:h}),re=h?`    const orderBy = resolveRecordsOrderBy(
-      recordsSortFieldsForView.${d.name},
+`}function ve(e,n){const r=n.raw.dependencies;if((r==null?void 0:r.mode)==="independent")return[];const o=new Set([n.input.raw.id,...(r==null?void 0:r.excludeInputIds)||[]]),t=(r==null?void 0:r.mode)==="explicit"?new Set(r.includeInputIds||[]):void 0;return e.inputs.filter(a=>o.has(a.raw.id)?!1:t?t.has(a.raw.id):!!a.raw.fieldRef)}function qe(e){const n=e.views.map(u=>{var l,w,b,V,O,A;const d=q(u.raw.sdkSpec.builder),m=Be(u);if(X(u)&&Ae(u)){const R=(l=u.raw.visualSpec)==null?void 0:l.tableBehavior,N=I(m.pagination),s=T(u),S=G(u),B=((w=R==null?void 0:R.pagination)==null?void 0:w.pageSize)||z(N==null?void 0:N.pageSize)||z(m.limit)||100,re=S?Y(u,e):[],L=S?je({view:u,contract:e,sortFields:re,defaultField:(b=R==null?void 0:R.sorting)==null?void 0:b.defaultField}):void 0,te=S?(V=R==null?void 0:R.sorting)==null?void 0:V.defaultDirection:void 0,oe=Qe({viewName:u.name,supportsPagination:s,supportsSort:S}),se=S?`    const orderBy = resolveRecordsOrderBy(
+      recordsSortFieldsForView.${u.name},
       params.sort,
-      ${k(B,e)},
-      ${k(ee,e)},
+      ${E(L,e)},
+      ${E(te,e)},
     );
-`:"",te=h?`      ...(orderBy ? { orderBy } : {}),
-`:"",oe=s?`      pagination: resolveServerTablePagination(params, ${JSON.stringify(q)}),
-`:"";return`  ${d.name}(
-    params: ${ne} = {},
+`:"",ae=S?`      ...(orderBy ? { orderBy } : {}),
+`:"",ie=s?`      pagination: resolveServerTablePagination(params, ${JSON.stringify(B)}),
+`:"";return`  ${u.name}(
+    params: ${oe} = {},
   ) {
-${re}    return semaphor.${c}({
-      ...${k(S,e)},
-${te}${oe}    });
-  },`}if(ae(d)&&_(d)){const I=(N=d.raw.visualSpec)==null?void 0:N.tableBehavior,O=g(S.pagination),s=((T=I==null?void 0:I.pagination)==null?void 0:T.pageSize)||U(O==null?void 0:O.pageSize)||U(S.limit)||100;return`  ${d.name}(
+${se}    return semaphor.${d}({
+      ...${E(m,e)},
+${ae}${ie}    });
+  },`}if(le(u)&&T(u)){const R=(O=u.raw.visualSpec)==null?void 0:O.tableBehavior,N=I(m.pagination),s=((A=R==null?void 0:R.pagination)==null?void 0:A.pageSize)||z(N==null?void 0:N.pageSize)||z(m.limit)||100;return`  ${u.name}(
     params: SemaphorGeneratedServerPaginationParams = {},
   ) {
-    return semaphor.${c}({
-      ...${k(S,e)},
+    return semaphor.${d}({
+      ...${E(m,e)},
       pagination: resolveServerTablePagination(params, ${JSON.stringify(s)}),
     });
-  },`}return`  ${d.name}: () => semaphor.${c}(${k(S,e)}),`}).join(`
-`),r=e.views.filter(d=>G(d)).map(d=>{const S=L(d,e).map(f=>`    ${JSON.stringify(f.key)}: fields.${f.fieldName},`).join(`
-`);return`  ${d.name}: {
-${S}
+  },`}return`  ${u.name}: () => semaphor.${d}(${E(m,e)}),`}).join(`
+`),r=e.views.filter(u=>G(u)).map(u=>{const m=Y(u,e).map(l=>`    ${JSON.stringify(l.key)}: fields.${l.fieldName},`).join(`
+`);return`  ${u.name}: {
+${m}
   },`}).join(`
-`),o=e.views.filter(d=>G(d)).map(d=>{const S=L(d,e).map(f=>`    { key: ${JSON.stringify(f.key)}, label: ${JSON.stringify(f.label)}, field: fields.${f.fieldName} },`).join(`
-`);return`  ${d.name}: [
-${S}
+`),o=e.views.filter(u=>G(u)).map(u=>{const m=Y(u,e).map(l=>`    { key: ${JSON.stringify(l.key)}, label: ${JSON.stringify(l.label)}, field: fields.${l.fieldName} },`).join(`
+`);return`  ${u.name}: [
+${m}
   ],`}).join(`
-`),t=e.views.some(d=>G(d)),i=e.views.some(d=>_(d)),u=[n,r,o].join(`
-`),l=[n?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,t?'import type { SemaphorFieldRef } from "react-semaphor/data-app-sdk";':void 0,u.includes("fields.")?'import { fields } from "./fields";':void 0,u.includes("sources.")?'import { sources } from "./sources";':void 0].filter(x).join(`
-`);return`${M}
-${l}
+`),t=e.views.some(u=>G(u)),a=e.views.some(u=>T(u)),p=[n,r,o].join(`
+`),f=[n?'import { semaphor } from "react-semaphor/data-app-sdk";':void 0,t?'import type { SemaphorFieldRef } from "react-semaphor/data-app-sdk";':void 0,p.includes("fields.")?'import { fields } from "./fields";':void 0,p.includes("sources.")?'import { sources } from "./sources";':void 0].filter(x).join(`
+`);return`${_}
+${f}
 ${t?`export type SemaphorGeneratedRecordsSortDirection = "asc" | "desc";
 
 export type SemaphorGeneratedRecordsSort<TSortKey extends string = string> = {
@@ -122,11 +123,11 @@ export type SemaphorGeneratedRecordsSort<TSortKey extends string = string> = {
 export type SemaphorGeneratedRecordsSortParams<TSortKey extends string = string> = {
   sort?: SemaphorGeneratedRecordsSort<TSortKey> | null;
 };
-`:""}${i?`export type SemaphorGeneratedServerPaginationParams = {
+`:""}${a?`export type SemaphorGeneratedServerPaginationParams = {
   page?: number;
   pageSize?: number;
 };
-`:""}${t&&i?`export type SemaphorGeneratedRecordsQueryParams<TSortKey extends string = string> =
+`:""}${t&&a?`export type SemaphorGeneratedRecordsQueryParams<TSortKey extends string = string> =
   SemaphorGeneratedServerPaginationParams &
   SemaphorGeneratedRecordsSortParams<TSortKey>;
 `:""}
@@ -163,7 +164,7 @@ ${t?`function resolveRecordsOrderBy<TSortKey extends string>(
   };
 }
 `:""}
-${i?`function resolveServerTablePagination(
+${a?`function resolveServerTablePagination(
   params: SemaphorGeneratedServerPaginationParams,
   defaultPageSize: number,
 ) {
@@ -173,29 +174,29 @@ ${i?`function resolveServerTablePagination(
   };
 }
 `:""}
-`}function qe(e){var i,u;const n=g((i=e.raw.sdkSpec)==null?void 0:i.spec)||{},{kind:r,id:o,...t}=n;return{...t,id:e.raw.id,label:((u=e.raw.visualSpec)==null?void 0:u.title)||e.raw.title||t.label}}function L(e,n){var i,u;const r=[],o=g((i=e.raw.sdkSpec)==null?void 0:i.spec)||{};for(const l of j(o.fields))y(r,l);y(r,o.dateField),y(r,(u=g(o.orderBy))==null?void 0:u.field);for(const l of e.raw.fields||[])y(r,l);return de(r.map(l=>{const p=E(l,n);if(!(!l.name||!p))return{key:p,fieldName:p,rawName:l.name,label:l.label||l.name}}).filter(x),l=>l.key)}function ve({view:e,contract:n,sortFields:r,defaultField:o}){var p,m;const t=new Set(r.map(a=>a.key));if(o&&t.has(o))return o;const i=r.filter(a=>a.rawName===o);if(i.length===1)return i[0].key;const u=g((p=e.raw.sdkSpec)==null?void 0:p.spec),l=E((m=g(u==null?void 0:u.orderBy))==null?void 0:m.field,n);return l&&t.has(l)?l:void 0}function je({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 Qe(e){const n=e.views.map(a=>{const b=De(e,a.raw.id).map(d=>{const c=d.inputId,S=E(d.fieldRef,e);if(!c||!S)return"";const f=[`field: fields.${S}`];if(d.relationshipHint)f.push(`relationshipHint: ${R(d.relationshipHint)}`);else if(Array.isArray(d.relationshipsUsed)&&d.relationshipsUsed.length>0){const C=d.relationshipsUsed.map(V=>{var N;return(N=g(V))==null?void 0:N.id}).filter(V=>typeof V=="string"&&V.length>0);C.length>0&&f.push(`relationshipHint: ${R({relationshipIds:C})}`)}const F=`inputHandles[${JSON.stringify(c)}]`;return`    if (${F}) {
-      inputs.push(semaphor.bindInput(${F}, { ${f.join(", ")} }));
+`}function Be(e){var a,p;const n=I((a=e.raw.sdkSpec)==null?void 0:a.spec)||{},{kind:r,id:o,...t}=n;return{...t,id:e.raw.id,label:((p=e.raw.visualSpec)==null?void 0:p.title)||e.raw.title||t.label}}function Y(e,n){var a,p;const r=[],o=I((a=e.raw.sdkSpec)==null?void 0:a.spec)||{};for(const f of H(o.fields))g(r,f);g(r,o.dateField),g(r,(p=I(o.orderBy))==null?void 0:p.field);for(const f of e.raw.fields||[])g(r,f);return ne(r.map(f=>{const h=C(f,n);if(!(!f.name||!h))return{key:h,fieldName:h,rawName:f.name,label:f.label||f.name}}).filter(x),f=>f.key)}function je({view:e,contract:n,sortFields:r,defaultField:o}){var h,y;const t=new Set(r.map(i=>i.key));if(o&&t.has(o))return o;const a=r.filter(i=>i.rawName===o);if(a.length===1)return a[0].key;const p=I((h=e.raw.sdkSpec)==null?void 0:h.spec),f=C((y=I(p==null?void 0:p.orderBy))==null?void 0:y.field,n);return f&&t.has(f)?f:void 0}function Qe({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 Pe(e){const n=e.views.map(i=>{const c=De(e,i.raw.id).map(u=>{const d=u.inputId,m=C(u.fieldRef,e);if(!d||!m)return"";const l=[`field: fields.${m}`];if(u.relationshipHint)l.push(`relationshipHint: ${k(u.relationshipHint)}`);else if(Array.isArray(u.relationshipsUsed)&&u.relationshipsUsed.length>0){const b=u.relationshipsUsed.map(V=>{var O;return(O=I(V))==null?void 0:O.id}).filter(V=>typeof V=="string"&&V.length>0);b.length>0&&l.push(`relationshipHint: ${k({relationshipIds:b})}`)}const w=`inputHandles[${JSON.stringify(d)}]`;return`    if (${w}) {
+      inputs.push(semaphor.bindInput(${w}, { ${l.join(", ")} }));
     }`}).filter(Boolean).join(`
-`);return{view:a,renderedBindings:b}}),r=n.some(a=>a.renderedBindings.length>0),o=n.map(({view:a,renderedBindings:$})=>{const b=$?"inputHandles":"_inputHandles";return`  ${a.name}(${b}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
+`);return{view:i,renderedBindings:c}}),r=n.some(i=>i.renderedBindings.length>0),o=n.map(({view:i,renderedBindings:F})=>{const c=F?"inputHandles":"_inputHandles";return`  ${i.name}(${c}: SemaphorGeneratedInputHandleMap): SemaphorInputReference[] {
     const inputs: SemaphorInputReference[] = [];
-${$}
+${F}
     return inputs;
   },`}).join(`
 
-`),t=e.views.map(a=>`  ${a.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
+`),t=e.views.map(i=>`  ${i.name}(inputHandles: SemaphorGeneratedInputHandleMap): SemaphorQueryRuntimeOptions {
     return {
-      inputs: inputsForView.${a.name}(inputHandles),
-      debug: queryDebugForView.${a.name},
+      inputs: inputsForView.${i.name}(inputHandles),
+      debug: queryDebugForView.${i.name},
     };
   },`).join(`
 
-`),i=e.views.map(a=>`    case ${JSON.stringify(a.raw.id)}:
-      return inputsForView.${a.name}(inputHandles);`).join(`
-`),u=e.views.map(a=>`    case ${JSON.stringify(a.raw.id)}:
-      return queryOptionsForView.${a.name}(inputHandles);`).join(`
-`),l=e.views.length>0,p=l?"inputHandles":"_inputHandles",m=[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";',l?'import { queryDebugForView } from "./metadata";':void 0,'import type { SemaphorGeneratedQueryViewId } from "./metadata";'].filter(x).join(`
-`);return`${M}
-${m}
+`),a=e.views.map(i=>`    case ${JSON.stringify(i.raw.id)}:
+      return inputsForView.${i.name}(inputHandles);`).join(`
+`),p=e.views.map(i=>`    case ${JSON.stringify(i.raw.id)}:
+      return queryOptionsForView.${i.name}(inputHandles);`).join(`
+`),f=e.views.length>0,h=f?"inputHandles":"_inputHandles",y=[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";',f?'import { queryDebugForView } from "./metadata";':void 0,'import type { SemaphorGeneratedQueryViewId } from "./metadata";'].filter(x).join(`
+`);return`${_}
+${y}
 
 export const inputsForView = {
 ${o}
@@ -207,48 +208,79 @@ ${t}
 
 export function inputsForViewId(
   viewId: SemaphorGeneratedQueryViewId,
-  ${p}: SemaphorGeneratedInputHandleMap,
+  ${h}: SemaphorGeneratedInputHandleMap,
 ): SemaphorInputReference[] {
   switch (viewId) {
-${i}
+${a}
   }
   throw new Error(\`Unknown generated Semaphor view id: \${viewId}\`);
 }
 
 export function queryOptionsForViewId(
   viewId: SemaphorGeneratedQueryViewId,
-  ${p}: SemaphorGeneratedInputHandleMap,
+  ${h}: SemaphorGeneratedInputHandleMap,
 ): SemaphorQueryRuntimeOptions {
   switch (viewId) {
-${u}
+${p}
   }
   throw new Error(\`Unknown generated Semaphor view id: \${viewId}\`);
 }
-`}function De(e,n){return e.filterContracts.flatMap(r=>(r.bindings||[]).filter(o=>o.viewId===n).map(o=>({inputId:r.inputId,fieldRef:o.fieldRef,relationshipHint:o.relationshipHint,relationshipsUsed:o.relationshipsUsed})))}function Ke(e){const n=e.views.map(u=>{const p=J(u,e).map(m=>{const a=E(m.raw,e);return a?`    ${m.name}: fields.${a},`:""}).filter(Boolean).join(`
-`);return`  ${u.name}: {
-${p}
+`}function De(e,n){return e.filterContracts.flatMap(r=>(r.bindings||[]).filter(o=>o.viewId===n).map(o=>({inputId:r.inputId,fieldRef:o.fieldRef,relationshipHint:o.relationshipHint,relationshipsUsed:o.relationshipsUsed})))}function Ue(e){const n=e.views.map(c=>{const d=W(c,e).map(m=>{const l=C(m.raw,e);return l?`    ${m.name}: fields.${l},`:""}).filter(Boolean).join(`
+`);return`  ${c.name}: {
+${d}
+  },`}).join(`
+`),r=e.views.map(c=>{const d=J(c,e).map(m=>{const l=C(m.raw,e);return l?`    ${m.name}: fields.${l},`:""}).filter(Boolean).join(`
+`);return`  ${c.name}: {
+${d}
   },`}).join(`
-`),r=e.views.map(u=>{const l=Pe(u,e);return`  ${u.name}: ${R(l)},`}).join(`
-`),o=e.views.map(u=>{const p=J(u,e).map(m=>`      ${m.name}: resolveColumnKey(columns, fieldsForView.${u.name}.${m.name}),`).join(`
-`);return`  ${u.name}(columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${u.name}, string | undefined> {
+`),o=e.views.map(c=>{const u=J(c,e),d=Ze(u),m=We(u),l=u.map(w=>{const b=Array.from(new Set(ge(w.raw).filter(V=>m.has(V))));return`    ${w.name}: metricKeysForField(metricFieldsForView.${c.name}.${w.name}, { allowNameFallback: ${d.has(w.raw.name)?"false":"true"}, excludedKeys: ${k(b)} }),`}).join(`
+`);return`  ${c.name}: {
+${l}
+  },`}).join(`
+`),t=e.views.map(c=>{const d=J(c,e).map(m=>`    ${m.name}: semaphorMetricMeasureBindingKey(metricFieldsForView.${c.name}.${m.name}),`).join(`
+`);return`  ${c.name}: {
+${d}
+  },`}).join(`
+`),a=e.views.map(c=>{const u=J(c,e);if(u.length===0)return`  ${c.name}(): Record<keyof typeof metricFieldsForView.${c.name}, unknown> {
+    return {};
+  },`;const d=Ye(c,u),m=u.map(l=>{const w=`metricMeasureKeysForView.${c.name}.${l.name}`,b=`metricMeasureBindingKeysForView.${c.name}.${l.name}`,V=d.has(l.name)?`readMetricValueByBindingWithFallback(measures, measureBindings, ${b}, ${w}, scalarValue)`:`readMetricValueByBinding(measures, measureBindings, ${b}, ${w})`;return`      ${l.name}: ${V},`}).join(`
+`);return`  ${c.name}(result: SemaphorGeneratedMetricResult): Record<keyof typeof metricFieldsForView.${c.name}, unknown> {
+    const measures = result?.measures;
+    const measureBindings = result?.measureBindings;
+    const scalarValue = result?.value;
     return {
-${p}
+${m}
     };
   },`}).join(`
 
-`),t=e.views.map(u=>{const p=J(u,e).map(m=>`      ${m.name}: readCell(row, columns, fieldsForView.${u.name}.${m.name}),`).join(`
-`);return`  ${u.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${u.name}, unknown> {
+`),p=e.views.map(c=>{const u=Le(c,e);return`  ${c.name}: ${k(u)},`}).join(`
+`),f=e.views.map(c=>{const d=W(c,e).map(m=>`      ${m.name}: resolveColumnKey(columns, fieldsForView.${c.name}.${m.name}),`).join(`
+`);return`  ${c.name}(columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${c.name}, string | undefined> {
     return {
-${p}
+${d}
     };
   },`}).join(`
 
-`),i=['import type { SemaphorFieldRef, SemaphorResultColumn } from "react-semaphor/data-app-sdk";',n.includes("fields.")?'import { fields } from "./fields";':void 0].filter(x).join(`
-`);return`${M}
-${i}
+`),h=e.views.map(c=>{const d=W(c,e).map(m=>`      ${m.name}: readCell(row, columns, fieldsForView.${c.name}.${m.name}),`).join(`
+`);return`  ${c.name}(row: SemaphorGeneratedRow, columns: SemaphorGeneratedColumns): Record<keyof typeof fieldsForView.${c.name}, unknown> {
+    return {
+${d}
+    };
+  },`}).join(`
+
+`),y=n.includes("fields.")||r.includes("fields."),F=[`import { ${["type SemaphorFieldRef","type SemaphorResultColumn","semaphorMetricMeasureBindingKey"].filter(x).join(", ")} } from "react-semaphor/data-app-sdk";`,y?'import { fields } from "./fields";':void 0].filter(x).join(`
+`);return`${_}
+${F}
 
 export type SemaphorGeneratedRow = Record<string, unknown>;
 export type SemaphorGeneratedColumns = readonly SemaphorResultColumn[] | null | undefined;
+export type SemaphorGeneratedMetricMeasures = Record<string, unknown> | null | undefined;
+export type SemaphorGeneratedMetricMeasureBindings = Record<string, string> | null | undefined;
+export type SemaphorGeneratedMetricResult = {
+  readonly measures?: SemaphorGeneratedMetricMeasures;
+  readonly measureBindings?: SemaphorGeneratedMetricMeasureBindings;
+  readonly value?: unknown;
+} | null | undefined;
 export type SemaphorGeneratedTableColumn = {
   readonly key: string;
   readonly label: string;
@@ -261,18 +293,34 @@ export const fieldsForView = {
 ${n}
 } as const;
 
-export const tableColumnsForView = {
+export const metricFieldsForView = {
 ${r}
 } as const;
 
-export const columnKeysForView = {
+export const metricMeasureKeysForView = {
 ${o}
 } as const;
 
-export const rowValuesForView = {
+export const metricMeasureBindingKeysForView = {
 ${t}
 } as const;
 
+export const tableColumnsForView = {
+${p}
+} as const;
+
+export const columnKeysForView = {
+${f}
+} as const;
+
+export const rowValuesForView = {
+${h}
+} as const;
+
+export const metricValuesForView = {
+${a}
+} as const;
+
 export function resolveColumnKey(
   columns: SemaphorGeneratedColumns,
   field: SemaphorFieldRef,
@@ -314,6 +362,157 @@ export function readStringCell(
   return value === null || value === undefined ? "" : String(value);
 }
 
+export function readMetricValue(
+  measures: SemaphorGeneratedMetricMeasures,
+  field: SemaphorFieldRef,
+): unknown {
+  return readMetricValueByKeys(measures, metricKeysForField(field));
+}
+
+export function readMetricValueByKeys(
+  measures: SemaphorGeneratedMetricMeasures,
+  keys: readonly string[],
+): unknown {
+  if (!measures) {
+    return undefined;
+  }
+  for (const key of keys) {
+    if (Object.prototype.hasOwnProperty.call(measures, key)) {
+      return measures[key];
+    }
+  }
+  return undefined;
+}
+
+export function readMetricValueByBinding(
+  measures: SemaphorGeneratedMetricMeasures,
+  measureBindings: SemaphorGeneratedMetricMeasureBindings,
+  bindingKey: string,
+  fallbackKeys: readonly string[],
+): unknown {
+  const resultKey = measureBindings?.[bindingKey];
+  if (resultKey && measures && Object.prototype.hasOwnProperty.call(measures, resultKey)) {
+    return measures[resultKey];
+  }
+  return readMetricValueByKeys(measures, fallbackKeys);
+}
+
+export function readMetricValueByKeysWithFallback(
+  measures: SemaphorGeneratedMetricMeasures,
+  keys: readonly string[],
+  fallbackValue: unknown,
+): unknown {
+  const value = readMetricValueByKeys(measures, keys);
+  return value === undefined ? fallbackValue : value;
+}
+
+export function readMetricValueByBindingWithFallback(
+  measures: SemaphorGeneratedMetricMeasures,
+  measureBindings: SemaphorGeneratedMetricMeasureBindings,
+  bindingKey: string,
+  fallbackKeys: readonly string[],
+  fallbackValue: unknown,
+): unknown {
+  const value = readMetricValueByBinding(measures, measureBindings, bindingKey, fallbackKeys);
+  return value === undefined ? fallbackValue : value;
+}
+
+export function readNumberMetricValue(
+  measures: SemaphorGeneratedMetricMeasures,
+  field: SemaphorFieldRef,
+): number | null {
+  const value = readMetricValue(measures, field);
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : null;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+  return null;
+}
+
+export function readStringMetricValue(
+  measures: SemaphorGeneratedMetricMeasures,
+  field: SemaphorFieldRef,
+): string {
+  const value = readMetricValue(measures, field);
+  return value === null || value === undefined ? "" : String(value);
+}
+
+export function metricKeysForField(
+  field: SemaphorFieldRef,
+  options: { allowNameFallback?: boolean; excludedKeys?: readonly string[] } = {},
+): string[] {
+  const prefixes = metricKeyPrefixesForSource(field.source);
+  const aggregate = metricAggregateForField(field);
+  const excludedKeys = new Set(options.excludedKeys || []);
+  return uniqueStrings([
+    metricQualifiedKeyForField(field),
+    ...prefixes.map((prefix) => \`\${prefix}.\${field.name}\`),
+    \`\${aggregate.toLowerCase()}_\${field.name}\`,
+    \`\${aggregate}_\${field.name}\`,
+    \`\${field.name}_\${aggregate.toLowerCase()}\`,
+    \`\${field.name}_\${aggregate}\`,
+    ...(options.allowNameFallback === false ? [] : [field.name]),
+  ]).filter((key) => !excludedKeys.has(key));
+}
+
+function metricQualifiedKeyForField(field: SemaphorFieldRef): string {
+  return semaphorMetricMeasureBindingKey(field);
+}
+
+function metricAggregateForField(field: SemaphorFieldRef): string {
+  return stringProperty(field as Record<string, unknown>, "aggregate")?.toUpperCase() || "SUM";
+}
+
+function metricKeyPrefixesForSource(
+  source: SemaphorFieldRef["source"] | undefined,
+): string[] {
+  if (!source) {
+    return [];
+  }
+  const sourceRecord = source as Record<string, unknown>;
+  if (source.kind === "semantic") {
+    const prefixes: string[] = [];
+    const datasetName = stringProperty(sourceRecord, "datasetName");
+    const datasetId = stringProperty(sourceRecord, "datasetId");
+    if (datasetName) {
+      prefixes.push(datasetName);
+    }
+    if (datasetId) {
+      prefixes.push(datasetId);
+    }
+    return uniqueStrings(prefixes);
+  }
+  if (source.kind === "physical") {
+    const prefixes: string[] = [];
+    const databaseName = stringProperty(sourceRecord, "databaseName");
+    const schemaName = stringProperty(sourceRecord, "schemaName");
+    const tableName = stringProperty(sourceRecord, "tableName");
+    if (tableName) {
+      prefixes.push(tableName);
+    }
+    if (schemaName && tableName) {
+      prefixes.push(\`\${schemaName}.\${tableName}\`);
+    }
+    if (databaseName && schemaName && tableName) {
+      prefixes.push(\`\${databaseName}.\${schemaName}.\${tableName}\`);
+    }
+    return uniqueStrings(prefixes);
+  }
+  return [];
+}
+
+function stringProperty(record: Record<string, unknown>, key: string): string | undefined {
+  const value = record[key];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+
+function uniqueStrings(values: string[]): string[] {
+  return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+
 function resolveColumn(
   columns: SemaphorGeneratedColumns,
   field: SemaphorFieldRef,
@@ -416,11 +615,11 @@ function sourcesReferToSameDataset(
   }
   return false;
 }
-`}function Pe(e,n){const r=J(e,n),o=new Map((G(e)?L(e,n):[]).map(t=>[t.fieldName,t.key]));return r.map(t=>{const i=E(t.raw,n),u=i?o.get(i):void 0;return H({key:t.name,label:t.raw.label||t.raw.name,dataType:t.raw.dataType,sortable:!!u,sortKey:u})})}function Be(e){const n=e.checklist.filterScopeByInput||[],r=e.checklist.requiredDevtools||{},o=e.summary.views.map(a=>a.id).filter(Boolean),t=e.views.map(a=>a.raw.id).filter(Boolean),i=e.inputs.map(a=>a.raw.id).filter(Boolean),u=e.optionQueries.map(a=>a.raw.id||`${a.input.raw.id}-options`).filter(Boolean),l=Object.fromEntries(t.map(a=>[a,e.filterContracts.filter($=>Array.isArray($.appliesToViewIds)&&$.appliesToViewIds.includes(a)).map($=>$.inputId)])),p=Object.fromEntries(e.views.map(a=>[a.raw.id,{title:a.raw.title,visual:a.raw.visual,visualSpec:a.raw.visualSpec,queryKind:a.raw.queryKind,sdkBuilder:a.raw.sdkBuilder}])),m=Object.fromEntries(e.views.map(a=>{var $,b,d;return[a.name,H({viewId:a.raw.id,viewTitle:(($=a.raw.visualSpec)==null?void 0:$.title)||a.raw.title,visualType:(b=a.raw.visualSpec)==null?void 0:b.visualType,title:((d=a.raw.visualSpec)==null?void 0:d.title)||a.raw.title})]}));return`${M}
-export const generatedViewIds = ${R(o)} as const;
-export const generatedQueryViewIds = ${R(t)} as const;
-export const generatedInputIds = ${R(i)} as const;
-export const generatedInputOptionQueryIds = ${R(u)} as const;
+`}function Le(e,n){const r=W(e,n),o=new Map((G(e)?Y(e,n):[]).map(t=>[t.fieldName,t.key]));return r.map(t=>{const a=C(t.raw,n),p=a?o.get(a):void 0;return v({key:t.name,label:t.raw.label||t.raw.name,dataType:t.raw.dataType,sortable:!!p,sortKey:p})})}function Je(e){const n=e.checklist.filterScopeByInput||[],r=e.checklist.requiredDevtools||{},o=e.summary.views.map(i=>i.id).filter(Boolean),t=e.views.map(i=>i.raw.id).filter(Boolean),a=e.inputs.map(i=>i.raw.id).filter(Boolean),p=e.optionQueries.map(i=>i.raw.id||`${i.input.raw.id}-options`).filter(Boolean),f=Object.fromEntries(t.map(i=>[i,e.filterContracts.filter(F=>Array.isArray(F.appliesToViewIds)&&F.appliesToViewIds.includes(i)).map(F=>F.inputId)])),h=Object.fromEntries(e.views.map(i=>[i.raw.id,{title:i.raw.title,visual:i.raw.visual,visualSpec:i.raw.visualSpec,queryKind:i.raw.queryKind,sdkBuilder:i.raw.sdkBuilder}])),y=Object.fromEntries(e.views.map(i=>{var F,c,u;return[i.name,v({viewId:i.raw.id,viewTitle:((F=i.raw.visualSpec)==null?void 0:F.title)||i.raw.title,visualType:(c=i.raw.visualSpec)==null?void 0:c.visualType,title:((u=i.raw.visualSpec)==null?void 0:u.title)||i.raw.title})]}));return`${_}
+export const generatedViewIds = ${k(o)} as const;
+export const generatedQueryViewIds = ${k(t)} as const;
+export const generatedInputIds = ${k(a)} as const;
+export const generatedInputOptionQueryIds = ${k(p)} as const;
 
 export type SemaphorGeneratedViewId = typeof generatedViewIds[number];
 export type SemaphorGeneratedQueryViewId = typeof generatedQueryViewIds[number];
@@ -439,8 +638,8 @@ export type SemaphorGeneratedFilterContract = {
   readonly [key: string]: unknown;
 };
 
-export const generatedInputIdsForView = ${R(l)} as const;
-export const generatedFilterContracts: readonly SemaphorGeneratedFilterContract[] = ${R(e.filterContracts)} as const;
+export const generatedInputIdsForView = ${k(f)} as const;
+export const generatedFilterContracts: readonly SemaphorGeneratedFilterContract[] = ${k(e.filterContracts)} as const;
 
 export function filterContractsForView(viewId: SemaphorGeneratedQueryViewId) {
   return generatedFilterContracts.filter((filterContract) =>
@@ -448,10 +647,10 @@ export function filterContractsForView(viewId: SemaphorGeneratedQueryViewId) {
   );
 }
 
-export const queryDebugForView = ${R(m)} as const;
+export const queryDebugForView = ${k(y)} as const;
 
-export const semaphorGeneratedContractMetadata = ${R({schemaVersion:"semaphor-generated-data-app-contract/v1",title:e.title,requiredDevtools:r,filterContracts:e.filterContracts,filterScopeByInput:n,generatedViewIds:o,generatedQueryViewIds:t,generatedInputIds:i,generatedInputOptionQueryIds:u,generatedInputIdsForView:l,visualSpecs:p,presentationViews:e.presentationViews})} as const;
-`}function Ue(){return`${M}
+export const semaphorGeneratedContractMetadata = ${k({schemaVersion:"semaphor-generated-data-app-contract/v1",title:e.title,requiredDevtools:r,filterContracts:e.filterContracts,filterScopeByInput:n,generatedViewIds:o,generatedQueryViewIds:t,generatedInputIds:a,generatedInputOptionQueryIds:p,generatedInputIdsForView:f,visualSpecs:h,presentationViews:e.presentationViews})} as const;
+`}function ze(){return`${_}
 export * from "./sources";
 export * from "./fields";
 export * from "./inputs";
@@ -459,4 +658,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}A(n)&&y(e,Z(n));for(const r of Object.values(n))Q(e,r)}}function J(e,n){const r=[];if(Le(r,e.raw.sdkSpec),r.length===0)for(const t of e.raw.fields||[])y(r,t);const o=de(r.filter(t=>t.name&&E(t,n)).map(t=>({raw:t,key:ue(t),name:""})),t=>t.key);return v(o,t=>D(t.raw.label||t.raw.name||"field")),o}function Le(e,n){const r=g(n.spec);if(!r)return;const o=P(n.builder);if(o==="records"){for(const t of j(r.fields))y(e,t);return}if(o==="sql"){for(const t of j(r.fields))y(e,t);return}if(o==="analysis"||o==="metric"){y(e,r.primaryMeasure);for(const t of j(r.measures))y(e,t);for(const t of j(r.dimensions))y(e,t);y(e,r.dateField);return}if(o==="matrix"){const t=le(r.rows),i=le(r.columns),u=j(r.values);for(const l of t)ce(e,l);for(const l of i)ce(e,l);for(const l of u){const p=g(l);y(e,p==null?void 0:p.field),y(e,p==null?void 0:p.measure)}}}function le(e){if(Array.isArray(e))return e;const n=g(e);return Array.isArray(n==null?void 0:n.levels)?n.levels:[]}function ce(e,n){var r;if(A(n)){y(e,n);return}y(e,(r=g(n))==null?void 0:r.field)}function me(e){var n,r,o,t;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"||((o=e==null?void 0:e.computation)==null?void 0:o.kind)==="unsupported"||(e==null?void 0:e.visual)==="text_block"||((t=e==null?void 0:e.visualSpec)==null?void 0:t.visualType)==="text_block"}function Je(e){const n=g(e)||{};return H({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 y(e,n){A(n)&&e.push(Z(n))}function Z(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 ze(e){if(!e.source)return;const n={...e.source,...e.sourceKey?{sourceKey:e.sourceKey}:{}},r=Se(n);if(r)return{raw:n,key:r,aliases:ge(n),name:""}}function A(e){const n=g(e);return!!(n&&typeof n.name=="string"&&(typeof n.role=="string"||typeof n.dataType=="string"||typeof n.aggregate=="string"||n.source||n.sourceKey))}function ye(e){const n=g(e);return!!(n&&(typeof n.sourceKey=="string"||n.kind==="semantic"||typeof n.datasetName=="string"&&typeof n.domainId=="string"))}function k(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(t=>k(t,n)).join(", ")}]`;if(A(e)){const t=E(Z(e),n);if(t)return`fields.${t}`}if(ye(e)){const t=he(e,n);if(t)return`sources.${t}`}const r=g(e);return r?`{ ${Object.entries(r).filter(([,t])=>t!==void 0).map(([t,i])=>`${JSON.stringify(t)}: ${k(i,n)}`).join(", ")} }`:JSON.stringify(e)}function R(e){return JSON.stringify(e,null,2)}function E(e,n){if(A(e))return n.fieldNameByKey.get(ue(Z(e)))}function he(e,n){if(ye(e))for(const r of W(e)){const o=n.sourceNameByKey.get(r);if(o)return o}}function ue(e){return[e.sourceKey||"",e.name||"",e.role||"",e.aggregate||""].join("|")}function Ye(e,n){return!A(e)||!A(n)||e.name!==n.name?!1:ie(e).some(r=>ie(n).includes(r))}function Ze(e){return A(e)&&e.role==="id"}function We(e){const n=[],r=new Map;for(const o of e){const t=K(o.aliases.length?o.aliases:[o.key]),i=t.map(u=>r.get(u)).find(x);if(i){i.aliases=K([...i.aliases,...t]);continue}o.aliases=t,n.push(o);for(const u of t)r.set(u,o)}return n}function Xe(e){const n=new Map;for(const r of e)for(const o of K([r.key,...r.aliases])){const t=n.get(o);if(t&&t!==r.name)throw new Error(`Source identity ${o} resolves to multiple generated sources.`);n.set(o,r.name)}return n}function K(e){return Array.from(new Set(e.filter(Boolean)))}function Se(e){return W(e)[0]||pe(e)}function W(e){const n=g(e);if(!n)return[];const r=[];if(typeof n.sourceKey=="string"&&r.push(n.sourceKey),n.kind==="semantic"||n.datasetName){const o=typeof n.domainId=="string"?n.domainId:"";o&&typeof n.datasetId=="string"&&r.push(`semantic:${o}:datasetId:${n.datasetId}`),o&&typeof n.datasetName=="string"&&r.push(`semantic:${o}:datasetName:${n.datasetName}`)}return r.length===0&&r.push(pe(e)),K(r)}function ge(e){return W(e)}function pe(e){const n=g(e);return n?typeof n.sourceKey=="string"?n.sourceKey:JSON.stringify(n):""}function en(e){return A(e)&&ie(e)[0]||""}function ie(e){return A(e)?K([...typeof e.sourceKey=="string"?[e.sourceKey]:[],...e.source?W(e.source):[]]):[]}function P(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 nn(e){const n=P(e);return n==="records"||n==="sql"}function rn(e){const n=g(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 v(e,n){const r=new Map;for(const o of e){const t=n(o)||"item",i=r.get(t)||0;r.set(t,i+1),o.name=i===0?t:`${t}${i+1}`}}function de(e,n){const r=new Set,o=[];for(const t of e){const i=n(t);!i||r.has(i)||(r.add(i),o.push(t))}return o}function D(e){const n=String(e||"").replace(/[^A-Za-z0-9]+/g," ").trim().split(/\s+/).filter(Boolean);if(n.length===0)return"item";const[r,...o]=n,t=[r.toLowerCase(),...o.map(i=>i.charAt(0).toUpperCase()+i.slice(1).toLowerCase())].join("");return/^[A-Za-z_$]/.test(t)?t:`item${t}`}function tn(e){const n=String(e).split(":");return n[n.length-1]||String(e)}function H(e){return Object.fromEntries(Object.entries(e).filter(([,n])=>n!==void 0))}function g(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function j(e){return Array.isArray(e)?e:[]}function U(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function x(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=w.CODEGEN_SUMMARY_SCHEMA_VERSION;exports.CODEGEN_SUMMARY_VALIDATOR_VERSION=w.CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.CONTRACT_MANIFEST_SCHEMA_VERSION=w.CONTRACT_MANIFEST_SCHEMA_VERSION;exports.GENERATED_CONTRACT_SCHEMA_VERSION=w.GENERATED_CONTRACT_SCHEMA_VERSION;exports.GENERATED_CONTRACT_TYPESCRIPT_FILES=w.GENERATED_CONTRACT_TYPESCRIPT_FILES;exports.REQUIRED_GENERATED_CONTRACT_FILES=w.REQUIRED_GENERATED_CONTRACT_FILES;exports.assertValidCodegenSummary=w.assertValidCodegenSummary;exports.buildSemaphorGeneratedActiveInput=w.buildSemaphorGeneratedActiveInput;exports.buildSemaphorGeneratedInputOptionIntent=w.buildSemaphorGeneratedInputOptionIntent;exports.buildSemaphorGeneratedViewExecutionRequest=w.buildSemaphorGeneratedViewExecutionRequest;exports.buildSemaphorGeneratedViewExecutionRequests=w.buildSemaphorGeneratedViewExecutionRequests;exports.evaluateSemaphorDataAppContractUpdatePolicy=w.evaluateSemaphorDataAppContractUpdatePolicy;exports.validateCodegenSummary=w.validateCodegenSummary;exports.validateSemaphorGeneratedContract=w.validateSemaphorGeneratedContract;exports.DEFAULT_GENERATED_CONTRACT_OUTPUT_DIR=$e;exports.generateSemaphorDataAppContract=Fe;
+`}function j(e,n){if(!(!n||typeof n!="object")){if(Array.isArray(n)){for(const r of n)j(e,r);return}M(n)&&g(e,D(n));for(const r of Object.values(n))j(e,r)}}function W(e,n){const r=[];if(Xe(r,e.raw.sdkSpec),r.length===0)for(const t of e.raw.fields||[])g(r,t);const o=ne(r.filter(t=>t.name&&C(t,n)).map(t=>({raw:t,key:U(t),name:""})),t=>t.key);return K(o,t=>Q(t.raw.label||t.raw.name||"field")),o}function J(e,n){if(q(e.raw.sdkSpec.builder)!=="metric")return[];const r=I(e.raw.sdkSpec.spec),o=[];g(o,r==null?void 0:r.primaryMeasure);for(const a of H(r==null?void 0:r.measures))g(o,a);const t=ne(o.filter(a=>a.name&&C(a,n)).map(a=>({raw:a,key:U(a),name:""})),a=>a.key);return K(t,a=>Q(a.raw.label||a.raw.name||"metric")),t}function Ye(e,n){if(n.length===1)return new Set([n[0].name]);const r=I(e.raw.sdkSpec.spec);if(!M(r==null?void 0:r.primaryMeasure))return new Set;const o=U(D(r.primaryMeasure)),t=n.find(a=>a.key===o);return t?new Set([t.name]):new Set}function We(e){const n=new Map;for(const r of e)for(const o of new Set(ge(r.raw)))n.set(o,(n.get(o)||0)+1);return new Set(Array.from(n.entries()).filter(([,r])=>r>1).map(([r])=>r))}function ge(e){const n=(e.aggregate||"SUM").toUpperCase();return P([`${n.toLowerCase()}_${e.name}`,`${n}_${e.name}`,`${e.name}_${n.toLowerCase()}`,`${e.name}_${n}`,e.name])}function Ze(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 Xe(e,n){const r=I(n.spec);if(!r)return;const o=q(n.builder);if(o==="records"){for(const t of H(r.fields))g(e,t);return}if(o==="sql"){for(const t of H(r.fields))g(e,t);return}if(o==="analysis"||o==="metric"){g(e,r.primaryMeasure);for(const t of H(r.measures))g(e,t);for(const t of H(r.dimensions))g(e,t);g(e,r.dateField);return}if(o==="matrix"){const t=ce(r.rows),a=ce(r.columns),p=H(r.values);for(const f of t)me(e,f);for(const f of a)me(e,f);for(const f of p){const h=I(f);g(e,h==null?void 0:h.field),g(e,h==null?void 0:h.measure)}}}function ce(e){if(Array.isArray(e))return e;const n=I(e);return Array.isArray(n==null?void 0:n.levels)?n.levels:[]}function me(e,n){var r;if(M(n)){g(e,n);return}g(e,(r=I(n))==null?void 0:r.field)}function fe(e){var n,r,o,t;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"||((o=e==null?void 0:e.computation)==null?void 0:o.kind)==="unsupported"||(e==null?void 0:e.visual)==="text_block"||((t=e==null?void 0:e.visualSpec)==null?void 0:t.visualType)==="text_block"}function en(e){const n=I(e)||{};return v({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 g(e,n){M(n)&&e.push(D(n))}function D(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 nn(e){if(!e.source)return;const n={...e.source,...e.sourceKey?{sourceKey:e.sourceKey}:{}},r=we(n);if(r)return{raw:n,key:r,aliases:Ie(n),name:""}}function M(e){const n=I(e);return!!(n&&typeof n.name=="string"&&(typeof n.role=="string"||typeof n.dataType=="string"||typeof n.aggregate=="string"||n.source||n.sourceKey))}function he(e){const n=I(e);return!!(n&&(typeof n.sourceKey=="string"||n.kind==="semantic"||typeof n.datasetName=="string"&&typeof n.domainId=="string"))}function E(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(t=>E(t,n)).join(", ")}]`;if(M(e)){const t=C(D(e),n);if(t)return`fields.${t}`}if(he(e)){const t=Se(e,n);if(t)return`sources.${t}`}const r=I(e);return r?`{ ${Object.entries(r).filter(([,t])=>t!==void 0).map(([t,a])=>`${JSON.stringify(t)}: ${E(a,n)}`).join(", ")} }`:JSON.stringify(e)}function k(e){return JSON.stringify(e,null,2)}function C(e,n){if(M(e))return n.fieldNameByKey.get(U(D(e)))}function Se(e,n){if(he(e))for(const r of ee(e)){const o=n.sourceNameByKey.get(r);if(o)return o}}function U(e){return[e.sourceKey||"",e.name||"",e.role||"",e.aggregate||""].join("|")}function rn(e,n){return!M(e)||!M(n)||e.name!==n.name?!1:de(e).some(r=>de(n).includes(r))}function tn(e){return M(e)&&e.role==="id"}function on(e){const n=[],r=new Map;for(const o of e){const t=P(o.aliases.length?o.aliases:[o.key]),a=t.map(p=>r.get(p)).find(x);if(a){a.aliases=P([...a.aliases,...t]);continue}o.aliases=t,n.push(o);for(const p of t)r.set(p,o)}return n}function sn(e){const n=new Map;for(const r of e)for(const o of P([r.key,...r.aliases])){const t=n.get(o);if(t&&t!==r.name)throw new Error(`Source identity ${o} resolves to multiple generated sources.`);n.set(o,r.name)}return n}function P(e){return Array.from(new Set(e.filter(Boolean)))}function we(e){return ee(e)[0]||pe(e)}function ee(e){const n=I(e);if(!n)return[];const r=[];if(typeof n.sourceKey=="string"&&r.push(n.sourceKey),n.kind==="semantic"||n.datasetName){const o=typeof n.domainId=="string"?n.domainId:"";o&&typeof n.datasetId=="string"&&r.push(`semantic:${o}:datasetId:${n.datasetId}`),o&&typeof n.datasetName=="string"&&r.push(`semantic:${o}:datasetName:${n.datasetName}`)}return r.length===0&&r.push(pe(e)),P(r)}function Ie(e){return ee(e)}function pe(e){const n=I(e);return n?typeof n.sourceKey=="string"?n.sourceKey:JSON.stringify(n):""}function an(e){return M(e)&&de(e)[0]||""}function de(e){return M(e)?P([...typeof e.sourceKey=="string"?[e.sourceKey]:[],...e.source?ee(e.source):[]]):[]}function q(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 un(e){const n=q(e);return n==="records"||n==="sql"}function dn(e){const n=I(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 K(e,n){const r=new Map;for(const o of e){const t=n(o)||"item",a=r.get(t)||0;r.set(t,a+1),o.name=a===0?t:`${t}${a+1}`}}function ne(e,n){const r=new Set,o=[];for(const t of e){const a=n(t);!a||r.has(a)||(r.add(a),o.push(t))}return o}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,...o]=n,t=[r.toLowerCase(),...o.map(a=>a.charAt(0).toUpperCase()+a.slice(1).toLowerCase())].join("");return/^[A-Za-z_$]/.test(t)?t:`item${t}`}function ln(e){const n=String(e).split(":");return n[n.length-1]||String(e)}function v(e){return Object.fromEntries(Object.entries(e).filter(([,n])=>n!==void 0))}function I(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:void 0}function H(e){return Array.isArray(e)?e:[]}function z(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function x(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=$.CODEGEN_SUMMARY_SCHEMA_VERSION;exports.CODEGEN_SUMMARY_VALIDATOR_VERSION=$.CODEGEN_SUMMARY_VALIDATOR_VERSION;exports.CONTRACT_MANIFEST_SCHEMA_VERSION=$.CONTRACT_MANIFEST_SCHEMA_VERSION;exports.GENERATED_CONTRACT_SCHEMA_VERSION=$.GENERATED_CONTRACT_SCHEMA_VERSION;exports.GENERATED_CONTRACT_TYPESCRIPT_FILES=$.GENERATED_CONTRACT_TYPESCRIPT_FILES;exports.REQUIRED_GENERATED_CONTRACT_FILES=$.REQUIRED_GENERATED_CONTRACT_FILES;exports.assertValidCodegenSummary=$.assertValidCodegenSummary;exports.buildSemaphorGeneratedActiveInput=$.buildSemaphorGeneratedActiveInput;exports.buildSemaphorGeneratedInputOptionIntent=$.buildSemaphorGeneratedInputOptionIntent;exports.buildSemaphorGeneratedViewExecutionRequest=$.buildSemaphorGeneratedViewExecutionRequest;exports.buildSemaphorGeneratedViewExecutionRequests=$.buildSemaphorGeneratedViewExecutionRequests;exports.evaluateSemaphorDataAppContractUpdatePolicy=$.evaluateSemaphorDataAppContractUpdatePolicy;exports.validateCodegenSummary=$.validateCodegenSummary;exports.validateSemaphorGeneratedContract=$.validateSemaphorGeneratedContract;exports.DEFAULT_GENERATED_CONTRACT_OUTPUT_DIR=Ve;exports.generateSemaphorDataAppContract=be;