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

package/controls/catalog.js

@@ -0,0 +1,341 @@
+/**
+ * Canonical component catalog for the Honua custom-element kit
+ * (`@honua/sdk-js/controls` + `@honua/sdk-js/web-components`; both moving to
+ * `@honua/app-platform` per `docs/decisions/scope-split-and-1.0.md`).
+ *
+ * Tracked by issue #679 (parent epic #678 "app-platform component production
+ * readiness"): before either kit's custom elements can be considered one
+ * coherent, production-supported surface, every shipped tag needs exactly one
+ * documented owner, described once, regardless of which subpath (or which
+ * import order) a consumer reaches it through.
+ *
+ * This module is pure metadata — it holds no reference to the actual element
+ * classes and performs no `customElements` registration. Importing it never
+ * touches DOM globals and carries none of either kit's runtime weight (in
+ * particular, none of `web-components`' `src/core` / `src/runtime`
+ * dependency), so it is safe to import from any environment — SSR, workers,
+ * either kit's bundle, or a lint/doc tool introspecting the catalog — without
+ * pulling in the other kit's closure. {@link "./registry.js"} is the
+ * companion module that turns catalog entries into actual registrations.
+ *
+ * @module
+ */
+/**
+ * The full component catalog: every custom-element tag shipped by either
+ * kit. Two tags — `honua-legend` and `honua-layer-list` — have two competing
+ * implementations (`controls` and `web-components`); each is represented as
+ * its own entry with `collidesWithIds` naming the other, and exactly one of
+ * the two is `canonical: true`.
+ */
+export const HONUA_COMPONENT_CATALOG = [
+    // ── controls kit (@honua/sdk-js/controls) ──────────────────────────────
+    {
+        id: "controls.basemap-switcher",
+        tag: "honua-basemap-switcher",
+        source: "controls",
+        className: "HonuaBasemapSwitcherElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["maplibre-map"],
+        events: ["change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "controls.swipe-control",
+        tag: "honua-swipe-control",
+        source: "controls",
+        className: "HonuaSwipeControlElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["maplibre-map"],
+        events: ["change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "controls.legend",
+        tag: "honua-legend",
+        source: "controls",
+        className: "HonuaLegendElement",
+        supportTier: "survival-tier",
+        canonical: false,
+        requiredAdapters: ["maplibre-map"],
+        events: [],
+        collidesWithIds: ["web-components.legend"],
+    },
+    {
+        id: "controls.layer-list",
+        tag: "honua-layer-list",
+        source: "controls",
+        className: "HonuaLayerListElement",
+        supportTier: "survival-tier",
+        canonical: false,
+        requiredAdapters: ["maplibre-map"],
+        events: ["change"],
+        collidesWithIds: ["web-components.layer-list"],
+    },
+    // ── web-components kit (@honua/sdk-js/web-components) ──────────────────
+    {
+        id: "web-components.map",
+        tag: "honua-map",
+        source: "web-components",
+        className: "HonuaMapElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: [],
+        events: [
+            "honua-controller-ready",
+            "honua-map-ready",
+            "honua-map-error",
+            "honua-map-click",
+            "honua-map-hover",
+            "honua-selection-change",
+            "honua-viewport-change",
+        ],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.layer-list",
+        tag: "honua-layer-list",
+        source: "web-components",
+        className: "HonuaLayerListElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-layer-visibility-change", "honua-layer-opacity-change", "honua-layer-order-change"],
+        collidesWithIds: ["controls.layer-list"],
+    },
+    {
+        id: "web-components.legend",
+        tag: "honua-legend",
+        source: "web-components",
+        className: "HonuaLegendElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: [],
+        collidesWithIds: ["controls.legend"],
+    },
+    {
+        id: "web-components.feature-table",
+        tag: "honua-feature-table",
+        source: "web-components",
+        className: "HonuaFeatureTableElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-filter-change", "honua-selection-change", "honua-table-conflict"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.search",
+        tag: "honua-search",
+        source: "web-components",
+        className: "HonuaSearchElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-search", "honua-selection-change", "honua-geocode-select"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.editor",
+        tag: "honua-editor",
+        source: "web-components",
+        className: "HonuaEditorElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-edit-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.feature-editor",
+        tag: "honua-feature-editor",
+        source: "web-components",
+        className: "HonuaFeatureEditorElement",
+        supportTier: "production-tier",
+        canonical: true,
+        requiredAdapters: ["edit-capable-source"],
+        events: ["honua-feature-edit-change", "honua-feature-edit-commit"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.chart",
+        tag: "honua-chart",
+        source: "web-components",
+        className: "HonuaChartElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: [],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.basemap-control",
+        tag: "honua-basemap-control",
+        source: "web-components",
+        className: "HonuaBasemapControlElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-basemap-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.bookmarks",
+        tag: "honua-bookmarks",
+        source: "web-components",
+        className: "HonuaBookmarksElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-bookmark-change", "honua-viewport-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.locate-control",
+        tag: "honua-locate-control",
+        source: "web-components",
+        className: "HonuaLocateControlElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-locate-change", "honua-viewport-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.measure-control",
+        tag: "honua-measure-control",
+        source: "web-components",
+        className: "HonuaMeasureControlElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller", "measurement-geometry-provider"],
+        events: ["honua-measure-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.measurement",
+        tag: "honua-measurement",
+        source: "web-components",
+        className: "HonuaMeasurementElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: [],
+        events: ["honua-measure-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.time-slider",
+        tag: "honua-time-slider",
+        source: "web-components",
+        className: "HonuaTimeSliderElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        // The temporal playback controller (`createTemporalPlayback`, issue #497)
+        // is the required adapter: the element is a view over it and renders an
+        // honest degraded panel until one is bound.
+        requiredAdapters: ["temporal-playback-controller"],
+        events: ["honua-time-change", "honua-time-playback-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.sketch-control",
+        tag: "honua-sketch-control",
+        source: "web-components",
+        className: "HonuaSketchControlElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller", "sketch-geometry-provider"],
+        events: ["honua-sketch-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.print-export",
+        tag: "honua-print-export",
+        source: "web-components",
+        className: "HonuaPrintExportElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-export"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.map-status",
+        tag: "honua-map-status",
+        source: "web-components",
+        className: "HonuaMapStatusElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-fullscreen-change"],
+        collidesWithIds: [],
+    },
+    {
+        id: "web-components.action-panel",
+        tag: "honua-action-panel",
+        source: "web-components",
+        className: "HonuaActionPanelElement",
+        supportTier: "survival-tier",
+        canonical: true,
+        requiredAdapters: ["web-component-controller"],
+        events: ["honua-action"],
+        collidesWithIds: [],
+    },
+];
+/** Looks up one catalog entry by its stable id. */
+export function getComponentCatalogEntry(id) {
+    return HONUA_COMPONENT_CATALOG.find((entry) => entry.id === id);
+}
+/** All catalog entries, optionally filtered by kit. */
+export function listComponentCatalogEntries(source) {
+    if (!source)
+        return HONUA_COMPONENT_CATALOG;
+    return HONUA_COMPONENT_CATALOG.filter((entry) => entry.source === source);
+}
+/** Every entry that registers `tag` (one entry unless the tag is contested). */
+export function getComponentCatalogEntriesForTag(tag) {
+    return HONUA_COMPONENT_CATALOG.filter((entry) => entry.tag === tag);
+}
+/** The single canonical/default entry for `tag`, or `undefined` for an unknown tag. */
+export function getCanonicalComponentCatalogEntry(tag) {
+    return HONUA_COMPONENT_CATALOG.find((entry) => entry.tag === tag && entry.canonical);
+}
+const DEPRECATED_COMPONENT_ALIASES = [
+    {
+        specifier: "@honua/sdk-js/controls",
+        canonicalReplacement: "@honua/app-platform/controls",
+        removedIn: "0.2.0",
+        note: "Moved to @honua/app-platform/controls per docs/decisions/scope-split-and-1.0.md. The @honua/sdk-js/controls re-export is retained through the 0.1.x line and removed in 0.2.0.",
+    },
+    {
+        specifier: "@honua/sdk-js/web-components",
+        canonicalReplacement: "@honua/app-platform/web-components",
+        removedIn: "0.2.0",
+        note: "Moved to @honua/app-platform/web-components per docs/decisions/scope-split-and-1.0.md. The @honua/sdk-js/web-components re-export is retained through the 0.1.x line and removed in 0.2.0.",
+    },
+    {
+        specifier: "controls.legend",
+        canonicalReplacement: "web-components.legend",
+        note: 'honua-legend\'s canonical/default registrant is the web-components (controller-driven) implementation. The controls (map-style-derive) implementation no longer auto-registers on import — call defineHonuaLegend() explicitly (or registerComponent("controls.legend")) to claim the tag with it instead.',
+    },
+    {
+        specifier: "controls.layer-list",
+        canonicalReplacement: "web-components.layer-list",
+        note: 'honua-layer-list\'s canonical/default registrant is the web-components (controller-driven) implementation. Call defineHonuaLayerList() explicitly (or registerComponent("controls.layer-list")) to claim the tag with the controls (overlay-definition) implementation instead.',
+    },
+];
+/**
+ * Looks up migration guidance for a deprecated `@honua/sdk-js` component
+ * subpath (e.g. `"@honua/sdk-js/controls"`) or a contested-tag catalog id
+ * (e.g. `"controls.legend"`). Returns `undefined` for specifiers the catalog
+ * has no recorded alias for.
+ */
+export function describeDeprecatedComponentImport(specifier) {
+    return DEPRECATED_COMPONENT_ALIASES.find((alias) => alias.specifier === specifier);
+}
+/** Every recorded deprecated component import/alias and its canonical replacement. */
+export function listDeprecatedComponentImports() {
+    return DEPRECATED_COMPONENT_ALIASES;
+}

package/controls/element-utils.d.ts

@@ -18,6 +18,8 @@ export declare const globalDom: typeof globalThis & {
     HTMLElement?: typeof HTMLElement;
     CustomEvent?: typeof CustomEvent;
     customElements?: CustomElementRegistry;
+    getComputedStyle?: typeof getComputedStyle;
+    CSSStyleSheet?: typeof CSSStyleSheet;
 };
 export declare const HTMLElementBase: typeof HTMLElement;
 /**
@@ -45,4 +47,11 @@ export declare function listenForHonuaMapReady(element: HostElementLike, assign:
 export declare function resolveHonuaMapFromContext(element: HostElementLike): unknown;
 export declare function escapeHtml(value: string): string;
 export declare function escapeAttribute(value: string): string;
+interface ShadowRenderRoot {
+    innerHTML: string;
+    adoptedStyleSheets?: CSSStyleSheet[];
+}
+/** Render controls with a constructable stylesheet when CSP-safe DOM APIs exist. */
+export declare function renderShadowRoot(root: ShadowRenderRoot, cssText: string, markup: string): void;
+export {};
 //# sourceMappingURL=element-utils.d.ts.map

package/controls/element-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-utils.d.ts","sourceRoot":"","sources":["../../../src/controls/element-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,SAAS,EAAiB,OAAO,UAAU,GAAG;IACzD,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAAO,WAAkF,CAAC;AAExH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,IAAI,IAAI,CAAC;CACtB;AAED,mIAAmI;AACnI,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS,CAIjF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC7B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAY1B;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAY5E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"element-utils.d.ts","sourceRoot":"","sources":["../../../src/controls/element-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,SAAS,EAAiB,OAAO,UAAU,GAAG;IACzD,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAAO,WAAkF,CAAC;AAExH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,IAAI,IAAI,CAAC;CACtB;AAED,mIAAmI;AACnI,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS,CAIjF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC7B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAY1B;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAY5E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAC;CACtC;AAID,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAe9F"}

package/controls/element-utils.js

@@ -76,3 +76,20 @@ export function escapeHtml(value) {
 export function escapeAttribute(value) {
     return escapeHtml(value);
 }
+const adoptedSheets = new WeakMap();
+/** Render controls with a constructable stylesheet when CSP-safe DOM APIs exist. */
+export function renderShadowRoot(root, cssText, markup) {
+    const StyleSheet = globalDom.CSSStyleSheet;
+    if (StyleSheet && Array.isArray(root.adoptedStyleSheets) && typeof StyleSheet.prototype.replaceSync === "function") {
+        let sheet = adoptedSheets.get(root);
+        if (!sheet) {
+            sheet = new StyleSheet();
+            adoptedSheets.set(root, sheet);
+            root.adoptedStyleSheets = [...root.adoptedStyleSheets, sheet];
+        }
+        sheet.replaceSync(cssText);
+        root.innerHTML = markup;
+        return;
+    }
+    root.innerHTML = `<style>${cssText}</style>${markup}`;
+}

package/controls/index.d.ts

@@ -2,19 +2,34 @@
  * Native Honua UI control kit (`@honua/sdk-js/controls`) — optional,
  * framework-free custom elements for apps built on the native lane
  * (HonuaClient + MapLibre). Tracked by issue #274; ships the basemap
- * switcher, the legend, and the layer list.
+ * switcher, the legend, the layer list, and the swipe control.
  *
  * This entry is intentionally independent of the SDK core bundle (the same
  * posture as `@honua/sdk-js/esri-compat`): it imports nothing from
  * `src/core`/`src/runtime` and has no dependency on `maplibre-gl` — controls
  * drive any MapLibre `Map` through a duck-typed interface.
  *
- * Importing this module registers the basemap switcher, legend, and swipe
- * control when a browser `customElements` registry is present. Node imports are
+ * Importing this module registers the basemap switcher and the swipe control
+ * when a browser `customElements` registry is present. Node imports are
  * safe; call `defineHonuaControls()` explicitly when using a scoped registry.
- * The layer list is opt-in via {@link defineHonuaLayerList} because its tag
- * (`honua-layer-list`) collides with the `web-components` kit's own
- * controller-driven element.
+ * The legend and the layer list are opt-in via {@link defineHonuaLegend} /
+ * {@link defineHonuaLayerList} — both tags also have a controller-driven
+ * implementation in `@honua/sdk-js/web-components`, which is each tag's
+ * canonical/default registrant (see `./catalog.js`). Issue #679 consolidated
+ * component ownership so importing any combination of `./controls` and
+ * `./web-components`, in any order, always registers the same tags with the
+ * same constructors — claiming a controls-kit implementation for a contested
+ * tag is now always an explicit call, never an import-order accident.
+ *
+ * `./catalog.js` and `./registry.js` (re-exported below) are the
+ * consolidated component catalog and typed registration surface spanning
+ * both kits: `HONUA_COMPONENT_CATALOG` describes every shipped tag's
+ * ownership, support tier, required adapters, and events, and
+ * `registerComponent` / `registerComponents` / `registerAllComponents` /
+ * `createComponentRegistry` register by catalog id — individually, as a
+ * named subset, as the full canonical set, or against an isolated registry —
+ * regardless of which subpath (`./controls` or `./web-components`) a caller
+ * imports them from.
  *
  * @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`.
@@ -23,11 +38,17 @@
 import "./basemap-switcher.js";
 import "./swipe-control.js";
 export { HonuaBasemapStyleBinding } from "./basemap-style-binding.js";
-export { HonuaBasemapSwitcherElement, defineHonuaControls } from "./basemap-switcher.js";
+export { HonuaBasemapSwitcherElement, defineHonuaBasemapSwitcher, defineHonuaControls } from "./basemap-switcher.js";
+export { HONUA_COMPONENT_CATALOG, describeDeprecatedComponentImport, getCanonicalComponentCatalogEntry, getComponentCatalogEntriesForTag, getComponentCatalogEntry, listComponentCatalogEntries, listDeprecatedComponentImports, } from "./catalog.js";
+export type { HonuaComponentCatalogEntry, HonuaComponentSource, HonuaComponentSupportTier, HonuaDeprecatedComponentDiagnostic, } from "./catalog.js";
 export { HonuaLayerListElement, defineHonuaLayerList } from "./layer-list.js";
 export { HonuaLegendDeriveError, deriveLegendEntries } from "./legend-derive.js";
 export type { HonuaLegendDeriveErrorCode } from "./legend-derive.js";
-export { HonuaLegendElement } from "./legend.js";
+export { HonuaLegendElement, defineHonuaLegend } from "./legend.js";
+export { HONUA_COMPONENT_QUALIFICATION_DATA_VERSION, HONUA_COMPONENT_QUALIFICATION_GATES, HONUA_COMPONENT_QUALIFICATION_STATUSES, describeComponentQualificationGate, getComponentQualification, isComponentProductionQualified, listOpenQualificationGates, listComponentQualifications, summarizeComponentQualification, } from "./qualification.js";
+export type { HonuaComponentQualification, HonuaComponentQualificationCell, HonuaComponentQualificationGate, HonuaComponentQualificationGateId, HonuaComponentQualificationRequirement, HonuaComponentQualificationStatus, HonuaComponentQualificationSummary, } from "./qualification.js";
+export { HonuaComponentCatalogError, createComponentRegistry, registerAllComponents, registerComponent, registerComponents, } from "./registry.js";
+export type { HonuaComponentCatalogId, HonuaComponentRegistrationOptions, HonuaComponentRegistry, } from "./registry.js";
 export { HonuaSwipeControlElement, defineHonuaSwipeControl } from "./swipe-control.js";
 export type { HonuaBasemapDefinition, HonuaBasemapKind, HonuaBasemapLayerSpecification, HonuaBasemapSwitcherChangeDetail, HonuaBasemapSwitcherMap, HonuaLayerListChangeDetail, HonuaLayerListMap, HonuaLayerListOverlay, HonuaLegendEntry, HonuaLegendMap, HonuaLegendSection, HonuaLegendSwatchColor, HonuaLegendSwatchShape, HonuaSwipeChangeDetail, HonuaSwipeMap, HonuaSwipeOrientation, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/controls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,8BAA8B,EAC9B,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,0CAA0C,EAC1C,mCAAmC,EACnC,sCAAsC,EACtC,kCAAkC,EAClC,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,EACjC,sCAAsC,EACtC,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,uBAAuB,EACvB,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,8BAA8B,EAC9B,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/controls/index.js

@@ -2,19 +2,34 @@
  * Native Honua UI control kit (`@honua/sdk-js/controls`) — optional,
  * framework-free custom elements for apps built on the native lane
  * (HonuaClient + MapLibre). Tracked by issue #274; ships the basemap
- * switcher, the legend, and the layer list.
+ * switcher, the legend, the layer list, and the swipe control.
  *
  * This entry is intentionally independent of the SDK core bundle (the same
  * posture as `@honua/sdk-js/esri-compat`): it imports nothing from
  * `src/core`/`src/runtime` and has no dependency on `maplibre-gl` — controls
  * drive any MapLibre `Map` through a duck-typed interface.
  *
- * Importing this module registers the basemap switcher, legend, and swipe
- * control when a browser `customElements` registry is present. Node imports are
+ * Importing this module registers the basemap switcher and the swipe control
+ * when a browser `customElements` registry is present. Node imports are
  * safe; call `defineHonuaControls()` explicitly when using a scoped registry.
- * The layer list is opt-in via {@link defineHonuaLayerList} because its tag
- * (`honua-layer-list`) collides with the `web-components` kit's own
- * controller-driven element.
+ * The legend and the layer list are opt-in via {@link defineHonuaLegend} /
+ * {@link defineHonuaLayerList} — both tags also have a controller-driven
+ * implementation in `@honua/sdk-js/web-components`, which is each tag's
+ * canonical/default registrant (see `./catalog.js`). Issue #679 consolidated
+ * component ownership so importing any combination of `./controls` and
+ * `./web-components`, in any order, always registers the same tags with the
+ * same constructors — claiming a controls-kit implementation for a contested
+ * tag is now always an explicit call, never an import-order accident.
+ *
+ * `./catalog.js` and `./registry.js` (re-exported below) are the
+ * consolidated component catalog and typed registration surface spanning
+ * both kits: `HONUA_COMPONENT_CATALOG` describes every shipped tag's
+ * ownership, support tier, required adapters, and events, and
+ * `registerComponent` / `registerComponents` / `registerAllComponents` /
+ * `createComponentRegistry` register by catalog id — individually, as a
+ * named subset, as the full canonical set, or against an isolated registry —
+ * regardless of which subpath (`./controls` or `./web-components`) a caller
+ * imports them from.
  *
  * @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`.
@@ -23,8 +38,11 @@
 import "./basemap-switcher.js";
 import "./swipe-control.js";
 export { HonuaBasemapStyleBinding } from "./basemap-style-binding.js";
-export { HonuaBasemapSwitcherElement, defineHonuaControls } from "./basemap-switcher.js";
+export { HonuaBasemapSwitcherElement, defineHonuaBasemapSwitcher, defineHonuaControls } from "./basemap-switcher.js";
+export { HONUA_COMPONENT_CATALOG, describeDeprecatedComponentImport, getCanonicalComponentCatalogEntry, getComponentCatalogEntriesForTag, getComponentCatalogEntry, listComponentCatalogEntries, listDeprecatedComponentImports, } from "./catalog.js";
 export { HonuaLayerListElement, defineHonuaLayerList } from "./layer-list.js";
 export { HonuaLegendDeriveError, deriveLegendEntries } from "./legend-derive.js";
-export { HonuaLegendElement } from "./legend.js";
+export { HonuaLegendElement, defineHonuaLegend } from "./legend.js";
+export { HONUA_COMPONENT_QUALIFICATION_DATA_VERSION, HONUA_COMPONENT_QUALIFICATION_GATES, HONUA_COMPONENT_QUALIFICATION_STATUSES, describeComponentQualificationGate, getComponentQualification, isComponentProductionQualified, listOpenQualificationGates, listComponentQualifications, summarizeComponentQualification, } from "./qualification.js";
+export { HonuaComponentCatalogError, createComponentRegistry, registerAllComponents, registerComponent, registerComponents, } from "./registry.js";
 export { HonuaSwipeControlElement, defineHonuaSwipeControl } from "./swipe-control.js";

package/controls/layer-list.d.ts

@@ -31,7 +31,10 @@
  * - `overlays` — JSON array of {@link HonuaLayerListOverlay} (the `overlays`
  *   property is preferred for non-trivial configs).
  * - `for` — id of the map-providing element, see Wiring.
- * - `label` — accessible name of the list (default "Layers").
+ * - `label` — accessible name of the list (default "Layers"); reflects the
+ *   `label` property.
+ * - `not-seeded-label` — fallback text for the disabled-row badge (default
+ *   "Not seeded"); reflects `notSeededLabel`.
  * - `auto-refresh` — boolean; see Reactivity.
  *
  * ## CSS parts
@@ -58,6 +61,12 @@ export declare class HonuaLayerListElement extends HTMLElementBase {
     set map(map: HonuaLayerListMap | undefined);
     /** Wires the list to a MapLibre map. Equivalent to setting `.map`. */
     connect(map: HonuaLayerListMap): void;
+    /** Accessible name of the list. Reflects the `label` attribute. */
+    get label(): string;
+    set label(value: string | undefined);
+    /** Fallback text for an overlay whose style layers are not seeded. */
+    get notSeededLabel(): string;
+    set notSeededLabel(value: string | undefined);
     /** The registered overlay definitions. */
     get overlays(): readonly HonuaLayerListOverlay[];
     set overlays(overlays: readonly HonuaLayerListOverlay[]);
@@ -84,10 +93,9 @@ export declare class HonuaLayerListElement extends HTMLElementBase {
  * Unlike the other controls-kit elements, this is **opt-in** and is NOT run by
  * the blanket `defineHonuaControls()` / module-load auto-registration. The
  * `web-components` entry ships its own (controller-driven) `honua-layer-list`
- * under the same tag, and that kit auto-registers on import. Auto-registering
- * the controls variant too would let it silently win the tag in apps that load
- * both kits (the order is import-dependent), so callers who want the native,
- * overlay-definition-driven layer list register it explicitly:
+ * under the same tag and is that tag's canonical/default registrant (see
+ * `./catalog.js`), so callers who want the native, overlay-definition-driven
+ * layer list register it explicitly:
  *
  * ```ts
  * import { defineHonuaLayerList } from "@honua/sdk-js/controls";

package/controls/layer-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layer-list.d.ts","sourceRoot":"","sources":["../../../src/controls/layer-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EACL,eAAe,EAMhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAA8B,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;;IACxD,WAAkB,kBAAkB,IAAI,MAAM,EAAE,CAE/C;IAQD,gEAAgE;IAChE,IAAW,GAAG,IAAI,iBAAiB,GAAG,SAAS,CAE9C;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAMhD;IAED,sEAAsE;IAC/D,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAI5C,0CAA0C;IAC1C,IAAW,QAAQ,IAAI,SAAS,qBAAqB,EAAE,CAEtD;IAED,IAAW,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,EAG7D;IAED,qFAAqF;IACrF,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,OAAO,EAIpC;IAED,2DAA2D;IACpD,OAAO,IAAI,IAAI;IAItB;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAiBxD,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAmB/F,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IA4EnC,SAAS,CAAC,MAAM,IAAI,IAAI;CAuEzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,wBAA2B,GAAG,IAAI,CAK9E"}
+{"version":3,"file":"layer-list.d.ts","sourceRoot":"","sources":["../../../src/controls/layer-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EACL,eAAe,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAA8B,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;;IACxD,WAAkB,kBAAkB,IAAI,MAAM,EAAE,CAE/C;IAQD,gEAAgE;IAChE,IAAW,GAAG,IAAI,iBAAiB,GAAG,SAAS,CAE9C;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAMhD;IAED,sEAAsE;IAC/D,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAI5C,mEAAmE;IACnE,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAIzC;IAED,sEAAsE;IACtE,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,IAAW,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAIlD;IAED,0CAA0C;IAC1C,IAAW,QAAQ,IAAI,SAAS,qBAAqB,EAAE,CAEtD;IAED,IAAW,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,EAG7D;IAED,qFAAqF;IACrF,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,OAAO,EAIpC;IAED,2DAA2D;IACpD,OAAO,IAAI,IAAI;IAItB;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAiBxD,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAmB/F,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IA4EnC,SAAS,CAAC,MAAM,IAAI,IAAI;CAkFzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,wBAA2B,GAAG,IAAI,CAK9E"}