@honua/app-platform 0.1.2-beta.0 → 0.1.7-beta.0

package/web-components/feature-table-view.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Pure presentation layer for `<honua-feature-table>` (issue #681).
+ *
+ * Everything here is a string/value function over a
+ * {@link HonuaFeatureTableViewModel}, so the WAI-ARIA grid contract and the
+ * keyboard mapping are testable without mounting a custom element, and
+ * `./elements.ts` keeps only wiring.
+ *
+ * The markup implements the WAI-ARIA `grid` pattern needed for the WCAG 2.2 AA
+ * workflow (NFR-001): a single roving `tabindex`, `role="row"`/`role="gridcell"`
+ * with 1-based `aria-rowindex`/`aria-colindex` so a virtualized window still
+ * announces absolute positions, `aria-sort` per column header, `aria-rowcount`
+ * of `-1` when the total is genuinely unknown, and a polite live region that
+ * announces result truth and reconciliation conflicts.
+ *
+ * @module
+ */
+import type { SortSpec } from "../contract/types.js";
+import { type HonuaFeatureTableConflict, type HonuaFeatureTableCount, type HonuaFeatureTableFocus, type HonuaFeatureTableFocusMove, type HonuaFeatureTableResolvedColumn, type HonuaFeatureTableSnapshot, type HonuaFeatureTableState, type HonuaFeatureTableWindow } from "./feature-table-engine.js";
+import type { HonuaFeatureTableModel } from "./types.js";
+/** One rendered row. `placeholder` rows sit inside the window but are not resident. */
+export interface HonuaFeatureTableViewRow {
+    readonly key: string;
+    readonly sourceId: string;
+    readonly featureId: string;
+    /** 1-based absolute grid row index (header is row 1). */
+    readonly ariaRowIndex: number;
+    readonly selected: boolean;
+    readonly cells: readonly string[];
+    readonly placeholder: boolean;
+}
+/** Everything the renderer needs. Derived from an engine snapshot. */
+export interface HonuaFeatureTableViewModel {
+    readonly label: string;
+    readonly state: HonuaFeatureTableState;
+    readonly columns: readonly HonuaFeatureTableResolvedColumn[];
+    readonly rows: readonly HonuaFeatureTableViewRow[];
+    readonly window: HonuaFeatureTableWindow;
+    readonly ariaRowCount: number;
+    readonly countLabel: string;
+    readonly statusLabel: string;
+    readonly sort: readonly SortSpec[];
+    readonly focus?: HonuaFeatureTableFocus;
+    readonly conflicts: readonly HonuaFeatureTableConflict[];
+    /** Row height in CSS pixels; drives the virtualization spacers. */
+    readonly rowHeight: number;
+    readonly busy: boolean;
+}
+/** Caller-supplied labels and announcements for `<honua-feature-table>`. */
+export interface HonuaFeatureTableMessages {
+    readonly label?: string;
+    readonly count?: (count: HonuaFeatureTableCount) => string;
+    readonly status?: Partial<Readonly<Record<HonuaFeatureTableState, string>>>;
+    readonly state?: (state: HonuaFeatureTableState, count: HonuaFeatureTableCount, message?: string) => string;
+}
+/** Human/screen-reader summary of the table's lifecycle state. */
+export declare function describeFeatureTableState(state: HonuaFeatureTableState, count: HonuaFeatureTableCount, message: string | undefined, messages?: HonuaFeatureTableMessages): string;
+/** Project an engine snapshot onto the renderer's view model. */
+export declare function featureTableViewModel<T>(snapshot: HonuaFeatureTableSnapshot<T>, options?: {
+    readonly label?: string;
+    readonly rowHeight?: number;
+    readonly messages?: HonuaFeatureTableMessages;
+}): HonuaFeatureTableViewModel;
+/**
+ * Project the legacy single-page {@link HonuaFeatureTableModel} onto the same
+ * view model, so a `<honua-feature-table>` with no bounded engine attached
+ * still renders the full accessible grid. Result truth is derived
+ * conservatively: a model that exceeded its transfer limit reports `partial`
+ * with no total, never the returned row count dressed up as one.
+ */
+export declare function legacyFeatureTableViewModel<T>(model: HonuaFeatureTableModel<T>, options?: {
+    readonly label?: string;
+    readonly rowHeight?: number;
+    readonly selectedFeatureId?: string;
+    readonly messages?: HonuaFeatureTableMessages;
+}): HonuaFeatureTableViewModel;
+/**
+ * Map a `KeyboardEvent.key` (plus modifiers) onto a grid navigation move.
+ * Returns `undefined` for keys the grid must not swallow.
+ */
+export declare function featureTableFocusMoveForKey(key: string, modifiers?: {
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+}): HonuaFeatureTableFocusMove | undefined;
+/**
+ * Render the accessible, virtualized grid.
+ *
+ * The window is positioned with two spacer rows sized in `rowHeight`
+ * increments, so only the resident window exists in the DOM while the scroll
+ * height still reflects the known total (REQ-002).
+ */
+export declare function featureTableGridHtml(model: HonuaFeatureTableViewModel): string;
+/** Grid styles layered on top of the kit's shared `tableStyles()`. */
+export declare function featureTableGridStyles(): string;
+//# sourceMappingURL=feature-table-view.d.ts.map

package/web-components/feature-table-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-table-view.d.ts","sourceRoot":"","sources":["../../../src/web-components/feature-table-view.ts"],"names":[],"mappings":"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"}

package/web-components/feature-table-view.js

@@ -0,0 +1,343 @@
+/**
+ * Pure presentation layer for `<honua-feature-table>` (issue #681).
+ *
+ * Everything here is a string/value function over a
+ * {@link HonuaFeatureTableViewModel}, so the WAI-ARIA grid contract and the
+ * keyboard mapping are testable without mounting a custom element, and
+ * `./elements.ts` keeps only wiring.
+ *
+ * The markup implements the WAI-ARIA `grid` pattern needed for the WCAG 2.2 AA
+ * workflow (NFR-001): a single roving `tabindex`, `role="row"`/`role="gridcell"`
+ * with 1-based `aria-rowindex`/`aria-colindex` so a virtualized window still
+ * announces absolute positions, `aria-sort` per column header, `aria-rowcount`
+ * of `-1` when the total is genuinely unknown, and a polite live region that
+ * announces result truth and reconciliation conflicts.
+ *
+ * @module
+ */
+import { describeFeatureTableCount, featureTableAriaRowCount, featureTableAriaSort, formatFeatureTableCell, } from "./feature-table-engine.js";
+/** Human/screen-reader summary of the table's lifecycle state. */
+export function describeFeatureTableState(state, count, message, messages) {
+    if (messages?.state)
+        return messages.state(state, count, message);
+    const countLabel = messages?.count?.(count) ?? describeFeatureTableCount(count);
+    const statusLabel = messages?.status?.[state];
+    if (statusLabel !== undefined)
+        return statusLabel;
+    switch (state) {
+        case "idle":
+            return "Not loaded";
+        case "loading":
+            return "Loading rows";
+        case "ready":
+            return countLabel;
+        case "partial":
+            return `Partial results — ${countLabel}`;
+        case "stale":
+            return `Stale results — ${message ?? countLabel}`;
+        case "cancelled":
+            return message ?? "The request was cancelled";
+        case "unsupported":
+            return message ?? "This table configuration is not supported by the source";
+        default:
+            return message ?? "The table query failed";
+    }
+}
+/** Project an engine snapshot onto the renderer's view model. */
+export function featureTableViewModel(snapshot, options = {}) {
+    const columns = snapshot.visibleColumns.length > 0 ? snapshot.visibleColumns : snapshot.columns;
+    const rows = snapshot.rows.map((row, offset) => row ? viewRow(row, columns, snapshot.selection) : placeholderRow(snapshot.window.startIndex + offset, columns));
+    return Object.freeze({
+        label: options.label ?? options.messages?.label ?? "Features",
+        state: snapshot.state,
+        columns,
+        rows: Object.freeze(rows),
+        window: snapshot.window,
+        ariaRowCount: featureTableAriaRowCount(snapshot.count),
+        countLabel: options.messages?.count?.(snapshot.count) ?? describeFeatureTableCount(snapshot.count),
+        statusLabel: describeFeatureTableState(snapshot.state, snapshot.count, snapshot.message, options.messages),
+        sort: snapshot.sort,
+        ...(snapshot.focus ? { focus: snapshot.focus } : {}),
+        conflicts: snapshot.conflicts,
+        rowHeight: options.rowHeight ?? 32,
+        busy: snapshot.state === "loading",
+    });
+}
+/**
+ * Project the legacy single-page {@link HonuaFeatureTableModel} onto the same
+ * view model, so a `<honua-feature-table>` with no bounded engine attached
+ * still renders the full accessible grid. Result truth is derived
+ * conservatively: a model that exceeded its transfer limit reports `partial`
+ * with no total, never the returned row count dressed up as one.
+ */
+export function legacyFeatureTableViewModel(model, options = {}) {
+    const columns = resolveLegacyColumns(model.fields);
+    const partial = model.exceededTransferLimit === true;
+    const count = partial
+        ? { kind: "partial", loaded: model.rows.length, evidence: "loaded-rows" }
+        : { kind: "known", value: model.totalCount, loaded: model.rows.length, evidence: "result-total-count" };
+    const state = legacyState(model.status, partial);
+    const rows = model.rows.map((row, index) => Object.freeze({
+        key: `${row.sourceId}:${String(row.id)}`,
+        sourceId: row.sourceId,
+        featureId: String(row.id),
+        ariaRowIndex: index + 2,
+        selected: options.selectedFeatureId !== undefined && options.selectedFeatureId === String(row.id),
+        cells: Object.freeze(columns.map((column) => formatFeatureTableCell(row.attributes[column.field]))),
+        placeholder: false,
+    }));
+    return Object.freeze({
+        label: options.label ?? options.messages?.label ?? "Features",
+        state,
+        columns,
+        rows: Object.freeze(rows),
+        window: Object.freeze({ startIndex: 0, endIndex: rows.length }),
+        ariaRowCount: featureTableAriaRowCount(count),
+        countLabel: options.messages?.count?.(count) ?? describeFeatureTableCount(count),
+        statusLabel: describeFeatureTableState(state, count, undefined, options.messages),
+        sort: Object.freeze([]),
+        conflicts: Object.freeze([]),
+        rowHeight: options.rowHeight ?? 32,
+        busy: model.status === "loading",
+    });
+}
+function legacyState(status, partial) {
+    if (status === "error")
+        return "error";
+    if (status === "unsupported")
+        return "unsupported";
+    if (status === "loading")
+        return "loading";
+    if (status === "idle")
+        return "idle";
+    return partial ? "partial" : "ready";
+}
+function resolveLegacyColumns(fields) {
+    return Object.freeze(fields.map((field) => Object.freeze({ field, label: field, type: "unknown", visible: true, sortable: false })));
+}
+function viewRow(row, columns, selection) {
+    const attributes = row.attributes;
+    return Object.freeze({
+        key: row.key,
+        sourceId: row.sourceId,
+        featureId: String(row.id),
+        ariaRowIndex: row.index + 2,
+        selected: selection.includes(row.key),
+        cells: Object.freeze(columns.map((column) => formatFeatureTableCell(attributes[column.field], column))),
+        placeholder: false,
+    });
+}
+function placeholderRow(index, columns) {
+    return Object.freeze({
+        key: `placeholder:${index}`,
+        sourceId: "",
+        featureId: "",
+        ariaRowIndex: index + 2,
+        selected: false,
+        cells: Object.freeze(columns.map(() => "")),
+        placeholder: true,
+    });
+}
+/**
+ * Map a `KeyboardEvent.key` (plus modifiers) onto a grid navigation move.
+ * Returns `undefined` for keys the grid must not swallow.
+ */
+export function featureTableFocusMoveForKey(key, modifiers = {}) {
+    const jump = Boolean(modifiers.ctrl ?? modifiers.meta);
+    switch (key) {
+        case "ArrowUp":
+            return "up";
+        case "ArrowDown":
+            return "down";
+        case "ArrowLeft":
+            return "left";
+        case "ArrowRight":
+            return "right";
+        case "Home":
+            return jump ? "grid-start" : "row-start";
+        case "End":
+            return jump ? "grid-end" : "row-end";
+        case "PageUp":
+            return "page-up";
+        case "PageDown":
+            return "page-down";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Render the accessible, virtualized grid.
+ *
+ * The window is positioned with two spacer rows sized in `rowHeight`
+ * increments, so only the resident window exists in the DOM while the scroll
+ * height still reflects the known total (REQ-002).
+ */
+export function featureTableGridHtml(model) {
+    const columnCount = Math.max(1, model.columns.length);
+    const leading = model.window.startIndex * model.rowHeight;
+    const knownRows = model.ariaRowCount > 0 ? model.ariaRowCount - 1 : model.window.endIndex;
+    const trailing = Math.max(0, (knownRows - model.window.endIndex) * model.rowHeight);
+    const focusedRow = model.focus?.rowKey;
+    const focusedField = model.focus?.field;
+    const hasFocus = model.rows.some((row) => row.key === focusedRow);
+    return `
+    <style>
+      [data-leading] { height: ${leading}px; }
+      [data-trailing] { height: ${trailing}px; }
+    </style>
+    <section class="table-panel" part="panel">
+      <div class="table-panel__bar">
+        <h2 id="honua-ft-label">${escapeHtml(model.label)}</h2>
+        <span class="count" data-count>${escapeHtml(model.countLabel)}</span>
+      </div>
+      <p class="status" data-status role="status" aria-live="polite">${escapeHtml(statusText(model))}</p>
+      <div class="table-wrap" data-scroller>
+        <div class="spacer" data-leading></div>
+        <table
+          role="grid"
+          aria-labelledby="honua-ft-label"
+          aria-rowcount="${model.ariaRowCount}"
+          aria-colcount="${columnCount}"
+          aria-busy="${String(model.busy)}"
+          data-grid
+        >
+          <thead>
+            <tr role="row" aria-rowindex="1">
+              ${model.columns
+        .map((column, index) => `
+              <th
+                role="columnheader"
+                scope="col"
+                aria-colindex="${index + 1}"
+                aria-sort="${featureTableAriaSort(column.field, model.sort)}"
+                data-field="${escapeAttribute(column.field)}"
+              >
+                ${column.sortable
+        ? `<button type="button" data-sort-field="${escapeAttribute(column.field)}">${escapeHtml(column.label)}</button>`
+        : escapeHtml(column.label)}
+              </th>`)
+        .join("")}
+            </tr>
+          </thead>
+          <tbody>
+            ${model.rows.length === 0
+        ? `<tr role="row"><td role="gridcell" colspan="${columnCount}" class="empty">${escapeHtml(model.statusLabel)}</td></tr>`
+        : model.rows
+            .map((row, rowOffset) => bodyRowHtml(row, rowOffset, model, focusedRow, focusedField, hasFocus))
+            .join("")}
+          </tbody>
+        </table>
+        <div class="spacer" data-trailing></div>
+      </div>
+    </section>
+  `;
+}
+function bodyRowHtml(row, rowOffset, model, focusedRow, focusedField, hasFocus) {
+    // Roving tabindex: exactly one cell in the grid is tabbable. When the focused
+    // row scrolled out of the window, the first cell of the first row takes it so
+    // the grid never becomes keyboard-unreachable.
+    //
+    // Rows carry `tabindex="-1"`: programmatically focusable (so a host app — or a
+    // test — can reveal and focus a whole row, which the pre-grid markup allowed
+    // via `tabindex="0"`) while staying out of the tab sequence, which the cells
+    // own. Row-level Enter/Space still selects; see `#bindGrid`.
+    const rovingRow = hasFocus ? row.key === focusedRow : rowOffset === 0;
+    return `
+            <tr
+              role="row"
+              tabindex="-1"
+              aria-rowindex="${row.ariaRowIndex}"
+              aria-selected="${String(row.selected)}"
+              ${row.placeholder ? 'data-placeholder="true"' : `data-row-key="${escapeAttribute(row.key)}"`}
+              ${row.placeholder ? "" : `data-source-id="${escapeAttribute(row.sourceId)}"`}
+              ${row.placeholder ? "" : `data-feature-id="${escapeAttribute(row.featureId)}"`}
+            >
+              ${row.cells
+        .map((cell, cellIndex) => {
+        const column = model.columns[cellIndex];
+        const field = column?.field ?? "";
+        const roving = rovingRow && (hasFocus ? field === focusedField : cellIndex === 0);
+        // `data-cell-key` is grid-unique. The kit restores focus after
+        // a re-render by matching the active element's first `data-`
+        // attribute alphabetically, and `data-field` alone matches the
+        // same column in *every* row — which silently dragged focus to
+        // row 1. This sorts before `data-field`, so focus returns to
+        // the exact cell that had it.
+        return `<td
+                role="gridcell"
+                aria-colindex="${cellIndex + 1}"
+                tabindex="${roving ? "0" : "-1"}"
+                data-cell-key="${escapeAttribute(`${row.key}::${field}`)}"
+                data-field="${escapeAttribute(field)}"
+              >${escapeHtml(cell)}</td>`;
+    })
+        .join("")}
+            </tr>`;
+}
+function statusText(model) {
+    if (model.conflicts.length === 0)
+        return model.statusLabel;
+    return `${model.statusLabel}. ${model.conflicts.map((conflict) => conflict.message).join(" ")}`;
+}
+/** Grid styles layered on top of the kit's shared `tableStyles()`. */
+export function featureTableGridStyles() {
+    return `
+    .table-panel { max-width: 100%; min-width: 0; }
+    .table-panel__bar { gap: 8px; min-width: 0; }
+    .table-panel__bar h2 { min-width: 0; overflow-wrap: anywhere; }
+    .table-wrap { max-width: 100%; overflow-x: auto; overflow-y: auto; }
+    .table-wrap table { min-width: 100%; width: 100%; }
+    .table-panel__bar .count { color: var(--honua-ui-muted); font-variant-numeric: tabular-nums; }
+    .status {
+      color: var(--honua-ui-muted);
+      margin: 0;
+      padding-block: 4px;
+      padding-inline: 10px;
+    }
+    .status:empty { display: none; }
+    .spacer { width: 1px; }
+    [role="columnheader"] button {
+      appearance: none;
+      background: none;
+      border: 0;
+      color: inherit;
+      cursor: pointer;
+      font: inherit;
+      font-weight: 650;
+      padding: 0;
+      text-align: start;
+      width: 100%;
+    }
+    [role="columnheader"][aria-sort="ascending"] button::after { content: " \\2191"; }
+    [role="columnheader"][aria-sort="descending"] button::after { content: " \\2193"; }
+    [role="gridcell"]:focus-visible,
+    [role="gridcell"]:focus {
+      outline: 2px solid var(--honua-ui-accent);
+      outline-offset: -2px;
+    }
+    [data-placeholder="true"] [role="gridcell"] { color: transparent; }
+    [data-placeholder="true"] [role="gridcell"]::after {
+      background: var(--honua-ui-border);
+      border-radius: 3px;
+      content: "";
+      display: block;
+      height: 8px;
+      opacity: 0.6;
+      width: 60%;
+    }
+    @media (max-width: 320px) {
+      .table-wrap th,
+      .table-wrap td {
+        overflow-wrap: anywhere;
+        text-overflow: clip;
+        white-space: normal;
+      }
+    }
+  `;
+}
+function escapeHtml(value) {
+    return value.split("&").join("&amp;").split("<").join("&lt;").split(">").join("&gt;").split('"').join("&quot;");
+}
+function escapeAttribute(value) {
+    return escapeHtml(value).split("'").join("&#39;");
+}

package/web-components/index.d.ts

@@ -19,13 +19,44 @@
  * distance/area drawing on the map's pointer events, computed with
  * `@honua/geometry` ops) — needs no external drawing provider.
  *
+ * `<honua-legend>` and `<honua-layer-list>` are also each contested by the
+ * `controls` kit's own framework-free implementation. This kit's classes are
+ * both tags' canonical/default registrant: importing `./web-components` —
+ * alone, or alongside `@honua/sdk-js/controls` in either order — always
+ * registers these tags with the classes exported here (issue #679; see
+ * `./catalog.js` for the full ownership record and `./registry.js` for the
+ * catalog-id-addressable registration APIs re-exported below).
+ *
  * @experimental This entrypoint is not yet covered by the SDK's semver contract
  *   — the surface may change in any minor release prior to `1.0.0`.
  * @module
  */
-import "./elements.js";
 export { HonuaInMemoryWebComponentController, createHonuaWebComponentController, createHonuaWebComponentControllerFromRuntime, layersFromMapPackage, legendFromMapPackage, } from "./controller.js";
-export { HonuaActionPanelElement, HonuaBasemapControlElement, HonuaBookmarksElement, HonuaChartElement, HonuaEditorElement, HonuaFeatureTableElement, HonuaLayerListElement, HonuaLegendElement, HonuaLocateControlElement, HonuaMapElement, HonuaMapStatusElement, HonuaMeasureControlElement, HonuaPrintExportElement, HonuaSearchElement, HonuaSketchControlElement, defineHonuaWebComponents, } from "./elements.js";
+export { HONUA_COMPONENT_CATALOG, describeDeprecatedComponentImport, getCanonicalComponentCatalogEntry, getComponentCatalogEntriesForTag, getComponentCatalogEntry, listComponentCatalogEntries, listDeprecatedComponentImports, } from "../controls/catalog.js";
+export type { HonuaComponentCatalogEntry, HonuaComponentSource, HonuaComponentSupportTier, HonuaDeprecatedComponentDiagnostic, } from "../controls/catalog.js";
+export { HonuaComponentCatalogError, createComponentRegistry, registerAllComponents, registerComponent, registerComponents, } from "../controls/registry.js";
+export type { HonuaComponentCatalogId, HonuaComponentRegistrationOptions, HonuaComponentRegistry, } from "../controls/registry.js";
+export { HonuaActionPanelElement, HonuaBasemapControlElement, HonuaBookmarksElement, HonuaChartElement, HonuaEditorElement, HonuaFeatureTableElement, HonuaLayerListElement, HonuaLegendElement, HonuaLocateControlElement, HonuaMapElement, HonuaMapStatusElement, HonuaMeasureControlElement, HonuaPrintExportElement, HonuaSearchElement, HonuaSketchControlElement, defineHonuaWebComponent, defineHonuaWebComponents, honuaExportKindFromFormat, } from "./elements.js";
+export type { HonuaFeatureTableConflictDetail } from "./elements.js";
 export { HonuaMeasurementElement, defineHonuaMeasurement } from "./measurement.js";
-export type { HonuaActionDetail, HonuaActionPanelAction, HonuaBasemapChangeDetail, HonuaBookmark, HonuaBookmarkChangeDetail, CreateHonuaWebComponentControllerOptions, HonuaChartDatum, HonuaChartModel, HonuaComponentStatus, HonuaControllerReadyDetail, HonuaControllerStateListener, HonuaControllerSubscription, HonuaEditCapabilities, HonuaEditChangeDetail, HonuaEditRequest, HonuaEditorModel, HonuaExportDetail, HonuaFeatureRecord, HonuaFeatureStateEntry, HonuaFeatureStateTarget, HonuaFeatureTableModel, HonuaFilterChangeDetail, HonuaFilterState, HonuaFullscreenChangeDetail, HonuaGeocodeSelectDetail, HonuaLayerModel, HonuaLayerOpacityChangeDetail, HonuaLayerOrderChangeDetail, HonuaLayerVisibilityChangeDetail, HonuaLegendItem, HonuaLocateChangeDetail, HonuaMapClickDetail, HonuaMapErrorDetail, HonuaMapHoverDetail, HonuaMapInteractionDetail, HonuaMapInteractionPoint, HonuaMapReadyDetail, HonuaMeasureChangeDetail, HonuaMeasureMode, HonuaMeasureProvider, HonuaMeasureResult, HonuaMeasurementMap, HonuaQueryFeaturesOptions, HonuaSearchDetail, HonuaSearchGeocodeCandidate, HonuaSearchGeocodeSuggestion, HonuaSearchGeocoderLike, HonuaSearchOptions, HonuaSearchResult, HonuaSelectionChangeDetail, HonuaSelectionState, HonuaSketchChangeDetail, HonuaSketchMode, HonuaSketchProvider, HonuaSketchResult, HonuaViewportChangeDetail, HonuaViewportState, HonuaWebComponentController, HonuaWebComponentRuntimeLike, HonuaWebComponentState, } from "./types.js";
+export { HonuaTimeSliderElement, defineHonuaTimeSlider } from "./time-slider.js";
+export { HONUA_EXPORT_KINDS, HonuaExportError, approximateHonuaScaleLabel, assertHonuaExportProvenanceComplete, assertHonuaExportReady, buildHonuaExportProvenance, createBrowserPrintExportAdapter, createHonuaExportAdapter, runHonuaExport, } from "./export.js";
+export type { BuildHonuaExportProvenanceOptions, CreateHonuaExportAdapterOptions, HonuaExportAdapter, HonuaExportCapabilities, HonuaExportContext, HonuaExportKind, HonuaExportOwnership, HonuaExportPayload, HonuaExportProvenance, HonuaExportRequest, HonuaExportResult, HonuaExportStatus, HonuaPrintWindowLike, HonuaSnapshotCanvasLike, HonuaSnapshotSource, } from "./export.js";
+export { HONUA_EXPORT_REDACTED, HONUA_EXPORT_STATE_SCHEMA, HonuaExportSafetyError, assertCredentialFreeExportBytes, assertCredentialFreeExportText, containsCredentialMaterial, extractPrintableRuns, isSensitiveExportKey, projectExportEndpoint, redactHonuaExportText, sanitizeHonuaExportFilename, sanitizeHonuaExportHeaders, sanitizeHonuaExportState, } from "./export-redaction.js";
+export type { HonuaExportEndpointProjection, HonuaExportRedaction, HonuaExportRedactionReason, HonuaExportStateSanitizationResult, HonuaSanitizedExportFilter, HonuaSanitizedExportLayer, HonuaSanitizedExportLegendItem, HonuaSanitizedExportSelection, HonuaSanitizedExportSource, HonuaSanitizedExportState, SanitizeHonuaExportFilenameOptions, SanitizeHonuaExportStateOptions, } from "./export-redaction.js";
+export { HONUA_COMPONENT_QUALIFICATION_DATA_VERSION, HONUA_COMPONENT_QUALIFICATION_GATES, HONUA_COMPONENT_QUALIFICATION_STATUSES, describeComponentQualificationGate, getComponentQualification, isComponentProductionQualified, listOpenQualificationGates, listComponentQualifications, summarizeComponentQualification, } from "../controls/qualification.js";
+export type { HonuaComponentQualification, HonuaComponentQualificationGate, HonuaComponentQualificationGateId, HonuaComponentQualificationRequirement, HonuaComponentQualificationStatus, HonuaComponentQualificationSummary, HonuaComponentQualificationCell, } from "../controls/qualification.js";
+export { DEFAULT_FEATURE_TABLE_BUDGETS, createHonuaFeatureTable, describeFeatureTableCount, explorationClauseToFilterClause, filterClauseToExplorationClause, featureTableAriaRowCount, featureTableAriaSort, featureTablePageCacheKey, featureTableRowKey, featureTableWindow, featureTableWorkByTier, formatFeatureTableCell, linkFeatureTableToExploration, } from "./feature-table-engine.js";
+export type { CreateHonuaFeatureTableOptions, HonuaFeatureTable, HonuaFeatureTableBudgetKind, HonuaFeatureTableBudgetLedger, HonuaFeatureTableBudgets, HonuaFeatureTableColumn, HonuaFeatureTableColumnType, HonuaFeatureTableConflict, HonuaFeatureTableConflictCode, HonuaFeatureTableCount, HonuaFeatureTableCountEvidence, HonuaFeatureTableExport, HonuaFeatureTableExportRequest, HonuaFeatureTableFocus, HonuaFeatureTableFocusMove, HonuaFeatureTablePageIdentity, HonuaFeatureTablePaging, HonuaFeatureTablePagingMode, HonuaFeatureTablePlanner, HonuaFeatureTableQueryEvidence, HonuaFeatureTableQuerySource, HonuaFeatureTableRealtimeDiff, HonuaFeatureTableRealtimeOutcome, HonuaFeatureTableResolvedColumn, HonuaFeatureTableRow, HonuaFeatureTableRowKey, HonuaFeatureTableScrollMetrics, HonuaFeatureTableSnapshot, HonuaFeatureTableState, HonuaFeatureTableWindow, HonuaFeatureTableWorkConcern, HonuaFeatureTableWorkItem, HonuaFeatureTableWorkTier, LinkFeatureTableToExplorationOptions, } from "./feature-table-engine.js";
+export { describeFeatureTableState, featureTableFocusMoveForKey, featureTableGridHtml, featureTableGridStyles, featureTableViewModel, legacyFeatureTableViewModel, } from "./feature-table-view.js";
+export type { HonuaFeatureTableMessages, HonuaFeatureTableViewModel, HonuaFeatureTableViewRow, } from "./feature-table-view.js";
+export { HonuaFeatureEditorElement, defineHonuaFeatureEditor } from "./feature-editor.js";
+export type { HonuaFeatureEditChangeDetail, HonuaFeatureEditCommitDetail } from "./feature-editor.js";
+export { HonuaFeatureEditorWorkflow, createFeatureEditorWorkflow } from "./feature-editor-workflow.js";
+export type { HonuaFeatureEditorCommit, HonuaFeatureEditorConflict, HonuaFeatureEditorConflictChoice, HonuaFeatureEditorExternalChangeOutcome, HonuaFeatureEditorFailure, HonuaFeatureEditorIdentity, HonuaFeatureEditorOptions, HonuaFeatureEditorSketchState, HonuaFeatureEditorSnapshot, HonuaFeatureEditorStatus, } from "./feature-editor-workflow.js";
+export { buildEditorFormModel, coerceEditorFieldValue, editorControlKind, editorDomainFromSchema, editorFieldInputValue, editorFieldsFromSchema, editorOperationAvailability, hiddenEditorFieldNames, redactEditorAttachment, resolveActiveEditorSubtype, resolveEditorFields, resolveEditorOperations, } from "./feature-editor-model.js";
+export type { BuildEditorFormModelInput, HonuaEditorAttachmentDraft, HonuaEditorAttachmentMutationLike, HonuaEditorCapabilityDecisionLike, HonuaEditorChoice, HonuaEditorControlKind, HonuaEditorFieldControl, HonuaEditorFormModel, HonuaEditorOperation, HonuaEditorOperationAvailability, HonuaEditorOperationOverride, HonuaEditorOperationOverrides, HonuaEditorSchemaDomainLike, HonuaEditorSchemaFieldLike, HonuaEditorSubtype, HonuaEditorSubtypeConfig, HonuaEditorSubtypeFieldOverride, HonuaEditorUnavailableCode, ResolveEditorOperationsInput, } from "./feature-editor-model.js";
+export { bindEditorSketch, createTerraDrawEditorSketch, editorSnappingOptions } from "./feature-editor-sketch.js";
+export type { CreateTerraDrawEditorSketchOptions, HonuaEditorSketchAdapter, HonuaEditorSketchOptions, HonuaEditorSnappingOptions, } from "./feature-editor-sketch.js";
+export type { HonuaActionDetail, HonuaActionPanelAction, HonuaActionPanelMessages, HonuaBasemapChangeDetail, HonuaBasemapControlMessages, HonuaBookmark, HonuaBookmarkChangeDetail, HonuaBookmarksMessages, CreateHonuaWebComponentControllerOptions, HonuaChartDatum, HonuaChartModel, HonuaChartMessages, HonuaComponentStatus, HonuaControllerReadyDetail, HonuaControllerStateListener, HonuaControllerSubscription, HonuaEditCapabilities, HonuaEditChangeDetail, HonuaEditRequest, HonuaEditorMessages, HonuaEditorModel, HonuaExportDetail, HonuaFeatureRecord, HonuaFeatureEditorMessages, HonuaFeatureStateEntry, HonuaFeatureStateTarget, HonuaFeatureTableModel, HonuaFilterChangeDetail, HonuaFilterState, HonuaFullscreenChangeDetail, HonuaGeocodeSelectDetail, HonuaLayerListMessages, HonuaLayerModel, HonuaLayerOpacityChangeDetail, HonuaLayerOrderChangeDetail, HonuaLayerVisibilityChangeDetail, HonuaLegendItem, HonuaLegendMessages, HonuaLocateControlMessages, HonuaLocateChangeDetail, HonuaMapMessages, HonuaMapStatusMessages, HonuaMapClickDetail, HonuaMapErrorDetail, HonuaMapHoverDetail, HonuaMapInteractionDetail, HonuaMapInteractionPoint, HonuaMapReadyDetail, HonuaMeasureChangeDetail, HonuaMeasureControlMessages, HonuaMeasureMode, HonuaMeasurementMessages, HonuaPrintExportMessages, HonuaMeasureProvider, HonuaMeasureResult, HonuaMeasurementMap, HonuaQueryFeaturesOptions, HonuaSearchDetail, HonuaSearchMessages, HonuaSearchGeocodeCandidate, HonuaSearchGeocodeSuggestion, HonuaSearchGeocoderLike, HonuaSearchOptions, HonuaSearchResult, HonuaSelectionChangeDetail, HonuaSelectionState, HonuaSketchChangeDetail, HonuaSketchControlMessages, HonuaSketchMode, HonuaSketchProvider, HonuaSketchResult, HonuaTimeChangeDetail, HonuaTimePlaybackChangeDetail, HonuaTimeSliderMessages, HonuaTimeSliderPlayback, HonuaTimeSliderWindow, HonuaViewportChangeDetail, HonuaViewportState, HonuaWebComponentController, HonuaWebComponentRuntimeLike, HonuaWebComponentState, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/web-components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web-components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,eAAe,CAAC;AAEvB,OAAO,EACL,mCAAmC,EACnC,iCAAiC,EACjC,4CAA4C,EAC5C,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACb,yBAAyB,EACzB,wCAAwC,EACxC,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web-components/index.ts"],"names":[],"mappings":"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"}

package/web-components/index.js

@@ -19,11 +19,44 @@
  * distance/area drawing on the map's pointer events, computed with
  * `@honua/geometry` ops) — needs no external drawing provider.
  *
+ * `<honua-legend>` and `<honua-layer-list>` are also each contested by the
+ * `controls` kit's own framework-free implementation. This kit's classes are
+ * both tags' canonical/default registrant: importing `./web-components` —
+ * alone, or alongside `@honua/sdk-js/controls` in either order — always
+ * registers these tags with the classes exported here (issue #679; see
+ * `./catalog.js` for the full ownership record and `./registry.js` for the
+ * catalog-id-addressable registration APIs re-exported below).
+ *
  * @experimental This entrypoint is not yet covered by the SDK's semver contract
  *   — the surface may change in any minor release prior to `1.0.0`.
  * @module
  */
-import "./elements.js";
+import { defineHonuaWebComponents } from "./elements.js";
+// The blanket auto-registration side effect lives here, not in `./elements.js`
+// (issue #679 PR review): `./elements.js` must stay side-effect-free on
+// import so `../controls/registry.js` can dynamically `import()` it to
+// register one tag without also claiming every tag the kit owns. This is
+// every existing `@honua/sdk-js/web-components` consumer's actual entry
+// point, so the observable behavior — importing this module registers all 16
+// tags when a `customElements` registry is present — is unchanged.
+defineHonuaWebComponents();
 export { HonuaInMemoryWebComponentController, createHonuaWebComponentController, createHonuaWebComponentControllerFromRuntime, layersFromMapPackage, legendFromMapPackage, } from "./controller.js";
-export { HonuaActionPanelElement, HonuaBasemapControlElement, HonuaBookmarksElement, HonuaChartElement, HonuaEditorElement, HonuaFeatureTableElement, HonuaLayerListElement, HonuaLegendElement, HonuaLocateControlElement, HonuaMapElement, HonuaMapStatusElement, HonuaMeasureControlElement, HonuaPrintExportElement, HonuaSearchElement, HonuaSketchControlElement, defineHonuaWebComponents, } from "./elements.js";
+export { HONUA_COMPONENT_CATALOG, describeDeprecatedComponentImport, getCanonicalComponentCatalogEntry, getComponentCatalogEntriesForTag, getComponentCatalogEntry, listComponentCatalogEntries, listDeprecatedComponentImports, } from "../controls/catalog.js";
+export { HonuaComponentCatalogError, createComponentRegistry, registerAllComponents, registerComponent, registerComponents, } from "../controls/registry.js";
+export { HonuaActionPanelElement, HonuaBasemapControlElement, HonuaBookmarksElement, HonuaChartElement, HonuaEditorElement, HonuaFeatureTableElement, HonuaLayerListElement, HonuaLegendElement, HonuaLocateControlElement, HonuaMapElement, HonuaMapStatusElement, HonuaMeasureControlElement, HonuaPrintExportElement, HonuaSearchElement, HonuaSketchControlElement, defineHonuaWebComponent, defineHonuaWebComponents, honuaExportKindFromFormat, } from "./elements.js";
 export { HonuaMeasurementElement, defineHonuaMeasurement } from "./measurement.js";
+// ── time slider over the temporal playback controller (issue #959) ───────
+export { HonuaTimeSliderElement, defineHonuaTimeSlider } from "./time-slider.js";
+// ── secure export contract (issue #683) ──────────────────────────────────
+export { HONUA_EXPORT_KINDS, HonuaExportError, approximateHonuaScaleLabel, assertHonuaExportProvenanceComplete, assertHonuaExportReady, buildHonuaExportProvenance, createBrowserPrintExportAdapter, createHonuaExportAdapter, runHonuaExport, } from "./export.js";
+export { HONUA_EXPORT_REDACTED, HONUA_EXPORT_STATE_SCHEMA, HonuaExportSafetyError, assertCredentialFreeExportBytes, assertCredentialFreeExportText, containsCredentialMaterial, extractPrintableRuns, isSensitiveExportKey, projectExportEndpoint, redactHonuaExportText, sanitizeHonuaExportFilename, sanitizeHonuaExportHeaders, sanitizeHonuaExportState, } from "./export-redaction.js";
+// ── production qualification matrix (issue #683) ─────────────────────────
+export { HONUA_COMPONENT_QUALIFICATION_DATA_VERSION, HONUA_COMPONENT_QUALIFICATION_GATES, HONUA_COMPONENT_QUALIFICATION_STATUSES, describeComponentQualificationGate, getComponentQualification, isComponentProductionQualified, listOpenQualificationGates, listComponentQualifications, summarizeComponentQualification, } from "../controls/qualification.js";
+// Bounded production feature table (issue #681).
+export { DEFAULT_FEATURE_TABLE_BUDGETS, createHonuaFeatureTable, describeFeatureTableCount, explorationClauseToFilterClause, filterClauseToExplorationClause, featureTableAriaRowCount, featureTableAriaSort, featureTablePageCacheKey, featureTableRowKey, featureTableWindow, featureTableWorkByTier, formatFeatureTableCell, linkFeatureTableToExploration, } from "./feature-table-engine.js";
+export { describeFeatureTableState, featureTableFocusMoveForKey, featureTableGridHtml, featureTableGridStyles, featureTableViewModel, legacyFeatureTableViewModel, } from "./feature-table-view.js";
+// ── production-tier feature editor (issue #680) ──────────────────────────
+export { HonuaFeatureEditorElement, defineHonuaFeatureEditor } from "./feature-editor.js";
+export { HonuaFeatureEditorWorkflow, createFeatureEditorWorkflow } from "./feature-editor-workflow.js";
+export { buildEditorFormModel, coerceEditorFieldValue, editorControlKind, editorDomainFromSchema, editorFieldInputValue, editorFieldsFromSchema, editorOperationAvailability, hiddenEditorFieldNames, redactEditorAttachment, resolveActiveEditorSubtype, resolveEditorFields, resolveEditorOperations, } from "./feature-editor-model.js";
+export { bindEditorSketch, createTerraDrawEditorSketch, editorSnappingOptions } from "./feature-editor-sketch.js";

package/web-components/maplibre-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maplibre-renderer.d.ts","sourceRoot":"","sources":["../../../src/web-components/maplibre-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAGV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAqCpB,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;IACrC,aAAa,IAAI,2BAA2B,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,qBAAa,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;gBAgBzC,OAAO,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAI3D,IAAW,GAAG,IAAI,OAAO,GAAG,SAAS,CAEpC;IAED,IAAW,OAAO,IAAI,4BAA4B,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhE;IAEY,UAAU,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE,UAAU,IAAI,IAAI;CAwW1B"}
+{"version":3,"file":"maplibre-renderer.d.ts","sourceRoot":"","sources":["../../../src/web-components/maplibre-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAGV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAqCpB,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;IACrC,aAAa,IAAI,2BAA2B,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,qBAAa,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;gBAgBzC,OAAO,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAI3D,IAAW,GAAG,IAAI,OAAO,GAAG,SAAS,CAEpC;IAED,IAAW,OAAO,IAAI,4BAA4B,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhE;IAEY,UAAU,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE,UAAU,IAAI,IAAI;CAoX1B"}

package/web-components/maplibre-renderer.js

@@ -64,9 +64,13 @@ export class HonuaMapLibreRenderer {
             ]);
             if (token !== this.#loadToken)
                 return;
-            const MapCtor = maplibregl.default?.Map ?? maplibregl.Map;
-            if (!MapCtor)
-                throw new Error("maplibre-gl did not export Map.");
+            // MapLibre 6 is ESM-only and publishes named exports; MapLibre 5 is
+            // reachable through either shape depending on how the host bundles it.
+            // Accept both so one renderer covers the whole `^5 || ^6` peer range.
+            const MapCtor = maplibregl.Map ?? maplibregl.default?.Map;
+            if (!MapCtor) {
+                throw new Error("maplibre-gl did not export a Map constructor; install maplibre-gl 5.x or 6.x (the SDK peer range is ^5.0.0 || ^6.0.0).");
+            }
             const map = new MapCtor({
                 container: this.#options.container,
                 style: emptyStyle(),
@@ -75,7 +79,12 @@ export class HonuaMapLibreRenderer {
                 bearing: mapPackage.initialView?.bearing ?? 0,
                 pitch: mapPackage.initialView?.pitch ?? 0,
                 attributionControl: false,
-                preserveDrawingBuffer: true,
+                // WebGL context attributes moved under `canvasContextAttributes` in
+                // MapLibre 5.0 and stayed there in 6.x. A top-level
+                // `preserveDrawingBuffer` is silently ignored by both majors, which
+                // would leave `<honua-map>` snapshot export (src/web-components/export.ts)
+                // reading an unreadable canvas.
+                canvasContextAttributes: { preserveDrawingBuffer: true },
             });
             this.#map = map;
             const runtime = await loadMapPackage(mapPackage, map, {

package/web-components/measurement.d.ts

@@ -33,12 +33,14 @@
  *
  * @module
  */
-import type { HonuaMeasureMode, HonuaMeasureResult, HonuaMeasurementMap } from "./types.js";
+import type { HonuaMeasureMode, HonuaMeasureResult, HonuaMeasurementMap, HonuaMeasurementMessages } from "./types.js";
 declare const HTMLElementBase: typeof HTMLElement;
 type LngLat = readonly [number, number];
 export declare class HonuaMeasurementElement extends HTMLElementBase {
     #private;
     static get observedAttributes(): string[];
+    get messages(): HonuaMeasurementMessages;
+    set messages(messages: HonuaMeasurementMessages | undefined);
     /** The MapLibre map this widget draws on. */
     get map(): HonuaMeasurementMap | undefined;
     set map(map: HonuaMeasurementMap | undefined);

package/web-components/measurement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measurement.d.ts","sourceRoot":"","sources":["../../../src/web-components/measurement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAA4B,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQtH,QAAA,MAAM,eAAe,EAAE,OAAO,WAAkF,CAAC;AAMjH,KAAK,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExC,qBAAa,uBAAwB,SAAQ,eAAe;;IAC1D,WAAkB,kBAAkB,IAAI,MAAM,EAAE,CAE/C;IAaD,6CAA6C;IAC7C,IAAW,GAAG,IAAI,mBAAmB,GAAG,SAAS,CAEhD;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,mBAAmB,GAAG,SAAS,EAMlD;IAED,wEAAwE;IACjE,OAAO,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAI9C,+BAA+B;IAC/B,IAAW,IAAI,IAAI,gBAAgB,CAElC;IAED,yDAAyD;IACzD,IAAW,MAAM,IAAI,kBAAkB,GAAG,SAAS,CAElD;IAED,4DAA4D;IAC5D,IAAW,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEvC;IAED,wEAAwE;IACjE,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAY5C,4DAA4D;IACrD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAatC,8DAA8D;IACvD,MAAM,IAAI,IAAI;IASrB,8EAA8E;IACvE,MAAM,IAAI,IAAI;IAUd,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5C,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAsMnC,SAAS,CAAC,MAAM,IAAI,IAAI;CAgFzB;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,QAAQ,wBAA2B,GAAG,IAAI,CAKhF"}
+{"version":3,"file":"measurement.d.ts","sourceRoot":"","sources":["../../../src/web-components/measurement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,KAAK,EAEV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAQpB,QAAA,MAAM,eAAe,EAAE,OAAO,WAAkF,CAAC;AAMjH,KAAK,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExC,qBAAa,uBAAwB,SAAQ,eAAe;;IAC1D,WAAkB,kBAAkB,IAAI,MAAM,EAAE,CAE/C;IASD,IAAW,QAAQ,IAAI,wBAAwB,CAE9C;IACD,IAAW,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,SAAS,EAGjE;IAOD,6CAA6C;IAC7C,IAAW,GAAG,IAAI,mBAAmB,GAAG,SAAS,CAEhD;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,mBAAmB,GAAG,SAAS,EAMlD;IAED,wEAAwE;IACjE,OAAO,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAI9C,+BAA+B;IAC/B,IAAW,IAAI,IAAI,gBAAgB,CAElC;IAED,yDAAyD;IACzD,IAAW,MAAM,IAAI,kBAAkB,GAAG,SAAS,CAElD;IAED,4DAA4D;IAC5D,IAAW,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEvC;IAED,wEAAwE;IACjE,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAY5C,4DAA4D;IACrD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAatC,8DAA8D;IACvD,MAAM,IAAI,IAAI;IASrB,8EAA8E;IACvE,MAAM,IAAI,IAAI;IAUd,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5C,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAsMnC,SAAS,CAAC,MAAM,IAAI,IAAI;CAwGzB;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,QAAQ,wBAA2B,GAAG,IAAI,CAKhF"}