@honua/app-platform 0.0.20-alpha.0

package/studio/capability-manifest.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Client projection of the server capability manifest — the server-advertised
+ * set of package families, feature capabilities, transports, limits, and policy
+ * state a Console/MCP/QGIS client may rely on. Lets a client gate UI and tool
+ * exposure on what the connected server actually supports for the current
+ * tenant, workspace, environment, and caller policy scope rather than
+ * hard-coding assumptions.
+ *
+ * These shapes mirror the frozen server wire contract
+ * `honua.capability_manifest.v1` (honua-server `CapabilityManifestService` /
+ * `CapabilityManifestDocument`, PR #2356) and are the TypeScript analogue of the
+ * honua-sdk-dotnet `CapabilityManifest` / `CapabilityEntry` projection
+ * (honua-sdk-dotnet PR #253). The wire is frozen; field names, the
+ * `supported`/`available` split, and the reason-code surface are stable, so
+ * these shapes are no longer marked `@experimental`. Fetch a manifest with the
+ * control-plane client's `getCapabilityManifest()`.
+ *
+ * @module
+ */
+/**
+ * Tenant, workspace, environment, and authentication scope a capability
+ * manifest was generated for.
+ */
+export interface StudioCapabilityScope {
+    readonly tenantId?: string;
+    readonly tenantSource?: string;
+    readonly environment?: string;
+    readonly workspaceId?: string;
+    readonly workspaceAvailable?: boolean;
+    readonly workspaceReasonCode?: string;
+    readonly authenticated?: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Server and API version information carried by a capability manifest. */
+export interface StudioCapabilityServerInfo {
+    readonly serverVersion?: string;
+    readonly apiVersion?: string;
+    readonly metadataApiVersion?: string;
+    readonly metadataSchemaVersion?: string;
+    readonly deploymentEnvironment?: string;
+    readonly [extra: string]: unknown;
+}
+/** Environment (metadata snapshot) availability state for a capability manifest. */
+export interface StudioCapabilityEnvironment {
+    readonly environmentId?: string;
+    readonly requested?: boolean;
+    readonly available?: boolean;
+    readonly reasonCode?: string;
+    readonly revision?: number;
+    readonly loadedAt?: string;
+    readonly [extra: string]: unknown;
+}
+/** One package family advertised by a capability manifest. */
+export interface StudioCapabilityPackageFamily {
+    readonly id: string;
+    readonly kind?: string;
+    readonly schemaVersion?: string;
+    readonly supported: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Package schema versions and family support state for a capability manifest. */
+export interface StudioCapabilityPackages {
+    readonly schemaVersions?: readonly string[];
+    readonly families?: readonly StudioCapabilityPackageFamily[];
+    readonly storageFamilies?: readonly string[];
+    readonly publicationFamilies?: readonly string[];
+    readonly [extra: string]: unknown;
+}
+/**
+ * One advertised capability entry. Mirrors the frozen server
+ * `honua.capability_manifest.v1` capability shape and the honua-sdk-dotnet
+ * `CapabilityEntry` projection.
+ *
+ * `supported` reports whether the server implements the capability at all;
+ * `available` reports whether it is usable in the current scope (a supported
+ * capability can still be unavailable — e.g. gated by edition or entitlement,
+ * with `reasonCode` explaining why).
+ */
+export interface StudioCapabilityEntry {
+    readonly id: string;
+    readonly category?: string;
+    readonly supported: boolean;
+    readonly available: boolean;
+    readonly reasonCode?: string;
+    readonly entitlementKey?: string;
+    readonly entitlementKeys?: readonly string[];
+    readonly minimumEdition?: string;
+    readonly messageKey?: string;
+    readonly [extra: string]: unknown;
+}
+/** Availability state of one transport (for example HTTP, gRPC, gRPC-Web). */
+export interface StudioCapabilityTransportState {
+    readonly id: string;
+    readonly supported: boolean;
+    readonly available: boolean;
+    readonly reasonCode?: string;
+    readonly messageKey?: string;
+    readonly [extra: string]: unknown;
+}
+/** Transport availability and mTLS state for a capability manifest. */
+export interface StudioCapabilityTransports {
+    readonly items: readonly StudioCapabilityTransportState[];
+    readonly mtlsMode?: string;
+    readonly forwardedClientCertificateEnabled?: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Preview limits advertised by a capability manifest. */
+export interface StudioCapabilityPreviewLimits {
+    readonly maxPreviewSizeBytes?: number;
+    readonly maxPreviewFeatures?: number;
+    readonly maxPreviewCountScan?: number;
+    readonly [extra: string]: unknown;
+}
+/** Query limits advertised by a capability manifest. */
+export interface StudioCapabilityQueryLimits {
+    readonly defaultRecordCount?: number;
+    readonly maxRecordCount?: number;
+    readonly maxFeatures?: number;
+    readonly maxPageSize?: number;
+    readonly queryTimeoutSeconds?: number;
+    readonly maxBboxAreaSqKm?: number;
+    readonly maxFilterDepth?: number;
+    readonly maxSpatialOperations?: number;
+    readonly [extra: string]: unknown;
+}
+/** Analysis limits advertised by a capability manifest. */
+export interface StudioCapabilityAnalysisLimits {
+    readonly maxInputFeatures?: number;
+    readonly maxClusters?: number;
+    readonly maxDbscanEpsMeters?: number;
+    readonly maxKMeansK?: number;
+    readonly maxBufferDistanceMeters?: number;
+    readonly minDensityCellSizeMeters?: number;
+    readonly maxDensityCellSizeMeters?: number;
+    readonly maxDensityCells?: number;
+    readonly maxDWithinDistanceMeters?: number;
+    readonly maxH3CellsPerQuery?: number;
+    readonly maxSpatialOperations?: number;
+    readonly maxJoins?: number;
+    readonly [extra: string]: unknown;
+}
+/** Publication limits advertised by a capability manifest. */
+export interface StudioCapabilityPublicationLimits {
+    readonly configuredDeployTargetCount?: number;
+    readonly gitOpsManifestExportSupported?: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Job limits advertised by a capability manifest. */
+export interface StudioCapabilityJobLimits {
+    readonly configuredWorkloadCount?: number;
+    readonly availableBackendCount?: number;
+    readonly supportsCancellation?: boolean;
+    readonly supportsProgressPolling?: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Upload limits advertised by a capability manifest. */
+export interface StudioCapabilityUploadLimits {
+    readonly maxUploadSizeBytes?: number;
+    readonly maxFileSizeBytes?: number;
+    readonly maxConcurrentUploads?: number;
+    readonly maxQueuedUploads?: number;
+    readonly maxSecurityScanSizeBytes?: number;
+    readonly [extra: string]: unknown;
+}
+/** Streaming limits advertised by a capability manifest. */
+export interface StudioCapabilityStreamingLimits {
+    readonly maxConcurrentSessions?: number;
+    readonly maxBufferPerConnection?: number;
+    readonly maxSubscriptionsPerSession?: number;
+    readonly maxSubscriptionIdLength?: number;
+    readonly maxControlFrameBytes?: number;
+    readonly cursorRetentionLimit?: number;
+    readonly heartbeatIntervalSeconds?: number;
+    readonly grpcStreamBatchSize?: number;
+    readonly [extra: string]: unknown;
+}
+/** Edit limits advertised by a capability manifest. */
+export interface StudioCapabilityEditLimits {
+    readonly maxFeaturesPerEdit?: number;
+    readonly maxEditsPerTransaction?: number;
+    readonly maxPayloadSizeBytes?: number;
+    readonly [extra: string]: unknown;
+}
+/** Geometry limits advertised by a capability manifest. */
+export interface StudioCapabilityGeometryLimits {
+    readonly maxVerticesPerGeometry?: number;
+    readonly maxGeometrySizeBytes?: number;
+    readonly maxCoordinatePrecision?: number;
+    readonly [extra: string]: unknown;
+}
+/** Attachment limits advertised by a capability manifest. */
+export interface StudioCapabilityAttachmentLimits {
+    readonly maxAttachmentsPerFeature?: number;
+    readonly maxAttachmentSizeBytes?: number;
+    readonly [extra: string]: unknown;
+}
+/** Operational limits advertised by a capability manifest. */
+export interface StudioCapabilityLimits {
+    readonly preview?: StudioCapabilityPreviewLimits;
+    readonly query?: StudioCapabilityQueryLimits;
+    readonly analysis?: StudioCapabilityAnalysisLimits;
+    readonly publication?: StudioCapabilityPublicationLimits;
+    readonly job?: StudioCapabilityJobLimits;
+    readonly upload?: StudioCapabilityUploadLimits;
+    readonly streaming?: StudioCapabilityStreamingLimits;
+    readonly edit?: StudioCapabilityEditLimits;
+    readonly geometry?: StudioCapabilityGeometryLimits;
+    readonly attachment?: StudioCapabilityAttachmentLimits;
+    readonly [extra: string]: unknown;
+}
+/** One entitlement decision advertised by a capability manifest. */
+export interface StudioCapabilityEntitlementDecision {
+    readonly key: string;
+    readonly active: boolean;
+    readonly minimumEdition?: string;
+    readonly reasonCode?: string;
+    readonly [extra: string]: unknown;
+}
+/** Edition, license, and entitlement policy state for a capability manifest. */
+export interface StudioCapabilityPolicies {
+    readonly currentEdition?: string;
+    readonly licenseValidationState?: string;
+    readonly licenseValid?: boolean;
+    readonly callerCapabilities?: readonly string[];
+    readonly entitlements?: readonly StudioCapabilityEntitlementDecision[];
+    readonly authorizationNotice?: string;
+    readonly [extra: string]: unknown;
+}
+/** A related resource link advertised by a capability manifest. */
+export interface StudioCapabilityLink {
+    readonly rel: string;
+    readonly href: string;
+    readonly type?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * The capability manifest a server returns describing supported package
+ * families, feature capabilities, transports, limits, and policy state.
+ * Schema `honua.capability_manifest.v1`.
+ */
+export interface StudioCapabilityManifest {
+    readonly schemaVersion: string;
+    readonly issuedAt?: string;
+    readonly scope?: StudioCapabilityScope;
+    readonly server?: StudioCapabilityServerInfo;
+    readonly environment?: StudioCapabilityEnvironment;
+    readonly packages?: StudioCapabilityPackages;
+    readonly capabilities: readonly StudioCapabilityEntry[];
+    readonly transports?: StudioCapabilityTransports;
+    readonly limits?: StudioCapabilityLimits;
+    readonly policies?: StudioCapabilityPolicies;
+    readonly links?: readonly StudioCapabilityLink[];
+    readonly [extra: string]: unknown;
+}
+/**
+ * Return the capability entry with the given id, or `undefined` if the
+ * manifest does not advertise it (regardless of supported/available state).
+ * Mirrors the .NET `CapabilityManifest.GetCapability`.
+ */
+export declare function getCapability(manifest: StudioCapabilityManifest, id: string): StudioCapabilityEntry | undefined;
+/**
+ * Return `true` when the manifest advertises the capability as available in the
+ * current scope. Mirrors the .NET `CapabilityManifest.IsAvailable`.
+ */
+export declare function hasCapability(manifest: StudioCapabilityManifest, id: string): boolean;
+/**
+ * Return `true` when the server implements the capability at all, even if it is
+ * not currently available (for example gated by edition or entitlement).
+ * Inspect {@link getCapabilityReasonCode} to explain an unavailable but
+ * supported capability. Mirrors the .NET `CapabilityManifest.IsSupported`.
+ */
+export declare function isCapabilitySupported(manifest: StudioCapabilityManifest, id: string): boolean;
+/**
+ * Return the machine-friendly reason code explaining a capability's
+ * availability state, or `undefined` when unknown or the capability is
+ * unrecognized. Mirrors the .NET `CapabilityManifest.GetReasonCode`.
+ */
+export declare function getCapabilityReasonCode(manifest: StudioCapabilityManifest, id: string): string | undefined;
+/**
+ * Return `true` when the server advertises a supported package family with the
+ * given identifier (for example `map`). Mirrors the .NET
+ * `CapabilityManifest.HasPackageFamily`.
+ */
+export declare function hasPackageFamily(manifest: StudioCapabilityManifest, familyId: string): boolean;
+//# sourceMappingURL=capability-manifest.d.ts.map

package/studio/capability-manifest.d.ts.map

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

package/studio/capability-manifest.js

@@ -0,0 +1,59 @@
+/**
+ * Client projection of the server capability manifest — the server-advertised
+ * set of package families, feature capabilities, transports, limits, and policy
+ * state a Console/MCP/QGIS client may rely on. Lets a client gate UI and tool
+ * exposure on what the connected server actually supports for the current
+ * tenant, workspace, environment, and caller policy scope rather than
+ * hard-coding assumptions.
+ *
+ * These shapes mirror the frozen server wire contract
+ * `honua.capability_manifest.v1` (honua-server `CapabilityManifestService` /
+ * `CapabilityManifestDocument`, PR #2356) and are the TypeScript analogue of the
+ * honua-sdk-dotnet `CapabilityManifest` / `CapabilityEntry` projection
+ * (honua-sdk-dotnet PR #253). The wire is frozen; field names, the
+ * `supported`/`available` split, and the reason-code surface are stable, so
+ * these shapes are no longer marked `@experimental`. Fetch a manifest with the
+ * control-plane client's `getCapabilityManifest()`.
+ *
+ * @module
+ */
+/**
+ * Return the capability entry with the given id, or `undefined` if the
+ * manifest does not advertise it (regardless of supported/available state).
+ * Mirrors the .NET `CapabilityManifest.GetCapability`.
+ */
+export function getCapability(manifest, id) {
+    return manifest.capabilities.find((entry) => entry.id === id);
+}
+/**
+ * Return `true` when the manifest advertises the capability as available in the
+ * current scope. Mirrors the .NET `CapabilityManifest.IsAvailable`.
+ */
+export function hasCapability(manifest, id) {
+    return getCapability(manifest, id)?.available === true;
+}
+/**
+ * Return `true` when the server implements the capability at all, even if it is
+ * not currently available (for example gated by edition or entitlement).
+ * Inspect {@link getCapabilityReasonCode} to explain an unavailable but
+ * supported capability. Mirrors the .NET `CapabilityManifest.IsSupported`.
+ */
+export function isCapabilitySupported(manifest, id) {
+    return getCapability(manifest, id)?.supported === true;
+}
+/**
+ * Return the machine-friendly reason code explaining a capability's
+ * availability state, or `undefined` when unknown or the capability is
+ * unrecognized. Mirrors the .NET `CapabilityManifest.GetReasonCode`.
+ */
+export function getCapabilityReasonCode(manifest, id) {
+    return getCapability(manifest, id)?.reasonCode;
+}
+/**
+ * Return `true` when the server advertises a supported package family with the
+ * given identifier (for example `map`). Mirrors the .NET
+ * `CapabilityManifest.HasPackageFamily`.
+ */
+export function hasPackageFamily(manifest, familyId) {
+    return manifest.packages?.families?.some((family) => family.id === familyId && family.supported) === true;
+}

package/studio/chart-spec.d.ts

@@ -0,0 +1,85 @@
+/**
+ * A documented, compatible subset of the Vega-Lite v5 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
+ * a pure helper that derives a spec from a generated-app chart widget so MCP,
+ * QGIS, Console, and the SDK preview runtime all render the same chart.
+ *
+ * The subset is intentionally narrow: bar / arc / line / point marks over a
+ * single positional encoding pair plus an optional color channel. It is a
+ * structural subset of a real Vega-Lite `TopLevelSpec`, so a host may hand the
+ * object directly to `vega-embed` / `vega-lite` without translation, while the
+ * SDK stays free of a Vega dependency (these are plain data types).
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`.
+ * @module
+ */
+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";
+/** Mark types in the supported subset. */
+export type HonuaChartMark = "bar" | "line" | "point" | "arc";
+/** Encoding field type in the supported subset. */
+export type HonuaChartFieldType = "quantitative" | "nominal" | "ordinal" | "temporal";
+/**
+ * One positional / visual encoding channel. A structural subset of a
+ * Vega-Lite `FieldDef`.
+ *
+ * @experimental
+ */
+export interface HonuaChartEncodingChannel {
+    readonly field: string;
+    readonly type: HonuaChartFieldType;
+    readonly title?: string;
+    readonly aggregate?: "count" | "sum" | "mean" | "min" | "max" | "median";
+    readonly timeUnit?: string;
+    readonly bin?: boolean | {
+        readonly maxbins?: number;
+    };
+}
+/**
+ * The encoding block. `x`/`y` are the positional pair; `color` is optional.
+ *
+ * @experimental
+ */
+export interface HonuaChartEncoding {
+    readonly x?: HonuaChartEncodingChannel;
+    readonly y?: HonuaChartEncodingChannel;
+    readonly color?: HonuaChartEncodingChannel;
+}
+/**
+ * The documented Vega-Lite-compatible chart spec. Inline `data.values` carry
+ * the rows; a host may instead point `data.name` at a named dataset. The
+ * `$schema` and structural layout make this directly consumable by Vega-Lite.
+ *
+ * @experimental
+ */
+export interface HonuaVegaLiteChartSpec {
+    readonly $schema: typeof HONUA_VEGA_LITE_SCHEMA_V5;
+    readonly title?: string;
+    readonly description?: string;
+    readonly mark: HonuaChartMark | {
+        readonly type: HonuaChartMark;
+        readonly tooltip?: boolean;
+    };
+    readonly encoding: HonuaChartEncoding;
+    readonly data?: {
+        readonly values?: ReadonlyArray<Record<string, unknown>>;
+        readonly name?: string;
+    };
+    readonly width?: number | "container";
+    readonly height?: number | "container";
+}
+/**
+ * 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
+ * chart kind (so a caller can degrade cleanly rather than emit a broken spec).
+ *
+ * @experimental
+ */
+export declare function chartWidgetToVegaLiteSpec(widget: HonuaGeneratedAppChartWidget, rows?: ReadonlyArray<Record<string, unknown>>): HonuaVegaLiteChartSpec | undefined;
+//# sourceMappingURL=chart-spec.d.ts.map

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

@@ -0,0 +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"}

package/studio/chart-spec.js

@@ -0,0 +1,106 @@
+/**
+ * A documented, compatible subset of the Vega-Lite v5 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
+ * a pure helper that derives a spec from a generated-app chart widget so MCP,
+ * QGIS, Console, and the SDK preview runtime all render the same chart.
+ *
+ * The subset is intentionally narrow: bar / arc / line / point marks over a
+ * single positional encoding pair plus an optional color channel. It is a
+ * structural subset of a real Vega-Lite `TopLevelSpec`, so a host may hand the
+ * object directly to `vega-embed` / `vega-lite` without translation, while the
+ * SDK stays free of a Vega dependency (these are plain data types).
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`.
+ * @module
+ */
+/** Vega-Lite schema URL this subset targets. */
+export const HONUA_VEGA_LITE_SCHEMA_V5 = "https://vega.github.io/schema/vega-lite/v5.json";
+/**
+ * Map a generated-app chart widget kind to a Vega-Lite mark and the encoding
+ * shape the subset expects.
+ */
+const CHART_KIND_MARK = {
+    categories: "bar",
+    histogram: "bar",
+    "time-series": "line",
+};
+/**
+ * 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
+ * chart kind (so a caller can degrade cleanly rather than emit a broken spec).
+ *
+ * @experimental
+ */
+export function chartWidgetToVegaLiteSpec(widget, rows) {
+    const chartKind = widget.chartKind ?? "categories";
+    const mark = CHART_KIND_MARK[chartKind];
+    let encoding;
+    if (chartKind === "categories") {
+        const category = widget.groupBy ?? widget.field;
+        if (!category)
+            return undefined;
+        encoding = {
+            x: { field: category, type: "nominal", title: widget.title },
+            y: { field: "count", type: "quantitative", aggregate: "count", title: "Count" },
+        };
+    }
+    else if (chartKind === "histogram") {
+        if (!widget.field)
+            return undefined;
+        encoding = {
+            x: {
+                field: widget.field,
+                type: "quantitative",
+                bin: widget.bins ? { maxbins: widget.bins } : true,
+                title: widget.title ?? widget.field,
+            },
+            y: { field: "count", type: "quantitative", aggregate: "count", title: "Count" },
+        };
+    }
+    else {
+        // time-series
+        const timeField = widget.field ?? widget.groupBy;
+        if (!timeField)
+            return undefined;
+        const valueChannel = widget.metric
+            ? {
+                field: widget.metric.field === "*" ? "count" : widget.metric.field,
+                type: "quantitative",
+                aggregate: metricToAggregate(widget.metric.fn),
+                title: widget.metric.alias ?? widget.metric.field,
+            }
+            : { field: "count", type: "quantitative", aggregate: "count", title: "Count" };
+        encoding = {
+            x: { field: timeField, type: "temporal", title: widget.title ?? timeField },
+            y: valueChannel,
+        };
+    }
+    return {
+        $schema: HONUA_VEGA_LITE_SCHEMA_V5,
+        ...(widget.title ? { title: widget.title } : {}),
+        mark: { type: mark, tooltip: true },
+        encoding,
+        width: "container",
+        ...(rows ? { data: { values: rows } } : {}),
+    };
+}
+function metricToAggregate(metric) {
+    switch (metric) {
+        case "sum":
+            return "sum";
+        case "avg":
+        case "mean":
+            return "mean";
+        case "min":
+            return "min";
+        case "max":
+            return "max";
+        default:
+            return "count";
+    }
+}

package/studio/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `@honua/sdk-js/studio` — browser-safe TypeScript projections, validation and
+ * preview envelopes, capability-manifest types, and publish/share/embed
+ * contracts for the Studio package families.
+ *
+ * This barrel is intentionally MCP/QGIS-safe: it exports only types and pure
+ * functions and never imports from `operator`, `esri-compat`, `web-components`,
+ * `interactions`, or `realtime` (which pull in MapLibre / DOM code). The
+ * established `map` and `dashboard`/`app` shapes are re-exported from their
+ * leaf modules so consumers reach every family from one import path.
+ *
+ * @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
+ *   stub families may change again when their server contracts ship.
+ * @module
+ */
+export { HONUA_ANALYSIS_PACKAGE_FORMAT_V1, HONUA_ETL_PACKAGE_FORMAT_V1, HONUA_FORM_PACKAGE_FORMAT_V1, HONUA_GP_PACKAGE_FORMAT_V1, HONUA_QUERY_PACKAGE_FORMAT_V1, HONUA_REPORT_PACKAGE_FORMAT_V1, HONUA_WORKFLOW_PACKAGE_FORMAT_V1, STUDIO_PACKAGE_FAMILIES, isStudioPackageFamily, tagStudioPackage, } from "./types.js";
+export type { HonuaAnalysisPackage, HonuaAnalysisPackageFormat, HonuaETLPackage, HonuaETLPackageFormat, HonuaFormFieldSpec, HonuaFormPackage, HonuaFormPackageFormat, HonuaGPPackage, HonuaGPPackageFormat, HonuaGPParameterSpec, HonuaQueryPackage, HonuaQueryPackageFormat, HonuaReportPackage, HonuaReportPackageFormat, HonuaReportSectionSpec, HonuaStudioBindingRef, HonuaStudioPackage, HonuaStudioPackageBase, HonuaStudioPackageFamily, HonuaStudioPackageStatus, HonuaStudioQuerySpec, HonuaWorkflowPackage, HonuaWorkflowPackageFormat, HonuaWorkflowStepSpec, StudioPackageFamilyShapes, } from "./types.js";
+export { fromMapPackageValidation, toStudioValidationResponse } from "./validation.js";
+export type { StudioPackageDiagnostic, StudioPackageDiagnosticSeverity, StudioPackagePreviewResponse, StudioPackageValidationResponse, StudioPreviewArtifactRef, } from "./validation.js";
+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 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";
+export type { HonuaShareRequest, HonuaShareResponse, StudioEmbedConfig, StudioPublishRequest, StudioPublishResponse, } from "./publish.js";
+export { HONUA_MAP_PACKAGE_FORMAT_V1 } from "../runtime/map-package.js";
+export type { HonuaMapPackage, HonuaMapPackageFormat } from "../runtime/map-package.js";
+export { HONUA_GENERATED_APP_MANIFEST_FORMAT_V1 } from "../generated-app/manifest.js";
+export type { HonuaGeneratedAppManifest, HonuaGeneratedAppPackage } from "../generated-app/manifest.js";
+//# sourceMappingURL=index.d.ts.map

package/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EAChC,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EACV,uBAAuB,EACvB,+BAA+B,EAC/B,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,kCAAkC,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,8BAA8B,EAC9B,gCAAgC,EAChC,0BAA0B,EAC1B,mCAAmC,EACnC,qBAAqB,EACrB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AACtF,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/studio/index.js

@@ -0,0 +1,27 @@
+/**
+ * `@honua/sdk-js/studio` — browser-safe TypeScript projections, validation and
+ * preview envelopes, capability-manifest types, and publish/share/embed
+ * contracts for the Studio package families.
+ *
+ * This barrel is intentionally MCP/QGIS-safe: it exports only types and pure
+ * functions and never imports from `operator`, `esri-compat`, `web-components`,
+ * `interactions`, or `realtime` (which pull in MapLibre / DOM code). The
+ * established `map` and `dashboard`/`app` shapes are re-exported from their
+ * leaf modules so consumers reach every family from one import path.
+ *
+ * @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
+ *   stub families may change again when their server contracts ship.
+ * @module
+ */
+export { HONUA_ANALYSIS_PACKAGE_FORMAT_V1, HONUA_ETL_PACKAGE_FORMAT_V1, HONUA_FORM_PACKAGE_FORMAT_V1, HONUA_GP_PACKAGE_FORMAT_V1, HONUA_QUERY_PACKAGE_FORMAT_V1, HONUA_REPORT_PACKAGE_FORMAT_V1, HONUA_WORKFLOW_PACKAGE_FORMAT_V1, STUDIO_PACKAGE_FAMILIES, isStudioPackageFamily, tagStudioPackage, } from "./types.js";
+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 { 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
+// no MapLibre/DOM runtime imports (their cross-module imports are type-only).
+export { HONUA_MAP_PACKAGE_FORMAT_V1 } from "../runtime/map-package.js";
+export { HONUA_GENERATED_APP_MANIFEST_FORMAT_V1 } from "../generated-app/manifest.js";