@pikku/addon-graph 0.12.12 → 0.12.13

package/dist/.pikku/addon/function/pikku-function-types.gen.d.ts

@@ -0,0 +1,270 @@
+/**
+ * This file was generated by @pikku/cli@0.12.107
+ */
+/**
+ * Core function types for all wirings
+ */
+import type { PickRequired } from '@pikku/core/utils';
+import type { ListInput, ListOutput } from '@pikku/core/function';
+import type { CorePermissionGroup } from '@pikku/core/function';
+import type { PikkuWire, SecretlessServices } from '@pikku/core/types';
+import type { CorePikkuFunctionConfig, CorePikkuSessionlessFunctionConfig, CorePikkuPermission } from '@pikku/core/function';
+import type { NodeType } from '@pikku/core/node';
+import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.js';
+import type { PikkuPermission } from '../auth/pikku-auth-types.gen.js';
+import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
+type CredentialsMap = Record<string, unknown>;
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function';
+import type { UserSession } from '../../../types/application-types.d.js';
+import type { SingletonServices } from '../../../types/application-types.d.js';
+import type { Services } from '../../../types/application-types.d.js';
+import type { TypedPikkuRPC, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
+import type { RequiredSingletonServices } from '../pikku-services.gen.js';
+import type { TypedWorkflow } from '../workflow/pikku-workflow-types.gen.js';
+import type { TypedScenario, TypedPersonas } from '../scenarios/pikku-scenario-types.gen.js';
+export type { SingletonServices as SingletonServices };
+export type { Services as Services };
+export type Session = UserSession;
+/**
+ * The services a wired function actually receives. The inspector records which
+ * services each wired `func`, `permissions` and `middleware` destructures and
+ * emits them as `RequiredSingletonServices`; intersecting that here makes those
+ * services **non-optional** at every call site. A service is optional only when
+ * nothing destructures it — in which case it is never created either. This is
+ * why an `if (!service)` guard inside a function body is always dead code.
+ */
+export type WiredSingletonServices = RequiredSingletonServices & SingletonServices;
+export type WiredServices = SecretlessServices<RequiredSingletonServices & Services>;
+/**
+ * Inline node configuration for function definitions.
+ */
+export type NodeConfig = {
+    displayName: string;
+    category: 'Transform' | 'Array' | 'Data' | 'Logic' | 'Files';
+    type: NodeType;
+    errorOutput?: boolean;
+};
+/**
+ * A function that generates a human-readable description of a pending approval action.
+ * Used by AI agents to show meaningful approval prompts instead of raw tool arguments.
+ *
+ * @template In - The input type (same as the function it describes)
+ * @template RequiredServices - The services required for this description function
+ */
+export type PikkuApprovalDescription<In = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices> = (services: RequiredServices, data: In) => Promise<string>;
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export declare const pikkuApprovalDescription: <In = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices>(fn: PikkuApprovalDescription<In, RequiredServices>) => PikkuApprovalDescription<In, RequiredServices>;
+/**
+ * A sessionless API function that doesn't require user authentication.
+ * Use this for public endpoints, health checks, or operations that don't need user context.
+ *
+ * @template In - The input type
+ * @template Out - The output type that the function returns
+ * @template RequiredServices - Services required by this function
+ * @template ScenarioOut - Types `scenario.context`; only scenarios set it.
+ *   Not defaulted to `Out`, which would make every ordinary function's wire
+ *   type vary with its return type and cost a `func` written against the
+ *   `PikkuFunction | PikkuFunctionSessionless` union its contextual typing.
+ */
+export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices, ScenarioOut = unknown> = CorePikkuFunctionSessionless<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, false, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario<ScenarioOut>, TypedPersonas, CredentialsMap>, RequiredWires>>;
+/**
+ * A session-aware API function that requires user authentication.
+ * Use this for protected endpoints that need access to user session data.
+ *
+ * @template In - The input type
+ * @template Out - The output type that the function returns
+ * @template RequiredServices - Services required by this function
+ */
+export type PikkuFunction<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = 'session', RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuFunction<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, true, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario, TypedPersonas, CredentialsMap>, RequiredWires>>;
+/**
+ * Helper type to infer the output type from a Standard Schema
+ */
+export type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output> ? Output : never;
+/**
+ * Configuration object for Pikku functions with optional middleware, permissions, tags, and documentation.
+ * This type wraps CorePikkuFunctionConfig with the user's custom types.
+ *
+ * @template In - The input type
+ * @template Out - The output type
+ * @template PikkuFunc - The function type (can be narrowed to PikkuFunction or PikkuFunctionSessionless)
+ */
+export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunction<In, Out, RequiredWires, any> | PikkuFunctionSessionless<In, Out, RequiredWires, any, any> = PikkuFunction<In, Out, RequiredWires> | PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, ScopeId>, 'node'> & {
+    node?: NodeConfig;
+};
+/**
+ * {@link PikkuFunctionConfig} for a function that runs without a session.
+ * Has no `scopes`: an anonymous caller holds none, so none can ever be met.
+ */
+type PikkuFunctionSessionlessConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunctionSessionless<In, Out, RequiredWires, any> = PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema>, 'node'> & {
+    node?: NodeConfig;
+};
+/**
+ * Configuration object for Pikku functions with Zod schema validation.
+ * Use this when you want to define input/output schemas using Zod.
+ * Types are automatically inferred from the schemas.
+ */
+type SchemaInferred<S, Fallback = unknown> = S extends StandardSchemaV1 ? InferSchemaOutput<S> : Fallback;
+/**
+ * Schema-overload variant for pikkuFunc. Derived from CorePikkuFunctionConfig
+ * so adding a field on the core type automatically propagates here.
+ */
+type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>, CorePikkuPermission<any>, PikkuMiddleware, undefined, undefined, ScopeId>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
+    func: PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>;
+    input?: InputSchema;
+    output?: OutputSchema;
+    node?: NodeConfig;
+    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
+    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
+};
+/**
+ * Creates a Pikku function that can be either session-aware or sessionless.
+ * This is the main function wrapper for creating API endpoints.
+ *
+ * Define the input and output with Zod schemas — the function's types are
+ * inferred from them, and the schemas double as runtime validation.
+ *
+ * @param config - Function definition with `input`/`output` Zod schemas and `func`.
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * const createUserInput = z.object({ name: z.string(), email: z.string() })
+ * const createUserOutput = z.object({ id: z.number() })
+ *
+ * const createUser = pikkuFunc({
+ *   input: createUserInput,
+ *   output: createUserOutput,
+ *   func: async ({db}, input) => {
+ *     // input is typed as { name: string, email: string }
+ *     const user = await db.users.create(input)
+ *     return { id: user.id } // must match output schema
+ *   }
+ * })
+ * ```
+ */
+export declare function pikkuFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuFunctionConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
+export declare function pikkuFunc<In, Out = unknown>(func: PikkuFunction<In, Out, 'session' | 'rpc'> | PikkuFunctionConfig<In, Out, 'session' | 'rpc'>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
+export declare const pikkuListFunc: <F extends Record<string, unknown> = {}, Row = unknown, S extends string = never>(config: PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">) => PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">;
+/**
+ * Configuration object for sessionless Pikku functions with Zod schema validation.
+ */
+/**
+ * Schema-overload variant for pikkuSessionlessFunc. Derived from
+ * CorePikkuSessionlessFunctionConfig to stay in sync with the generic-typed
+ * config — so it has no `scopes` either.
+ */
+type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
+    func: PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>;
+    input?: InputSchema;
+    output?: OutputSchema;
+    node?: NodeConfig;
+    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
+    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
+};
+/**
+ * Creates a sessionless Pikku function that doesn't require user authentication.
+ * Use this for public endpoints, webhooks, or background tasks.
+ *
+ * Define the input and output with Zod schemas — the function's types are
+ * inferred from them, and the schemas double as runtime validation.
+ *
+ * @param config - Function definition with `input`/`output` Zod schemas and `func`.
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * const greetInput = z.object({ name: z.string() })
+ * const greetOutput = z.object({ message: z.string() })
+ *
+ * const greet = pikkuSessionlessFunc({
+ *   input: greetInput,
+ *   output: greetOutput,
+ *   func: async (_services, { name }) => {
+ *     return { message: `Hello, ${name}!` }
+ *   }
+ * })
+ * ```
+ */
+export declare function pikkuSessionlessFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredServices extends SecretlessServices<Services> = WiredServices>(config: PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc', RequiredServices>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
+export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices>(func: PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices> | PikkuFunctionSessionlessConfig<In, Out, 'session' | 'rpc', PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices>>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
+/**
+ * Creates a function that takes no input and returns no output.
+ * Useful for health checks, triggers, or cleanup operations.
+ *
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
+ *     logger.info('Starting cleanup of temporary files')
+ *     await fileSystem.deleteDirectory('/tmp/uploads')
+ *     logger.info('Cleanup completed')
+ * })
+ * ```
+ */
+export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionSessionlessConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "session" | "rpc">;
+/**
+ * References a registered function by name for use in any wiring.
+ * Works for both local and addon functions — resolves via RPC at runtime.
+ *
+ * @template Name - The function name (must be a key in FlattenedRPCMap)
+ * @param rpcName - The name of the function to reference
+ * @returns A Pikku function config that proxies calls via RPC
+ *
+ * @example
+ * ```typescript
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
+ * ```
+ */
+export declare const ref: <Name extends keyof FlattenedRPCMap>(rpcName: Name) => PikkuFunctionConfig<FlattenedRPCMap[Name]["input"], FlattenedRPCMap[Name]["output"], "session" | "rpc">;
+/**
+ * Declares a capability the connected client answers, reachable from any
+ * `wireChannel` function as `channel.remote(name, input)`.
+ *
+ * There is no `func`: this side owns the contract, the client owns the body.
+ * The `description` is what a person is shown when asked to approve the call,
+ * so write it for them rather than for the caller.
+ *
+ * @example
+ * ```typescript
+ * export const localCheckoutOutput = z.object({ sha: z.string(), branch: z.string() })
+ *
+ * export const localCheckout = pikkuRemoteChannelFunc({
+ *   description: 'Read the current commit and branch of your working tree',
+ *   output: localCheckoutOutput,
+ * })
+ * ```
+ */
+export declare function pikkuRemoteChannelFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: Omit<PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>, 'func'>): PikkuFunctionConfig<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, 'session' | 'rpc'>;
+/**
+ * Addon contract references. Generated from each wired addon's published
+ * contract metadata — no addon source is imported. Functions are proxied via
+ * ref() (RPC) exactly like ref('namespace:fn').
+ */
+declare const __addonHttp: {};
+declare const __addonChannel: {};
+declare const __addonCli: {};
+export declare const refHTTP: <Name extends keyof typeof __addonHttp>(name: Name, options?: {
+    basePath?: string;
+}) => (typeof __addonHttp)[Name];
+export declare const refChannel: <Name extends keyof typeof __addonChannel>(name: Name) => (typeof __addonChannel)[Name];
+export declare const refCLI: <Name extends keyof typeof __addonCli>(name: Name) => (typeof __addonCli)[Name];
+//# sourceMappingURL=pikku-function-types.gen.d.ts.map

package/dist/.pikku/addon/function/pikku-function-types.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-function-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/function/pikku-function-types.gen.ts"],"names":[],"mappings":"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"}

package/dist/.pikku/addon/function/pikku-function-types.gen.js

@@ -0,0 +1,117 @@
+/**
+ * This file was generated by @pikku/cli@0.12.107
+ */
+/**
+ * Core function types for all wirings
+ */
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export const pikkuApprovalDescription = (fn) => {
+    return fn;
+};
+export function pikkuFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+export const pikkuListFunc = (config) => {
+    return pikkuFunc(config);
+};
+export function pikkuSessionlessFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+/**
+ * Creates a function that takes no input and returns no output.
+ * Useful for health checks, triggers, or cleanup operations.
+ *
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
+ *     logger.info('Starting cleanup of temporary files')
+ *     await fileSystem.deleteDirectory('/tmp/uploads')
+ *     logger.info('Cleanup completed')
+ * })
+ * ```
+ */
+export const pikkuVoidFunc = (func) => {
+    return typeof func === 'function' ? { func } : func;
+};
+/**
+ * References a registered function by name for use in any wiring.
+ * Works for both local and addon functions — resolves via RPC at runtime.
+ *
+ * @template Name - The function name (must be a key in FlattenedRPCMap)
+ * @param rpcName - The name of the function to reference
+ * @returns A Pikku function config that proxies calls via RPC
+ *
+ * @example
+ * ```typescript
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
+ * ```
+ */
+export const ref = (rpcName) => {
+    return {
+        func: async (_services, data, { rpc }) => {
+            return rpc.invoke(rpcName, data);
+        }
+    };
+};
+/**
+ * Declares a capability the connected client answers, reachable from any
+ * `wireChannel` function as `channel.remote(name, input)`.
+ *
+ * There is no `func`: this side owns the contract, the client owns the body.
+ * The `description` is what a person is shown when asked to approve the call,
+ * so write it for them rather than for the caller.
+ *
+ * @example
+ * ```typescript
+ * export const localCheckoutOutput = z.object({ sha: z.string(), branch: z.string() })
+ *
+ * export const localCheckout = pikkuRemoteChannelFunc({
+ *   description: 'Read the current commit and branch of your working tree',
+ *   output: localCheckoutOutput,
+ * })
+ * ```
+ */
+export function pikkuRemoteChannelFunc(config) {
+    return {
+        ...config,
+        func: async (_services, _data, _wire) => {
+            throw new Error(`${config.title ?? 'This'} is a remote channel capability and has no local implementation — reach it with channel.remote() on the channel whose client exposes it.`);
+        },
+    };
+}
+/**
+ * Addon contract references. Generated from each wired addon's published
+ * contract metadata — no addon source is imported. Functions are proxied via
+ * ref() (RPC) exactly like ref('namespace:fn').
+ */
+const __addonHttp = {};
+const __addonChannel = {};
+const __addonCli = {};
+export const refHTTP = (name, options) => {
+    const contract = __addonHttp[name];
+    return (options?.basePath !== undefined
+        ? { ...contract, basePath: options.basePath }
+        : contract);
+};
+export const refChannel = (name) => __addonChannel[name];
+export const refCLI = (name) => __addonCli[name];
+//# sourceMappingURL=pikku-function-types.gen.js.map

package/dist/.pikku/addon/function/pikku-function-types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-function-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/function/pikku-function-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAmEH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,EAAkD,EACF,EAAE;IAClD,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AA2KD,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAK3B,MAIC,EACyE,EAAE;IAC5E,OAAO,SAAS,CAAC,MAAM,CAAC,CAAA;AAC1B,CAAC,CAAA;AA0ED,MAAM,UAAU,oBAAoB,CAAC,IAAS;IAC5C,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAEiE,EACb,EAAE;IACtD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,OAAa,EAKb,EAAE;IACF,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,SAAc,EAAE,IAAoC,EAAE,EAAE,GAAG,EAAO,EAAE,EAAE;YACjF,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAClC,CAAC;KAKF,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CAIpC,MAGC;IAED,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,KAAK,EAAE,SAAc,EAAE,KAAU,EAAE,KAAU,EAAE,EAAE;YACrD,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,0IAA0I,CACpK,CAAA;QACH,CAAC;KACK,CAAA;AACV,CAAC;AAKD;;;;GAIG;AACH,MAAM,WAAW,GAAG,EAAW,CAAA;AAC/B,MAAM,cAAc,GAAG,EAAW,CAAA;AAClC,MAAM,UAAU,GAAG,EAAW,CAAA;AAE9B,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAU,EACV,OAA+B,EACH,EAAE;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAQ,CAAA;IACzC,OAAO,CACL,OAAO,EAAE,QAAQ,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;QAC7C,CAAC,CAAC,QAAQ,CACiB,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAU,EACqB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAExD,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,IAAU,EACiB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA"}