ggaction 0.0.23 → 0.0.26

package/src/actions/facets/actions.js

@@ -1 +1 @@
-import{normalizeFacetAxes as R,validateFacetAxisPolicy as x}from"../../core/facetAxisPolicy.js";import{DEFAULT_ACTION_METHODS as te}from"../../core/vocabulary.js";import{axisGraphicIds as ie}from"../../materialization/guides/resources.js";import{cartesianAxisOwners as ne,axisTargetArgs as ae}from"../../selectors/axes.js";import{resolveGraphicBounds as oe}from"../../layout/canvas.js";import{action as z,closedAction as T,getWrappedActionMetadata as ce}from"../../core/action.js";import{registerFacetDataRevision as se,reviseUnitData as re}from"../data/revise.js";import{applyMaterializationPlan as de}from"../../materialization/dependencies.js";import{getMarkMaterializationStep as le}from"../../materialization/marks/index.js";import{buildMaterializationPlan as fe}from"../../materialization/planner.js";import{freezeOwned as A,isPlainObject as S}from"../../core/immutable.js";import{validateUserId as P}from"../../core/identifiers.js";import{validateNonEmptyString as $,validateNonNegativeFinite as pe,validateOptionObject as w,validatePositiveFinite as ue}from"../../core/validation.js";import{resolveFacetDefinition as G,resolveFacetGridDefinition as I}from"../../grammar/facets/index.js";import{collectFacetScaleBindings as N,resolveFacetFamily as k}from"../../grammar/facets/dependencies.js";import{FACET_SCALE_CHANNELS as _,normalizeFacetScalePolicies as j}from"../../grammar/facets/scales.js";import{resolveFacetLayout as he}from"../../layout/facets.js";import{compositionChildDescriptor as me}from"../../materialization/composition.js";import{deriveFacetChildren as H}from"./derive.js";import{resolveFacetChildrenScales as ge}from"./derive.js";import{replayDerivedData as Se}from"./replay.js";import{composeFacetGuides as we}from"./guides.js";import{applyCompositionState as q}from"../composition/actions.js";import{replayCompositionThemeState as ye}from"../theme/composition.js";import{findDataset as Fe}from"../../selectors/datasets.js";import{findLayer as U}from"../../selectors/layers.js";import{findSemanticScale as be}from"../../selectors/scales.js";import{normalizeDisplayLabelMap as W}from"../../grammar/displayLabels.js";import{resolveRotation as ve}from"../../grammar/rotation.js";import{normalizeFacetHeaderTitle as Ce}from"../../grammar/facetHeaders.js";import{createDefaultFacetHeaders as Ee,normalizeFacetHeadersConfig as K,resolveFacetHeaderConfig as Oe}from"../../materialization/facetHeaders.js";const xe=Object.freeze(["id","field","data","values","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),ze=Object.freeze(["id","data","rows","columns","combinations","gap","spacing","topLane","align","padding","scales","guides","headers"]),Te=Object.freeze(["id","target","channel","fields","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),$e=new Set(te),ke=Object.freeze(["program","action"]),V=Object.freeze(["axes","legend"]),B=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","role","labelMap","side","align","rotation","title","anchor"]),Y=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","align","rotation","anchor"]);function b(t,e=!1){if(t===void 0)return{axes:"each",legend:!1};w(t,V,"facet.guides");const n=R(t.axes),i=t.legend??!1;if(i!==!1&&i!=="shared"&&!S(i))throw new Error('facet guides.legend must be false, "shared", or legend options.');if(!e&&S(i)&&Object.hasOwn(i,"type"))throw new Error("Facet legend options do not accept internal type tags.");return{axes:n,legend:i}}function v(t,e){if(t._assertCompositionProgram(e),t.compositionSpec.type!=="facet")throw new Error(`${e} requires a facet composition.`)}function C(t,e){const n=new Set(N(t.semanticSpec).map(i=>i.policyKey));return Object.fromEntries(_.flatMap(i=>n.has(i)&&e[i]!==void 0?[[i,e[i]]]:[]))}function E(t,e=!1){const n=t.compositionSpec.children.find(l=>t.children[l]?.semanticSpec.layers.length>0)??t.compositionSpec.children[0],i=t.children[n];if(i===void 0)throw new Error(`Facet "${t.compositionSpec.id}" requires a retained child.`);const{facets:c,guides:o,...d}=t.materializationConfigs,{legend:s,...r}=t.semanticSpec.guides,a={...i.materializationConfigs.guides,axis:o?.axis??i.guideConfigs.axis,grid:o?.grid??i.guideConfigs.grid};return e&&delete d.title,new t.constructor({semanticSpec:e?{...t.semanticSpec,title:{},guides:{...r,...i.semanticSpec.guides.legend===void 0?{}:{legend:i.semanticSpec.guides.legend}}}:t.semanticSpec,graphicSpec:i.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:A({...d,...i.materializationConfigs.theme===void 0?{}:{theme:i.materializationConfigs.theme},...a===void 0?{}:{guides:a},canvas:i.materializationConfigs.canvas}),children:{},context:t.context,trace:t.trace,actionStack:t.actionStack,actionSequence:t._actionSequence})}function D(t,{scales:e,guides:n}){const i=t.compositionSpec;if(i.facet.repeat!==void 0){const f=E(t),u=Q(f,{id:i.id,...i.facet.repeat}),m=Z(f,u,C(f,e),!0);return q(t,{children:m.children,compositionSpec:{...i,facet:{...i.facet,scales:e,guides:n}}},i.children)}const c=i.facet.grid===void 0?G(t.semanticSpec,{id:i.id,data:i.facet.data,field:i.facet.field,values:i.facet.values}):I(t.semanticSpec,{id:i.id,data:i.facet.data,rows:i.facet.grid.rows,columns:i.facet.grid.columns,combinations:i.facet.grid.combinations}),o=C(t,e),d=j(t.semanticSpec,o),s=E(t),r=H(s,c,{closeInheritedAction:!0,stripTitle:!0,scales:o}),a={...i,facet:{...i.facet,scales:d.channels,guides:n}};let l=t._withoutMaterializationConfig(["guides","legend"]);for(const[f,u]of Object.entries(s.guideConfigs.legend??{}))l=l._withLegendConfig(f,u);return q(l,{children:r.children,compositionSpec:a},a.children)}function L(t,e,n,i="editFacetHeaders"){w(e,B,i,{allowEmpty:!1,emptyMessage:`${i} requires at least one change.`});const c=e.role??"all";if(!["all","row","column"].includes(c))throw new Error(`Unknown facet header role "${c}".`);if(c==="all"&&Object.hasOwn(e,"side"))throw new Error(`${i} side requires an explicit row or column role.`);if(c==="all"&&Object.hasOwn(e,"title"))throw new Error(`${i} title requires an explicit row or column role.`);if(c==="row"&&n===void 0)throw new Error(`${i} row role requires a row-column facet grid.`);if(Object.hasOwn(e,"side")){const a=c==="row"?["left","right"]:n===void 0?["top","bottom","left","right"]:["top","bottom"];if(!a.includes(e.side))throw new Error(`${i} ${c} side must be ${a.join(" or ")}.`)}if(Object.hasOwn(e,"align")&&!["start","center","end"].includes(e.align))throw new Error(`${i} align must be start, center, or end.`);if(c==="all"&&Object.keys(e).every(a=>a==="role"))throw new Error(`${i} requires at least one change.`);const o=K(t),d=c==="all"?"common":c,s={...o[d]};if(Object.hasOwn(e,"title")){const a=Ce(s.title,e.title);a===void 0?delete s.title:s.title=a}for(const a of Y)Object.hasOwn(e,a)&&(s[a]=e[a]);Object.hasOwn(e,"rotation")&&(s.rotation=ve(e.rotation,`${i} ${c} rotation`)),Object.hasOwn(e,"side")&&(s.side=e.side),Object.hasOwn(e,"labelMap")&&(e.labelMap==="auto"?delete s.labelMap:s.labelMap=W(e.labelMap,`${i} ${c} labelMap`));const r={...o,...c==="all"?{}:{mode:"roles"},[d]:s};for(const a of["all","row","column"]){const l=Oe(r,a);if(ue(l.fontSize,`Facet ${a} header fontSize`),$(l.fontFamily,`Facet ${a} header fontFamily`),$(l.color,`Facet ${a} header color`),pe(l.offset,`Facet ${a} header offset`),l.rotation!==void 0&&!Number.isFinite(l.rotation))throw new TypeError(`Facet ${a} header rotation must resolve to finite radians.`);if(!(typeof l.fontWeight=="string"&&l.fontWeight.length>0||Number.isFinite(l.fontWeight)))throw new TypeError(`Facet ${a} header fontWeight must be a non-empty string or number.`);if(!["start","center","end"].includes(l.align))throw new Error(`Facet ${a} header align must be start, center, or end.`);l.labelMap!==void 0&&W(l.labelMap,`Facet ${a} header labelMap`)}return r}function _e(t,e){let n=Ee();if(t===void 0)return n;w(t,[...Y,"labelMap","row","column"],"facet.headers");const{row:i,column:c,...o}=t;Object.keys(o).length>0&&(n=L(n,o,e,"facet.headers"));for(const[d,s]of[["row",i],["column",c]])s!==void 0&&(w(s,B.filter(r=>r!=="role"),`facet.headers.${d}`),n=L(n,{...s,role:d},e,`facet.headers.${d}`));return n}function X(t,e,{definition:n,derived:i,guides:c,scalePolicies:o,facet:d}){const s=t.materializationConfigs.facets?.[n.id]?.headers,r=e.headers===void 0&&s!==void 0?K(s):_e(e.headers,n.grid),a=he({spacing:e.spacing,topLane:e.topLane,plots:Object.entries(i.children).map(([f,u])=>({id:f,...oe(u)})),children:n.cells.map(f=>({...me(f.id,i.children[f.id]),value:f.value,...n.grid===void 0?{}:{row:f.row,column:f.column}})),columns:n.grid?.columns.values.length??e.columns,gap:e.gap,align:e.align,padding:e.padding,sharedLegend:c.legend==="shared"}),l={id:n.id,type:"facet",children:n.cells.map(f=>f.id),columns:a.columns,gap:a.gap,align:a.align,padding:a.padding,...a.spacing===void 0?{}:{spacing:a.spacing},...a.topLane===void 0?{}:{topLane:a.topLane},facet:{data:n.data,...d,scales:o.channels,guides:c}};return q(t._withMaterializationConfig(["facets",n.id],{headers:r}),{children:i.children,compositionSpec:l},l.children)}function J(t,e,n){return T({op:t,description:e},t==="facet"?xe:ze,function(i={}){const c=b(i.guides),o=n(this.semanticSpec,i);x(c.axes,o.family);const d=j(this.semanticSpec,i.scales??{}),s=H(this,o,{closeInheritedAction:!0,stripTitle:!0,scales:i.scales??{}}),r=o.grid===void 0?{field:o.field,values:o.values}:{values:o.cells.map(a=>a.value),grid:{...o.grid,cells:o.cells.map(a=>({id:a.id,row:a.row,column:a.column,rowValue:a.rowValue,columnValue:a.columnValue,empty:a.empty}))}};return X(this,i,{definition:o,derived:s,guides:c,scalePolicies:d,facet:r})})}const je=J("facet","Repeat one direct-source chart by field value.",G);function Q(t,e){if(!S(e))throw new TypeError("repeatCharts options must be a plain object.");const n=P(e.id??"repeat","Repeat id"),i=S(e.channel);if(i){const p=Object.keys(e.channel);if(p.length!==1||p[0]!=="parallelDimension"||typeof e.channel.parallelDimension!="string"||e.channel.parallelDimension.length===0)throw new Error("repeatCharts Parallel channel must contain exactly one non-empty parallelDimension.")}else if(!["x","y","theta","r"].includes(e.channel))throw new Error('repeatCharts channel must be "x", "y", "theta", "r", or one parallelDimension.');if(!Array.isArray(e.fields)||e.fields.length===0||e.fields.some(p=>typeof p!="string"||p.length===0))throw new TypeError("repeatCharts fields must be a non-empty array of field names.");if(new Set(e.fields).size!==e.fields.length)throw new Error("repeatCharts fields must be unique.");const c=k(t.semanticSpec).family,o=e.channel==="r"?"radius":e.channel,d=t.semanticSpec.layers.filter(p=>{if(i){const F=(p.encoding?.parallel?.dimensions??[]).filter(y=>y.field===e.channel.parallelDimension);return c==="parallel"&&p.mark?.type==="line"&&F.length===1}if(["x","y"].includes(e.channel))return c==="cartesian"&&p.encoding?.x?.scale!==void 0&&p.encoding?.y?.scale!==void 0&&p.encoding?.[e.channel]?.field!==void 0&&["point","line","area","bar","rule","tick","rect"].includes(p.mark?.type);const g=t.markConfigs[p.id]?.compositionRole;return c!=="polar"||["pie","radar"].includes(g)?!1:["point","line","arc"].includes(p.mark?.type)&&p.encoding?.[o]?.field!==void 0});let s;if(e.target!==void 0){if(s=P(e.target,"Repeat target"),!d.some(p=>p.id===s))throw new Error(`repeatCharts target "${s}" is not eligible for the requested field role.`)}else if(d.length===1)s=d[0].id;else throw new Error(d.length===0?"repeatCharts requires one eligible complete mark for the requested field role.":"repeatCharts target is ambiguous; provide target.");if(t.semanticSpec.layers.filter(p=>{if(p.id===s)return!1;const g=p.mark?.type==="text"&&p.source===s,F=t.markConfigs[p.id]?.statisticalReference?.source===s;return!g&&!F}).length>0)throw new Error("repeatCharts currently supports one direct mark only.");const a=t.markConfigs[s]??{},l=["boxPlot","gradientPlot","violinPlot","regressionPlot","endpointPlot","ecdfPlot","raincloudPlot","intervalPlot"].find(p=>a[p]!==void 0);if(l!==void 0)throw new Error(`repeatCharts does not replace the ${l} composite role.`);const f=U(t,s),u=Fe(t,f.data);if(u?.transform?.length>0&&u.transform[0].type!=="lookup")throw new Error("repeatCharts does not rewrite a derived dataset dependency.");const m=i?f.encoding.parallel:f.encoding[o],h=i?m.dimensions.findIndex(p=>p.field===e.channel.parallelDimension):void 0;return{id:n,target:s,channel:i?{...e.channel}:e.channel,policyKey:i?"parallelDimensions":e.channel,fields:[...e.fields],data:f.data,encoding:m,...h===void 0?{}:{dimensionIndex:h},cells:e.fields.map((p,g)=>({id:`${n}-field-${g+1}`,field:p,value:p}))}}function qe(t,e){const n=t.encoding;return{target:t.target,field:e,fieldType:n.fieldType,...n.temporalUnit===void 0?{}:{temporalUnit:n.temporalUnit},...n.aggregate===void 0?{}:{aggregate:n.aggregate},...n.bin===void 0?{}:{bin:n.bin},...n.stack===void 0?{}:{stack:n.stack},...n.weight===void 0?{}:{weight:n.weight},scale:{id:n.scale}}}function De(t,e,n){return e.encoding.dimensions.map((i,c)=>{const o=be(t,i.scale);if(o===void 0)throw new Error(`repeatCharts Parallel dimension scale "${i.scale}" is missing.`);const{id:d,...s}=o,r=c===e.dimensionIndex;return{field:r?n:i.field,fieldType:i.fieldType,title:r&&i.title===i.field?n:i.title,scale:s}})}function Le(t,e,n){if(S(e.channel))return t.encodeParallelCoordinates({target:e.target,coordinate:U(t,e.target).coordinate,dimensions:De(t,e,n),...e.encoding.key===void 0?{}:{key:e.encoding.key},missing:e.encoding.missing});const i={x:"encodeX",y:"encodeY",theta:"encodeTheta",r:"encodeR"}[e.channel];return t[i](qe(e,n))}function Z(t,e,n,i){const c=t.semanticSpec.title.text===void 0?t:t.removeTitle(),o=Object.fromEntries(e.cells.map(d=>[d.id,Le(c,e,d.field)]));return ge(c,e.cells.map(d=>d.id),o,n,i)}const Me=T({op:"repeatCharts",description:"Repeat one direct chart across an ordered field-role list."},Te,function(t={}){const e=b(t.guides),n=Q(this,t);x(e.axes,k(this.semanticSpec).family,!0);const i={...t.scales??{},[n.policyKey]:t.scales?.[n.policyKey]??"independent"},c=j(this.semanticSpec,i),o=Z(this,n,i,!0);return X(this,t,{definition:n,derived:o,guides:e,scalePolicies:c,facet:{values:n.fields,repeat:{target:n.target,channel:n.channel,fields:n.fields}}})}),Re=J("facetGrid","Repeat one direct-source Cartesian chart across a row and column field grid.",I),Ae=z({op:"editFacetHeaders",description:"Edit parent-owned facet header appearance.",scope:"composition"},function(t={}){v(this,"editFacetHeaders");const e=this.compositionSpec.id,n=this.materializationConfigs.facets?.[e];if(!S(n?.headers))throw new Error(`Facet "${e}" requires header configuration.`);const i=L(n.headers,t,this.compositionSpec.facet.grid);return this._withMaterializationConfig(["facets",e],{...n,headers:i}).materializeComposition()}),Pe=z({op:"editFacetScales",description:"Edit facet scale-resolution policies and rederive every cell.",scope:"composition"},function(t={}){v(this,"editFacetScales"),w(t,_,"editFacetScales",{allowEmpty:!1,emptyMessage:"editFacetScales requires at least one channel policy change."});for(const i of Object.keys(t))if(!N(this.semanticSpec).some(c=>c.policyKey===i))throw new Error(`Facet scale channel "${i}" is not used by an affected layer.`);const e=this.compositionSpec.facet,n={...e.scales,...t};if(_.every(i=>n[i]===e.scales[i]))throw new Error("editFacetScales requires at least one channel policy change.");return D(this,{scales:n,guides:e.guides})}),Ge=z({op:"editFacetGuides",description:"Edit facet guide ownership and rederive every cell.",scope:"composition"},function(t={}){v(this,"editFacetGuides"),w(t,V,"editFacetGuides",{allowEmpty:!1,emptyMessage:"editFacetGuides requires at least one guide policy."});const e=this.compositionSpec.facet;Object.hasOwn(t,"legend")&&b({legend:t.legend});const n=b({...e.guides,...t,...Object.hasOwn(t,"axes")?{axes:R(t.axes,e.guides.axes)}:{}},!0),i=k(this.semanticSpec).family;return x(n.axes,i,e.repeat!==void 0),D(this,{scales:e.scales,guides:n})});function Ie(t,e,n=!1){if(!(t instanceof e.constructor))throw new TypeError("editFacetSource program must be a ChartProgram.");if(t.compositionSpec!==void 0)throw new Error("editFacetSource program must be a complete unit ChartProgram.");if(t.actionStack.length!==0)throw new Error("editFacetSource program has an unfinished action stack.");const i=e.compositionSpec.children.find(a=>e.children[a]?.semanticSpec.layers.length>0)??e.compositionSpec.children[0],c=e.children[i]?.materializationConfigs??{},{canvas:o,theme:d,facets:s,...r}=c;return new e.constructor({semanticSpec:t.semanticSpec,graphicSpec:t.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:A({...n?{...r,...t.materializationConfigs}:{...t.materializationConfigs,...r},...t.materializationConfigs.canvas===void 0?{}:{canvas:t.materializationConfigs.canvas},...t.materializationConfigs.theme===void 0?{}:{theme:t.materializationConfigs.theme}}),children:{},context:t.context,trace:e.trace,actionStack:e.actionStack,actionSequence:e._actionSequence})}const Ne=T({op:"editFacetSource",description:"Reapply one facet, grid, or repeat recipe to a revised complete unit program.",scope:"composition"},ke,function(t={}){v(this,"editFacetSource");const e=this.compositionSpec,n=this.materializationConfigs.facets?.[e.id];if(Object.hasOwn(t,"program")===Object.hasOwn(t,"action"))throw new Error("editFacetSource requires exactly one of program or action.");let i=t.program,c=this;if(t.action!==void 0){w(t.action,["method","options"],"editFacetSource action");const l=$(t.action.method,"editFacetSource action method");let f=E(this,!0);const u=typeof f[l]=="function"?ce(f[l]):void 0;if(!u||!$e.has(l)||u.scope==="composition"||/^(?:_|materialize|rematerialize|replay|editSemantic$|editGraphics$|createGraphics$)/.test(l))throw new Error("editFacetSource action requires a unit chart-authoring action.");f=de(f,fe({marks:f.semanticSpec.layers.map(h=>le(f,h))}));for(const h of ne(f)){const p=f.guideConfigs.axis?.[h.id]??{},g=ie(h.channel,h.id);for(const[F,y]of["line","ticks","labels","title"].entries()){if(!p[y]||f.graphicSpec.objects[g[F]])continue;const{mode:M,inferredValues:He,inferredText:Ue,inferredRotation:We,inferredOffset:Ke,...O}=p[y];M==="values"&&delete O.count,M==="count"&&delete O.values;const ee=y[0].toUpperCase()+y.slice(1);f=f[`create${h.channel.toUpperCase()}Axis${ee}`]({...O,...ae(h.id,h.channel)})}}const m=f[l](t.action.options??{});c=new this.constructor({...this,trace:m.trace,actionStack:m.actionStack,actionSequence:m._actionSequence}),i=new this.constructor({...m,actionStack:[],actionSequence:m._actionSequence})}let o=Ie(i,c,t.action!==void 0);n!==void 0&&(o=o._withMaterializationConfig(["facets",e.id],n));const d=S(e.facet.guides.legend),s=d?{...e.facet.guides,legend:!1}:e.facet.guides;let r;const a=C(o,C(this,e.facet.scales));if(e.facet.grid!==void 0?r=o.facetGrid({id:e.id,data:e.facet.data,rows:e.facet.grid.rows,columns:e.facet.grid.columns,combinations:e.facet.grid.combinations,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}):e.facet.repeat!==void 0?r=o.repeatCharts({id:e.id,...e.facet.repeat,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}):r=o.facet({id:e.id,data:e.facet.data,field:e.facet.field,values:e.facet.values,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:a,guides:s}),d){const l=r.compositionSpec;r=r._withCompositionState({children:r.children,compositionSpec:{...l,facet:{...l.facet,guides:e.facet.guides}}})}return n!==void 0&&(r=r._withMaterializationConfig(["facets",e.id],n).materializeComposition()),r.semanticSpec.title.text!==void 0&&(r=r.removeTitle()),this.semanticSpec.title.text!==void 0&&(r=r.createTitle({...this.titleConfig,...this.semanticSpec.title})),ye(r,this.materializationConfigs.theme)});function Et(t){se((e,n)=>{const{program:i,plan:c}=re(E(e),n),o=e.compositionSpec,d=new e.constructor({...i,graphicSpec:e.graphicSpec,children:e.children,materializationConfigs:{...i.materializationConfigs,facets:e.materializationConfigs.facets,...e.titleConfig===void 0?{}:{title:e.titleConfig}},actionSequence:i._actionSequence,compositionSpec:{...o,facet:{...o.facet,data:c.replacements.get(o.facet.data)??o.facet.data}}});return D(d,o.facet)}),t.prototype.replayDerivedData=Se,t.prototype.composeFacetGuides=we,t.prototype.facet=je,t.prototype.facetGrid=Re,t.prototype.repeatCharts=Me,t.prototype.editFacetHeaders=Ae,t.prototype.editFacetScales=Pe,t.prototype.editFacetGuides=Ge,t.prototype.editFacetSource=Ne}export{Ge as editFacetGuides,Ae as editFacetHeaders,Pe as editFacetScales,Ne as editFacetSource,je as facet,Re as facetGrid,Et as registerFacetActions,Me as repeatCharts};
+import{normalizeFacetAxes as P,validateFacetAxisPolicy as k}from"../../core/facetAxisPolicy.js";import{DEFAULT_ACTION_METHODS as ne}from"../../core/vocabulary.js";import{axisGraphicIds as ae}from"../../materialization/guides/resources.js";import{facetLegendIntent as oe}from"../../materialization/facetGuides/owner.js";import{legendBlockChannels as ce}from"../../grammar/legendBlocks.js";import{cartesianAxisOwners as se,axisTargetArgs as re}from"../../selectors/axes.js";import{resolveGraphicBounds as de}from"../../layout/canvas.js";import{action as T,closedAction as $,getWrappedActionMetadata as le}from"../../core/action.js";import{registerFacetDataRevision as fe,reviseUnitData as pe}from"../data/revise.js";import{applyMaterializationPlan as ue}from"../../materialization/dependencies.js";import{getMarkMaterializationStep as he}from"../../materialization/marks/index.js";import{buildMaterializationPlan as me}from"../../materialization/planner.js";import{freezeOwned as G,isPlainObject as b}from"../../core/immutable.js";import{validateUserId as I}from"../../core/identifiers.js";import{validateNonEmptyString as j,validateNonNegativeFinite as ge,validateOptionObject as v,validatePositiveFinite as Se}from"../../core/validation.js";import{resolveFacetDefinition as N,resolveFacetGridDefinition as H}from"../../grammar/facets/index.js";import{collectFacetScaleBindings as U,resolveFacetFamily as _}from"../../grammar/facets/dependencies.js";import{FACET_SCALE_CHANNELS as L,normalizeFacetScalePolicies as q}from"../../grammar/facets/scales.js";import{resolveFacetLayout as we}from"../../layout/facets.js";import{compositionChildDescriptor as ye}from"../../materialization/composition.js";import{deriveFacetChildren as W}from"./derive.js";import{resolveFacetChildrenScales as be}from"./derive.js";import{replayDerivedData as ve}from"./replay.js";import{composeFacetGuides as Ce}from"./guides.js";import{applyCompositionState as D}from"../composition/actions.js";import{replayCompositionThemeState as Fe}from"../theme/composition.js";import{findDataset as Ee}from"../../selectors/datasets.js";import{findLayer as K}from"../../selectors/layers.js";import{findSemanticScale as Oe}from"../../selectors/scales.js";import{normalizeDisplayLabelMap as V}from"../../grammar/displayLabels.js";import{resolveRotation as xe}from"../../grammar/rotation.js";import{normalizeFacetHeaderTitle as ze}from"../../grammar/facetHeaders.js";import{createDefaultFacetHeaders as ke,normalizeFacetHeadersConfig as B,resolveFacetHeaderConfig as Te}from"../../materialization/facetHeaders.js";const $e=Object.freeze(["id","field","data","values","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),je=Object.freeze(["id","data","rows","columns","combinations","gap","spacing","topLane","align","padding","scales","guides","headers"]),_e=Object.freeze(["id","target","channel","fields","columns","gap","spacing","topLane","align","padding","scales","guides","headers"]),Le=new Set(ne),qe=Object.freeze(["program","action"]),Y=Object.freeze(["axes","legend"]),X=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","role","labelMap","side","align","rotation","title","anchor"]),J=Object.freeze(["fontSize","fontFamily","fontWeight","color","offset","align","rotation","anchor"]);function F(t,e=!1){if(t===void 0)return{axes:"each",legend:!1};v(t,Y,"facet.guides");const n=P(t.axes),i=t.legend??!1;if(i!==!1&&i!=="shared"&&!b(i))throw new Error('facet guides.legend must be false, "shared", or legend options.');if(!e&&b(i)&&Object.hasOwn(i,"type"))throw new Error("Facet legend options do not accept internal type tags.");return{axes:n,legend:i}}function E(t,e){if(t._assertCompositionProgram(e),t.compositionSpec.type!=="facet")throw new Error(`${e} requires a facet composition.`)}function O(t,e){const n=new Set(U(t.semanticSpec).map(i=>i.policyKey));return Object.fromEntries(L.flatMap(i=>n.has(i)&&e[i]!==void 0?[[i,e[i]]]:[]))}function x(t,e=!1){const n=t.compositionSpec.children.find(f=>t.children[f]?.semanticSpec.layers.length>0)??t.compositionSpec.children[0],i=t.children[n];if(i===void 0)throw new Error(`Facet "${t.compositionSpec.id}" requires a retained child.`);const{facets:s,guides:o,...d}=t.materializationConfigs,{legend:c,...p}=t.semanticSpec.guides,a={...i.materializationConfigs.guides,axis:o?.axis??i.guideConfigs.axis,grid:o?.grid??i.guideConfigs.grid};return e&&delete d.title,new t.constructor({semanticSpec:e?{...t.semanticSpec,title:{},guides:{...p,...i.semanticSpec.guides.legend===void 0?{}:{legend:i.semanticSpec.guides.legend}}}:t.semanticSpec,graphicSpec:i.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:G({...d,...i.materializationConfigs.theme===void 0?{}:{theme:i.materializationConfigs.theme},...a===void 0?{}:{guides:a},canvas:i.materializationConfigs.canvas}),children:{},context:t.context,trace:t.trace,actionStack:t.actionStack,actionSequence:t._actionSequence})}function M(t,{scales:e,guides:n}){const i=t.compositionSpec;if(i.facet.repeat!==void 0){const l=x(t),u=ee(l,{id:i.id,...i.facet.repeat}),w=te(l,u,O(l,e),!0);return D(t,{children:w.children,compositionSpec:{...i,facet:{...i.facet,scales:e,guides:n}}},i.children)}const s=i.facet.grid===void 0?N(t.semanticSpec,{id:i.id,data:i.facet.data,field:i.facet.field,values:i.facet.values}):H(t.semanticSpec,{id:i.id,data:i.facet.data,rows:i.facet.grid.rows,columns:i.facet.grid.columns,combinations:i.facet.grid.combinations}),o=O(t,e),d=q(t.semanticSpec,o),c=x(t),p=W(c,s,{closeInheritedAction:!0,stripTitle:!0,scales:o}),a={...i,facet:{...i.facet,scales:d.channels,guides:n}};let f=t._withoutMaterializationConfig(["guides","legend"]);for(const[l,u]of Object.entries(c.guideConfigs.legend??{}))f=f._withLegendConfig(l,u);return D(f,{children:p.children,compositionSpec:a},a.children)}function R(t,e,n,i="editFacetHeaders"){v(e,X,i,{allowEmpty:!1,emptyMessage:`${i} requires at least one change.`});const s=e.role??"all";if(!["all","row","column"].includes(s))throw new Error(`Unknown facet header role "${s}".`);if(s==="all"&&Object.hasOwn(e,"side"))throw new Error(`${i} side requires an explicit row or column role.`);if(s==="all"&&Object.hasOwn(e,"title"))throw new Error(`${i} title requires an explicit row or column role.`);if(s==="row"&&n===void 0)throw new Error(`${i} row role requires a row-column facet grid.`);if(Object.hasOwn(e,"side")){const a=s==="row"?["left","right"]:n===void 0?["top","bottom","left","right"]:["top","bottom"];if(!a.includes(e.side))throw new Error(`${i} ${s} side must be ${a.join(" or ")}.`)}if(Object.hasOwn(e,"align")&&!["start","center","end"].includes(e.align))throw new Error(`${i} align must be start, center, or end.`);if(s==="all"&&Object.keys(e).every(a=>a==="role"))throw new Error(`${i} requires at least one change.`);const o=B(t),d=s==="all"?"common":s,c={...o[d]};if(Object.hasOwn(e,"title")){const a=ze(c.title,e.title);a===void 0?delete c.title:c.title=a}for(const a of J)Object.hasOwn(e,a)&&(c[a]=e[a]);Object.hasOwn(e,"rotation")&&(c.rotation=xe(e.rotation,`${i} ${s} rotation`)),Object.hasOwn(e,"side")&&(c.side=e.side),Object.hasOwn(e,"labelMap")&&(e.labelMap==="auto"?delete c.labelMap:c.labelMap=V(e.labelMap,`${i} ${s} labelMap`));const p={...o,...s==="all"?{}:{mode:"roles"},[d]:c};for(const a of["all","row","column"]){const f=Te(p,a);if(Se(f.fontSize,`Facet ${a} header fontSize`),j(f.fontFamily,`Facet ${a} header fontFamily`),j(f.color,`Facet ${a} header color`),ge(f.offset,`Facet ${a} header offset`),f.rotation!==void 0&&!Number.isFinite(f.rotation))throw new TypeError(`Facet ${a} header rotation must resolve to finite radians.`);if(!(typeof f.fontWeight=="string"&&f.fontWeight.length>0||Number.isFinite(f.fontWeight)))throw new TypeError(`Facet ${a} header fontWeight must be a non-empty string or number.`);if(!["start","center","end"].includes(f.align))throw new Error(`Facet ${a} header align must be start, center, or end.`);f.labelMap!==void 0&&V(f.labelMap,`Facet ${a} header labelMap`)}return p}function De(t,e){let n=ke();if(t===void 0)return n;v(t,[...J,"labelMap","row","column"],"facet.headers");const{row:i,column:s,...o}=t;Object.keys(o).length>0&&(n=R(n,o,e,"facet.headers"));for(const[d,c]of[["row",i],["column",s]])c!==void 0&&(v(c,X.filter(p=>p!=="role"),`facet.headers.${d}`),n=R(n,{...c,role:d},e,`facet.headers.${d}`));return n}function Q(t,e,{definition:n,derived:i,guides:s,scalePolicies:o,facet:d}){const c=t.materializationConfigs.facets?.[n.id]?.headers,p=e.headers===void 0&&c!==void 0?B(c):De(e.headers,n.grid),a=we({spacing:e.spacing,topLane:e.topLane,plots:Object.entries(i.children).map(([l,u])=>({id:l,...de(u)})),children:n.cells.map(l=>({...ye(l.id,i.children[l.id]),value:l.value,...n.grid===void 0?{}:{row:l.row,column:l.column}})),columns:n.grid?.columns.values.length??e.columns,gap:e.gap,align:e.align,padding:e.padding,sharedLegend:s.legend==="shared"}),f={id:n.id,type:"facet",children:n.cells.map(l=>l.id),columns:a.columns,gap:a.gap,align:a.align,padding:a.padding,...a.spacing===void 0?{}:{spacing:a.spacing},...a.topLane===void 0?{}:{topLane:a.topLane},facet:{data:n.data,...d,scales:o.channels,guides:s}};return D(t._withMaterializationConfig(["facets",n.id],{headers:p}),{children:i.children,compositionSpec:f},f.children)}function Z(t,e,n){return $({op:t,description:e},t==="facet"?$e:je,function(i={}){const s=F(i.guides),o=n(this.semanticSpec,i);k(s.axes,o.family);const d=q(this.semanticSpec,i.scales??{}),c=W(this,o,{closeInheritedAction:!0,stripTitle:!0,scales:i.scales??{}}),p=o.grid===void 0?{field:o.field,values:o.values}:{values:o.cells.map(a=>a.value),grid:{...o.grid,cells:o.cells.map(a=>({id:a.id,row:a.row,column:a.column,rowValue:a.rowValue,columnValue:a.columnValue,empty:a.empty}))}};return Q(this,i,{definition:o,derived:c,guides:s,scalePolicies:d,facet:p})})}const Me=Z("facet","Repeat one direct-source chart by field value.",N);function ee(t,e){if(!b(e))throw new TypeError("repeatCharts options must be a plain object.");const n=I(e.id??"repeat","Repeat id"),i=b(e.channel);if(i){const r=Object.keys(e.channel);if(r.length!==1||r[0]!=="parallelDimension"||typeof e.channel.parallelDimension!="string"||e.channel.parallelDimension.length===0)throw new Error("repeatCharts Parallel channel must contain exactly one non-empty parallelDimension.")}else if(!["x","y","theta","r"].includes(e.channel))throw new Error('repeatCharts channel must be "x", "y", "theta", "r", or one parallelDimension.');if(!Array.isArray(e.fields)||e.fields.length===0||e.fields.some(r=>typeof r!="string"||r.length===0))throw new TypeError("repeatCharts fields must be a non-empty array of field names.");if(new Set(e.fields).size!==e.fields.length)throw new Error("repeatCharts fields must be unique.");const s=_(t.semanticSpec).family,o=e.channel==="r"?"radius":e.channel,d=t.semanticSpec.layers.filter(r=>{if(i){const g=(r.encoding?.parallel?.dimensions??[]).filter(S=>S.field===e.channel.parallelDimension);return s==="parallel"&&r.mark?.type==="line"&&g.length===1}if(["x","y"].includes(e.channel))return s==="cartesian"&&r.encoding?.x?.scale!==void 0&&r.encoding?.y?.scale!==void 0&&r.encoding?.[e.channel]?.field!==void 0&&["point","line","area","bar","rule","tick","rect"].includes(r.mark?.type);const h=t.markConfigs[r.id]?.compositionRole;return s!=="polar"||["pie","radar"].includes(h)?!1:["point","line","arc"].includes(r.mark?.type)&&r.encoding?.[o]?.field!==void 0});let c;if(e.target!==void 0){if(c=I(e.target,"Repeat target"),!d.some(r=>r.id===c))throw new Error(`repeatCharts target "${c}" is not eligible for the requested field role.`)}else if(d.length===1)c=d[0].id;else throw new Error(d.length===0?"repeatCharts requires one eligible complete mark for the requested field role.":"repeatCharts target is ambiguous; provide target.");if(t.semanticSpec.layers.filter(r=>{if(r.id===c)return!1;const h=r.mark?.type==="text"&&r.source===c,g=t.markConfigs[r.id]?.statisticalReference?.source===c;return!h&&!g}).length>0)throw new Error("repeatCharts currently supports one direct mark only.");const a=t.markConfigs[c]??{},f=["boxPlot","gradientPlot","violinPlot","regressionPlot","endpointPlot","ecdfPlot","raincloudPlot","intervalPlot"].find(r=>a[r]!==void 0);if(f!==void 0)throw new Error(`repeatCharts does not replace the ${f} composite role.`);const l=K(t,c),u=Ee(t,l.data);if(u?.transform?.length>0&&u.transform[0].type!=="lookup")throw new Error("repeatCharts does not rewrite a derived dataset dependency.");const w=i?l.encoding.parallel:l.encoding[o],m=i?w.dimensions.findIndex(r=>r.field===e.channel.parallelDimension):void 0;return{id:n,target:c,channel:i?{...e.channel}:e.channel,policyKey:i?"parallelDimensions":e.channel,fields:[...e.fields],data:l.data,encoding:w,...m===void 0?{}:{dimensionIndex:m},cells:e.fields.map((r,h)=>({id:`${n}-field-${h+1}`,field:r,value:r}))}}function Re(t,e){const n=t.encoding;return{target:t.target,field:e,fieldType:n.fieldType,...n.temporalUnit===void 0?{}:{temporalUnit:n.temporalUnit},...n.aggregate===void 0?{}:{aggregate:n.aggregate},...n.bin===void 0?{}:{bin:n.bin},...n.stack===void 0?{}:{stack:n.stack},...n.weight===void 0?{}:{weight:n.weight},scale:{id:n.scale}}}function Ae(t,e,n){return e.encoding.dimensions.map((i,s)=>{const o=Oe(t,i.scale);if(o===void 0)throw new Error(`repeatCharts Parallel dimension scale "${i.scale}" is missing.`);const{id:d,...c}=o,p=s===e.dimensionIndex;return{field:p?n:i.field,fieldType:i.fieldType,title:p&&i.title===i.field?n:i.title,scale:c}})}function Pe(t,e,n){if(b(e.channel))return t.encodeParallelCoordinates({target:e.target,coordinate:K(t,e.target).coordinate,dimensions:Ae(t,e,n),...e.encoding.key===void 0?{}:{key:e.encoding.key},missing:e.encoding.missing});const i={x:"encodeX",y:"encodeY",theta:"encodeTheta",r:"encodeR"}[e.channel];return t[i](Re(e,n))}function te(t,e,n,i){const s=t.semanticSpec.title.text===void 0?t:t.removeTitle(),o=Object.fromEntries(e.cells.map(d=>[d.id,Pe(s,e,d.field)]));return be(s,e.cells.map(d=>d.id),o,n,i)}const Ge=$({op:"repeatCharts",description:"Repeat one direct chart across an ordered field-role list."},_e,function(t={}){const e=F(t.guides),n=ee(this,t);k(e.axes,_(this.semanticSpec).family,!0);const i={...t.scales??{},[n.policyKey]:t.scales?.[n.policyKey]??"independent"},s=q(this.semanticSpec,i),o=te(this,n,i,!0);return Q(this,t,{definition:n,derived:o,guides:e,scalePolicies:s,facet:{values:n.fields,repeat:{target:n.target,channel:n.channel,fields:n.fields}}})}),Ie=Z("facetGrid","Repeat one direct-source Cartesian chart across a row and column field grid.",H),Ne=T({op:"editFacetHeaders",description:"Edit parent-owned facet header appearance.",scope:"composition"},function(t={}){E(this,"editFacetHeaders");const e=this.compositionSpec.id,n=this.materializationConfigs.facets?.[e];if(!b(n?.headers))throw new Error(`Facet "${e}" requires header configuration.`);const i=R(n.headers,t,this.compositionSpec.facet.grid);return this._withMaterializationConfig(["facets",e],{...n,headers:i}).materializeComposition()}),He=T({op:"editFacetScales",description:"Edit facet scale-resolution policies and rederive every cell.",scope:"composition"},function(t={}){E(this,"editFacetScales"),v(t,L,"editFacetScales",{allowEmpty:!1,emptyMessage:"editFacetScales requires at least one channel policy change."});for(const i of Object.keys(t))if(!U(this.semanticSpec).some(s=>s.policyKey===i))throw new Error(`Facet scale channel "${i}" is not used by an affected layer.`);const e=this.compositionSpec.facet,n={...e.scales,...t};if(L.every(i=>n[i]===e.scales[i]))throw new Error("editFacetScales requires at least one channel policy change.");return M(this,{scales:n,guides:e.guides})}),Ue=T({op:"editFacetGuides",description:"Edit facet guide ownership and rederive every cell.",scope:"composition"},function(t={}){E(this,"editFacetGuides"),v(t,Y,"editFacetGuides",{allowEmpty:!1,emptyMessage:"editFacetGuides requires at least one guide policy."});const e=this.compositionSpec.facet;Object.hasOwn(t,"legend")&&F({legend:t.legend});const n=F({...e.guides,...t,...Object.hasOwn(t,"axes")?{axes:P(t.axes,e.guides.axes)}:{}},!0),i=_(this.semanticSpec).family;return k(n.axes,i,e.repeat!==void 0),M(this,{scales:e.scales,guides:n})});function We(t,e,n=!1){if(!(t instanceof e.constructor))throw new TypeError("editFacetSource program must be a ChartProgram.");if(t.compositionSpec!==void 0)throw new Error("editFacetSource program must be a complete unit ChartProgram.");if(t.actionStack.length!==0)throw new Error("editFacetSource program has an unfinished action stack.");const i=e.compositionSpec.children.find(a=>e.children[a]?.semanticSpec.layers.length>0)??e.compositionSpec.children[0],s=e.children[i]?.materializationConfigs??{},{canvas:o,theme:d,facets:c,...p}=s;return new e.constructor({semanticSpec:t.semanticSpec,graphicSpec:t.graphicSpec,resolvedScales:t.resolvedScales,materializationConfigs:G({...n?{...p,...t.materializationConfigs}:{...t.materializationConfigs,...p},...t.materializationConfigs.canvas===void 0?{}:{canvas:t.materializationConfigs.canvas},...t.materializationConfigs.theme===void 0?{}:{theme:t.materializationConfigs.theme}}),children:{},context:t.context,trace:e.trace,actionStack:e.actionStack,actionSequence:e._actionSequence})}const Ke=$({op:"editFacetSource",description:"Reapply one facet, grid, or repeat recipe to a revised complete unit program.",scope:"composition"},qe,function(t={}){E(this,"editFacetSource");const e=this.compositionSpec,n=this.materializationConfigs.facets?.[e.id];if(Object.hasOwn(t,"program")===Object.hasOwn(t,"action"))throw new Error("editFacetSource requires exactly one of program or action.");let i=t.program,s=this,o=e.facet.guides;if(t.action!==void 0){v(t.action,["method","options"],"editFacetSource action");const l=j(t.action.method,"editFacetSource action method");let u=x(this,!0);const w=typeof u[l]=="function"?le(u[l]):void 0;if(!w||!Le.has(l)||w.scope==="composition"||/^(?:_|materialize|rematerialize|replay|editSemantic$|editGraphics$|createGraphics$)/.test(l))throw new Error("editFacetSource action requires a unit chart-authoring action.");u=ue(u,me({marks:u.semanticSpec.layers.map(r=>he(u,r))}));for(const r of se(u)){const h=u.guideConfigs.axis?.[r.id]??{},g=ae(r.channel,r.id);for(const[S,y]of["line","ticks","labels","title"].entries()){if(!h[y]||u.graphicSpec.objects[g[S]])continue;const{mode:C,inferredValues:A,inferredText:Ve,inferredRotation:Be,inferredOffset:Ye,...z}=h[y];C==="values"&&delete z.count,C==="count"&&delete z.values;const ie=y[0].toUpperCase()+y.slice(1);u=u[`create${r.channel.toUpperCase()}Axis${ie}`]({...z,...re(r.id,r.channel)})}}const m=u[l](t.action.options??{});if(l==="createLegend"&&o.legend?.type==="authored-legend"){const r=Object.entries(u.guideConfigs.suppressedLegends??{}).flatMap(([h,{channels:g}])=>g.filter(S=>!m.guideConfigs.suppressedLegends?.[h]?.channels.includes(S)).map(S=>[h,S]));if(r.length){const h=oe(m),g=Object.fromEntries(Object.entries(h.blocks).filter(([S,{config:y}])=>r.some(([C,A])=>y.target===C&&ce(S,y).includes(A))));o={...o,legend:{...o.legend,blocks:{...o.legend.blocks,...g}}}}}s=new this.constructor({...this,trace:m.trace,actionStack:m.actionStack,actionSequence:m._actionSequence}),i=new this.constructor({...m,actionStack:[],actionSequence:m._actionSequence})}let d=We(i,s,t.action!==void 0);n!==void 0&&(d=d._withMaterializationConfig(["facets",e.id],n));const c=b(o.legend),p=c?{...o,legend:!1}:o;let a;const f=O(d,O(this,e.facet.scales));if(e.facet.grid!==void 0?a=d.facetGrid({id:e.id,data:e.facet.data,rows:e.facet.grid.rows,columns:e.facet.grid.columns,combinations:e.facet.grid.combinations,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:f,guides:p}):e.facet.repeat!==void 0?a=d.repeatCharts({id:e.id,...e.facet.repeat,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:f,guides:p}):a=d.facet({id:e.id,data:e.facet.data,field:e.facet.field,values:e.facet.values,columns:e.columns,gap:e.gap,...e.spacing===void 0?{}:{spacing:e.spacing},...e.topLane===void 0?{}:{topLane:e.topLane},align:e.align,padding:e.padding,scales:f,guides:p}),c){const l=a.compositionSpec;a=a._withCompositionState({children:a.children,compositionSpec:{...l,facet:{...l.facet,guides:o}}})}return n!==void 0&&(a=a._withMaterializationConfig(["facets",e.id],n).materializeComposition()),a.semanticSpec.title.text!==void 0&&(a=a.removeTitle()),this.semanticSpec.title.text!==void 0&&(a=a.createTitle({...this.titleConfig,...this.semanticSpec.title})),Fe(a,this.materializationConfigs.theme)});function Tt(t){fe((e,n)=>{const i=x(e),s=i.semanticSpec.title.text===void 0?i:i.removeTitle(),{program:o,plan:d}=pe(s,n),c=e.compositionSpec,p=new e.constructor({...o,semanticSpec:{...o.semanticSpec,title:e.semanticSpec.title},graphicSpec:e.graphicSpec,children:e.children,materializationConfigs:{...o.materializationConfigs,facets:e.materializationConfigs.facets,...e.titleConfig===void 0?{}:{title:e.titleConfig}},actionSequence:o._actionSequence,compositionSpec:{...c,facet:{...c.facet,data:d.replacements.get(c.facet.data)??c.facet.data}}});return M(p,c.facet)}),t.prototype.replayDerivedData=ve,t.prototype.composeFacetGuides=Ce,t.prototype.facet=Me,t.prototype.facetGrid=Ie,t.prototype.repeatCharts=Ge,t.prototype.editFacetHeaders=Ne,t.prototype.editFacetScales=He,t.prototype.editFacetGuides=Ue,t.prototype.editFacetSource=Ke}export{Ue as editFacetGuides,Ne as editFacetHeaders,He as editFacetScales,Ke as editFacetSource,Me as facet,Ie as facetGrid,x as facetUnitTemplate,Tt as registerFacetActions,Ge as repeatCharts};

package/src/actions/guides/axes/axes.js

@@ -156,7 +156,7 @@ function resolvePolarAxisArgs(program, layers, channel, option, descriptor) {
 }
 
 function hasChannel(layers, channel) {
-  return layers.some(layer => layer.encoding?.[channel] !== undefined);
+  return layers.some(layer => layer.encoding?.[channel] !== undefined && !(layer.mark?.type === "tick" && Object.hasOwn(layer.encoding[channel], "datum")));
 }
 
 function resolveAxisArgs(layers, channel, option) {
@@ -170,6 +170,7 @@ function resolveAxisArgs(layers, channel, option) {
   const encodedScaleIds = [
     ...new Set(
       layers
+        .filter(layer => !(layer.mark?.type === "tick" && Object.hasOwn(layer.encoding?.[channel] ?? {}, "datum")))
         .map(layer => layer.encoding?.[channel]?.scale)
         .filter(id => id !== undefined)
     )

package/src/actions/guides/axes/components.js

@@ -1,4 +1,5 @@
 import { axisGraphicIds } from "../../../materialization/guides/resources.js";
+import { isLabelRelativeTitleOffset } from "../../../grammar/axisTextPlacement.js";
 
 export const AXIS_COMPONENTS = Object.freeze(["line", "ticks", "labels", "title"]);
 
@@ -31,6 +32,10 @@ export function assertRemovableAxisComponent(program, channel, component, operat
 }
 
 export function removeAxisComponent(program, channel, component, axisId = channel) {
+  if (component === "labels" && isLabelRelativeTitleOffset(program.guideConfigs.axis?.[axisId]?.title?.offset) &&
+      program.context.pendingRelativeTitleAxis !== axisId) {
+    throw new Error("Remove the label-relative axis title together with its labels.");
+  }
   const id = axisComponentId(channel, component, axisId);
   let next = program;
   if (component === "title" && next.semanticSpec.guides.axis?.[axisId]?.title !== undefined) {

package/src/actions/guides/axes/edit.js

@@ -1,188 +1 @@
-import { selectCartesianAxis, axisTargetArgs, assertCartesianAxisSideAvailable } from "../../../selectors/axes.js";
-import { validateAxisPosition, resolveAxisFrameConfig } from "./policy.js";
-import { withGuideLayoutValidation } from "../../../materialization/guides/layout.js";
-import { action } from "../../../core/action.js";
-import { isPlainObject } from "../../../core/immutable.js";
-import { validateKeys, validateOptionObject, validateNonNegativeFinite } from "../../../core/validation.js";
-
-import {
-  AXIS_COMPONENTS,
-  axisComponentId as graphicId,
-  hasAxisComponent as hasComponent,
-  assertRemovableAxisComponent as assertRemovable,
-  removeAxisComponent as removeComponent
-} from "./components.js";
-
-const OPTIONS = Object.freeze([
-  "target", "position", "line", "ticks", "labels", "ticksAndLabels", "title", "offset", "underlay"
-]);
-const LINE_OPTIONS = Object.freeze(["color", "lineWidth"]);
-const TICK_OPTIONS = Object.freeze([
-  "count", "values", "rounding", "length", "color", "lineWidth", "alongOffset", "strokeDash", "strokeDashMap"
-]);
-const LABEL_OPTIONS = Object.freeze([
-  "count", "values", "rounding", "offset", "format", "color", "fontSize",
-  "fontFamily", "fontWeight", "rotation", "maxWidth", "wrap",
-  "lineHeight", "overlap", "alongOffset", "labelMap", "flush", "colorMap", "align"
-]);
-const GROUP_OPTIONS = Object.freeze(["count", "values", "rounding", "ticks", "labels"]);
-const TITLE_OPTIONS = Object.freeze([
-  "text", "at", "offset", "rotation", "color", "fontSize",
-  "fontFamily", "fontWeight", "alongOffset", "align", "baseline", "overlap"
-]);
-
-function validateNested(args, key, options, operation, { allowFalse = false } = {}) {
-  if (!Object.hasOwn(args, key)) return;
-  if (allowFalse && args[key] === false) return;
-  if (!isPlainObject(args[key])) {
-    const accepted = allowFalse ? "false or a plain object" : "a plain object";
-    throw new TypeError(`${operation}.${key} must be ${accepted}.`);
-  }
-  validateKeys(args[key], options, `${operation}.${key}`);
-}
-
-function validateArgs(args, operation) {
-  if (Object.hasOwn(args, "offset")) validateNonNegativeFinite(args.offset, "Axis frame offset");
-  resolveAxisFrameConfig(undefined, args);
-  validateOptionObject(args, OPTIONS, operation, {
-    allowEmpty: false,
-    emptyMessage: `${operation} requires at least one axis change.`,
-    emptyError: Error
-  });
-  const removable = { allowFalse: true };
-  validateNested(args, "line", LINE_OPTIONS, operation, removable);
-  validateNested(args, "ticks", TICK_OPTIONS, operation, removable);
-  validateNested(args, "labels", LABEL_OPTIONS, operation, removable);
-  validateNested(args, "ticksAndLabels", GROUP_OPTIONS, operation, removable);
-  validateNested(args, "title", TITLE_OPTIONS, operation, removable);
-  if (args.ticksAndLabels !== undefined && (
-    args.ticks !== undefined || args.labels !== undefined
-  )) {
-    throw new Error(
-      `${operation} cannot combine ticksAndLabels with ticks or labels.`
-    );
-  }
-  if (args.ticksAndLabels !== false && args.ticksAndLabels?.ticks !== undefined) {
-    validateNested(args.ticksAndLabels, "ticks", ["length", "color", "lineWidth", "alongOffset", "strokeDash", "strokeDashMap"], `${operation}.ticksAndLabels`);
-  }
-  if (args.ticksAndLabels !== false && args.ticksAndLabels?.labels !== undefined) {
-    validateNested(args.ticksAndLabels, "labels", [
-      "offset", "format", "color", "fontSize", "fontFamily", "fontWeight",
-      "rotation", "maxWidth", "wrap", "lineHeight", "overlap", "alongOffset", "labelMap", "flush", "colorMap", "align"
-    ], `${operation}.ticksAndLabels`);
-  }
-}
-
-function names(channel) {
-  const prefix = channel === "x" ? "X" : "Y";
-  return {
-    operation: `edit${prefix}Axis`,
-    line: `edit${prefix}AxisLine`,
-    ticks: `edit${prefix}AxisTicks`,
-    labels: `edit${prefix}AxisLabels`,
-    group: `edit${prefix}AxisTicksAndLabels`,
-    title: `edit${prefix}AxisTitle`,
-    remove: `remove${prefix}Axis`
-  };
-}
-
-function buildPlan(program, channel, args, operation, axisId = channel) {
-  const shared = { ...axisTargetArgs(axisId, channel),
-    ...(Object.hasOwn(args, "position") ? { position: args.position } : {}) };
-  const plan = [];
-  const addLeaf = (component, edit) => {
-    const value = args[component];
-    if (value === false) {
-      assertRemovable(program, channel, component, operation.operation, axisId);
-      plan.push({ kind: "remove", component });
-    } else if (value !== undefined) {
-      plan.push({ kind: "edit", operation: edit, args: { ...shared, ...value } });
-    } else if ((args.position !== undefined || Object.hasOwn(args, "offset") || Object.hasOwn(args, "underlay")) && hasComponent(program, channel, component, axisId)) {
-      plan.push({ kind: "edit", operation: edit, args: shared });
-    }
-  };
-
-  addLeaf("line", operation.line);
-  if (args.ticksAndLabels === false) {
-    assertRemovable(program, channel, "ticks", operation.operation, axisId);
-    assertRemovable(program, channel, "labels", operation.operation, axisId);
-    plan.push(
-      { kind: "remove", component: "ticks" },
-      { kind: "remove", component: "labels" }
-    );
-  } else if (args.ticksAndLabels !== undefined) {
-    plan.push({
-      kind: "edit",
-      operation: operation.group,
-      args: { ...shared, ...args.ticksAndLabels }
-    });
-  } else {
-    addLeaf("ticks", operation.ticks);
-    addLeaf("labels", operation.labels);
-  }
-  addLeaf("title", operation.title);
-
-  if (plan.length === 0) {
-    throw new Error(`${operation.operation} requires an existing ${channel}-axis component.`);
-  }
-  return plan;
-}
-
-function applyPlan(program, channel, plan, operation, axisId = channel) {
-  let next = program;
-  for (const step of plan) {
-    next = step.kind === "remove"
-      ? removeComponent(next, channel, step.component, axisId)
-      : next[step.operation](step.args);
-  }
-
-  const hasRetainedGraphic = AXIS_COMPONENTS.some(
-    component => next.graphicSpec.objects[graphicId(channel, component, axisId)] !== undefined
-  );
-  if (!hasRetainedGraphic && (
-    next.semanticSpec.guides.axis?.[axisId] !== undefined ||
-    next.guideConfigs.axis?.[axisId] !== undefined
-  )) {
-    next = next[operation.remove](axisId === channel ? undefined : axisTargetArgs(axisId, channel));
-  }
-  return next;
-}
-
-function makeEditAxis(channel) {
-  const operation = names(channel);
-  return action(
-    {
-      op: operation.operation,
-      description: `Edit selected existing ${channel}-axis components.`
-    },
-    withGuideLayoutValidation(function (args = {}) {
-      validateArgs(args, operation.operation);
-      const selected = selectCartesianAxis(this, channel, args, { whole: true });
-      const axisId = selected.id; args = selected.options;
-      let source = this;
-      if (selected.owner?.named && args.position !== undefined) {
-        const position = validateAxisPosition(channel, args.position);
-        assertCartesianAxisSideAvailable(this, { id: axisId, channel,
-          coordinate: selected.owner.coordinate, position });
-        source = source.editSemantic({ property: `guide.axis.${axisId}.position`, value: position });
-      }
-      const frame = resolveAxisFrameConfig(source.guideConfigs.axis?.[axisId]?.frame, args);
-      source = frame === undefined ? source._withoutMaterializationConfig(["guides", "axis", axisId, "frame"])
-        : source._withGuideConfig(axisId, "frame", frame);
-      const plan = buildPlan(source, channel, args, operation, axisId);
-
-      // Run the complete proposal against an immutable speculative branch so a
-      // later leaf failure cannot begin the returned action trace or state.
-      applyPlan(source, channel, plan, operation, axisId);
-      return applyPlan(source, channel, plan, operation, axisId);
-    })
-  );
-}
-
-const editXAxis = /* @__PURE__ */ makeEditAxis("x");
-const editYAxis = /* @__PURE__ */ makeEditAxis("y");
-
-export function registerCompleteAxisEditActions(ProgramClass) {
-  ProgramClass.prototype.editXAxis = editXAxis;
-  ProgramClass.prototype.editYAxis = editYAxis;
-}
+import{splitGuideVisibility as L,patchGuideVisibility as T}from"../../../materialization/guides/visibility.js";import{resolveAxisTickEditConfig as w}from"./ticks.js";import{resolveAxisLabelEditConfig as C}from"./labels.js";import{validateAxisTickGroupEditConfig as $}from"./tickGroups.js";import{selectCartesianAxis as j,axisTargetArgs as A,assertCartesianAxisSideAvailable as y}from"../../../selectors/axes.js";import{validateAxisPosition as E,resolveAxisFrameConfig as h}from"./policy.js";import{withGuideLayoutValidation as S,withPendingRelativeAxisTitle as N}from"../../../materialization/guides/layout.js";import{action as P}from"../../../core/action.js";import{applyMaterializationPlan as g}from"../../../materialization/planner.js";import{isPlainObject as u}from"../../../core/immutable.js";import{isLabelRelativeTitleOffset as O}from"../../../grammar/axisTextPlacement.js";import{validateKeys as z,validateOptionObject as M,validateNonNegativeFinite as G}from"../../../core/validation.js";import{AXIS_COMPONENTS as R,axisComponentId as W,hasAxisComponent as _,assertRemovableAxisComponent as m,removeAxisComponent as F}from"./components.js";const D=Object.freeze(["target","position","line","ticks","labels","ticksAndLabels","title","offset","underlay"]),X=Object.freeze(["color","lineWidth"]),V=Object.freeze(["count","values","rounding","length","color","lineWidth","alongOffset","strokeDash","strokeDashMap"]),Y=Object.freeze(["count","values","rounding","offset","format","color","fontSize","fontFamily","fontWeight","rotation","maxWidth","wrap","lineHeight","overlap","alongOffset","labelMap","flush","flushThreshold","colorMap","align"]),q=Object.freeze(["count","values","rounding","ticks","labels"]),H=Object.freeze(["text","at","offset","rotation","color","fontSize","fontFamily","fontWeight","alongOffset","align","baseline","overlap"]);function a(e,i,t,l,{allowFalse:s=!1}={}){if(Object.hasOwn(e,i)&&!(s&&e[i]===!1)){if(!u(e[i])){const f=s?"false or a plain object":"a plain object";throw new TypeError(`${l}.${i} must be ${f}.`)}z(e[i],t,`${l}.${i}`)}}function v(e,i){Object.hasOwn(e,"offset")&&G(e.offset,"Axis frame offset"),h(void 0,e),M(e,D,i,{allowEmpty:!1,emptyMessage:`${i} requires at least one axis change.`,emptyError:Error});const t={allowFalse:!0};if(a(e,"line",X,i,t),a(e,"ticks",V,i,t),a(e,"labels",Y,i,t),a(e,"ticksAndLabels",q,i,t),a(e,"title",H,i,t),e.ticksAndLabels!==void 0&&(e.ticks!==void 0||e.labels!==void 0))throw new Error(`${i} cannot combine ticksAndLabels with ticks or labels.`);e.ticksAndLabels!==!1&&e.ticksAndLabels?.ticks!==void 0&&a(e.ticksAndLabels,"ticks",["length","color","lineWidth","alongOffset","strokeDash","strokeDashMap"],`${i}.ticksAndLabels`),e.ticksAndLabels!==!1&&e.ticksAndLabels?.labels!==void 0&&a(e.ticksAndLabels,"labels",["offset","format","color","fontSize","fontFamily","fontWeight","rotation","maxWidth","wrap","lineHeight","overlap","alongOffset","labelMap","flush","flushThreshold","colorMap","align"],`${i}.ticksAndLabels`)}function K(e){const i=e==="x"?"X":"Y";return{operation:`edit${i}Axis`,line:`edit${i}AxisLine`,ticks:`edit${i}AxisTicks`,labels:`edit${i}AxisLabels`,group:`edit${i}AxisTicksAndLabels`,title:`edit${i}AxisTitle`,remove:`remove${i}Axis`}}function B(e,i,t,l){u(t.ticks)&&w(e,i,t.ticks,l),u(t.labels)&&C(e,i,t.labels,l),u(t.ticksAndLabels)&&$(e,i,t.ticksAndLabels,l)}function U(e,i,t,l,s=i){const f={...A(s,i),...Object.hasOwn(t,"position")?{position:t.position}:{}},n=[],d=(c,o)=>{const r=t[c];r===!1?(m(e,i,c,l.operation,s),n.push({kind:"remove",component:c})):r!==void 0?n.push({kind:"edit",operation:o,args:{...f,...r}}):(t.position!==void 0||Object.hasOwn(t,"offset")||Object.hasOwn(t,"underlay"))&&_(e,i,c,s)&&n.push({kind:"edit",operation:o,args:f})};if(d("line",l.line),t.ticksAndLabels===!1?(m(e,i,"ticks",l.operation,s),m(e,i,"labels",l.operation,s),n.push({kind:"remove",component:"ticks"},{kind:"remove",component:"labels"})):t.ticksAndLabels!==void 0?n.push({kind:"edit",operation:l.group,args:{...f,...t.ticksAndLabels}}):(d("ticks",l.ticks),d("labels",l.labels)),d("title",l.title),n.length===0)throw new Error(`${l.operation} requires an existing ${i}-axis component.`);return n}function p(e,i,t,l,s=i){if(O(e.guideConfigs.axis?.[s]?.title?.offset)&&t.some(o=>o.kind==="edit"&&o.operation===l.title)&&e.context.pendingRelativeTitleAxis!==s)return N(e,s,o=>p(o,i,t,l,s));let n=e;const d=O(e.guideConfigs.axis?.[s]?.title?.offset)&&t.some(o=>o.kind==="remove"&&o.component==="title")?[...t.filter(o=>o.kind==="remove"&&o.component==="title"),...t.filter(o=>!(o.kind==="remove"&&o.component==="title"))]:t;for(let o=0;o<d.length;){const r=d[o];if(r.kind==="remove"){n=F(n,i,r.component,s),o+=1;continue}const b=[];for(;o<d.length&&d[o].kind==="edit";){const k=d[o++];b.push({op:k.operation,args:k.args})}n=g(n,b)}return!R.some(o=>n.graphicSpec.objects[W(i,o,s)]!==void 0)&&(n.semanticSpec.guides.axis?.[s]!==void 0||n.guideConfigs.axis?.[s]!==void 0)&&(n=n[l.remove](s===i?void 0:A(s,i))),n}function x(e){const i=K(e);return P({op:i.operation,description:`Edit selected existing ${e}-axis components.`},S(function(t={}){const l=L(t);t=l.args,Object.keys(t).some(o=>o!=="target")&&v(t,i.operation);const s=j(this,e,t,{whole:!0}),f=s.id;t=s.options,B(this,e,t,f);let n=T(this,"axis",f,l.visibility);if(!Object.keys(t).some(o=>o!=="target"))return Object.keys(l.visibility).length||v(t,i.operation),n;if(s.owner?.named&&t.position!==void 0){const o=E(e,t.position);y(this,{id:f,channel:e,coordinate:s.owner.coordinate,position:o}),n=n.editSemantic({property:`guide.axis.${f}.position`,value:o})}const d=h(n.guideConfigs.axis?.[f]?.frame,t);n=d===void 0?n._withoutMaterializationConfig(["guides","axis",f,"frame"]):n._withGuideConfig(f,"frame",d);const c=U(n,e,t,i,f);return p(n,e,c,i,f),p(n,e,c,i,f)}))}const J=x("x"),Q=x("y");function re(e){e.prototype.editXAxis=J,e.prototype.editYAxis=Q}export{re as registerCompleteAxisEditActions};