@honua/app-platform 0.1.1-beta.0 → 0.1.4-beta.0

package/web-components/feature-editor.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `<honua-feature-editor>` — the production-tier capability-aware editing and
+ * sketch widget (issue #680, parent epic #678).
+ *
+ * The element is pure presentation over
+ * {@link HonuaFeatureEditorWorkflow}: it renders the schema/domain/subtype
+ * derived form, the geometry workflow, staged attachments, validation,
+ * per-operation availability, failure and conflict state, and turns user input
+ * back into workflow calls. It imports no protocol adapter, performs no
+ * transport of its own, and never reports a rejected edit as a success.
+ *
+ * ## Wiring
+ * ```ts
+ * const workflow = createFeatureEditorWorkflow({ source, subtypes });
+ * const editor = document.createElement("honua-feature-editor");
+ * editor.workflow = workflow;          // element subscribes and renders
+ * document.body.append(editor);
+ * ```
+ * Geometry may additionally be driven from the map through a sketch adapter
+ * (`createTerraDrawEditorSketch` in `./feature-editor-sketch.js`) — the element
+ * itself never needs the map.
+ *
+ * ## Accessibility (NFR-001)
+ * The entire workflow is reachable without touching the map canvas:
+ *
+ * - operation, sketch-tool, undo/redo, conflict, and submit affordances are
+ *   native `<button>`s in labelled `role="group"` toolbars, with `aria-pressed`
+ *   for the active operation/tool and `aria-disabled` + a visible reason
+ *   whenever an operation is unavailable;
+ * - every field is a labelled native control with `aria-required`,
+ *   `aria-invalid`, and `aria-describedby` pointing at its own error text;
+ * - geometry can be entered, replaced, or cleared entirely from the keyboard
+ *   through the GeoJSON geometry textarea plus **Apply geometry** / **Clear**;
+ * - validation problems and service failures render in `role="alert"` regions,
+ *   the workflow message in a `role="status" aria-live="polite"` region;
+ * - `Escape` cancels the draft and `Ctrl`/`Cmd`+`Z` / `Shift`+`Ctrl`/`Cmd`+`Z`
+ *   drive undo / redo from anywhere inside the panel;
+ * - focus and text selection survive re-renders, so typing is never
+ *   interrupted by an unrelated realtime change.
+ *
+ * @module
+ */
+import type { CanonicalFeature } from "../contract/types.js";
+import type { HonuaFeatureEditorCommit, HonuaFeatureEditorSnapshot, HonuaFeatureEditorWorkflow } from "./feature-editor-workflow.js";
+import type { HonuaFeatureEditorMessages } from "./types.js";
+declare const HTMLElementBase: typeof HTMLElement;
+/** Detail of the `honua-feature-edit-change` event (redacted snapshot). */
+export interface HonuaFeatureEditChangeDetail {
+    readonly snapshot: HonuaFeatureEditorSnapshot;
+}
+/** Detail of the `honua-feature-edit-commit` event (submit outcome). */
+export interface HonuaFeatureEditCommitDetail {
+    readonly commit: HonuaFeatureEditorCommit;
+}
+export declare class HonuaFeatureEditorElement<T = Record<string, unknown>> extends HTMLElementBase {
+    #private;
+    static get observedAttributes(): string[];
+    get messages(): HonuaFeatureEditorMessages;
+    set messages(messages: HonuaFeatureEditorMessages | undefined);
+    /** The workflow this editor renders. Setting it re-subscribes and re-renders. */
+    get workflow(): HonuaFeatureEditorWorkflow<T> | undefined;
+    set workflow(workflow: HonuaFeatureEditorWorkflow<T> | undefined);
+    /** Equivalent to setting `.workflow`. */
+    connect(workflow: HonuaFeatureEditorWorkflow<T>): void;
+    /**
+     * The feature `update` / `delete` drafts open on. Hosts assign this from
+     * their own selection state (table row, map click, search result); it is
+     * forwarded to the workflow so per-operation availability reflects it
+     * immediately. The element never reads the map.
+     */
+    get selectedFeature(): CanonicalFeature<T> | undefined;
+    set selectedFeature(feature: CanonicalFeature<T> | undefined);
+    /** The last snapshot rendered. */
+    get snapshot(): HonuaFeatureEditorSnapshot | undefined;
+    attributeChangedCallback(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+/** Registers `<honua-feature-editor>`; skipped when the tag is already defined. */
+export declare function defineHonuaFeatureEditor(registry?: CustomElementRegistry): void;
+export {};
+//# sourceMappingURL=feature-editor.d.ts.map

package/web-components/feature-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-editor.d.ts","sourceRoot":"","sources":["../../../src/web-components/feature-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EACV,wBAAwB,EAExB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAQ7D,QAAA,MAAM,eAAe,EAAE,OAAO,WAAkF,CAAC;AAEjH,2EAA2E;AAC3E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;CAC/C;AAED,wEAAwE;AACxE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAQD,qBAAa,yBAAyB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,eAAe;;IACzF,WAAkB,kBAAkB,IAAI,MAAM,EAAE,CAE/C;IAiBD,IAAW,QAAQ,IAAI,0BAA0B,CAEhD;IACD,IAAW,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,GAAG,SAAS,EAGnE;IAED,iFAAiF;IACjF,IAAW,QAAQ,IAAI,0BAA0B,CAAC,CAAC,CAAC,GAAG,SAAS,CAE/D;IAED,IAAW,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,SAAS,EAYtE;IAeD,yCAAyC;IAClC,OAAO,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI;IAI7D;;;;;OAKG;IACH,IAAW,eAAe,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CAE5D;IAED,IAAW,eAAe,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,EAElE;IAED,kCAAkC;IAClC,IAAW,QAAQ,IAAI,0BAA0B,GAAG,SAAS,CAE5D;IAEM,wBAAwB,IAAI,IAAI;IAIhC,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAgDnC,SAAS,CAAC,MAAM,IAAI,IAAI;CAwZzB;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,QAAQ,wBAA2B,GAAG,IAAI,CAKlF"}