@honua/react 0.0.20-alpha.0

package/generated-app/manifest.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Versioned manifest/profile consumed by `@honua/sdk-js/generated-app`.
+ *
+ * The manifest is the browser-safe projection of the canonical builder
+ * package: it does not define a new wire contract, it names the SDK widget
+ * bindings the preview runtime needs to hydrate one generated operations
+ * dashboard slice.
+ *
+ * @module
+ */
+import type { AggregationMetric, FeatureId, WidgetTimeSeriesInterval } from "../contract/index.js";
+import type { ExplorationState, FilterClause, LinkedViewPresetName } from "../exploration/index.js";
+import type { HonuaMapPackage } from "../runtime/index.js";
+export declare const HONUA_GENERATED_APP_MANIFEST_FORMAT_V1: "honua_generated_app_manifest.v1";
+export declare const HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND: "honua.generated-app.manifest";
+export declare const HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION: 1;
+export declare const HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1: "operations-dashboard.v1";
+export type HonuaGeneratedAppManifestFormat = typeof HONUA_GENERATED_APP_MANIFEST_FORMAT_V1;
+export type HonuaGeneratedAppManifestArtifactKind = typeof HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND;
+export type HonuaGeneratedAppManifestArtifactVersion = typeof HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION;
+export type HonuaGeneratedAppProfile = typeof HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1;
+export type HonuaGeneratedAppWidgetKind = "map" | "table" | "list" | "count" | "chart" | "filter";
+export type HonuaGeneratedAppChartKind = "categories" | "histogram" | "time-series";
+export interface HonuaGeneratedAppFieldBinding {
+    readonly sourceId?: string;
+    readonly primaryKey?: string;
+    readonly titleField?: string;
+    readonly subtitleField?: string;
+    readonly categoryField?: string;
+    readonly filterField?: string;
+    readonly tableFields?: ReadonlyArray<string>;
+    readonly searchFields?: ReadonlyArray<string>;
+    readonly layerId?: string;
+    readonly sourceLayer?: string;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppDataBinding {
+    readonly sourceId: string;
+    /**
+     * Maximum records the default preview loader requests from the source.
+     * Hosts that need larger/realtime result sets should pass a custom
+     * `featureLoader` to the runtime.
+     */
+    readonly previewLimit?: number;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppWidgetBase {
+    readonly id: string;
+    readonly kind: HonuaGeneratedAppWidgetKind;
+    readonly title?: string;
+    readonly sourceId?: string;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppMapWidget extends HonuaGeneratedAppWidgetBase {
+    readonly kind: "map";
+    readonly layerId?: string;
+    readonly sourceLayer?: string;
+    readonly showLegend?: boolean;
+    readonly showSearch?: boolean;
+}
+export interface HonuaGeneratedAppTableWidget extends HonuaGeneratedAppWidgetBase {
+    readonly kind: "table" | "list";
+    readonly fields?: ReadonlyArray<string>;
+    readonly primaryKey?: string;
+    readonly titleField?: string;
+    readonly subtitleField?: string;
+    readonly pageSize?: number;
+}
+export interface HonuaGeneratedAppCountWidget extends HonuaGeneratedAppWidgetBase {
+    readonly kind: "count";
+    readonly label?: string;
+}
+export interface HonuaGeneratedAppChartWidget extends HonuaGeneratedAppWidgetBase {
+    readonly kind: "chart";
+    readonly chartKind?: HonuaGeneratedAppChartKind;
+    readonly groupBy?: string;
+    readonly field?: string;
+    readonly bins?: number;
+    readonly min?: number;
+    readonly max?: number;
+    readonly interval?: WidgetTimeSeriesInterval;
+    readonly start?: string | number;
+    readonly end?: string | number;
+    readonly fillMissing?: boolean;
+    readonly metric?: AggregationMetric;
+}
+export interface HonuaGeneratedAppFilterOption {
+    readonly value: string | number | boolean;
+    readonly label?: string;
+}
+export interface HonuaGeneratedAppFilterWidget extends HonuaGeneratedAppWidgetBase {
+    readonly kind: "filter";
+    readonly field: string;
+    readonly label?: string;
+    readonly options?: ReadonlyArray<HonuaGeneratedAppFilterOption>;
+}
+export type HonuaGeneratedAppWidget = HonuaGeneratedAppMapWidget | HonuaGeneratedAppTableWidget | HonuaGeneratedAppCountWidget | HonuaGeneratedAppChartWidget | HonuaGeneratedAppFilterWidget;
+export interface HonuaGeneratedAppLayout {
+    readonly kind: "operations-dashboard";
+    readonly widgets: ReadonlyArray<HonuaGeneratedAppWidget>;
+}
+export interface HonuaGeneratedAppManifest {
+    readonly format: HonuaGeneratedAppManifestFormat;
+    readonly profile: HonuaGeneratedAppProfile;
+    readonly appId: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly version?: string;
+    readonly data: HonuaGeneratedAppDataBinding;
+    readonly mapPackageId?: string;
+    readonly mapPackage?: HonuaMapPackage;
+    readonly layout: HonuaGeneratedAppLayout;
+    readonly bindings?: HonuaGeneratedAppFieldBinding;
+    readonly initialState?: Partial<ExplorationState>;
+    readonly linkedViewPreset?: LinkedViewPresetName;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppManifestArtifact {
+    readonly artifactKind: HonuaGeneratedAppManifestArtifactKind;
+    readonly artifactVersion: HonuaGeneratedAppManifestArtifactVersion;
+    readonly manifest: HonuaGeneratedAppManifest;
+    readonly createdAt?: string;
+    readonly source?: string;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppAssetRef {
+    readonly id: string;
+    readonly kind: "map-package" | "app-package" | "manifest" | "file" | "artifact" | (string & {});
+    readonly url?: string;
+    readonly mediaType?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * Structural `AppPackage` subset the SDK generated-app projection consumes.
+ * The canonical server object remains authoritative; this interface only names
+ * the `manifest_artifact` bridge and stable package identity the browser needs.
+ */
+export interface HonuaGeneratedAppPackage {
+    readonly id: string;
+    readonly version: string;
+    readonly assets?: ReadonlyArray<HonuaGeneratedAppAssetRef>;
+    readonly manifest_artifact?: HonuaGeneratedAppManifestArtifact | HonuaGeneratedAppManifest;
+    readonly manifestArtifact?: HonuaGeneratedAppManifestArtifact | HonuaGeneratedAppManifest;
+    readonly mapPackage?: HonuaMapPackage;
+    readonly metadata?: unknown;
+    readonly [extra: string]: unknown;
+}
+/**
+ * Structural `BuildSpec` subset used by the SDK projection helper. Canonical
+ * builders may carry richer fields; additive content is preserved on
+ * `manifest.metadata.buildSpec`.
+ */
+export interface HonuaGeneratedAppBuildSpec {
+    readonly id?: string;
+    readonly appId?: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly profile?: string;
+    readonly appProfile?: string;
+    readonly sourceId?: string;
+    readonly primarySourceId?: string;
+    readonly widgets?: ReadonlyArray<HonuaGeneratedAppWidget>;
+    readonly layout?: Partial<HonuaGeneratedAppLayout> & {
+        readonly widgets?: ReadonlyArray<HonuaGeneratedAppWidget>;
+    };
+    readonly bindings?: HonuaGeneratedAppFieldBinding;
+    readonly initialState?: Partial<ExplorationState>;
+    readonly linkedViewPreset?: LinkedViewPresetName;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppFeatureRecord<TAttributes extends Record<string, unknown> = Record<string, unknown>> {
+    readonly id: FeatureId;
+    readonly sourceId?: string;
+    readonly attributes: TAttributes;
+    readonly geometry?: unknown;
+    readonly [extra: string]: unknown;
+}
+export interface HonuaGeneratedAppFilterState {
+    readonly id: string;
+    readonly clause: FilterClause;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/generated-app/manifest.d.ts.map

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

package/generated-app/manifest.js

@@ -0,0 +1,14 @@
+/**
+ * Versioned manifest/profile consumed by `@honua/sdk-js/generated-app`.
+ *
+ * The manifest is the browser-safe projection of the canonical builder
+ * package: it does not define a new wire contract, it names the SDK widget
+ * bindings the preview runtime needs to hydrate one generated operations
+ * dashboard slice.
+ *
+ * @module
+ */
+export const HONUA_GENERATED_APP_MANIFEST_FORMAT_V1 = "honua_generated_app_manifest.v1";
+export const HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND = "honua.generated-app.manifest";
+export const HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION = 1;
+export const HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1 = "operations-dashboard.v1";

package/generated-app/projection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Projection helpers from canonical builder/package artifacts into the
+ * SDK generated-app manifest. These helpers are structural on purpose:
+ * the canonical protobuf / server DTOs remain the source of truth, and this
+ * subpath only extracts the browser-safe fields needed by the preview runtime.
+ *
+ * @module
+ */
+import type { HonuaMapPackage } from "../runtime/index.js";
+import { type HonuaGeneratedAppBuildSpec, type HonuaGeneratedAppFieldBinding, type HonuaGeneratedAppManifest, type HonuaGeneratedAppManifestArtifact, type HonuaGeneratedAppPackage, type HonuaGeneratedAppWidget } from "./manifest.js";
+export declare const HONUA_GENERATED_APP_DEFAULT_PREVIEW_LIMIT = 250;
+export declare const HONUA_GENERATED_APP_MAX_PREVIEW_LIMIT = 1000;
+export declare const HONUA_GENERATED_APP_MAX_WIDGETS = 64;
+export interface ProjectBuildSpecToGeneratedAppManifestOptions {
+    readonly appId?: string;
+    readonly version?: string;
+    readonly sourceId?: string;
+    readonly mapPackage?: HonuaMapPackage;
+    readonly mapPackageId?: string;
+    readonly bindings?: HonuaGeneratedAppFieldBinding;
+    readonly widgets?: ReadonlyArray<HonuaGeneratedAppWidget>;
+}
+export interface ProjectMapPackageToGeneratedAppManifestOptions {
+    readonly appId?: string;
+    readonly title?: string;
+    readonly version?: string;
+    readonly sourceId?: string;
+    readonly bindings?: HonuaGeneratedAppFieldBinding;
+    readonly widgets?: ReadonlyArray<HonuaGeneratedAppWidget>;
+}
+export declare function createGeneratedAppManifestArtifact(manifest: HonuaGeneratedAppManifest, options?: {
+    readonly createdAt?: string;
+    readonly source?: string;
+}): HonuaGeneratedAppManifestArtifact;
+export declare function projectAppPackageToGeneratedAppManifest(pkg: HonuaGeneratedAppPackage, options?: {
+    readonly mapPackage?: HonuaMapPackage;
+}): HonuaGeneratedAppManifest;
+export declare function projectBuildSpecToGeneratedAppManifest(buildSpec: HonuaGeneratedAppBuildSpec, options?: ProjectBuildSpecToGeneratedAppManifestOptions): HonuaGeneratedAppManifest;
+export declare function projectMapPackageToGeneratedAppManifest(mapPackage: HonuaMapPackage, options?: ProjectMapPackageToGeneratedAppManifestOptions): HonuaGeneratedAppManifest;
+export declare function assertGeneratedAppManifest(manifest: HonuaGeneratedAppManifest): void;
+export declare function clampGeneratedAppManifest(manifest: HonuaGeneratedAppManifest): HonuaGeneratedAppManifest;
+export declare function clampGeneratedAppPreviewLimit(value: number | undefined): number | undefined;
+export declare function clampGeneratedAppWidgets(widgets: ReadonlyArray<HonuaGeneratedAppWidget>): ReadonlyArray<HonuaGeneratedAppWidget>;
+//# sourceMappingURL=projection.d.ts.map

package/generated-app/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/generated-app/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAKL,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAElC,KAAK,yBAAyB,EAC9B,KAAK,iCAAiC,EACtC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,yCAAyC,MAAM,CAAC;AAC7D,eAAO,MAAM,qCAAqC,OAAQ,CAAC;AAC3D,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,8CAA8C;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAC3D;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,iCAAiC,CASnC;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,wBAAwB,EAC7B,OAAO,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;CAAO,GACtD,yBAAyB,CAuB3B;AAED,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,0BAA0B,EACrC,OAAO,GAAE,6CAAkD,GAC1D,yBAAyB,CAsD3B;AAED,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,8CAAmD,GAC3D,yBAAyB,CAgC3B;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CA2CpF;AA8DD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,yBAAyB,CAaxG;AAaD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI3F;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,CAAC,uBAAuB,CAAC,GAC9C,aAAa,CAAC,uBAAuB,CAAC,CAExC"}

package/generated-app/projection.js

@@ -0,0 +1,234 @@
+/**
+ * Projection helpers from canonical builder/package artifacts into the
+ * SDK generated-app manifest. These helpers are structural on purpose:
+ * the canonical protobuf / server DTOs remain the source of truth, and this
+ * subpath only extracts the browser-safe fields needed by the preview runtime.
+ *
+ * @module
+ */
+import { HonuaGeneratedAppError } from "./errors.js";
+import { HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND, HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION, HONUA_GENERATED_APP_MANIFEST_FORMAT_V1, HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1, } from "./manifest.js";
+export const HONUA_GENERATED_APP_DEFAULT_PREVIEW_LIMIT = 250;
+export const HONUA_GENERATED_APP_MAX_PREVIEW_LIMIT = 1_000;
+export const HONUA_GENERATED_APP_MAX_WIDGETS = 64;
+export function createGeneratedAppManifestArtifact(manifest, options = {}) {
+    assertGeneratedAppManifest(manifest);
+    return {
+        artifactKind: HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND,
+        artifactVersion: HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION,
+        manifest,
+        ...(options.createdAt ? { createdAt: options.createdAt } : {}),
+        ...(options.source ? { source: options.source } : {}),
+    };
+}
+export function projectAppPackageToGeneratedAppManifest(pkg, options = {}) {
+    const artifact = pkg.manifest_artifact ?? pkg.manifestArtifact;
+    if (!artifact) {
+        throw new HonuaGeneratedAppError("missing-manifest-artifact", "AppPackage is missing manifest_artifact for generated-app preview", {
+            stage: "projection",
+            detail: { appId: pkg.id, path: "AppPackage.manifest_artifact" },
+        });
+    }
+    const manifest = extractManifestArtifact(artifact, pkg.id);
+    assertGeneratedAppManifest(manifest);
+    const mapPackage = manifest.mapPackage ?? options.mapPackage ?? pkg.mapPackage;
+    return clampGeneratedAppManifest({
+        ...manifest,
+        appId: manifest.appId || pkg.id,
+        version: manifest.version ?? pkg.version,
+        ...(mapPackage ? { mapPackage, mapPackageId: manifest.mapPackageId ?? mapPackage.mapPackageId } : {}),
+    });
+}
+export function projectBuildSpecToGeneratedAppManifest(buildSpec, options = {}) {
+    const profile = buildSpec.profile ?? buildSpec.appProfile ?? HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1;
+    if (profile !== HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1) {
+        throw new HonuaGeneratedAppError("unsupported-profile", `unsupported generated app profile "${profile}"`, {
+            stage: "projection",
+            detail: {
+                appId: buildSpec.appId ?? buildSpec.id ?? options.appId,
+                expected: HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1,
+                received: profile,
+            },
+        });
+    }
+    const bindings = { ...(options.bindings ?? {}), ...(buildSpec.bindings ?? {}) };
+    const sourceId = options.sourceId ?? buildSpec.sourceId ?? buildSpec.primarySourceId ?? bindings.sourceId;
+    if (!sourceId) {
+        throw new HonuaGeneratedAppError("missing-binding", "BuildSpec projection requires a sourceId", {
+            stage: "projection",
+            detail: { appId: buildSpec.appId ?? buildSpec.id ?? options.appId, path: "BuildSpec.sourceId" },
+        });
+    }
+    const widgets = clampGeneratedAppWidgets(options.widgets ?? buildSpec.widgets ?? buildSpec.layout?.widgets ?? defaultOperationsWidgets(bindings));
+    const previewLimit = clampGeneratedAppPreviewLimit(buildSpec.data?.previewLimit);
+    return clampGeneratedAppManifest({
+        format: HONUA_GENERATED_APP_MANIFEST_FORMAT_V1,
+        profile: HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1,
+        appId: options.appId ?? buildSpec.appId ?? buildSpec.id ?? "generated-app",
+        ...(buildSpec.title ? { title: buildSpec.title } : {}),
+        ...(buildSpec.description ? { description: buildSpec.description } : {}),
+        ...(options.version ? { version: options.version } : {}),
+        data: {
+            sourceId,
+            ...(previewLimit === undefined ? {} : { previewLimit }),
+        },
+        ...((options.mapPackageId ?? options.mapPackage?.mapPackageId)
+            ? { mapPackageId: options.mapPackageId ?? options.mapPackage?.mapPackageId }
+            : {}),
+        ...(options.mapPackage ? { mapPackage: options.mapPackage } : {}),
+        layout: {
+            kind: "operations-dashboard",
+            widgets,
+        },
+        ...(Object.keys(bindings).length > 0 ? { bindings } : {}),
+        ...(buildSpec.initialState ? { initialState: buildSpec.initialState } : {}),
+        ...(buildSpec.linkedViewPreset ? { linkedViewPreset: buildSpec.linkedViewPreset } : {}),
+        metadata: {
+            buildSpec,
+        },
+    });
+}
+export function projectMapPackageToGeneratedAppManifest(mapPackage, options = {}) {
+    const sourceId = options.sourceId ?? mapPackage.sourceBindings[0]?.sourceId;
+    if (!sourceId) {
+        throw new HonuaGeneratedAppError("missing-binding", "MapPackage projection requires at least one source binding", {
+            stage: "projection",
+            detail: { appId: options.appId, path: "MapPackage.sourceBindings" },
+        });
+    }
+    const bindings = {
+        sourceId,
+        layerId: firstLayerIdForSource(mapPackage, sourceId),
+        ...(options.bindings ?? {}),
+    };
+    return clampGeneratedAppManifest({
+        format: HONUA_GENERATED_APP_MANIFEST_FORMAT_V1,
+        profile: HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1,
+        appId: options.appId ?? mapPackage.previewArtifactId ?? mapPackage.mapPackageId,
+        title: options.title ?? mapPackage.templateId ?? "Generated operations dashboard",
+        ...(options.version ? { version: options.version } : {}),
+        data: { sourceId },
+        mapPackageId: mapPackage.mapPackageId,
+        mapPackage,
+        layout: {
+            kind: "operations-dashboard",
+            widgets: options.widgets ?? defaultOperationsWidgets(bindings),
+        },
+        bindings,
+        metadata: {
+            mapPackageId: mapPackage.mapPackageId,
+        },
+    });
+}
+export function assertGeneratedAppManifest(manifest) {
+    if (manifest.format !== HONUA_GENERATED_APP_MANIFEST_FORMAT_V1) {
+        throw new HonuaGeneratedAppError("missing-manifest", `unsupported generated app manifest format "${String(manifest.format)}"`, {
+            stage: "manifest",
+            detail: {
+                appId: manifest.appId,
+                path: "GeneratedAppManifest.format",
+                expected: HONUA_GENERATED_APP_MANIFEST_FORMAT_V1,
+                received: manifest.format,
+            },
+        });
+    }
+    if (manifest.profile !== HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1) {
+        throw new HonuaGeneratedAppError("unsupported-profile", `unsupported generated app profile "${String(manifest.profile)}"`, {
+            stage: "manifest",
+            detail: {
+                appId: manifest.appId,
+                path: "GeneratedAppManifest.profile",
+                expected: HONUA_GENERATED_APP_PROFILE_OPERATIONS_DASHBOARD_V1,
+                received: manifest.profile,
+            },
+        });
+    }
+    if (!manifest.data?.sourceId) {
+        throw new HonuaGeneratedAppError("missing-binding", "GeneratedAppManifest.data.sourceId is required", {
+            stage: "manifest",
+            detail: { appId: manifest.appId, path: "GeneratedAppManifest.data.sourceId" },
+        });
+    }
+    if (!manifest.layout || manifest.layout.kind !== "operations-dashboard" || !Array.isArray(manifest.layout.widgets)) {
+        throw new HonuaGeneratedAppError("missing-binding", "GeneratedAppManifest.layout.widgets is required", {
+            stage: "manifest",
+            detail: { appId: manifest.appId, path: "GeneratedAppManifest.layout.widgets" },
+        });
+    }
+}
+function extractManifestArtifact(artifact, appId) {
+    if ("artifactKind" in artifact || "artifactVersion" in artifact) {
+        const manifestArtifact = artifact;
+        if (manifestArtifact.artifactKind !== HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND) {
+            throw new HonuaGeneratedAppError("missing-manifest-artifact", "unsupported generated-app manifest artifact kind", {
+                stage: "projection",
+                detail: {
+                    appId,
+                    path: "AppPackage.manifest_artifact.artifactKind",
+                    expected: HONUA_GENERATED_APP_MANIFEST_ARTIFACT_KIND,
+                    received: manifestArtifact.artifactKind,
+                },
+            });
+        }
+        if (manifestArtifact.artifactVersion !== HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION) {
+            throw new HonuaGeneratedAppError("missing-manifest-artifact", "unsupported generated-app manifest artifact version", {
+                stage: "projection",
+                detail: {
+                    appId,
+                    path: "AppPackage.manifest_artifact.artifactVersion",
+                    expected: HONUA_GENERATED_APP_MANIFEST_ARTIFACT_VERSION,
+                    received: manifestArtifact.artifactVersion,
+                },
+            });
+        }
+        return manifestArtifact.manifest;
+    }
+    return artifact;
+}
+function defaultOperationsWidgets(bindings) {
+    const sourceId = bindings.sourceId;
+    const filterField = bindings.filterField ?? bindings.categoryField ?? "category";
+    const categoryField = bindings.categoryField ?? bindings.filterField ?? "category";
+    const tableFields = bindings.tableFields;
+    const layerId = bindings.layerId;
+    return [
+        { id: "map", kind: "map", title: "Map", sourceId, layerId },
+        { id: "table", kind: "table", title: "Results", sourceId, fields: tableFields },
+        { id: "count", kind: "count", title: "Count", sourceId },
+        { id: "chart", kind: "chart", title: "By category", sourceId, groupBy: categoryField },
+        { id: "filter", kind: "filter", title: "Filter", sourceId, field: filterField },
+    ];
+}
+function firstLayerIdForSource(mapPackage, sourceId) {
+    return mapPackage.mapSpec.layers.find((layer) => layer.source === sourceId)?.id;
+}
+export function clampGeneratedAppManifest(manifest) {
+    const widgets = clampGeneratedAppWidgets(manifest.layout.widgets);
+    const previewLimit = clampGeneratedAppPreviewLimit(manifest.data.previewLimit);
+    const data = previewLimit === manifest.data.previewLimit ? manifest.data : dataWithPreviewLimit(manifest, previewLimit);
+    return {
+        ...manifest,
+        data,
+        layout: {
+            ...manifest.layout,
+            widgets,
+        },
+    };
+}
+function dataWithPreviewLimit(manifest, previewLimit) {
+    const { previewLimit: _previewLimit, ...rest } = manifest.data;
+    return {
+        ...rest,
+        ...(previewLimit === undefined ? {} : { previewLimit }),
+    };
+}
+export function clampGeneratedAppPreviewLimit(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isFinite(value))
+        return undefined;
+    return Math.max(1, Math.min(HONUA_GENERATED_APP_MAX_PREVIEW_LIMIT, Math.trunc(value)));
+}
+export function clampGeneratedAppWidgets(widgets) {
+    return widgets.length > HONUA_GENERATED_APP_MAX_WIDGETS ? widgets.slice(0, HONUA_GENERATED_APP_MAX_WIDGETS) : widgets;
+}