@inf-monkeys-tech/monkeys 1.0.65 → 1.0.68

package/lib/runtime/declarative-control-compiler.d.ts

@@ -0,0 +1,141 @@
+import type { DeclarativeCreateTemplateRegistration, DeclarativeProductResourceRegistration, DeclarativeRouteSpaceRegistration } from '../contracts/declarative-control-http';
+import { type AccessPolicy, type CompiledRouteClaim, type DeclarativeRouteClaim, type Navigation, type NavigationRelease, type NavigationRuntimeBundle, type Page, type PageRelease, type PageRuntimeBundle, type RevisionRef, type RouteSpace, type StableRef, type Workbench, type WorkbenchRelease, type WorkbenchRuntimeBundle } from '../contracts/declarative-control';
+export type DeclarativeControlCompilationErrorCode = 'AUDIENCE_WIDER_THAN_TARGET' | 'CAPABILITY_BINDING_MISMATCH' | 'CAPABILITY_NOT_EDITOR_ELIGIBLE' | 'CROSS_TENANT_REFERENCE' | 'DEPENDENCY_MISSING' | 'HEAD_CONFLICT' | 'NAV_DEPTH_EXCEEDED' | 'NAV_ACTION_INPUT_INVALID' | 'NAV_NODE_LIMIT_EXCEEDED' | 'NAV_TARGET_UNRELEASED' | 'PORT_TYPE_MISMATCH' | 'RENDER_DEPTH_EXCEEDED' | 'RENDER_NODE_LIMIT_EXCEEDED' | 'RELEASE_VALIDATION_FAILED' | 'REGISTRY_CONFLICT' | 'REVISION_MISMATCH' | 'ROUTE_CONFLICT' | 'ROUTE_RESERVED' | 'ROUTE_SPACE_MISSING' | 'ROUTE_SPACE_MISMATCH' | 'WORKBENCH_INSTANCE_LIMIT_EXCEEDED' | 'WORKBENCH_RELEASE_SET_INVALID' | 'WORKBENCH_TEMPLATE_UNRELEASABLE';
+export declare class DeclarativeControlCompilationError extends Error {
+    readonly code: DeclarativeControlCompilationErrorCode;
+    readonly path: string;
+    constructor(code: DeclarativeControlCompilationErrorCode, path: string, message: string);
+}
+export interface DeclarativeControlCompileLimits {
+    maxNavigationNodes: number;
+    maxNavigationDepth: number;
+    maxRenderNodes: number;
+    maxRenderDepth: number;
+    maxWorkbenchGroups: number;
+    maxWorkbenchInstances: number;
+}
+export interface RouteSpaceRegistration {
+    revisionRef: RevisionRef;
+    routeSpace: RouteSpace;
+}
+export interface CapabilityPortRegistration {
+    name: string;
+    schemaRevisionRef: RevisionRef;
+}
+export interface DeclarativeCapabilityRegistration {
+    capabilityRevisionRef: RevisionRef;
+    providerRevisionRef: RevisionRef;
+    editorEligible: boolean;
+    inputPorts: readonly CapabilityPortRegistration[];
+    outputPorts: readonly CapabilityPortRegistration[];
+    allowedSideEffects: readonly ('network' | 'storage' | 'navigation' | 'worker' | 'websocket')[];
+}
+export interface WorkbenchTargetRegistration {
+    stableTargetRef: StableRef;
+    targetRevisionRef: RevisionRef;
+    accessPolicy: AccessPolicy;
+}
+export interface NavigationRouteTargetRegistration extends WorkbenchTargetRegistration {
+    kind: 'route';
+    releaseRevisionRef?: RevisionRef;
+    surface: 'studio' | 'kernel';
+    routeClaim: CompiledRouteClaim;
+}
+export interface NavigationRegisteredMenuActionRegistration extends WorkbenchTargetRegistration {
+    kind: 'registered-menu-action';
+    surface: 'studio' | 'kernel';
+    applicationId: string;
+    actionRef: string;
+    inputSchemaRef?: string;
+    validateInput?: (input: Record<string, unknown>) => Record<string, unknown>;
+    sourceCatalogRevisionRef: RevisionRef;
+}
+export interface NavigationDomainCommandRegistration extends WorkbenchTargetRegistration {
+    kind: 'governed-domain-command';
+    surface: 'studio' | 'kernel';
+    inputSchemaRevisionRef: RevisionRef;
+    resultSchemaRevisionRef?: RevisionRef;
+}
+export type NavigationTargetRegistration = NavigationRouteTargetRegistration | NavigationRegisteredMenuActionRegistration | NavigationDomainCommandRegistration;
+export interface CompileRouteClaimsInput {
+    claims: readonly DeclarativeRouteClaim[];
+    routeSpaces: readonly RouteSpaceRegistration[];
+    surface: 'studio' | 'kernel';
+}
+export interface MaterializeRouteSpacePathInput {
+    routeSpace: RouteSpace;
+    applicationPath: string;
+    parameters?: Readonly<Record<string, string | number>>;
+}
+export interface CompilePageRuntimeBundleInput {
+    page: Page;
+    pageRevisionRef: RevisionRef;
+    release: PageRelease;
+    releaseRevisionRef: RevisionRef;
+    routeSpaces: readonly RouteSpaceRegistration[];
+    compilerRevisionRef: RevisionRef;
+    generation: number;
+    limits: DeclarativeControlCompileLimits;
+    capabilityRegistry: readonly DeclarativeCapabilityRegistration[];
+}
+export interface CompileWorkbenchRuntimeBundleInput {
+    workbench: Workbench;
+    workbenchRevisionRef: RevisionRef;
+    release: WorkbenchRelease;
+    releaseRevisionRef: RevisionRef;
+    routeSpaces: readonly RouteSpaceRegistration[];
+    targetRegistry: readonly WorkbenchTargetRegistration[];
+    compilerRevisionRef: RevisionRef;
+    generation: number;
+    limits: DeclarativeControlCompileLimits;
+}
+export interface CompileNavigationRuntimeBundleInput {
+    navigation: Navigation;
+    navigationRevisionRef: RevisionRef;
+    release: NavigationRelease;
+    releaseRevisionRef: RevisionRef;
+    targetRegistry: readonly NavigationTargetRegistration[];
+    compilerRevisionRef: RevisionRef;
+    generation: number;
+    limits: DeclarativeControlCompileLimits;
+}
+export declare const stableRefKey: (reference: StableRef) => string;
+export declare const revisionRefKey: (reference: RevisionRef) => string;
+export declare const sameStableRef: (left: StableRef, right: StableRef) => boolean;
+export declare const sameRevisionRef: (left: RevisionRef, right: RevisionRef) => boolean;
+export declare const canonicalContentHash: (value: unknown) => string;
+export declare const declarativeCreateTemplateSourceHash: (document: DeclarativeCreateTemplateRegistration['document']) => string;
+export declare const declarativeCreateTemplateRevisionHash: (registration: DeclarativeCreateTemplateRegistration) => string;
+export declare const declarativeRouteSpaceSourceHash: (routeSpace: DeclarativeRouteSpaceRegistration['routeSpace']) => string;
+export declare const declarativeRouteSpaceRevisionHash: (registration: DeclarativeRouteSpaceRegistration) => string;
+export declare const declarativeProductResourceSourceHash: (document: DeclarativeProductResourceRegistration['document']) => string;
+export declare const declarativeProductResourceRevisionHash: (registration: DeclarativeProductResourceRegistration) => string;
+export declare const accessPolicyChainImplies: (policyInputs: readonly AccessPolicy[], targetInput: AccessPolicy) => boolean;
+export declare const compileRouteClaims: (input: CompileRouteClaimsInput) => readonly CompiledRouteClaim[];
+/**
+ * Materializes the browser URL owned by a RouteSpace from an application-relative
+ * compiled route. Declarations and runtime resolution remain application-relative;
+ * only this boundary applies product bases such as /:teamId or /kernel.
+ */
+export declare const materializeRouteSpacePath: (input: MaterializeRouteSpacePathInput) => string;
+export declare const compilePageRuntimeBundle: (input: CompilePageRuntimeBundleInput) => PageRuntimeBundle;
+export declare const compileWorkbenchRuntimeBundle: (input: CompileWorkbenchRuntimeBundleInput) => WorkbenchRuntimeBundle;
+export declare const compileNavigationRuntimeBundle: (input: CompileNavigationRuntimeBundleInput) => NavigationRuntimeBundle;
+export declare const validateWorkbenchRuntimeSet: (bundleInputs: readonly WorkbenchRuntimeBundle[]) => readonly WorkbenchRuntimeBundle[];
+export type WorkbenchEntryResolution = {
+    status: 'resolved';
+    bundle: WorkbenchRuntimeBundle;
+    source: 'explicit' | 'default' | 'first-accessible';
+} | {
+    status: 'not-found';
+    workbenchId: string;
+} | {
+    status: 'forbidden';
+    workbenchId: string;
+};
+export declare const resolveWorkbenchEntry: (input: {
+    bundles: readonly WorkbenchRuntimeBundle[];
+    requestedWorkbenchId?: string;
+    isAllowed: (bundle: WorkbenchRuntimeBundle) => boolean;
+}) => WorkbenchEntryResolution;
+//# sourceMappingURL=declarative-control-compiler.d.ts.map

package/lib/runtime/declarative-control-compiler.d.ts.map

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