@chipmobilesdk/rn-chart 0.3.0 → 0.5.0

package/lib/module/geometry/ticks.js

@@ -0,0 +1,112 @@
+"use strict";
+
+/**
+ * Tick generation and label thinning (FR-070).
+ *
+ * React Native offers no synchronous text measurement, and an `onLayout`
+ * round-trip per label would cost a second layout pass — enough to breach the
+ * first-paint budget. So we estimate width from character count and thin ticks
+ * to fit.
+ *
+ * The estimate is deliberately generous: over-estimating drops one tick too
+ * many, which is legible. Under-estimating produces overlapping text, which is
+ * the failure FR-070 exists to prevent. See research.md R6.
+ *
+ * PURE. No React, no SVG.
+ */
+
+/**
+ * Average glyph advance as a fraction of font size, for the Latin digits and
+ * letters that dominate axis labels. Rounded up from the ~0.5-0.55 typical of
+ * the platform sans-serif faces.
+ */
+export const AVERAGE_ADVANCE_RATIO = 0.62;
+
+/** Minimum breathing room between two adjacent labels, in px. */
+export const LABEL_GUTTER = 8;
+export function estimateTextWidth(text, fontSize) {
+  return text.length * fontSize * AVERAGE_ADVANCE_RATIO;
+}
+/**
+ * "Nice" step sizes: 1, 2, 5 and their powers of ten. Standard axis practice —
+ * these are the intervals people read fluently.
+ */
+function niceStep(rawStep) {
+  if (rawStep <= 0 || !Number.isFinite(rawStep)) {
+    return 1;
+  }
+  const magnitude = Math.pow(10, Math.floor(Math.log10(rawStep)));
+  const normalized = rawStep / magnitude;
+  if (normalized <= 1) {
+    return magnitude;
+  }
+  if (normalized <= 2) {
+    return 2 * magnitude;
+  }
+  if (normalized <= 5) {
+    return 5 * magnitude;
+  }
+  return 10 * magnitude;
+}
+export function niceTickValues(domain, targetCount) {
+  const span = domain.max - domain.min;
+  if (span <= 0 || targetCount < 1) {
+    return [domain.min];
+  }
+  const step = niceStep(span / targetCount);
+  const start = Math.ceil(domain.min / step) * step;
+  const values = [];
+  // Guard against a pathological step producing an unbounded loop.
+  for (let v = start, guard = 0; v <= domain.max && guard < 1000; v += step) {
+    // Re-round to kill floating-point drift such as 0.30000000000000004.
+    values.push(Number((Math.round(v / step) * step).toFixed(10)));
+    guard += 1;
+  }
+  return values.length > 0 ? values : [domain.min];
+}
+
+/**
+ * Drops ticks until no two labels can overlap.
+ *
+ * Thinning is preferred over rotation as the default: rotated labels are harder
+ * to read on a phone and cost vertical space a mobile chart cannot spare.
+ * Rotation stays available as an opt-in for dense category axes.
+ *
+ * The first tick is always kept, so an axis never renders empty.
+ */
+export function thinTicks(ticks, fontSize, axisLengthPx) {
+  if (ticks.length <= 1) {
+    return [...ticks];
+  }
+  let widest = 0;
+  for (const t of ticks) {
+    widest = Math.max(widest, estimateTextWidth(t.label, fontSize));
+  }
+  const slot = widest + LABEL_GUTTER;
+  const maxLabels = Math.max(1, Math.floor(axisLengthPx / slot));
+  if (ticks.length <= maxLabels) {
+    return [...ticks];
+  }
+  const stride = Math.ceil(ticks.length / maxLabels);
+  return ticks.filter((_, i) => i % stride === 0);
+}
+
+/**
+ * How much space an axis must reserve for its labels, at the current system
+ * font scale (FR-071).
+ */
+export function reserveAxisSpace(labels, fontSize, orientation) {
+  if (labels.length === 0) {
+    return 0;
+  }
+  if (orientation === 'horizontal') {
+    // One line of text plus a gutter.
+    return fontSize * 1.4 + LABEL_GUTTER;
+  }
+  let widest = 0;
+  for (const label of labels) {
+    widest = Math.max(widest, estimateTextWidth(label, fontSize));
+  }
+  return widest + LABEL_GUTTER;
+}
+//# sourceMappingURL=ticks.js.map

package/lib/module/geometry/ticks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AVERAGE_ADVANCE_RATIO","LABEL_GUTTER","estimateTextWidth","text","fontSize","length","niceStep","rawStep","Number","isFinite","magnitude","Math","pow","floor","log10","normalized","niceTickValues","domain","targetCount","span","max","min","step","start","ceil","values","v","guard","push","round","toFixed","thinTicks","ticks","axisLengthPx","widest","t","label","slot","maxLabels","stride","filter","_","i","reserveAxisSpace","labels","orientation"],"sourceRoot":"../../../src","sources":["geometry/ticks.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/timeSeries.js

@@ -0,0 +1,153 @@
+"use strict";
+
+/**
+ * Time-series geometry: one stroked path per series over an instant domain.
+ *
+ * Gaps are the interesting part. A non-known value contributes `null` to the
+ * point list, `linePath` lifts the pen there, and the line simply does not
+ * exist across the gap (FR-012).
+ *
+ * PURE. No React, no SVG.
+ */
+
+import { isKnown, isWithheld } from "../contract/value.js";
+import { insetForAxes, plotBottom, plotRight } from "./layout.js";
+import { horizontalMarkers, markerDomainValues } from "./markers.js";
+import { linePath } from "./path.js";
+import { domainFrom, linearScale, timeScale, widenDegenerateDomain } from "./scale.js";
+import { niceTickValues, thinTicks } from "./ticks.js";
+function visiblePoints(series, range) {
+  const points = [...series.points].filter(p => p.position.kind === 'instant')
+  // Out-of-order input must still produce a correct axis.
+  .sort((a, b) => {
+    const at = a.position.kind === 'instant' ? a.position.at : 0;
+    const bt = b.position.kind === 'instant' ? b.position.at : 0;
+    return at - bt;
+  });
+  if (!range) {
+    return points;
+  }
+  return points.filter(p => {
+    const at = p.position.kind === 'instant' ? p.position.at : 0;
+    return at >= range.from && at <= range.to;
+  });
+}
+export function buildTimeSeriesGeometry(datasource, input, options = {}) {
+  const instants = [];
+  const values = [];
+  let excluded = 0;
+
+  // Sorted and windowed once per series; both passes below read the result.
+  const ordered = new Map(datasource.series.map(series => [series, visiblePoints(series, options.range)]));
+  for (const series of datasource.series) {
+    for (const point of ordered.get(series) ?? []) {
+      if (point.position.kind === 'instant') {
+        instants.push(point.position.at);
+      }
+      if (isKnown(point.value)) {
+        values.push(point.value.value);
+      } else {
+        excluded += 1;
+      }
+    }
+  }
+  if (instants.length === 0) {
+    return {
+      plot: input.plot,
+      paths: [],
+      markers: [],
+      labels: [],
+      xTicks: [],
+      yTicks: [],
+      hitRegions: [],
+      incomplete: excluded > 0
+    };
+  }
+
+  // Tick labels depend only on the domains, so the plot can make room for
+  // them before anything is projected.
+  // Widened here, as the scales would, so the ticks label the axes actually drawn.
+  const xDomain = widenDegenerateDomain(domainFrom(instants));
+  const yDomain = widenDegenerateDomain(domainFrom([...values, ...markerDomainValues(datasource.markers)], {
+    padFraction: 0.1
+  }));
+  const xTickValues = niceTickValues(xDomain, 4);
+  const yTickValues = niceTickValues(yDomain, 4);
+  const plot = insetForAxes(input.plot, {
+    xLabels: xTickValues.map(input.formatInstant),
+    yLabels: yTickValues.map(input.formatValue),
+    fontSize: input.fontSize
+  });
+  const x = timeScale(xDomain, {
+    min: plot.x,
+    max: plotRight(plot)
+  });
+  const y = linearScale(yDomain, {
+    min: plotBottom(plot),
+    max: plot.y
+  });
+  const paths = [];
+  const hitRegions = [];
+  for (const series of datasource.series) {
+    if (series.hidden) {
+      continue;
+    }
+    const pts = [];
+    for (const point of ordered.get(series) ?? []) {
+      const at = point.position.kind === 'instant' ? point.position.at : 0;
+      const px = x.project(at);
+      if (!isKnown(point.value)) {
+        // The gap. No coordinate is produced, so no segment can span it.
+        pts.push(null);
+        continue;
+      }
+      const py = y.project(point.value.value);
+      pts.push({
+        x: px,
+        y: py
+      });
+      hitRegions.push({
+        seriesId: series.id,
+        pointId: point.id,
+        x: px,
+        y: py,
+        // Withheld values are never selectable, so a callback can never
+        // carry one (FR-053).
+        selectable: !isWithheld(point.value)
+      });
+    }
+    const d = linePath(pts);
+    if (d.length > 0) {
+      paths.push({
+        key: `line-${series.id}`,
+        seriesId: series.id,
+        d,
+        color: input.seriesColors[series.id],
+        pattern: series.pattern ?? 'solid',
+        filled: false
+      });
+    }
+  }
+  const xTicks = xTickValues.map(v => ({
+    value: v,
+    position: x.project(v),
+    label: input.formatInstant(v)
+  }));
+  const yTicks = yTickValues.map(v => ({
+    value: v,
+    position: y.project(v),
+    label: input.formatValue(v)
+  }));
+  const markers = horizontalMarkers(datasource.markers, plot, y.project);
+  return {
+    plot,
+    paths,
+    markers: markers.lines,
+    labels: markers.labels,
+    xTicks: thinTicks(xTicks, input.fontSize, plot.width),
+    yTicks,
+    hitRegions,
+    incomplete: excluded > 0
+  };
+}
+//# sourceMappingURL=timeSeries.js.map

package/lib/module/geometry/timeSeries.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","isWithheld","insetForAxes","plotBottom","plotRight","horizontalMarkers","markerDomainValues","linePath","domainFrom","linearScale","timeScale","widenDegenerateDomain","niceTickValues","thinTicks","visiblePoints","series","range","points","filter","p","position","kind","sort","a","b","at","bt","from","to","buildTimeSeriesGeometry","datasource","input","options","instants","values","excluded","ordered","Map","map","point","get","push","value","length","plot","paths","markers","labels","xTicks","yTicks","hitRegions","incomplete","xDomain","yDomain","padFraction","xTickValues","yTickValues","xLabels","formatInstant","yLabels","formatValue","fontSize","x","min","max","y","hidden","pts","px","project","py","seriesId","id","pointId","selectable","d","key","color","seriesColors","pattern","filled","v","label","lines","width"],"sourceRoot":"../../../src","sources":["geometry/timeSeries.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/types.js

@@ -0,0 +1,39 @@
+"use strict";
+
+/**
+ * The single memoized artefact each chart produces.
+ *
+ * `ResolvedGeometry` is keyed on datasource identity, plot rectangle, theme
+ * identity, and formatter identity — and deliberately **not** on selection.
+ * Highlighting a point must repaint the highlight, not recompute every scale
+ * and path string (research.md R3, FR-073).
+ *
+ * PURE. No React, no SVG.
+ */
+
+/** One drawable group. Element count scales with these, never with points. */
+
+/** A target, baseline, or threshold drawn across the plot. */
+
+/** Text the chart draws itself, such as progress values or segment labels. */
+
+/** What a colour ramp runs from and to, for the legend that explains it. */
+
+export const EMPTY_GEOMETRY = {
+  plot: {
+    x: 0,
+    y: 0,
+    width: 0,
+    height: 0
+  },
+  paths: [],
+  markers: [],
+  labels: [],
+  xTicks: [],
+  yTicks: [],
+  hitRegions: [],
+  incomplete: false
+};
+
+/** Inputs every family geometry builder needs. */
+//# sourceMappingURL=types.js.map

package/lib/module/geometry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EMPTY_GEOMETRY","plot","x","y","width","height","paths","markers","labels","xTicks","yTicks","hitRegions","incomplete"],"sourceRoot":"../../../src","sources":["geometry/types.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;;AAcA;;AAQA;;AAUA;;AAwBA,OAAO,MAAMA,cAAgC,GAAG;EAC/CC,IAAI,EAAE;IAAEC,CAAC,EAAE,CAAC;IAAEC,CAAC,EAAE,CAAC;IAAEC,KAAK,EAAE,CAAC;IAAEC,MAAM,EAAE;EAAE,CAAC;EACzCC,KAAK,EAAE,EAAE;EACTC,OAAO,EAAE,EAAE;EACXC,MAAM,EAAE,EAAE;EACVC,MAAM,EAAE,EAAE;EACVC,MAAM,EAAE,EAAE;EACVC,UAAU,EAAE,EAAE;EACdC,UAAU,EAAE;AACb,CAAC;;AAED","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,85 @@
+"use strict";
+
+/**
+ * @chipmobilesdk/rn-chart — domain-agnostic charting for ChipMobileSdk-family
+ * React Native apps.
+ *
+ * This is the single public entrypoint (LIB-003). Modules under `geometry/`,
+ * `render/`, `validation/`, and the internals of `react/` are private; import
+ * them only through this file. Keeping them private is what lets the geometry,
+ * the layout maths, and the rendering substrate change without a breaking
+ * release.
+ *
+ * The package makes no network request, calls no AI service, reads no
+ * database, persists nothing, and logs no data value or series label. It
+ * renders numeric data and app-supplied labels — nothing else.
+ *
+ * There is deliberately **no insight, message, or narrative surface**: apps
+ * render their own text around a chart, and a chart imposes no outer margin
+ * that would fight that layout.
+ */
+
+// ---------------------------------------------------------------------------
+// Value semantics — the foundation of the contract
+// ---------------------------------------------------------------------------
+
+export { isKnown, isWithheld, known, notApplicable, participatesInTotals, sumKnown, unknown, withheld } from "./contract/value.js";
+
+// ---------------------------------------------------------------------------
+// Datasource contract
+// ---------------------------------------------------------------------------
+
+export { FAMILY_POSITION_KINDS, familyAcceptsPositionKind, resolveFormat, resolveUnit } from "./contract/datasource.js";
+export { findTarget, isUsableTarget, readProgress } from "./contract/marker.js";
+
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+
+export { NON_VALUE_TEXT, formatLegendDefault, formatPositionDefault, formatValueDefault, seriesRef } from "./contract/format.js";
+
+// ---------------------------------------------------------------------------
+// State and errors
+// ---------------------------------------------------------------------------
+
+export { STATUS_PRECEDENCE, drawsData, resolveStatus, suppressesInteraction } from "./contract/state.js";
+export { isChartError } from "./contract/errors.js";
+
+// ---------------------------------------------------------------------------
+// Interaction
+// ---------------------------------------------------------------------------
+
+export { sameSelection } from "./contract/interaction.js";
+
+// ---------------------------------------------------------------------------
+// Theme
+// ---------------------------------------------------------------------------
+
+export { defaultChartTheme, resolveSeriesColor } from "./contract/theme.js";
+
+// ---------------------------------------------------------------------------
+// Props and accessibility
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Dataset budgets
+// ---------------------------------------------------------------------------
+
+export { DATASET_BUDGETS, checkBudget } from "./validation/budgets.js";
+
+// ---------------------------------------------------------------------------
+// Components
+// ---------------------------------------------------------------------------
+
+export { BarChart, DistributionChart, HeatmapChart, ProgressChart, TimeSeriesChart } from "./react/charts.js";
+export { ChartLegend, ColorScaleLegend, buildLegendEntries } from "./react/ChartLegend.js";
+export { ChartThemeProvider, useChartTheme } from "./react/ChartThemeProvider.js";
+
+// ---------------------------------------------------------------------------
+// Accessibility helpers
+// ---------------------------------------------------------------------------
+export { buildChartSummary, buildPointAnnouncement, buildTotalAnnouncement } from "./a11y/summary.js";
+
+// The package's own texts, for translation (CHT-05).
+export { chartStrings } from "./contract/strings.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","isWithheld","known","notApplicable","participatesInTotals","sumKnown","unknown","withheld","FAMILY_POSITION_KINDS","familyAcceptsPositionKind","resolveFormat","resolveUnit","findTarget","isUsableTarget","readProgress","NON_VALUE_TEXT","formatLegendDefault","formatPositionDefault","formatValueDefault","seriesRef","STATUS_PRECEDENCE","drawsData","resolveStatus","suppressesInteraction","isChartError","sameSelection","defaultChartTheme","resolveSeriesColor","DATASET_BUDGETS","checkBudget","BarChart","DistributionChart","HeatmapChart","ProgressChart","TimeSeriesChart","ChartLegend","ColorScaleLegend","buildLegendEntries","ChartThemeProvider","useChartTheme","buildChartSummary","buildPointAnnouncement","buildTotalAnnouncement","chartStrings"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAUA,SACCA,OAAO,EACPC,UAAU,EACVC,KAAK,EACLC,aAAa,EACbC,oBAAoB,EACpBC,QAAQ,EACRC,OAAO,EACPC,QAAQ,QACF,qBAAkB;;AAEzB;AACA;AACA;;AAaA,SACCC,qBAAqB,EACrBC,yBAAyB,EACzBC,aAAa,EACbC,WAAW,QACL,0BAAuB;AAK9B,SAASC,UAAU,EAAEC,cAAc,EAAEC,YAAY,QAAQ,sBAAmB;;AAE5E;AACA;AACA;;AAEA,SACCC,cAAc,EACdC,mBAAmB,EACnBC,qBAAqB,EACrBC,kBAAkB,EAClBC,SAAS,QACH,sBAAmB;;AAE1B;AACA;AACA;;AAOA,SACCC,iBAAiB,EACjBC,SAAS,EACTC,aAAa,EACbC,qBAAqB,QACf,qBAAkB;AASzB,SAASC,YAAY,QAAQ,sBAAmB;;AAEhD;AACA;AACA;;AAQA,SAASC,aAAa,QAAQ,2BAAwB;;AAEtD;AACA;AACA;;AAEA,SAASC,iBAAiB,EAAEC,kBAAkB,QAAQ,qBAAkB;;AAExE;AACA;AACA;;AAGA;AACA;AACA;;AAEA,SAASC,eAAe,EAAEC,WAAW,QAAQ,yBAAsB;;AAEnE;AACA;AACA;;AAQA,SACCC,QAAQ,EACRC,iBAAiB,EACjBC,YAAY,EACZC,aAAa,EACbC,eAAe,QACT,mBAAgB;AAEvB,SAASC,WAAW,EAAEC,gBAAgB,EAAEC,kBAAkB,QAAQ,wBAAqB;AAEvF,SAASC,kBAAkB,EAAEC,aAAa,QAAQ,+BAA4B;;AAE9E;AACA;AACA;AACA,SAASC,iBAAiB,EAAEC,sBAAsB,EAAEC,sBAAsB,QAAQ,mBAAgB;;AAElG;AACA,SAASC,YAAY,QAAQ,uBAAoB","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/react/ChartBoundary.js

@@ -0,0 +1,75 @@
+"use strict";
+
+/**
+ * Per-chart render-failure containment (FR-038a, FR-038b).
+ *
+ * React 19 still has no hook equivalent of an error boundary —
+ * `getDerivedStateFromError` and `componentDidCatch` remain class-only — so
+ * this is a class. Forty lines beats adding a dependency for it.
+ *
+ * Three behaviours are deliberate:
+ *
+ *  - **Reset only on a real change.** The boundary clears its error when the
+ *    datasource identity or chart key changes, never on an unrelated parent
+ *    re-render. A deterministic geometry defect therefore cannot pin the CPU in
+ *    a render-fail-render loop.
+ *  - **Report once per distinct failure.** De-duplicated by signature, so a
+ *    chart re-rendered by a sibling's state change does not re-report.
+ *  - **Redact.** The report carries the chart identity and a catalogue message.
+ *    A third-party exception's own text is never copied in, because we cannot
+ *    promise it is free of data (POL-011).
+ */
+import React from 'react';
+import { chartError, failureSignature, toFailureReport } from "../contract/errors.js";
+export class ChartBoundary extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = {
+      resetKey: props.resetKey
+    };
+  }
+  static getDerivedStateFromProps(props, state) {
+    if (props.resetKey !== state.resetKey) {
+      // New data: give the chart another chance.
+      return {
+        resetKey: props.resetKey,
+        error: undefined
+      };
+    }
+    return null;
+  }
+  static getDerivedStateFromError() {
+    // This must set the error, not just acknowledge it. Returning an empty
+    // object leaves render() showing the children again, they throw again,
+    // and React escalates past the boundary — which is exactly the
+    // screen-blanking failure this class exists to prevent.
+    //
+    // componentDidCatch then refines this into a report carrying the chart
+    // identity and family.
+    return {
+      error: chartError('render', 'renderException')
+    };
+  }
+  componentDidCatch(error, info) {
+    const report = toFailureReport(this.props.family, error, this.props.chartId, info?.componentStack ?? undefined);
+    const signature = failureSignature(report);
+    if (this.state.reportedSignature === signature) {
+      this.setState({
+        error: report.error
+      });
+      return;
+    }
+    this.setState({
+      error: report.error,
+      reportedSignature: signature
+    });
+    this.props.onFailure?.(report);
+  }
+  render() {
+    if (this.state.error) {
+      return this.props.renderFallback(this.state.error);
+    }
+    return this.props.children;
+  }
+}
+//# sourceMappingURL=ChartBoundary.js.map

package/lib/module/react/ChartBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","chartError","failureSignature","toFailureReport","ChartBoundary","Component","constructor","props","state","resetKey","getDerivedStateFromProps","error","undefined","getDerivedStateFromError","componentDidCatch","info","report","family","chartId","componentStack","signature","reportedSignature","setState","onFailure","render","renderFallback","children"],"sourceRoot":"../../../src","sources":["react/ChartBoundary.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAOA,KAAK,MAAM,OAAO;AAGzB,SACCC,UAAU,EACVC,gBAAgB,EAChBC,eAAe,QAGT,uBAAoB;AAkB3B,OAAO,MAAMC,aAAa,SAASJ,KAAK,CAACK,SAAS,CAAe;EAChEC,WAAWA,CAACC,KAAY,EAAE;IACzB,KAAK,CAACA,KAAK,CAAC;IACZ,IAAI,CAACC,KAAK,GAAG;MAAEC,QAAQ,EAAEF,KAAK,CAACE;IAAS,CAAC;EAC1C;EAEA,OAAOC,wBAAwBA,CAACH,KAAY,EAAEC,KAAY,EAAgB;IACzE,IAAID,KAAK,CAACE,QAAQ,KAAKD,KAAK,CAACC,QAAQ,EAAE;MACtC;MACA,OAAO;QAAEA,QAAQ,EAAEF,KAAK,CAACE,QAAQ;QAAEE,KAAK,EAAEC;MAAU,CAAC;IACtD;IACA,OAAO,IAAI;EACZ;EAEA,OAAOC,wBAAwBA,CAAA,EAAmB;IACjD;IACA;IACA;IACA;IACA;IACA;IACA;IACA,OAAO;MAAEF,KAAK,EAAEV,UAAU,CAAC,QAAQ,EAAE,iBAAiB;IAAE,CAAC;EAC1D;EAESa,iBAAiBA,CAACH,KAAc,EAAEI,IAAiC,EAAQ;IACnF,MAAMC,MAAM,GAAGb,eAAe,CAC7B,IAAI,CAACI,KAAK,CAACU,MAAM,EACjBN,KAAK,EACL,IAAI,CAACJ,KAAK,CAACW,OAAO,EAClBH,IAAI,EAAEI,cAAc,IAAIP,SACzB,CAAC;IAED,MAAMQ,SAAS,GAAGlB,gBAAgB,CAACc,MAAM,CAAC;IAC1C,IAAI,IAAI,CAACR,KAAK,CAACa,iBAAiB,KAAKD,SAAS,EAAE;MAC/C,IAAI,CAACE,QAAQ,CAAC;QAAEX,KAAK,EAAEK,MAAM,CAACL;MAAM,CAAC,CAAC;MACtC;IACD;IAEA,IAAI,CAACW,QAAQ,CAAC;MAAEX,KAAK,EAAEK,MAAM,CAACL,KAAK;MAAEU,iBAAiB,EAAED;IAAU,CAAC,CAAC;IACpE,IAAI,CAACb,KAAK,CAACgB,SAAS,GAAGP,MAAM,CAAC;EAC/B;EAESQ,MAAMA,CAAA,EAAoB;IAClC,IAAI,IAAI,CAAChB,KAAK,CAACG,KAAK,EAAE;MACrB,OAAO,IAAI,CAACJ,KAAK,CAACkB,cAAc,CAAC,IAAI,CAACjB,KAAK,CAACG,KAAK,CAAC;IACnD;IACA,OAAO,IAAI,CAACJ,KAAK,CAACmB,QAAQ;EAC3B;AACD","ignoreList":[]}