@honua/react 0.1.7-beta.0 → 0.1.9-beta.0

package/runtime/map-package-validation.js

@@ -1,17 +1,92 @@
-import { HONUA_MAP_PACKAGE_FORMAT_V1 } from "./map-package.js";
-const SUPPORTED_SOURCE_PROTOCOLS = new Set([
-    "geoservices_feature_service",
-    "geoservices_map_service",
-    "ogc_features",
-    "ogc_maps",
-    "ogc_tiles",
-    "wfs",
-    "wms",
-    "wmts",
-    "odata",
-    "vector_tile",
-    "raster_tile",
-]);
+/**
+ * `MapPackage` validation.
+ *
+ * The *structural* rules — which properties exist, which are required, which
+ * scalar types and enum members are legal, how long a string may be — are not
+ * written here. They live in `schemas/honua-map-package.v1.json`, the canonical
+ * artifact schema (honua-sdk-js#1426), which `scripts/generate-map-package-validator.mjs`
+ * compiles into `./generated/map-package-schema-validator.js`. This module runs
+ * that generated validator and translates its errors into the SDK's stable
+ * diagnostic codes. Restating the shape in TypeScript would recreate exactly
+ * the parallel description the schema exists to eliminate.
+ *
+ * What stays here is everything a JSON Schema genuinely cannot express:
+ * cross-field resolution (does every layer's `source` resolve to a binding or
+ * an inline style source?), package-level uniqueness (`sourceId` collisions),
+ * runtime capability (which of the schema's protocols the source bridge can
+ * actually bind), and wall-clock lifecycle (expiry and staleness).
+ *
+ * @module
+ */
+import { HONUA_MAP_PACKAGE_SCHEMA_PROTOCOLS } from "./generated/map-package-schema-meta.js";
+import validateAgainstSchema from "./generated/map-package-schema-validator.js";
+/**
+ * Schema-legal protocols the MapLibre source bridge cannot bind to a
+ * `Dataset`/`Source` today. The schema is the wire contract and admits these;
+ * the runtime is narrower. Deriving the bindable set by subtraction — rather
+ * than by writing a second list — means a protocol added to the schema is
+ * bindable by default and a deliberate gap has to be named here, in one place,
+ * with a reason.
+ */
+const UNBINDABLE_SOURCE_PROTOCOLS = [
+    // `pmtiles://` archives are attached through the pmtiles protocol handler
+    // (`registerPmtilesProtocol`), not through `createDataset`.
+    "pmtiles",
+    // Workspace artifacts resolve through the workspace/app layer, which the
+    // map runtime does not depend on.
+    "workspace_artifact",
+];
+const SUPPORTED_SOURCE_PROTOCOLS = new Set(HONUA_MAP_PACKAGE_SCHEMA_PROTOCOLS.filter((protocol) => !UNBINDABLE_SOURCE_PROTOCOLS.includes(protocol)));
+/**
+ * Translates one Ajv error into the SDK's stable diagnostic vocabulary.
+ *
+ * The codes predate the schema and are part of the public surface, so the
+ * mapping is explicit rather than derived: hosts switch on these strings.
+ */
+function schemaErrorToDiagnostic(error) {
+    const path = jsonPointerToPath(error.instancePath ?? "");
+    const missing = error.params?.missingProperty;
+    const fullPath = missing ? (path ? `${path}.${missing}` : missing) : path;
+    const detail = { schemaPath: error.schemaPath, keyword: error.keyword, params: error.params };
+    const message = `MapPackage does not satisfy honua-map-package.v1 at ${fullPath || "(root)"}${error.message ? `: ${error.message}` : ""}.`;
+    return { code: schemaErrorCode(fullPath, missing), severity: "error", message, path: fullPath || undefined, detail };
+}
+function schemaErrorCode(fullPath, missing) {
+    if (fullPath === "mapPackageId")
+        return "missing-map-package-id";
+    if (fullPath === "format")
+        return "unsupported-format";
+    if (fullPath === "sourceBindings")
+        return "missing-source-bindings";
+    if (fullPath === "mapSpec")
+        return "missing-map-spec";
+    if (fullPath.startsWith("mapSpec"))
+        return "invalid-map-spec";
+    if (fullPath.startsWith("sourceBindings[")) {
+        const field = fullPath.slice(fullPath.indexOf("]") + 1);
+        if (field === ".sourceId")
+            return "missing-source-id";
+        if (field === ".protocol")
+            return "unsupported-protocol";
+        if (field.startsWith(".locator") || missing === "locator")
+            return "missing-source-locator";
+    }
+    return "invalid-package";
+}
+/** `/sourceBindings/0/locator/url` → `sourceBindings[0].locator.url`. */
+function jsonPointerToPath(pointer) {
+    if (pointer.length === 0)
+        return "";
+    let path = "";
+    for (const rawSegment of pointer.split("/").slice(1)) {
+        const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
+        if (/^\d+$/.test(segment))
+            path += `[${segment}]`;
+        else
+            path += path.length === 0 ? segment : `.${segment}`;
+    }
+    return path;
+}
 /**
  * Validate the server-produced `MapPackage` wire shape and runtime binding
  * assumptions without throwing raw JSON/type errors. Diagnostics are
@@ -31,79 +106,61 @@ export function validateMapPackage(value, options = {}) {
     const add = (diagnostic) => {
         diagnostics.push({ ...(packageId ? { packageId } : {}), ...diagnostic });
     };
-    if (!packageId) {
-        add({
-            code: "missing-map-package-id",
-            severity: "error",
-            message: "MapPackage.mapPackageId must be a non-empty string.",
-            path: "mapPackageId",
-        });
-    }
-    if (value.format !== HONUA_MAP_PACKAGE_FORMAT_V1) {
-        add({
-            code: "unsupported-format",
-            severity: "error",
-            message: `MapPackage.format must be "${HONUA_MAP_PACKAGE_FORMAT_V1}".`,
-            path: "format",
-            detail: { expected: HONUA_MAP_PACKAGE_FORMAT_V1, received: value.format },
-        });
+    // Structural pass: every required/type/enum/bound rule comes from
+    // `schemas/honua-map-package.v1.json` by way of the generated validator.
+    const validator = validateAgainstSchema;
+    const structurallyValid = validator(value);
+    const schemaErrorPaths = new Set();
+    if (!structurallyValid) {
+        for (const error of validator.errors ?? []) {
+            const diagnostic = schemaErrorToDiagnostic(error);
+            if (diagnostic.path)
+                schemaErrorPaths.add(diagnostic.path);
+            add(diagnostic);
+        }
     }
     const sourceIds = new Set();
     const sourceBindings = value.sourceBindings;
-    if (!Array.isArray(sourceBindings)) {
-        add({
-            code: "missing-source-bindings",
-            severity: "error",
-            message: "MapPackage.sourceBindings must be an array.",
-            path: "sourceBindings",
-        });
-    }
-    else {
+    if (Array.isArray(sourceBindings)) {
         for (let i = 0; i < sourceBindings.length; i += 1) {
             const binding = sourceBindings[i];
             const path = `sourceBindings[${i}]`;
-            if (!isRecord(binding)) {
-                add({
-                    code: "invalid-package",
-                    severity: "error",
-                    message: "MapPackage.sourceBindings entries must be objects.",
-                    path,
-                });
+            if (!isRecord(binding))
                 continue;
-            }
             const sourceId = typeof binding.sourceId === "string" && binding.sourceId.length > 0 ? binding.sourceId : "";
-            if (!sourceId) {
-                add({
-                    code: "missing-source-id",
-                    severity: "error",
-                    message: "SourceBinding.sourceId must be a non-empty string.",
-                    path: `${path}.sourceId`,
-                });
-            }
-            else if (sourceIds.has(sourceId)) {
-                add({
-                    code: "duplicate-source",
-                    severity: "error",
-                    message: `SourceBinding sourceId "${sourceId}" is duplicated.`,
-                    path: `${path}.sourceId`,
-                    detail: { sourceId },
-                });
-            }
-            else {
-                sourceIds.add(sourceId);
+            if (sourceId) {
+                // Uniqueness is a package-level invariant; JSON Schema has no way to
+                // express "distinct by this property", so it stays here.
+                if (sourceIds.has(sourceId)) {
+                    add({
+                        code: "duplicate-source",
+                        severity: "error",
+                        message: `SourceBinding sourceId "${sourceId}" is duplicated.`,
+                        path: `${path}.sourceId`,
+                        detail: { sourceId },
+                    });
+                }
+                else {
+                    sourceIds.add(sourceId);
+                }
             }
+            // The schema already rejected values outside its protocol enum; this is
+            // the narrower question of what the source bridge can actually bind.
             const protocol = typeof binding.protocol === "string" ? binding.protocol : undefined;
-            if (!protocol || !SUPPORTED_SOURCE_PROTOCOLS.has(protocol)) {
+            if (protocol && !SUPPORTED_SOURCE_PROTOCOLS.has(protocol) && !schemaErrorPaths.has(`${path}.protocol`)) {
                 add({
                     code: "unsupported-protocol",
                     severity: "error",
-                    message: `SourceBinding "${sourceId || i}" uses unsupported protocol "${String(binding.protocol)}".`,
+                    message: `SourceBinding "${sourceId || i}" uses unsupported protocol "${protocol}".`,
                     path: `${path}.protocol`,
-                    detail: { sourceId, protocol: binding.protocol },
+                    detail: { sourceId, protocol },
                 });
             }
+            // `locator.url` is optional in the schema — a locator addressed purely by
+            // `serviceId` is a legal artifact — but the runtime cannot bind one, so
+            // the requirement is enforced here rather than in the wire contract.
             const locator = binding.locator;
-            if (!isRecord(locator) || typeof locator.url !== "string" || locator.url.length === 0) {
+            if (isRecord(locator) && (typeof locator.url !== "string" || locator.url.length === 0)) {
                 add({
                     code: "missing-source-locator",
                     severity: "error",
@@ -115,15 +172,7 @@ export function validateMapPackage(value, options = {}) {
         }
     }
     const mapSpec = value.mapSpec;
-    if (!isRecord(mapSpec)) {
-        add({
-            code: "missing-map-spec",
-            severity: "error",
-            message: "MapPackage.mapSpec must be a MapLibre style object.",
-            path: "mapSpec",
-        });
-    }
-    else {
+    if (isRecord(mapSpec)) {
         validateMapSpecSources(add, mapSpec, sourceIds);
         validateStyleRefTargets(add, value, mapSpec);
     }
@@ -141,26 +190,14 @@ export function hasMapPackageDiagnosticErrors(diagnostics) {
 function validateMapSpecSources(add, mapSpec, sourceIds) {
     const mapSpecSources = isRecord(mapSpec.sources) ? new Set(Object.keys(mapSpec.sources)) : new Set();
     const layers = mapSpec.layers;
-    if (!Array.isArray(layers)) {
-        add({
-            code: "invalid-map-spec",
-            severity: "error",
-            message: "MapPackage.mapSpec.layers must be an array.",
-            path: "mapSpec.layers",
-        });
+    // A non-array `layers`, or a non-object entry, is a structural failure the
+    // schema has already reported; re-reporting it here would double up.
+    if (!Array.isArray(layers))
         return;
-    }
     for (let i = 0; i < layers.length; i += 1) {
         const layer = layers[i];
-        if (!isRecord(layer)) {
-            add({
-                code: "invalid-map-spec",
-                severity: "error",
-                message: "MapPackage.mapSpec.layers entries must be objects.",
-                path: `mapSpec.layers[${i}]`,
-            });
+        if (!isRecord(layer))
             continue;
-        }
         if (typeof layer.source !== "string")
             continue;
         if (!sourceIds.has(layer.source) && !mapSpecSources.has(layer.source)) {

package/runtime/map-package.d.ts

@@ -129,6 +129,78 @@ export interface HonuaMapPackageLabelBinding {
     fieldName: string;
     placement?: "point" | "line" | "polygon";
 }
+/**
+ * Package-level attribution the host is expected to display.
+ *
+ * Per-binding `attribution` on {@link HonuaMapPackageSourceBinding} stays the
+ * source-of-record for a single service; this collection is for the
+ * package-wide notices (basemap credit, licence text) that no single binding
+ * owns.
+ */
+export interface HonuaMapPackageAttribution {
+    /** Attribution text. Plain text; hosts escape before rendering. */
+    text: string;
+    /** Optional link target for the attribution. */
+    url?: string;
+    /** Bindings this notice covers. Omitted means package-wide. */
+    sourceIds?: readonly string[];
+    /** Whether the host must display this notice (licence obligation). */
+    required?: boolean;
+}
+/**
+ * A renderer-neutral widget/component declared by the package.
+ *
+ * `type` is an open string rather than a closed union: the widget catalogue
+ * belongs to the host application, and closing it here would make every new
+ * component a breaking change to the artifact. Unknown types are carried
+ * through the round trip and ignored by hosts that cannot render them.
+ */
+export interface HonuaMapPackageWidget {
+    widgetId: string;
+    /** Widget kind, e.g. `legend`, `layer-list`, `basemap-gallery`, `search`. */
+    type: string;
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    label?: string;
+    /** Whether the widget starts visible. Defaults to `true` when omitted. */
+    visible?: boolean;
+    /** Widget-specific configuration, carried through unmodified. */
+    config?: Record<string, unknown>;
+}
+/**
+ * An external capability the package needs in order to render. Declarative
+ * only — nothing in the SDK installs or resolves these; hosts use them to
+ * report a fidelity gap before rendering rather than after.
+ */
+export interface HonuaMapPackageDependency {
+    /** Dependency name, e.g. `maplibre-gl`, `@honua/sdk-js`, `pmtiles`. */
+    name: string;
+    /** semver range the package was authored against. */
+    versionRange?: string;
+    kind?: "renderer" | "protocol" | "sdk" | "plugin" | "font" | "sprite" | "basemap";
+    /** Whether the package still renders (degraded) without it. */
+    optional?: boolean;
+}
+/**
+ * How this package was produced. Descriptive only.
+ *
+ * Deliberately carries no content hash, actor/tenant, authorization scope, or
+ * audit/correlation identifier. Those are identity and governance concerns
+ * owned by the canonical honua-server composition contract and projected into
+ * the SDK through #1397 / #1398; minting them here would fork the identity
+ * model, which is the failure mode #1426 exists to prevent.
+ */
+export interface HonuaMapPackageProvenance {
+    /** Tool that produced the package, e.g. `honua-cli`, `@honua/mcp-server`. */
+    generatedBy?: string;
+    /** Version of that tool. */
+    generatorVersion?: string;
+    /** ISO-8601 timestamp of production. */
+    generatedAt?: string;
+    /** Ids of upstream artifacts this package was composed from. */
+    derivedFrom?: readonly string[];
+    /** Free-text note for humans reading the artifact. */
+    notes?: string;
+}
 /**
  * v1 MapPackage shape — mirrors the draft server type in
  * `/home/makani/honua-server/src/Honua.Core/Features/Geoprocessing/Domain/MapPackage.cs`.
@@ -161,6 +233,14 @@ export interface HonuaMapPackage {
     popupBindings?: readonly HonuaMapPackagePopupBinding[];
     labelBindings?: readonly HonuaMapPackageLabelBinding[];
     boundArtifacts?: readonly string[];
+    /** Package-wide attribution notices. */
+    attribution?: readonly HonuaMapPackageAttribution[];
+    /** Renderer-neutral widgets/components declared by the package. */
+    widgets?: readonly HonuaMapPackageWidget[];
+    /** External capabilities required to render at full fidelity. */
+    dependencies?: readonly HonuaMapPackageDependency[];
+    /** How the package was produced. Descriptive; carries no identity. */
+    provenance?: HonuaMapPackageProvenance;
     /** Preserve additive fields through round-trip without forcing a type bump. */
     [extra: string]: unknown;
 }

package/runtime/map-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-package.d.ts","sourceRoot":"","sources":["../../../src/runtime/map-package.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"map-package.d.ts","sourceRoot":"","sources":["../../../src/runtime/map-package.ts"],"names":[],"mappings":"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"}

package/studio/chart-spec.d.ts

@@ -1,5 +1,5 @@
 /**
- * A documented, compatible subset of the Vega-Lite v5 spec used by Studio
+ * A documented, compatible subset of the Vega-Lite v6 spec used by Studio
  * dashboard and report charts. The acceptance criterion for cross-surface
  * parity is that "dashboard/report charts use Vega-Lite specs or an explicitly
  * documented compatible subset" — this module is that documented subset, plus
@@ -18,7 +18,7 @@
  */
 import type { HonuaGeneratedAppChartWidget } from "../generated-app/manifest.js";
 /** Vega-Lite schema URL this subset targets. */
-export declare const HONUA_VEGA_LITE_SCHEMA_V5: "https://vega.github.io/schema/vega-lite/v5.json";
+export declare const HONUA_VEGA_LITE_SCHEMA: "https://vega.github.io/schema/vega-lite/v6.json";
 /** Mark types in the supported subset. */
 export type HonuaChartMark = "bar" | "line" | "point" | "arc";
 /** Encoding field type in the supported subset. */
@@ -57,7 +57,7 @@ export interface HonuaChartEncoding {
  * @experimental
  */
 export interface HonuaVegaLiteChartSpec {
-    readonly $schema: typeof HONUA_VEGA_LITE_SCHEMA_V5;
+    readonly $schema: typeof HONUA_VEGA_LITE_SCHEMA;
     readonly title?: string;
     readonly description?: string;
     readonly mark: HonuaChartMark | {
@@ -65,7 +65,7 @@ export interface HonuaVegaLiteChartSpec {
         readonly tooltip?: boolean;
     };
     readonly encoding: HonuaChartEncoding;
-    readonly data?: {
+    readonly data: {
         readonly values?: ReadonlyArray<Record<string, unknown>>;
         readonly name?: string;
     };
@@ -75,8 +75,8 @@ export interface HonuaVegaLiteChartSpec {
 /**
  * Derive a {@link HonuaVegaLiteChartSpec} from a generated-app chart widget so
  * dashboard and report charts render identically across surfaces. `rows`, when
- * supplied, become inline `data.values`; otherwise the host binds a named
- * dataset. Returns `undefined` when the widget lacks the field needed for its
+ * supplied, become inline `data.values`; otherwise the host binds the named
+ * dataset identified by the widget id. Returns `undefined` when the widget lacks the field needed for its
  * chart kind (so a caller can degrade cleanly rather than emit a broken spec).
  *
  * @experimental

package/studio/chart-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-spec.d.ts","sourceRoot":"","sources":["../../../src/studio/chart-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAEjF,gDAAgD;AAChD,eAAO,MAAM,yBAAyB,EAAG,iDAA0D,CAAC;AAEpG,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9D,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACvC,QAAQ,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,yBAAyB,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9F,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACxC;AAYD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,4BAA4B,EACpC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,sBAAsB,GAAG,SAAS,CAiDpC"}
+{"version":3,"file":"chart-spec.d.ts","sourceRoot":"","sources":["../../../src/studio/chart-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAEjF,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,EAAG,iDAA0D,CAAC;AAEjG,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9D,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACvC,QAAQ,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9F,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACxC;AAYD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,4BAA4B,EACpC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,sBAAsB,GAAG,SAAS,CAiDpC"}

package/studio/chart-spec.js

@@ -1,5 +1,5 @@
 /**
- * A documented, compatible subset of the Vega-Lite v5 spec used by Studio
+ * A documented, compatible subset of the Vega-Lite v6 spec used by Studio
  * dashboard and report charts. The acceptance criterion for cross-surface
  * parity is that "dashboard/report charts use Vega-Lite specs or an explicitly
  * documented compatible subset" — this module is that documented subset, plus
@@ -17,7 +17,7 @@
  * @module
  */
 /** Vega-Lite schema URL this subset targets. */
-export const HONUA_VEGA_LITE_SCHEMA_V5 = "https://vega.github.io/schema/vega-lite/v5.json";
+export const HONUA_VEGA_LITE_SCHEMA = "https://vega.github.io/schema/vega-lite/v6.json";
 /**
  * Map a generated-app chart widget kind to a Vega-Lite mark and the encoding
  * shape the subset expects.
@@ -30,8 +30,8 @@ const CHART_KIND_MARK = {
 /**
  * Derive a {@link HonuaVegaLiteChartSpec} from a generated-app chart widget so
  * dashboard and report charts render identically across surfaces. `rows`, when
- * supplied, become inline `data.values`; otherwise the host binds a named
- * dataset. Returns `undefined` when the widget lacks the field needed for its
+ * supplied, become inline `data.values`; otherwise the host binds the named
+ * dataset identified by the widget id. Returns `undefined` when the widget lacks the field needed for its
  * chart kind (so a caller can degrade cleanly rather than emit a broken spec).
  *
  * @experimental
@@ -81,12 +81,12 @@ export function chartWidgetToVegaLiteSpec(widget, rows) {
         };
     }
     return {
-        $schema: HONUA_VEGA_LITE_SCHEMA_V5,
+        $schema: HONUA_VEGA_LITE_SCHEMA,
         ...(widget.title ? { title: widget.title } : {}),
         mark: { type: mark, tooltip: true },
         encoding,
         width: "container",
-        ...(rows ? { data: { values: rows } } : {}),
+        data: rows ? { values: rows } : { name: widget.id },
     };
 }
 function metricToAggregate(metric) {

package/studio/index.d.ts

@@ -17,9 +17,18 @@
  * (`/api/v{version}/studio`): package-family discovery, draft CRUD with
  * optimistic-generation checking, validate, preview-plan, immutable content
  * versions and comparisons, publish requests, reopen, and rollback requests.
- * See that module's doc comment for the documented enumeration-endpoint gap
- * (`honua-server#3003`) and how the client absorbs it without a breaking
- * change.
+ * It also enumerates: `contentItems.list()` and `drafts.list()` page the
+ * `honua-server#3003` content-browser endpoints with filters, opaque keyset
+ * cursors, and a joined publication-registry lifecycle badge per content-item
+ * row — plus bounded `listAll()`/`collect()` cursor walks. See that module's
+ * doc comment.
+ *
+ * Publication proposals are submitted, read and polled to a final state
+ * through `publicationRequests` — `create`, `get` and a bounded, cancellable
+ * `poll` that returns a final publication URL only at `Active`. This surface
+ * carries **no** approve/authorize/override capability by design: approval is
+ * a separate principal acting through the canonical Admin API/CLI. See
+ * `./publication-status.js` for the state machine.
  *
  * @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`, and the
@@ -34,7 +43,7 @@ export { validatePackageProvenance, validateStudioPackage } from "./validate.js"
 export type { ValidateStudioPackageOptions } from "./validate.js";
 export { HONUA_PACKAGE_PROVENANCE_FORMAT_V1, getPackageProvenance } from "./provenance.js";
 export type { HonuaPackageOrigin, HonuaPackagePermission, HonuaPackageProvenance, HonuaPackageProvenanceFormat, HonuaPlanProvenance, HonuaPlanStep, HonuaPromptProvenance, HonuaProvenanceDataBinding, } from "./provenance.js";
-export { HONUA_VEGA_LITE_SCHEMA_V5, chartWidgetToVegaLiteSpec } from "./chart-spec.js";
+export { HONUA_VEGA_LITE_SCHEMA, chartWidgetToVegaLiteSpec } from "./chart-spec.js";
 export type { HonuaChartEncoding, HonuaChartEncodingChannel, HonuaChartFieldType, HonuaChartMark, HonuaVegaLiteChartSpec, } from "./chart-spec.js";
 export { getCapability, getCapabilityReasonCode, hasCapability, hasPackageFamily, isCapabilitySupported, } from "./capability-manifest.js";
 export type { StudioCapabilityAnalysisLimits, StudioCapabilityAttachmentLimits, StudioCapabilityEditLimits, StudioCapabilityEntitlementDecision, StudioCapabilityEntry, StudioCapabilityEnvironment, StudioCapabilityGeometryLimits, StudioCapabilityJobLimits, StudioCapabilityLimits, StudioCapabilityLink, StudioCapabilityManifest, StudioCapabilityPackageFamily, StudioCapabilityPackages, StudioCapabilityPolicies, StudioCapabilityPreviewLimits, StudioCapabilityPublicationLimits, StudioCapabilityQueryLimits, StudioCapabilityScope, StudioCapabilityServerInfo, StudioCapabilityStreamingLimits, StudioCapabilityTransports, StudioCapabilityTransportState, StudioCapabilityUploadLimits, } from "./capability-manifest.js";
@@ -45,7 +54,8 @@ export { HONUA_GENERATED_APP_MANIFEST_FORMAT_V1 } from "../generated-app/manifes
 export type { HonuaGeneratedAppManifest, HonuaGeneratedAppPackage } from "../generated-app/manifest.js";
 export { HONUA_STUDIO_PROBLEM_TYPE, HonuaStudioError, classifyStudioProblemStatus, isHonuaStudioError, isHonuaStudioGenerationConflict, } from "./lifecycle-errors.js";
 export type { HonuaStudioProblemDetails, HonuaStudioProblemKind } from "./lifecycle-errors.js";
-export type { StudioApiResponse, StudioBindingRef, StudioContentItemPointers, StudioContentVersion, StudioContentVersionListResponse, StudioDependencyRef, StudioPackageDraft, StudioPackageDraftCreateRequest, StudioPackageDraftReplaceRequest, StudioPackageEnvelope, StudioPackageFamilyCapabilities, StudioPackageFamilyCapability, StudioPackageFamilyOperation, StudioPackageFamilySupportLevel, StudioPersistenceMode, StudioPreviewPlan, StudioProvenanceRef, StudioPublicationIntent, StudioPublicationRequest, StudioPublicationRequestInput, StudioPublicationRequestStatus, StudioReopenVersionRequest, StudioRollbackPointer, StudioRollbackRequest, StudioRollbackRequestInput, StudioValidationDepth, StudioValidationStatus, StudioValidationSummary, StudioVersionComparison, StudioVersionComparisonDiff, StudioVersionComparisonRequest, } from "./lifecycle-types.js";
-export { HONUA_STUDIO_LIFECYCLE_BASE_PATH, HonuaStudioContentVersionsClient, HonuaStudioDraftsClient, HonuaStudioLifecycleClient, HonuaStudioPackageFamiliesClient, HonuaStudioPublicationRequestsClient, HonuaStudioRollbackRequestsClient, createHonuaStudioLifecycleClient, } from "./lifecycle-client.js";
-export type { HonuaStudioLifecycleClientOptions, HonuaStudioRawRequest, HonuaStudioRequestOptions, } from "./lifecycle-client.js";
+export { STUDIO_PUBLICATION_LIFECYCLE_STATES, isStudioPublicationActive, isStudioPublicationTerminal, normalizeStudioPublicationStatus, studioPublicationUrl, } from "./publication-status.js";
+export type { StudioApiResponse, StudioBindingRef, StudioContentItemListOptions, StudioContentItemListResponse, StudioContentItemListRow, StudioContentItemPointers, StudioContentItemPublicationBadge, StudioContentItemState, StudioContentVersion, StudioContentVersionListResponse, StudioDependencyRef, StudioListFilterOptions, StudioListPage, StudioPackageDraft, StudioPackageDraftCreateRequest, StudioPackageDraftListOptions, StudioPackageDraftListResponse, StudioPackageDraftReplaceRequest, StudioPackageEnvelope, StudioPackageFamilyCapabilities, StudioPackageFamilyCapability, StudioPackageFamilyOperation, StudioPackageFamilySupportLevel, StudioPersistenceMode, StudioPreviewPlan, StudioProvenanceRef, StudioPublicationIdentifiers, StudioPublicationIntent, StudioPublicationLifecycleState, StudioPublicationRequest, StudioPublicationRequestInput, StudioPublicationRequestStatus, StudioPublicationRouteLifecycle, StudioReopenVersionRequest, StudioRollbackPointer, StudioRollbackRequest, StudioRollbackRequestInput, StudioValidationDepth, StudioValidationStatus, StudioValidationSummary, StudioVersionComparison, StudioVersionComparisonDiff, StudioVersionComparisonRequest, } from "./lifecycle-types.js";
+export { HONUA_STUDIO_LIFECYCLE_BASE_PATH, HONUA_STUDIO_LIST_DEFAULT_LIMIT, HONUA_STUDIO_LIST_MAX_LIMIT, HONUA_STUDIO_LIST_MAX_PAGES, HONUA_STUDIO_PUBLICATION_POLL_INTERVAL_MS, HONUA_STUDIO_PUBLICATION_POLL_MAX_ATTEMPTS, HonuaStudioContentItemsClient, HonuaStudioContentVersionsClient, HonuaStudioDraftsClient, HonuaStudioLifecycleClient, HonuaStudioPackageFamiliesClient, HonuaStudioPublicationRequestsClient, HonuaStudioRollbackRequestsClient, createHonuaStudioLifecycleClient, isStudioListExhausted, } from "./lifecycle-client.js";
+export type { HonuaStudioLifecycleClientOptions, HonuaStudioPaginationOptions, HonuaStudioPublicationPollOptions, HonuaStudioRawRequest, HonuaStudioRequestOptions, StudioListCollection, StudioPublicationPollOutcome, } from "./lifecycle-client.js";
 //# sourceMappingURL=index.d.ts.map

package/studio/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/studio/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/studio/index.ts"],"names":[],"mappings":"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"}

package/studio/index.js

@@ -17,9 +17,18 @@
  * (`/api/v{version}/studio`): package-family discovery, draft CRUD with
  * optimistic-generation checking, validate, preview-plan, immutable content
  * versions and comparisons, publish requests, reopen, and rollback requests.
- * See that module's doc comment for the documented enumeration-endpoint gap
- * (`honua-server#3003`) and how the client absorbs it without a breaking
- * change.
+ * It also enumerates: `contentItems.list()` and `drafts.list()` page the
+ * `honua-server#3003` content-browser endpoints with filters, opaque keyset
+ * cursors, and a joined publication-registry lifecycle badge per content-item
+ * row — plus bounded `listAll()`/`collect()` cursor walks. See that module's
+ * doc comment.
+ *
+ * Publication proposals are submitted, read and polled to a final state
+ * through `publicationRequests` — `create`, `get` and a bounded, cancellable
+ * `poll` that returns a final publication URL only at `Active`. This surface
+ * carries **no** approve/authorize/override capability by design: approval is
+ * a separate principal acting through the canonical Admin API/CLI. See
+ * `./publication-status.js` for the state machine.
  *
  * @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`, and the
@@ -30,7 +39,7 @@ export { HONUA_ANALYSIS_PACKAGE_FORMAT_V1, HONUA_ETL_PACKAGE_FORMAT_V1, HONUA_FO
 export { fromMapPackageValidation, toStudioValidationResponse } from "./validation.js";
 export { validatePackageProvenance, validateStudioPackage } from "./validate.js";
 export { HONUA_PACKAGE_PROVENANCE_FORMAT_V1, getPackageProvenance } from "./provenance.js";
-export { HONUA_VEGA_LITE_SCHEMA_V5, chartWidgetToVegaLiteSpec } from "./chart-spec.js";
+export { HONUA_VEGA_LITE_SCHEMA, chartWidgetToVegaLiteSpec } from "./chart-spec.js";
 export { getCapability, getCapabilityReasonCode, hasCapability, hasPackageFamily, isCapabilitySupported, } from "./capability-manifest.js";
 // Re-exported established families so `@honua/sdk-js/studio` is the single
 // import path for every Studio package projection. These leaf modules carry
@@ -38,4 +47,5 @@ export { getCapability, getCapabilityReasonCode, hasCapability, hasPackageFamily
 export { HONUA_MAP_PACKAGE_FORMAT_V1 } from "../runtime/map-package.js";
 export { HONUA_GENERATED_APP_MANIFEST_FORMAT_V1 } from "../generated-app/manifest.js";
 export { HONUA_STUDIO_PROBLEM_TYPE, HonuaStudioError, classifyStudioProblemStatus, isHonuaStudioError, isHonuaStudioGenerationConflict, } from "./lifecycle-errors.js";
-export { HONUA_STUDIO_LIFECYCLE_BASE_PATH, HonuaStudioContentVersionsClient, HonuaStudioDraftsClient, HonuaStudioLifecycleClient, HonuaStudioPackageFamiliesClient, HonuaStudioPublicationRequestsClient, HonuaStudioRollbackRequestsClient, createHonuaStudioLifecycleClient, } from "./lifecycle-client.js";
+export { STUDIO_PUBLICATION_LIFECYCLE_STATES, isStudioPublicationActive, isStudioPublicationTerminal, normalizeStudioPublicationStatus, studioPublicationUrl, } from "./publication-status.js";
+export { HONUA_STUDIO_LIFECYCLE_BASE_PATH, HONUA_STUDIO_LIST_DEFAULT_LIMIT, HONUA_STUDIO_LIST_MAX_LIMIT, HONUA_STUDIO_LIST_MAX_PAGES, HONUA_STUDIO_PUBLICATION_POLL_INTERVAL_MS, HONUA_STUDIO_PUBLICATION_POLL_MAX_ATTEMPTS, HonuaStudioContentItemsClient, HonuaStudioContentVersionsClient, HonuaStudioDraftsClient, HonuaStudioLifecycleClient, HonuaStudioPackageFamiliesClient, HonuaStudioPublicationRequestsClient, HonuaStudioRollbackRequestsClient, createHonuaStudioLifecycleClient, isStudioListExhausted, } from "./lifecycle-client.js";