ggaction 0.0.21 → 0.0.23

package/src/grammar/transformTopology.js

@@ -8,12 +8,14 @@ const TRANSFORM_TOPOLOGY = Object.freeze({
   density: Object.freeze({ facetTopology: "statistical" }),
   ecdf: Object.freeze({ facetTopology: "statistical" }),
   filter: Object.freeze({ facetTopology: "rowPreserving" }),
+  flatten: Object.freeze({ facetTopology: "statistical" }),
+  lookup: Object.freeze({ facetTopology: "rowPreserving" }),
   fold: Object.freeze({ facetTopology: "statistical" }),
   gradientProfile: Object.freeze({ facetTopology: "statistical" }),
   horizon: Object.freeze({ facetTopology: "statistical" }),
   interval: Object.freeze({ facetTopology: "statistical" }),
   impute: Object.freeze({ facetTopology: "statistical" }),
-  markFilter: Object.freeze({ provenanceTransparent: true }),
+  markFilter: Object.freeze({ provenanceTransparent: true, facetTopology: "statistical" }),
   normalize: Object.freeze({ facetTopology: "statistical" }),
   regression: Object.freeze({ facetTopology: "statistical" }),
   regressionStatistics: Object.freeze({ facetTopology: "statistical" }),

package/src/grammar/transforms.js

@@ -29,6 +29,8 @@ import {
   validateFilterTransform
 } from "./filter.js";
 import { normalizeFoldTransform, validateFoldTransform } from "./fold.js";
+import { normalizeFlattenTransform, validateFlattenTransform } from "./flatten.js";
+import {normalizeLookupTransform,validateLookupTransform} from "./lookup.js";
 import {
   requestedGradientProfileTransform,
   validateGradientProfileTransform
@@ -381,6 +383,28 @@ const TRANSFORM_POLICIES = Object.freeze({
     normalizeEdit: normalizeFilterTransformEdit,
     outputRoles: () => ({})
   }),
+  flatten: Object.freeze({
+    ...findTransformTopology("flatten"),
+    validate: validateFlattenTransform,
+    materializeOp: "materializeFlattenData",
+    replayTransform: requestedTransform,
+    editable: true,
+    normalizeEdit: normalizeSimple(normalizeFlattenTransform),
+    outputRoles: transform => Object.fromEntries(
+      transform.fields.map((field, index) => [`value:${field}`, transform.as[index]])
+    )
+  }),
+  lookup: Object.freeze({
+    ...findTransformTopology("lookup"),
+    validate:validateLookupTransform,
+    materializeOp:"materializeLookupData",
+    replayTransform:requestedTransform,
+    editable:true,
+    normalizeEdit:normalizeSimple(normalizeLookupTransform),
+    outputRoles:transform=>Object.fromEntries(transform.lookup.fields.map((field,index)=>[
+      `value:${field}`,transform.lookup.as[index]
+    ]))
+  }),
   fold: Object.freeze({
     ...findTransformTopology("fold"),
     validate: validateFoldTransform,

package/src/inspection.js

@@ -1,495 +1 @@
-import { ChartProgram } from "./ChartProgram.js";
-import { BasicChartProgram } from "./BasicChartProgram.js";
-import { getWrappedActionMetadata } from "./core/action.js";
-import { cloneAndFreeze, isPlainObject } from "./core/immutable.js";
-import { encodeValue } from "./persistence/codec.js";
-import {
-  findDataset,
-  hasDatasetOwner,
-  resolveDatasetReference
-} from "./selectors/datasets.js";
-import { findLayer } from "./selectors/layers.js";
-import { findSemanticScale } from "./selectors/scales.js";
-import { findCoordinate } from "./selectors/coordinates.js";
-import { inferDatasetSchema } from "./grammar/datasetSchema.js";
-import { BUILTIN_ACTION_DESCRIPTOR_RECORDS } from "./inspectionDescriptors.js";
-
-const KINDS = new Set(["data", "mark", "scale", "coordinate", "guide"]);
-const ACTION_DESCRIPTORS = new Map(BUILTIN_ACTION_DESCRIPTOR_RECORDS.map(
-  ([name, options, idOptions, prerequisites, entryPoints]) => [name, {
-    options: options.map(([path, required, kind, choices, unit]) => ({
-      path, required, kind,
-      ...(choices === null ? {} : { choices }),
-      ...(unit === null ? {} : { unit })
-    })),
-    idOptions,
-    prerequisites,
-    entryPoints
-  }]
-));
-
-function requireProgram(program, label = "Program") {
-  if (!(program instanceof ChartProgram || program instanceof BasicChartProgram)) {
-    throw new TypeError(`${label} must be a ggaction program.`);
-  }
-  if (program.actionStack.length !== 0) throw new Error(`${label} must have a closed action stack.`);
-  return program;
-}
-
-function atChildPath(program, childPath = []) {
-  if (!Array.isArray(childPath)) throw new TypeError("childPath must be an array.");
-  let current = program;
-  for (const id of childPath) {
-    if (typeof id !== "string" || !Object.hasOwn(current.children, id)) {
-      throw new Error(`Unknown program child "${String(id)}".`);
-    }
-    current = current.children[id];
-  }
-  return current;
-}
-
-function validateTarget(target) {
-  if (!isPlainObject(target) || !KINDS.has(target.kind) || typeof target.id !== "string" || target.id.length === 0) {
-    throw new TypeError("Inspection target requires a supported kind and non-empty id.");
-  }
-  return target;
-}
-
-function findResource(program, target) {
-  const current = atChildPath(program, target.childPath);
-  if (target.kind === "data") {
-    return hasDatasetOwner(current, target.id)
-      ? resolveDatasetReference(current, target.id, "Inspection target")
-      : findDataset(current, target.id);
-  }
-  if (target.kind === "mark") return findLayer(current, target.id);
-  if (target.kind === "scale") return findSemanticScale(current, target.id);
-  if (target.kind === "coordinate") return findCoordinate(current, target.id);
-  return current.semanticSpec.guides[target.id];
-}
-
-function resourceRef(kind, id, childPath) {
-  return { kind, id, ...(childPath?.length ? { childPath: [...childPath] } : {}) };
-}
-
-export function getDatasetSchema(program, { data, childPath } = {}) {
-  requireProgram(program);
-  const current = atChildPath(program, childPath);
-  if (typeof data !== "string" || data.length === 0) throw new TypeError("getDatasetSchema requires data.");
-  const dataset = resolveDatasetReference(current, data, "Dataset schema data");
-  const schema = dataset.schema ?? inferDatasetSchema(dataset.values ?? []);
-  return cloneAndFreeze({ data: dataset.id, schema });
-}
-
-export function describeAction(program, { action, target, options = {} } = {}) {
-  requireProgram(program);
-  if (typeof action !== "string" || action.length === 0) throw new TypeError("describeAction requires action.");
-  if (!isPlainObject(options)) throw new TypeError("describeAction options must be a plain object.");
-  let targetResource;
-  if (target !== undefined) {
-    validateTarget(target);
-    targetResource = findResource(program, target);
-    if (targetResource === undefined) {
-      return cloneAndFreeze({
-        version: 1, action, applicability: "incompatible", parameterDefinitions: [], requirements: [],
-        checks: [{ name: "target", status: "failed", evidencePaths: [], findings: [] }],
-        findings: [{ severity: "error", code: "missing-resource", reason: "target-unavailable", message: `Unknown ${target.kind} "${target.id}".`, resource: resourceRef(target.kind, target.id, target.childPath) }]
-      });
-    }
-    if (options.target !== undefined && options.target !== target.id) {
-      return cloneAndFreeze({
-        version: 1, action, applicability: "incompatible", parameterDefinitions: [], requirements: [],
-        checks: [{ name: "target", status: "failed", evidencePaths: ["target"], findings: [] }],
-        findings: [{ severity: "error", code: "incompatible-resource", reason: "target-mismatch", message: `Inspection target "${target.id}" conflicts with options.target "${options.target}".`, resource: resourceRef(target.kind, target.id, target.childPath), optionPath: "target" }]
-      });
-    }
-    if (action === "encodeShape" && (target.kind !== "mark" || targetResource.mark?.type !== "point")) {
-      return cloneAndFreeze({
-        version: 1, action, applicability: "unsupported", parameterDefinitions: [], requirements: [],
-        checks: [{ name: "target", status: "not_applicable", evidencePaths: ["target"], findings: [] }],
-        findings: [{ severity: "info", code: "unsupported-combination", reason: "mark-type", message: "encodeShape supports Point marks.", resource: resourceRef(target.kind, target.id, target.childPath) }]
-      });
-    }
-  }
-  const fn = program[action];
-  const metadata = typeof fn === "function" ? getWrappedActionMetadata(fn) : undefined;
-  if (metadata === undefined) {
-    return cloneAndFreeze({
-      version: 1, action, applicability: typeof fn === "function" ? "unverified" : "unsupported",
-      parameterDefinitions: [], requirements: [], checks: [], findings: [{ severity: "info", code: "unsupported-format", reason: typeof fn === "function" ? "extension-unverified" : "action-unavailable", message: `Action "${action}" has no built-in inspection descriptor.` }]
-    });
-  }
-  const descriptor = ACTION_DESCRIPTORS.get(action);
-  const optionNames = metadata.options ?? descriptor?.options.map(option => option.path);
-  if (optionNames === undefined) {
-    return cloneAndFreeze({
-      version: 1, action, applicability: "unverified", parameterDefinitions: [], requirements: [],
-      checks: [{ name: "execution", status: "not_run", evidencePaths: [], findings: [] }],
-      findings: [{ severity: "info", code: "unsupported-format", reason: "descriptor-unavailable", message: `Action "${action}" is registered but its static option descriptor is unavailable.` }]
-    });
-  }
-  const unknown = Object.keys(options).find(key => !optionNames.includes(key));
-  const required = descriptor?.options.filter(option => option.required).map(option => option.path) ?? [];
-  const missing = required.filter(key => options[key] === undefined);
-  let fieldFinding = [];
-  if (targetResource !== undefined && target.kind === "mark") {
-    const schema = getDatasetSchema(program, {
-      data: targetResource.data,
-      childPath: target.childPath
-    }).schema;
-    if (schema.completeness === "known") {
-      const fields = new Set(schema.fields.map(field => field.name));
-      fieldFinding = (descriptor?.options ?? [])
-        .filter(definition => definition.kind === "field" &&
-          typeof options[definition.path] === "string" &&
-          !fields.has(options[definition.path]))
-        .map(definition => ({
-          severity: "error",
-          code: "missing-resource",
-          reason: "field-unavailable",
-          message: `Dataset does not contain field "${options[definition.path]}".`,
-          resource: resourceRef("data", targetResource.data, target.childPath),
-          optionPath: definition.path
-        }));
-    }
-  }
-  const finding = unknown !== undefined
-    ? [{ severity: "error", code: "invalid-option", reason: "unknown-option", message: `Unknown ${action} option "${unknown}".`, optionPath: unknown }]
-    : [...missing.map(key => ({ severity: "info", code: "missing-input", reason: "required-option", message: `${action} requires option "${key}".`, optionPath: key })), ...fieldFinding];
-  const applicability = unknown !== undefined || fieldFinding.length ? "incompatible" : missing.length ? "needs-input" : "supported";
-  return cloneAndFreeze({
-    version: 1,
-    action,
-    applicability,
-    parameterDefinitions: descriptor?.options.map(definition => ({
-      ...definition,
-      active: true
-    })) ?? optionNames.map(path => ({ path, kind: "object", required: false, active: true })),
-    requirements: missing.map(optionPath => ({ reason: "required-option", optionPath })),
-    checks: [
-      { name: "option-shape", status: unknown === undefined ? "passed" : "failed", evidencePaths: Object.keys(options), findings: unknown === undefined ? [] : finding },
-      { name: "execution", status: "not_run", evidencePaths: [], findings: [] }
-    ],
-    findings: finding
-  });
-}
-
-function canonicalInput(value) {
-  if (Array.isArray(value)) return value.map(canonicalInput);
-  if (!isPlainObject(value)) return value;
-  return Object.fromEntries(Object.keys(value).sort().map(
-    key => [key, canonicalInput(value[key])]
-  ));
-}
-
-function canonical(value) {
-  return JSON.stringify(encodeValue(canonicalInput(value)));
-}
-
-function resources(program, childPath = [], output = []) {
-  for (const value of program.semanticSpec.datasets) output.push({ ref: resourceRef("data", value.id, childPath), value });
-  for (const [orderIndex, value] of program.semanticSpec.layers.entries()) output.push({
-    ref: resourceRef("mark", value.id, childPath),
-    value: { semantic: value, graphic: program.graphicSpec.objects[value.id], config: program.markConfigs[value.id], orderIndex }
-  });
-  for (const value of program.semanticSpec.scales) output.push({ ref: resourceRef("scale", value.id, childPath), value: { semantic: value, resolved: program.resolvedScales[value.id] } });
-  for (const value of program.semanticSpec.coordinates) output.push({ ref: resourceRef("coordinate", value.id, childPath), value });
-  for (const [id, value] of Object.entries(program.semanticSpec.guides)) output.push({ ref: resourceRef("guide", id, childPath), value: { semantic: value, graphic: program.graphicSpec.objects[id], config: program.guideConfigs[id] } });
-  if (Object.keys(program.semanticSpec.title).length) output.push({ ref: resourceRef("guide", "title", childPath), value: { semantic: program.semanticSpec.title, config: program.guideConfigs.title } });
-  if (program.graphicSpec.objects.canvas !== undefined) output.push({
-    ref: resourceRef("canvas", "canvas", childPath),
-    value: program.graphicSpec.objects.canvas
-  });
-  if (Object.keys(program.compositionSpec ?? {}).length > 0) output.push({
-    ref: resourceRef("composition", "layout", childPath),
-    value: program.compositionSpec
-  });
-  for (const [id, child] of Object.entries(program.children)) resources(child, [...childPath, id], output);
-  return output;
-}
-
-function refKey(ref) { return `${ref.childPath?.join("/") ?? ""}|${ref.kind}|${ref.id}`; }
-function effect(kind) { return kind === "data" ? "data" : kind === "scale" ? "scale" : kind === "guide" ? "guide" : ["coordinate", "canvas", "composition"].includes(kind) ? "structure" : "style"; }
-function changeEffect(a, b, kind) {
-  if (kind !== "mark" || a === undefined || b === undefined) return effect(kind);
-  if (a.value.orderIndex !== b.value.orderIndex) return "structure";
-  if (canonical(a.value.semantic?.encoding) !== canonical(b.value.semantic?.encoding) ||
-      a.value.semantic?.data !== b.value.semantic?.data) return "binding";
-  if (canonical(a.value.semantic) !== canonical(b.value.semantic)) return "structure";
-  return "style";
-}
-
-export function comparePrograms(before, after, { target } = {}) {
-  requireProgram(before, "Before program");
-  requireProgram(after, "After program");
-  if (target !== undefined) validateTarget(target);
-  const left = new Map(resources(before).map(item => [refKey(item.ref), item]));
-  const right = new Map(resources(after).map(item => [refKey(item.ref), item]));
-  const keys = [...new Set([...left.keys(), ...right.keys()])].sort();
-  let changes = keys.flatMap(key => {
-    const a = left.get(key); const b = right.get(key); const item = a ?? b;
-    if (a !== undefined && b !== undefined && canonical(a.value) === canonical(b.value)) return [];
-    const semanticRoles = item.ref.kind === "mark" && a !== undefined && b !== undefined
-      ? [...new Set([...Object.keys(a.value.semantic?.encoding ?? {}), ...Object.keys(b.value.semantic?.encoding ?? {})])]
-        .filter(role => canonical(a.value.semantic?.encoding?.[role]) !== canonical(b.value.semantic?.encoding?.[role]))
-      : [];
-    return [{ resource: item.ref, operation: a === undefined ? "add" : b === undefined ? "remove" : "modify", effect: changeEffect(a, b, item.ref.kind), roles: semanticRoles }];
-  });
-  if (target !== undefined) {
-    const targetKeys = [before, after].flatMap(candidate => {
-      const resolved = findResource(candidate, target);
-      return resolved === undefined ? [] : [refKey(resourceRef(
-        target.kind,
-        target.kind === "data" ? resolved.id : target.id,
-        target.childPath
-      ))];
-    });
-    if (targetKeys.length === 0) throw new Error(`Unknown ${target.kind} "${target.id}" in both programs.`);
-    const connected = new Set(targetKeys);
-    for (const map of [left, right]) {
-      let advanced = true;
-      while (advanced) {
-        advanced = false;
-        for (const [candidateKey, candidate] of map) {
-          if (connected.has(candidateKey)) continue;
-          const path = canonical(candidate.ref.childPath ?? []);
-          const consumes = [...connected].some(connectedKey => {
-            const source = map.get(connectedKey);
-            if (source === undefined || canonical(source.ref.childPath ?? []) !== path) return false;
-            if (source.ref.kind === "data") {
-              return candidate.ref.kind === "data"
-                ? candidate.value.source === source.ref.id
-                : candidate.ref.kind === "mark" && candidate.value.semantic?.data === source.ref.id;
-            }
-            if (source.ref.kind === "mark") {
-              return (candidate.ref.kind === "mark" && candidate.value.semantic?.source === source.ref.id) ||
-                (candidate.ref.kind === "guide" && (candidate.value.semantic?.target === source.ref.id || candidate.value.config?.target === source.ref.id));
-            }
-            if (source.ref.kind === "scale") {
-              return (candidate.ref.kind === "mark" && Object.values(candidate.value.semantic?.encoding ?? {}).some(
-                encoding => encoding?.scale === source.ref.id || encoding?.dimensions?.some(dimension => dimension.scale === source.ref.id)
-              )) || (candidate.ref.kind === "guide" && (candidate.value.semantic?.scale === source.ref.id || candidate.value.config?.scale === source.ref.id));
-            }
-            return source.ref.kind === "coordinate" && candidate.ref.kind === "mark" &&
-              candidate.value.semantic?.coordinate === source.ref.id;
-          });
-          if (consumes) { connected.add(candidateKey); advanced = true; }
-        }
-      }
-    }
-    changes = changes.filter(change => connected.has(refKey(change.resource)));
-  }
-  const extensionUnknown = ![ChartProgram, BasicChartProgram].includes(before.constructor) ||
-    ![ChartProgram, BasicChartProgram].includes(after.constructor);
-  const findings = extensionUnknown ? [{
-    severity: "info", code: "unsupported-format", reason: "extension-unverified",
-    message: "Extension-owned semantic equivalence could not be fully verified."
-  }] : [];
-  return cloneAndFreeze({
-    version: 1,
-    equivalence: changes.length ? "different" : extensionUnknown ? "unknown" : "equal",
-    completeProgramComparison: target === undefined,
-    changes,
-    affected: changes.map(change => change.resource),
-    findings
-  });
-}
-
-function itemBounds(properties, type) {
-  if (!isPlainObject(properties)) return null;
-  if (type === "circle") {
-    if (!Number.isFinite(properties.x) || !Number.isFinite(properties.y) ||
-        !Number.isFinite(properties.radius) || properties.radius < 0) return null;
-    return { x: properties.x - properties.radius, y: properties.y - properties.radius,
-      width: properties.radius * 2, height: properties.radius * 2 };
-  }
-  if (type === "rect") {
-    if (![properties.x, properties.y, properties.width, properties.height].every(Number.isFinite)) return null;
-    return { x: Math.min(properties.x, properties.x + properties.width),
-      y: Math.min(properties.y, properties.y + properties.height),
-      width: Math.abs(properties.width), height: Math.abs(properties.height) };
-  }
-  if (type === "path" && Array.isArray(properties.commands)) {
-    const points = properties.commands.flatMap(command =>
-      Number.isFinite(command.x) && Number.isFinite(command.y) ? [[command.x, command.y]] : []
-    );
-    if (points.length === 0) return null;
-    const xs = points.map(point => point[0]);
-    const ys = points.map(point => point[1]);
-    return { x: Math.min(...xs), y: Math.min(...ys),
-      width: Math.max(...xs) - Math.min(...xs), height: Math.max(...ys) - Math.min(...ys) };
-  }
-  if ([properties.x1, properties.y1, properties.x2, properties.y2].every(Number.isFinite)) {
-    return { x: Math.min(properties.x1, properties.x2), y: Math.min(properties.y1, properties.y2),
-      width: Math.abs(properties.x2 - properties.x1), height: Math.abs(properties.y2 - properties.y1) };
-  }
-  return null;
-}
-
-function inspectMark(program, layer, childPath) {
-  const graphic = program.graphicSpec.objects[layer.id];
-  const dataset = findDataset(program, layer.data);
-  const boundedTypes = new Set(["circle", "rect", "line", "path"]);
-  const items = graphic?.items ?? (graphic?.properties ? [{ properties: graphic.properties }] : []);
-  const concreteTypes = items.map(item => item.type ?? graphic?.type);
-  const logicalSupported = graphic !== undefined && concreteTypes.every(type =>
-    boundedTypes.has(type) || type === "text"
-  );
-  const geometrySupported = logicalSupported && concreteTypes.every(type => boundedTypes.has(type));
-  const opacityZero = items.filter(item => item.properties.opacity === 0).length;
-  const zeroSize = items.filter(item => { const b = itemBounds(item.properties, item.type ?? graphic?.type); return b !== null && b.width === 0 && b.height === 0; }).length;
-  const bounds = items.map(item => itemBounds(item.properties, item.type ?? graphic?.type)).filter(Boolean);
-  const canvas = program.graphicSpec.objects.canvas?.properties;
-  const outside = Number.isFinite(canvas?.width) && Number.isFinite(canvas?.height)
-    ? bounds.filter(bound => bound.x + bound.width < 0 || bound.y + bound.height < 0 ||
-        bound.x > canvas.width || bound.y > canvas.height).length
-    : null;
-  const union = bounds.length === 0 ? null : {
-    x: Math.min(...bounds.map(item => item.x)), y: Math.min(...bounds.map(item => item.y)),
-    width: Math.max(...bounds.map(item => item.x + item.width)) - Math.min(...bounds.map(item => item.x)),
-    height: Math.max(...bounds.map(item => item.y + item.height)) - Math.min(...bounds.map(item => item.y))
-  };
-  const grain = ["line", "area"].includes(layer.mark?.type) ? "series" : "item";
-  return {
-    owner: resourceRef("mark", layer.id, childPath), grain,
-    rawRows: dataset?.values?.length ?? null,
-    logicalDataItems: logicalSupported ? items.length : null,
-    drawablePrimitives: logicalSupported ? items.length : null,
-    visibleCandidates: geometrySupported ? Math.max(0, items.length - new Set([
-      ...items.map((item, index) => item.properties.opacity === 0 ? index : -1),
-      ...items.map((item, index) => { const b = itemBounds(item.properties, item.type ?? graphic?.type); return b !== null && b.width === 0 && b.height === 0 ? index : -1; }),
-      ...(outside === null ? [] : items.map((item, index) => { const b = itemBounds(item.properties, item.type ?? graphic?.type); return b !== null && (b.x + b.width < 0 || b.y + b.height < 0 || b.x > canvas.width || b.y > canvas.height) ? index : -1; }))
-    ].filter(index => index >= 0)).size) : null,
-    flags: [
-      { reason: "opacity-zero", count: opacityZero },
-      { reason: "zero-size", count: zeroSize },
-      { reason: "outside-clip", count: outside },
-      { reason: "missing-skipped", count: layer.mark?.missing === "skip" && dataset?.values
-        ? Math.max(0, dataset.values.length - items.length) : null }
-    ],
-    bounds: union,
-    sourceRefs: dataset === undefined ? [] : [resourceRef("data", dataset.id, childPath)],
-    checks: [
-      { name: "concrete-structure", status: graphic === undefined ? "failed" : logicalSupported ? "passed" : "not_applicable", evidencePaths: [layer.id], findings: [] },
-      { name: "pixel-visibility", status: "not_run", evidencePaths: [], findings: [] }
-    ]
-  };
-}
-
-function inspectGuide(program, id, childPath) {
-  const markIds = new Set(program.semanticSpec.layers.map(layer => layer.id));
-  const pattern = id === "axis" ? /axis/iu
-    : id === "grid" ? /grid/iu
-      : id === "legend" ? /legend/iu
-        : id === "title" ? /title|subtitle/iu
-          : new RegExp(id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "iu");
-  const graphicIds = Object.keys(program.graphicSpec.objects).filter(candidate =>
-    candidate !== "canvas" && !candidate.startsWith("plot-") &&
-    !markIds.has(candidate) && pattern.test(candidate)
-  );
-  const items = graphicIds.flatMap(candidate => {
-    const graphic = program.graphicSpec.objects[candidate];
-    if (Array.isArray(graphic?.items)) return graphic.items;
-    return graphic?.properties === undefined ? [] : [{ properties: graphic.properties }];
-  });
-  const semantic = id === "title"
-    ? program.semanticSpec.title
-    : program.semanticSpec.guides[id];
-  const sourceRefs = [];
-  function collectRefs(value) {
-    if (!isPlainObject(value)) return;
-    if (typeof value.scale === "string") sourceRefs.push(resourceRef("scale", value.scale, childPath));
-    if (typeof value.coordinate === "string") sourceRefs.push(resourceRef("coordinate", value.coordinate, childPath));
-    for (const child of Object.values(value)) collectRefs(child);
-  }
-  collectRefs(semantic);
-  return {
-    owner: resourceRef("guide", id, childPath),
-    grain: "unknown",
-    rawRows: null,
-    logicalDataItems: items.length,
-    drawablePrimitives: items.length,
-    visibleCandidates: null,
-    flags: [
-      { reason: "opacity-zero", count: null },
-      { reason: "zero-size", count: null },
-      { reason: "outside-clip", count: null },
-      { reason: "missing-skipped", count: null }
-    ],
-    bounds: null,
-    sourceRefs: [...new Map(sourceRefs.map(ref => [refKey(ref), ref])).values()],
-    checks: [
-      { name: "concrete-structure", status: graphicIds.length > 0 ? "passed" : "not_applicable", evidencePaths: graphicIds, findings: [] },
-      { name: "pixel-visibility", status: "not_run", evidencePaths: [], findings: [] }
-    ]
-  };
-}
-
-export function inspectProgram(program, { target } = {}) {
-  requireProgram(program);
-  if (target !== undefined) validateTarget(target);
-  const views = [];
-  function visit(current, path = []) {
-    const visited = new Set();
-    const active = new Set();
-    function validateGraphic(id) {
-      if (active.has(id)) throw new Error(`Graphic hierarchy contains a cycle at "${id}".`);
-      if (visited.has(id)) throw new Error(`Graphic "${id}" is referenced more than once.`);
-      const object = current.graphicSpec.objects[id];
-      if (object === undefined) throw new Error(`Graphic hierarchy references missing object "${id}".`);
-      visited.add(id); active.add(id);
-      for (const child of object.children ?? []) validateGraphic(child);
-      active.delete(id);
-    }
-    for (const id of current.graphicSpec.order) validateGraphic(id);
-    for (const layer of current.semanticSpec.layers) views.push(inspectMark(current, layer, path));
-    for (const id of Object.keys(current.semanticSpec.guides)) {
-      views.push(inspectGuide(current, id, path));
-    }
-    if (Object.keys(current.semanticSpec.title).length > 0) {
-      views.push(inspectGuide(current, "title", path));
-    }
-    for (const [id, child] of Object.entries(current.children)) visit(child, [...path, id]);
-  }
-  visit(program);
-  let filtered = views;
-  if (target !== undefined) {
-    const current = atChildPath(program, target.childPath);
-    const targetResource = findResource(program, target);
-    if (targetResource === undefined) {
-      throw new Error(`Unknown ${target.kind} "${target.id}".`);
-    }
-    filtered = views.filter(view => {
-      if (canonical(view.owner.childPath ?? []) !== canonical(target.childPath ?? [])) return false;
-      if (target.kind === "mark") return view.owner.id === target.id;
-      const layer = findLayer(current, view.owner.id);
-      if (target.kind === "data") return layer?.data === targetResource.id;
-      if (target.kind === "coordinate") return layer?.coordinate === target.id;
-      if (target.kind === "scale") return Object.values(layer?.encoding ?? {}).some(
-        encoding => encoding?.scale === target.id || encoding?.dimensions?.some(dimension => dimension.scale === target.id)
-      );
-      if (target.kind === "guide") return view.owner.kind === "guide" && view.owner.id === target.id;
-      return false;
-    });
-  }
-  const calculations = [];
-  function collectCalculations(current, path = []) {
-    for (const family of Object.values(current.materializationConfigs.calculations ?? {})) {
-      if (!isPlainObject(family)) continue;
-      for (const report of Object.values(family)) {
-        calculations.push(path.length === 0 ? report : { ...report, childPath: path });
-      }
-    }
-    for (const [id, child] of Object.entries(current.children)) {
-      collectCalculations(child, [...path, id]);
-    }
-  }
-  collectCalculations(program);
-  const unsupported = filtered.filter(view => view.logicalDataItems === null).map(view => view.owner);
-  return cloneAndFreeze({
-    version: 1, views: filtered,
-    calculations,
-    checks: [{ name: "pixel-visibility", status: "not_run", evidencePaths: [], findings: [] }],
-    findings: [], coverage: { partial: filtered.some(view => view.checks.some(check => check.status !== "passed")), unsupported }
-  });
-}
+import{resolveGraphicClipBounds as B,resolveGraphicParentOffset as W}from"./grammar/schemas/graphicBounds.js";import{resolveFacetDefinition as K,resolveFacetGridDefinition as L}from"./grammar/facets/index.js";import{APPEARANCE_MARK_TYPES as V}from"./core/vocabulary.js";import{ChartProgram as E}from"./ChartProgram.js";import{BasicChartProgram as C}from"./BasicChartProgram.js";import{getWrappedActionMetadata as J}from"./core/action.js";import{cloneAndFreeze as b,isOwned as _,isPlainObject as S}from"./core/immutable.js";import{encodeValue as Y}from"./persistence/codec.js";import{findDataset as z,hasDatasetOwner as Z,resolveDatasetReference as F}from"./selectors/datasets.js";import{findLayer as G}from"./selectors/layers.js";import{findSemanticScale as H}from"./selectors/scales.js";import{findCoordinate as Q}from"./selectors/coordinates.js";import{inferDatasetSchema as X}from"./grammar/datasetSchema.js";import{BUILTIN_ACTION_DESCRIPTOR_RECORDS as ee}from"./inspectionDescriptors.js";const ne=new Set(["data","mark","scale","coordinate","guide"]),ie=new Map(ee.map(([e,n,i,t,c])=>[e,{options:n.map(([m,l,k,d,a])=>({path:m,required:l,kind:k,...d===null?{}:{choices:d},...a===null?{}:{unit:a}})),idOptions:i,prerequisites:t,entryPoints:c}]));function P(e,n="Program"){if(!(e instanceof E||e instanceof C))throw new TypeError(`${n} must be a ggaction program.`);if(e.actionStack.length!==0)throw new Error(`${n} must have a closed action stack.`);return e}function $(e,n=[]){if(!Array.isArray(n))throw new TypeError("childPath must be an array.");let i=e;for(const t of n){if(typeof t!="string"||!Object.hasOwn(i.children,t))throw new Error(`Unknown program child "${String(t)}".`);i=i.children[t]}return i}function R(e){if(!S(e)||!ne.has(e.kind)||typeof e.id!="string"||e.id.length===0)throw new TypeError("Inspection target requires a supported kind and non-empty id.");return e}function I(e,n){const i=$(e,n.childPath);return n.kind==="data"?Z(i,n.id)?F(i,n.id,"Inspection target"):z(i,n.id):n.kind==="mark"?G(i,n.id):n.kind==="scale"?H(i,n.id):n.kind==="coordinate"?Q(i,n.id):i.semanticSpec.guides[n.id]}function g(e,n,i){return{kind:e,id:n,...i?.length?{childPath:[...i]}:{}}}function te(e,{data:n,childPath:i}={}){P(e);const t=$(e,i);if(typeof n!="string"||n.length===0)throw new TypeError("getDatasetSchema requires data.");const c=F(t,n,"Dataset schema data"),m=c.schema??X(c.values??[]);return b({data:c.id,schema:m})}function be(e,{action:n,target:i,options:t={}}={}){if(P(e),typeof n!="string"||n.length===0)throw new TypeError("describeAction requires action.");if(!S(t))throw new TypeError("describeAction options must be a plain object.");let c;if(i!==void 0){if(R(i),c=I(e,i),c===void 0)return b({version:1,action:n,applicability:"incompatible",parameterDefinitions:[],requirements:[],checks:[{name:"target",status:"failed",evidencePaths:[],findings:[]}],findings:[{severity:"error",code:"missing-resource",reason:"target-unavailable",message:`Unknown ${i.kind} "${i.id}".`,resource:g(i.kind,i.id,i.childPath)}]});if(t.target!==void 0&&t.target!==i.id)return b({version:1,action:n,applicability:"incompatible",parameterDefinitions:[],requirements:[],checks:[{name:"target",status:"failed",evidencePaths:["target"],findings:[]}],findings:[{severity:"error",code:"incompatible-resource",reason:"target-mismatch",message:`Inspection target "${i.id}" conflicts with options.target "${t.target}".`,resource:g(i.kind,i.id,i.childPath),optionPath:"target"}]});const f=V[n];if(f&&(i.kind!=="mark"||!f.includes(c.mark?.type)))return b({version:1,action:n,applicability:"unsupported",parameterDefinitions:[],requirements:[],checks:[{name:"target",status:"not_applicable",evidencePaths:["target"],findings:[]}],findings:[{severity:"info",code:"unsupported-combination",reason:"mark-type",message:`${n} supports ${f.join(", ")} marks.`,resource:g(i.kind,i.id,i.childPath)}]})}const m=e[n],l=typeof m=="function"?J(m):void 0;if(l===void 0)return b({version:1,action:n,applicability:typeof m=="function"?"unverified":"unsupported",parameterDefinitions:[],requirements:[],checks:[],findings:[{severity:"info",code:"unsupported-format",reason:typeof m=="function"?"extension-unverified":"action-unavailable",message:`Action "${n}" has no built-in inspection descriptor.`}]});const k=ie.get(n),d=l.options??k?.options.map(f=>f.path);if(d===void 0)return b({version:1,action:n,applicability:"unverified",parameterDefinitions:[],requirements:[],checks:[{name:"execution",status:"not_run",evidencePaths:[],findings:[]}],findings:[{severity:"info",code:"unsupported-format",reason:"descriptor-unavailable",message:`Action "${n}" is registered but its static option descriptor is unavailable.`}]});const a=Object.keys(t).find(f=>!d.includes(f)),o=(k?.options.filter(f=>f.required).map(f=>f.path)??[]).filter(f=>t[f]===void 0);let p=[];if(c!==void 0&&i.kind==="mark"){const f=$(e,i.childPath),O=n.startsWith("edit")&&n.endsWith("Plot")?Object.entries(f.markConfigs[i.id]??{}).find(([r])=>r.toLowerCase()===n.slice(4).toLowerCase())?.[1]:void 0,x=O?.source===void 0?c.data:t.data??O.source,y=te(e,{data:x,childPath:i.childPath}).schema;if(y.completeness==="known"){const r=new Set(y.fields.map(v=>v.name));p=(k?.options??[]).filter(v=>v.kind==="field"&&typeof t[v.path]=="string"&&!r.has(t[v.path])).map(v=>({severity:"error",code:"missing-resource",reason:"field-unavailable",message:`Dataset does not contain field "${t[v.path]}".`,resource:g("data",x,i.childPath),optionPath:v.path}))}}if(a===void 0&&o.length===0&&(n==="facet"&&t.field||n==="facetGrid"&&t.rows&&t.columns))try{(n==="facet"?K:L)(e.semanticSpec,t)}catch(f){p.push({severity:"error",code:"unsupported-combination",reason:"facet-partition",message:f.message,optionPath:"data"})}const u=a!==void 0?[{severity:"error",code:"invalid-option",reason:"unknown-option",message:`Unknown ${n} option "${a}".`,optionPath:a}]:[...o.map(f=>({severity:"info",code:"missing-input",reason:"required-option",message:`${n} requires option "${f}".`,optionPath:f})),...p],h=a!==void 0||p.length?"incompatible":o.length?"needs-input":"supported";return b({version:1,action:n,applicability:h,parameterDefinitions:k?.options.map(f=>({...f,active:!0}))??d.map(f=>({path:f,kind:"object",required:!1,active:!0})),requirements:o.map(f=>({reason:"required-option",optionPath:f})),checks:[{name:"option-shape",status:a===void 0?"passed":"failed",evidencePaths:Object.keys(t),findings:a===void 0?[]:u},{name:"execution",status:"not_run",evidencePaths:[],findings:[]}],findings:u})}function T(e){return Array.isArray(e)?e.map(T):S(e)?Object.fromEntries(Object.keys(e).sort().map(n=>[n,T(e[n])])):e}function j(e){return JSON.stringify(Y(T(e)))}const D=new WeakMap;function M(e,n){if(Object.is(e,n))return!0;if(e===null||n===null||typeof e!="object"||typeof n!="object"||Array.isArray(e)!==Array.isArray(n))return!1;if(!Array.isArray(e)&&(!S(e)||!S(n)))return j(e)===j(n);const i=_(e)&&_(n),t=i?D.get(e)?.get(n):void 0;if(t!==void 0)return t;const c=Object.keys(e),m=(!Array.isArray(e)||e.length===n.length)&&c.length===Object.keys(n).length&&c.every(l=>Object.hasOwn(n,l)&&M(e[l],n[l]));return i&&(D.has(e)||D.set(e,new WeakMap),D.get(e).set(n,m)),m}function N(e,n=[],i=[]){for(const t of e.semanticSpec.datasets)i.push({ref:g("data",t.id,n),value:t});for(const[t,c]of e.semanticSpec.layers.entries())i.push({ref:g("mark",c.id,n),value:{semantic:c,graphic:e.graphicSpec.objects[c.id],config:e.markConfigs[c.id],orderIndex:t}});for(const t of e.semanticSpec.scales)i.push({ref:g("scale",t.id,n),value:{semantic:t,resolved:e.resolvedScales[t.id]}});for(const t of e.semanticSpec.coordinates)i.push({ref:g("coordinate",t.id,n),value:t});for(const[t,c]of Object.entries(e.semanticSpec.guides))i.push({ref:g("guide",t,n),value:{semantic:c,graphic:e.graphicSpec.objects[t],config:e.guideConfigs[t]}});Object.keys(e.semanticSpec.title).length&&i.push({ref:g("guide","title",n),value:{semantic:e.semanticSpec.title,config:e.titleConfig}}),e.graphicSpec.objects.canvas!==void 0&&i.push({ref:g("canvas","canvas",n),value:e.graphicSpec.objects.canvas}),Object.keys(e.compositionSpec??{}).length>0&&i.push({ref:g("composition","layout",n),value:e.compositionSpec});for(const[t,c]of Object.entries(e.children))N(c,[...n,t],i);return i}function A(e){return`${e.childPath?.join("/")??""}|${e.kind}|${e.id}`}function se(e){return e==="data"?"data":e==="scale"?"scale":e==="guide"?"guide":["coordinate","canvas","composition"].includes(e)?"structure":"style"}function re(e,n,i){return i!=="mark"||e===void 0||n===void 0?se(i):e.value.orderIndex!==n.value.orderIndex?"structure":!M(e.value.semantic?.encoding,n.value.semantic?.encoding)||e.value.semantic?.data!==n.value.semantic?.data?"binding":M(e.value.semantic,n.value.semantic)?"style":"structure"}function Se(e,n,{target:i}={}){P(e,"Before program"),P(n,"After program"),i!==void 0&&R(i);const t=new Map(N(e).map(a=>[A(a.ref),a])),c=new Map(N(n).map(a=>[A(a.ref),a]));let l=[...new Set([...t.keys(),...c.keys()])].sort().flatMap(a=>{const s=t.get(a),o=c.get(a),p=s??o;if(s!==void 0&&o!==void 0&&M(s.value,o.value))return[];const u=p.ref.kind==="mark"&&s!==void 0&&o!==void 0?[...new Set([...Object.keys(s.value.semantic?.encoding??{}),...Object.keys(o.value.semantic?.encoding??{})])].filter(h=>!M(s.value.semantic?.encoding?.[h],o.value.semantic?.encoding?.[h])):[];return[{resource:p.ref,operation:s===void 0?"add":o===void 0?"remove":"modify",effect:re(s,o,p.ref.kind),roles:u}]});if(i!==void 0){const a=[e,n].flatMap(o=>{const p=I(o,i);return p===void 0?[]:[A(g(i.kind,i.kind==="data"?p.id:i.id,i.childPath))]});if(a.length===0)throw new Error(`Unknown ${i.kind} "${i.id}" in both programs.`);const s=new Set(a);for(const o of[t,c]){let p=!0;for(;p;){p=!1;for(const[u,h]of o){if(s.has(u))continue;const f=j(h.ref.childPath??[]);[...s].some(x=>{const y=o.get(x);return y===void 0||j(y.ref.childPath??[])!==f?!1:y.ref.kind==="data"?h.ref.kind==="data"?h.value.source===y.ref.id:h.ref.kind==="mark"&&h.value.semantic?.data===y.ref.id:y.ref.kind==="mark"?h.ref.kind==="mark"&&h.value.semantic?.source===y.ref.id||h.ref.kind==="guide"&&(h.value.semantic?.target===y.ref.id||h.value.config?.target===y.ref.id):y.ref.kind==="scale"?h.ref.kind==="mark"&&Object.values(h.value.semantic?.encoding??{}).some(r=>r?.scale===y.ref.id||r?.dimensions?.some(v=>v.scale===y.ref.id))||h.ref.kind==="guide"&&(h.value.semantic?.scale===y.ref.id||h.value.config?.scale===y.ref.id):y.ref.kind==="coordinate"&&h.ref.kind==="mark"&&h.value.semantic?.coordinate===y.ref.id})&&(s.add(u),p=!0)}}}l=l.filter(o=>s.has(A(o.resource)))}const k=![E,C].includes(e.constructor)||![E,C].includes(n.constructor),d=k?[{severity:"info",code:"unsupported-format",reason:"extension-unverified",message:"Extension-owned semantic equivalence could not be fully verified."}]:[];return b({version:1,equivalence:l.length?"different":k?"unknown":"equal",completeProgramComparison:i===void 0,changes:l,affected:l.map(a=>a.resource),findings:d})}function q(e,n){if(!S(e))return null;if(n==="circle")return!Number.isFinite(e.x)||!Number.isFinite(e.y)||!Number.isFinite(e.radius)||e.radius<0?null:{x:e.x-e.radius,y:e.y-e.radius,width:e.radius*2,height:e.radius*2};if(n==="rect")return[e.x,e.y,e.width,e.height].every(Number.isFinite)?{x:Math.min(e.x,e.x+e.width),y:Math.min(e.y,e.y+e.height),width:Math.abs(e.width),height:Math.abs(e.height)}:null;if(n==="path"&&Array.isArray(e.commands)){const i=e.commands.flatMap(m=>Number.isFinite(m.x)&&Number.isFinite(m.y)?[[m.x,m.y]]:[]);if(i.length===0)return null;const t=i.map(m=>m[0]),c=i.map(m=>m[1]);return{x:Math.min(...t),y:Math.min(...c),width:Math.max(...t)-Math.min(...t),height:Math.max(...c)-Math.min(...c)}}return[e.x1,e.y1,e.x2,e.y2].every(Number.isFinite)?{x:Math.min(e.x1,e.x2),y:Math.min(e.y1,e.y2),width:Math.abs(e.x2-e.x1),height:Math.abs(e.y2-e.y1)}:null}function ce(e,n,i){const t=e.graphicSpec.objects[n.id],c=z(e,n.data),m=new Set(["circle","rect","line","path"]),l=t?.items??(t?.properties?[{properties:t.properties}]:[]),k=l.map(r=>r.type??t?.type),d=t!==void 0&&k.every(r=>m.has(r)||r==="text"),a=d&&k.every(r=>m.has(r)),s=l.filter(r=>r.properties.opacity===0).length,o=l.filter(r=>{const v=q(r.properties,r.type??t?.type);return v!==null&&v.width===0&&v.height===0}).length,p=l.map(r=>q(r.properties,r.type??t?.type)).filter(Boolean),u=t===void 0?void 0:B(e.graphicSpec,n.id,{rootViewport:!0}),h=t===void 0?[0,0]:W(e.graphicSpec,n.id),f=u===void 0?null:l.flatMap((r,v)=>{const w=q(r.properties,r.type??t.type);return w!==null&&(u.right<=u.left||u.bottom<=u.top||w.x+h[0]+w.width<u.left||w.y+h[1]+w.height<u.top||w.x+h[0]>u.right||w.y+h[1]>u.bottom)?[v]:[]}),O=f?.length??null,x=p.length===0?null:{x:Math.min(...p.map(r=>r.x)),y:Math.min(...p.map(r=>r.y)),width:Math.max(...p.map(r=>r.x+r.width))-Math.min(...p.map(r=>r.x)),height:Math.max(...p.map(r=>r.y+r.height))-Math.min(...p.map(r=>r.y))},y=["line","area"].includes(n.mark?.type)?"series":"item";return{owner:g("mark",n.id,i),grain:y,rawRows:c?.values?.length??null,logicalDataItems:d?l.length:null,drawablePrimitives:d?l.length:null,visibleCandidates:a?Math.max(0,l.length-new Set([...l.map((r,v)=>r.properties.opacity===0?v:-1),...l.map((r,v)=>{const w=q(r.properties,r.type??t?.type);return w!==null&&w.width===0&&w.height===0?v:-1}),...f??[]].filter(r=>r>=0)).size):null,flags:[{reason:"opacity-zero",count:s},{reason:"zero-size",count:o},{reason:"outside-clip",count:O},{reason:"missing-skipped",count:n.mark?.missing==="skip"&&c?.values?Math.max(0,c.values.length-l.length):null}],bounds:x,sourceRefs:c===void 0?[]:[g("data",c.id,i)],checks:[{name:"concrete-structure",status:t===void 0&&!e.compositionSpec?.facet?"failed":d?"passed":"not_applicable",evidencePaths:[n.id],findings:[]},{name:"pixel-visibility",status:"not_run",evidencePaths:[],findings:[]}]}}function U(e,n,i){const t=new Set(e.semanticSpec.layers.map(s=>s.id)),c=n==="axis"?/axis/iu:n==="grid"?/grid/iu:n==="legend"?/legend/iu:n==="title"?/title|subtitle/iu:new RegExp(n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),"iu"),m=Object.keys(e.graphicSpec.objects).filter(s=>s!=="canvas"&&!s.startsWith("plot-")&&!t.has(s)&&c.test(s)),l=m.flatMap(s=>{const o=e.graphicSpec.objects[s];return Array.isArray(o?.items)?o.items:o?.properties===void 0?[]:[{properties:o.properties}]}),k=n==="title"?e.semanticSpec.title:e.semanticSpec.guides[n],d=[];function a(s){if(S(s)){typeof s.scale=="string"&&d.push(g("scale",s.scale,i)),typeof s.coordinate=="string"&&d.push(g("coordinate",s.coordinate,i));for(const o of Object.values(s))a(o)}}return a(k),{owner:g("guide",n,i),grain:"unknown",rawRows:null,logicalDataItems:l.length,drawablePrimitives:l.length,visibleCandidates:null,flags:[{reason:"opacity-zero",count:null},{reason:"zero-size",count:null},{reason:"outside-clip",count:null},{reason:"missing-skipped",count:null}],bounds:null,sourceRefs:[...new Map(d.map(s=>[A(s),s])).values()],checks:[{name:"concrete-structure",status:m.length>0?"passed":"not_applicable",evidencePaths:m,findings:[]},{name:"pixel-visibility",status:"not_run",evidencePaths:[],findings:[]}]}}function xe(e,{target:n}={}){P(e),n!==void 0&&R(n);const i=[];function t(d,a=[]){const s=new Set,o=new Set;function p(u){if(o.has(u))throw new Error(`Graphic hierarchy contains a cycle at "${u}".`);if(s.has(u))throw new Error(`Graphic "${u}" is referenced more than once.`);const h=d.graphicSpec.objects[u];if(h===void 0)throw new Error(`Graphic hierarchy references missing object "${u}".`);s.add(u),o.add(u);for(const f of h.children??[])p(f);o.delete(u)}for(const u of d.graphicSpec.order)p(u);for(const u of d.semanticSpec.layers)i.push(ce(d,u,a));for(const u of Object.keys(d.semanticSpec.guides))i.push(U(d,u,a));Object.keys(d.semanticSpec.title).length>0&&i.push(U(d,"title",a));for(const[u,h]of Object.entries(d.children))t(h,[...a,u])}t(e);let c=i;if(n!==void 0){const d=$(e,n.childPath),a=I(e,n);if(a===void 0)throw new Error(`Unknown ${n.kind} "${n.id}".`);c=i.filter(s=>{if(j(s.owner.childPath??[])!==j(n.childPath??[]))return!1;if(n.kind==="mark")return s.owner.id===n.id;const o=G(d,s.owner.id);return n.kind==="data"?o?.data===a.id:n.kind==="coordinate"?o?.coordinate===n.id:n.kind==="scale"?Object.values(o?.encoding??{}).some(p=>p?.scale===n.id||p?.dimensions?.some(u=>u.scale===n.id)):n.kind==="guide"?s.owner.kind==="guide"&&s.owner.id===n.id:!1})}const m=[];function l(d,a=[]){for(const s of Object.values(d.materializationConfigs.calculations??{}))if(S(s))for(const o of Object.values(s))m.push(a.length===0?o:{...o,childPath:a});for(const[s,o]of Object.entries(d.children))l(o,[...a,s])}l(e);const k=c.filter(d=>d.logicalDataItems===null).map(d=>d.owner);return b({version:1,views:c,calculations:m,checks:[{name:"pixel-visibility",status:"not_run",evidencePaths:[],findings:[]}],findings:[],coverage:{partial:c.some(d=>d.checks.some(a=>a.status!=="passed")),unsupported:k}})}export{Se as comparePrograms,be as describeAction,te as getDatasetSchema,xe as inspectProgram};