@honua/react 0.0.20-alpha.0

package/runtime/style-spec-validation.js

@@ -0,0 +1,357 @@
+let loadAttempted = false;
+let loadedModule;
+let loadFailure;
+let loadPromise;
+export async function prepareRuntimeStyleSpecValidation(mode = "strict") {
+    if (mode === "renderer-deferred")
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (mod)
+        return [];
+    return [validatorUnavailableDiagnostic({ mode })];
+}
+export async function validateRuntimeStyleSpec(style, options = {}) {
+    const mode = options.mode ?? "strict";
+    if (mode === "renderer-deferred")
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic({ ...options, mode })];
+    return mapStyleSpecErrors(mod.validateStyleMin(sanitizeStyle(style)), { ...options, mode }, {});
+}
+export async function validateRuntimeSourceStyleSpec(sourceId, source, options = {}) {
+    const mode = options.mode ?? "strict";
+    if (mode === "renderer-deferred" || isHonuaSourceLike(source))
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (!mod)
+        return [
+            validatorUnavailableDiagnostic({ ...options, mode, sourceId, path: options.path ?? `sources.${sourceId}` }),
+        ];
+    return mapStyleSpecErrors(mod.validateStyleMin({
+        version: 8,
+        sources: { [sourceId]: source },
+        layers: [],
+    }), { ...options, mode, sourceId, path: options.path ?? `sources.${sourceId}` }, {});
+}
+export async function validateRuntimeLayerStyleSpec(layer, options = {}) {
+    const mode = options.mode ?? "strict";
+    if (mode === "renderer-deferred")
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (!mod) {
+        return [
+            validatorUnavailableDiagnostic({
+                ...options,
+                mode,
+                layerId: options.layerId ?? layer.id,
+                sourceId: options.sourceId ?? layer.source,
+                path: options.path ?? layerPath(layer),
+            }),
+        ];
+    }
+    return mapStyleSpecErrors(mod.validateStyleMin(styleForLayerValidation(layer, options)), {
+        ...options,
+        mode,
+        layerId: options.layerId ?? layer.id,
+        sourceId: options.sourceId ?? layer.source,
+        path: options.path ?? layerPath(layer),
+    }, { layerId: layer.id });
+}
+export async function validateRuntimeStyleExpressionStyleSpec(value, options = {}) {
+    const mode = options.mode ?? "strict";
+    if (mode === "renderer-deferred")
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic({ ...options, mode })];
+    return validateExpressionWithModule(mod, value, { ...options, mode });
+}
+export async function validateRuntimeFilterStyleSpec(filter, options = {}) {
+    const mode = options.mode ?? "strict";
+    if (mode === "renderer-deferred")
+        return [];
+    const mod = await loadMapLibreStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic({ ...options, mode })];
+    return mapStyleSpecErrors(mod.validateStyleMin(styleForFilterValidation(filter, options.layerId)), { ...options, mode, path: options.path ?? filterPath(options.layerId) }, { layerId: options.layerId ?? "__honua_filter_validation__" });
+}
+export function validateRuntimeSourceStyleSpecSync(sourceId, source, options = {}) {
+    if (!shouldRunSyncStyleSpecValidation(options.mode) || isHonuaSourceLike(source))
+        return [];
+    const mod = loadedStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic({ ...options, sourceId, path: options.path ?? `sources.${sourceId}` })];
+    return mapStyleSpecErrors(mod.validateStyleMin({
+        version: 8,
+        sources: { [sourceId]: source },
+        layers: [],
+    }), { ...options, sourceId, path: options.path ?? `sources.${sourceId}` }, {});
+}
+export function validateRuntimeLayerStyleSpecSync(layer, options = {}) {
+    if (!shouldRunSyncStyleSpecValidation(options.mode))
+        return [];
+    const mod = loadedStyleSpecModule();
+    if (!mod) {
+        return [
+            validatorUnavailableDiagnostic({
+                ...options,
+                layerId: options.layerId ?? layer.id,
+                sourceId: options.sourceId ?? layer.source,
+                path: options.path ?? layerPath(layer),
+            }),
+        ];
+    }
+    return mapStyleSpecErrors(mod.validateStyleMin(styleForLayerValidation(layer, options)), {
+        ...options,
+        layerId: options.layerId ?? layer.id,
+        sourceId: options.sourceId ?? layer.source,
+        path: options.path ?? layerPath(layer),
+    }, { layerId: layer.id });
+}
+export function validateRuntimeStyleExpressionStyleSpecSync(value, options = {}) {
+    if (!shouldRunSyncStyleSpecValidation(options.mode))
+        return [];
+    const mod = loadedStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic(options)];
+    return validateExpressionWithModule(mod, value, options);
+}
+export function validateRuntimeFilterStyleSpecSync(filter, options = {}) {
+    if (!shouldRunSyncStyleSpecValidation(options.mode))
+        return [];
+    const mod = loadedStyleSpecModule();
+    if (!mod)
+        return [validatorUnavailableDiagnostic(options)];
+    return mapStyleSpecErrors(mod.validateStyleMin(styleForFilterValidation(filter, options.layerId)), { ...options, path: options.path ?? filterPath(options.layerId) }, { layerId: options.layerId ?? "__honua_filter_validation__" });
+}
+function validateExpressionWithModule(mod, value, options) {
+    const result = mod.createExpression(value);
+    if (result.result !== "error" || !Array.isArray(result.value))
+        return [];
+    return result.value.map((error) => {
+        const mapLibrePath = pathWithExpressionKey(options.path, stringProperty(error, "key"));
+        return mapLibreDiagnostic(error, stringProperty(error, "message") ?? "Invalid MapLibre style expression.", {
+            ...options,
+            path: mapLibrePath,
+            mapLibrePath,
+        });
+    });
+}
+async function loadMapLibreStyleSpecModule() {
+    if (loadedModule)
+        return loadedModule;
+    loadAttempted = true;
+    loadPromise ??= import("@maplibre/maplibre-gl-style-spec")
+        .then((mod) => {
+        const candidate = mod;
+        if (typeof candidate.validateStyleMin !== "function" || typeof candidate.createExpression !== "function") {
+            throw new Error("@maplibre/maplibre-gl-style-spec does not expose the expected validator API.");
+        }
+        loadedModule = {
+            validateStyleMin: candidate.validateStyleMin,
+            createExpression: candidate.createExpression,
+        };
+        loadFailure = undefined;
+        return loadedModule;
+    })
+        .catch((error) => {
+        loadFailure = error;
+        loadedModule = undefined;
+        return undefined;
+    });
+    return loadPromise;
+}
+function loadedStyleSpecModule() {
+    return loadedModule;
+}
+function shouldRunSyncStyleSpecValidation(mode) {
+    return mode !== undefined && mode !== "renderer-deferred";
+}
+function mapStyleSpecErrors(errors, options, remap) {
+    return errors.map((error) => {
+        const parsed = parseMapLibreMessage(stringProperty(error, "message") ?? "Invalid MapLibre style specification.");
+        const path = parsed.path ? normalizeStylePath(parsed.path, remap) : options.path;
+        return mapLibreDiagnostic(error, parsed.message, {
+            ...options,
+            path: path ?? options.path,
+            mapLibrePath: parsed.path,
+        });
+    });
+}
+function mapLibreDiagnostic(error, message, options) {
+    const mapLibreCode = stringProperty(error, "identifier") ?? "validation-error";
+    const line = numberProperty(error, "line");
+    return {
+        code: "style-spec-invalid",
+        severity: severityForMode(options.mode),
+        message,
+        ...(options.path ? { path: options.path } : {}),
+        ...(options.sourceId ? { sourceId: options.sourceId } : {}),
+        ...(options.layerId ? { layerId: options.layerId } : {}),
+        ...(options.protocol ? { protocol: options.protocol } : {}),
+        context: {
+            ...(options.context ?? {}),
+            mapLibreCode,
+            ...(options.mapLibrePath ? { mapLibrePath: options.mapLibrePath } : {}),
+            ...(line !== undefined ? { mapLibreLine: line } : {}),
+        },
+    };
+}
+function validatorUnavailableDiagnostic(options) {
+    const cause = loadAttempted
+        ? errorMessage(loadFailure) || "unknown import failure"
+        : "validator has not been prepared";
+    return {
+        code: "style-spec-validator-unavailable",
+        severity: severityForMode(options.mode),
+        message: "MapLibre style-spec validation is unavailable. Install @maplibre/maplibre-gl-style-spec or use renderer-deferred validation.",
+        ...(options.path ? { path: options.path } : {}),
+        ...(options.sourceId ? { sourceId: options.sourceId } : {}),
+        ...(options.layerId ? { layerId: options.layerId } : {}),
+        ...(options.protocol ? { protocol: options.protocol } : {}),
+        context: {
+            ...(options.context ?? {}),
+            mapLibreCode: "validator-unavailable",
+            cause,
+        },
+    };
+}
+function sanitizeStyle(style) {
+    const sources = {};
+    for (const [sourceId, source] of Object.entries(style.sources)) {
+        sources[sourceId] = isHonuaSourceLike(source)
+            ? placeholderSourceForLayer(firstLayerForSource(style.layers, sourceId), source)
+            : source;
+    }
+    return {
+        ...style,
+        sources,
+    };
+}
+function styleForLayerValidation(layer, options) {
+    const sources = {};
+    const sourceId = typeof layer.source === "string" ? layer.source : undefined;
+    if (sourceId) {
+        const existing = options.style?.sources[sourceId];
+        if (existing) {
+            sources[sourceId] = isHonuaSourceLike(existing) ? placeholderSourceForLayer(layer, existing) : existing;
+        }
+        else if (!options.style) {
+            sources[sourceId] = placeholderSourceForLayer(layer);
+        }
+    }
+    return {
+        version: 8,
+        sources,
+        layers: [layer],
+    };
+}
+function styleForFilterValidation(filter, layerId) {
+    const sourceId = "__honua_filter_source__";
+    return {
+        version: 8,
+        sources: {
+            [sourceId]: geoJsonPlaceholderSource(),
+        },
+        layers: [
+            {
+                id: layerId ?? "__honua_filter_validation__",
+                type: "circle",
+                source: sourceId,
+                filter,
+            },
+        ],
+    };
+}
+function placeholderSourceForLayer(layer, source) {
+    const sourceType = isPlainObject(source) && typeof source.type === "string" ? source.type : undefined;
+    if (sourceType === "honua-wms" || sourceType === "honua-wmts" || sourceType === "honua-map-service") {
+        return rasterPlaceholderSource();
+    }
+    if (layer?.type === "raster")
+        return rasterPlaceholderSource();
+    if (layer?.type === "hillshade")
+        return rasterDemPlaceholderSource();
+    return geoJsonPlaceholderSource();
+}
+function geoJsonPlaceholderSource() {
+    return {
+        type: "geojson",
+        data: { type: "FeatureCollection", features: [] },
+    };
+}
+function rasterPlaceholderSource() {
+    return {
+        type: "raster",
+        tiles: ["https://example.invalid/{z}/{x}/{y}.png"],
+        tileSize: 256,
+    };
+}
+function rasterDemPlaceholderSource() {
+    return {
+        type: "raster-dem",
+        tiles: ["https://example.invalid/{z}/{x}/{y}.png"],
+        tileSize: 256,
+    };
+}
+function firstLayerForSource(layers, sourceId) {
+    return layers.find((layer) => layer.source === sourceId);
+}
+function isHonuaSourceLike(value) {
+    return isPlainObject(value) && typeof value.type === "string" && value.type.startsWith("honua-");
+}
+function parseMapLibreMessage(message) {
+    const separator = message.indexOf(": ");
+    if (separator <= 0)
+        return { path: undefined, message };
+    const path = message.slice(0, separator);
+    if (!looksLikeMapLibrePath(path))
+        return { path: undefined, message };
+    return { path, message: message.slice(separator + 2) };
+}
+function looksLikeMapLibrePath(path) {
+    return /^(version|name|metadata|center|zoom|bearing|pitch|sources|layers|sprite|glyphs|transition|light|terrain|projection|sky)(?:$|[.[\]])/.test(path);
+}
+function normalizeStylePath(path, remap) {
+    if (remap.layerId) {
+        return path.replace(/^layers\[\d+\]/, `layers.${remap.layerId}`);
+    }
+    return path;
+}
+function pathWithExpressionKey(path, key) {
+    if (!key)
+        return path;
+    if (!path)
+        return key.startsWith(".") ? key.slice(1) : key;
+    return key.startsWith("[") || key.startsWith(".") ? `${path}${key}` : `${path}.${key}`;
+}
+function filterPath(layerId) {
+    return layerId ? `layers.${layerId}.filter` : "filter";
+}
+function layerPath(layer) {
+    return layer.id ? `layers.${layer.id}` : "layers[]";
+}
+function severityForMode(mode) {
+    return mode === "warning-only" ? "warning" : "error";
+}
+function stringProperty(value, property) {
+    if (!isPlainObject(value))
+        return undefined;
+    const candidate = value[property];
+    return typeof candidate === "string" ? candidate : undefined;
+}
+function numberProperty(value, property) {
+    if (!isPlainObject(value))
+        return undefined;
+    const candidate = value[property];
+    return typeof candidate === "number" ? candidate : undefined;
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return typeof error === "string" ? error : undefined;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

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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"}