@vibesdotdev/config 0.0.1

package/dist/crud/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * CRUD Metadata Types for Config Manifests
+ *
+ * Extends the manifest system with metadata for rendering
+ * list views, create/edit forms, and delete confirmations.
+ */
+import type { ReactNode } from 'react';
+import type { ConfigManifest, ConfigFieldMeta } from '../manifest/types.ts';
+import type { ExtensionSurface } from '../extensions/types.ts';
+import type { ManifestRouting, NestedRouting } from '../routing/types.ts';
+import type { BaseRecord, CRUDViewMode, FormStep } from './base-types.ts';
+export type { BaseRecord, CRUDViewMode, FormStep } from './base-types.ts';
+/**
+ * Column definition for list/table views
+ */
+export interface ListColumn<T = unknown> {
+    /** Field key to display (dot notation for nested) */
+    key: string;
+    /** Column header label */
+    label: string;
+    /** Column width (characters or 'auto') */
+    width?: number | 'auto';
+    /** Text alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Whether column is sortable */
+    sortable?: boolean;
+    /** Custom render function */
+    render?: (value: unknown, record: T) => ReactNode;
+    /** Format preset (applies default render) */
+    format?: 'text' | 'number' | 'date' | 'boolean' | 'status' | 'badge';
+}
+/**
+ * List view configuration
+ */
+export interface ListViewConfig<T = unknown> {
+    /** Columns to display */
+    columns: ListColumn<T>[];
+    /** Field to use as display name in UI */
+    displayField: string;
+    /** Field to use as unique identifier */
+    idField?: string;
+    /** Default sort field */
+    defaultSort?: string;
+    /** Default sort direction */
+    defaultSortDirection?: 'asc' | 'desc';
+    /** Empty state message */
+    emptyMessage?: string;
+    /** Whether to show search/filter */
+    searchable?: boolean;
+    /** Fields to search in */
+    searchFields?: string[];
+    /** Row actions (edit, delete, custom) */
+    actions?: ListAction[];
+    /** Bulk actions */
+    bulkActions?: ListAction[];
+}
+/**
+ * Action available in list view
+ */
+export interface ListAction {
+    id: string;
+    label: string;
+    icon?: string;
+    variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
+    /** When action should be disabled */
+    disabledWhen?: (record: unknown) => boolean;
+    /** When action should be hidden */
+    hiddenWhen?: (record: unknown) => boolean;
+}
+/**
+ * Form view configuration (create/edit)
+ */
+export interface FormViewConfig {
+    /** Title for create mode */
+    createTitle?: string;
+    /** Title for edit mode */
+    editTitle?: string;
+    /** Fields to show in create mode (defaults to all) */
+    createFields?: string[];
+    /** Fields to show in edit mode (defaults to all) */
+    editFields?: string[];
+    /** Fields that are read-only in edit mode */
+    readOnlyInEdit?: string[];
+    /** Whether to show cancel button */
+    showCancel?: boolean;
+    /** Submit button label for create */
+    createSubmitLabel?: string;
+    /** Submit button label for edit */
+    editSubmitLabel?: string;
+    /** Layout mode */
+    layout?: 'vertical' | 'horizontal' | 'grid';
+    /**
+     * Optional wizard steps for multi-step forms.
+     * If provided, form renders as a stepped wizard.
+     * If omitted, form renders all fields in a single view.
+     */
+    steps?: FormStep[];
+}
+/**
+ * Detail/view configuration (read-only view of single record)
+ */
+export interface DetailViewConfig {
+    /** Title template (can include {field} placeholders) */
+    titleTemplate?: string;
+    /** Fields to display */
+    fields?: string[];
+    /** Whether to group fields */
+    grouped?: boolean;
+    /** Custom sections */
+    sections?: DetailSection[];
+}
+/**
+ * Section in detail view
+ */
+export interface DetailSection {
+    id: string;
+    title: string;
+    icon?: string;
+    fields: string[];
+    collapsed?: boolean;
+}
+/**
+ * Delete confirmation configuration
+ */
+export interface DeleteConfig {
+    /** Confirmation message template */
+    confirmMessage?: string;
+    /** Whether to require typing name to confirm */
+    requireNameConfirmation?: boolean;
+    /** Warning message about consequences */
+    warningMessage?: string;
+    /** Related records that will be affected */
+    cascadeWarning?: string;
+}
+/**
+ * Auto-detection configuration for CRUD resources
+ * Enables scanning for local/cloud providers, agents, etc.
+ */
+export interface DetectionConfig<TDetected = unknown, TRecord = unknown> {
+    /** Whether detection is enabled */
+    enabled: boolean;
+    /** Function that performs detection */
+    detector: () => Promise<TDetected[]>;
+    /** Label for detection button */
+    label?: string;
+    /** Description of what will be detected */
+    description?: string;
+    /** Function to match detected item with existing record */
+    matcher: (detected: TDetected, existing: TRecord) => boolean;
+}
+/**
+ * Complete CRUD configuration for a record-type manifest
+ */
+export interface CRUDConfig<T = unknown, TDetected = unknown> {
+    /** List view configuration */
+    list: ListViewConfig<T>;
+    /** Form view configuration */
+    form?: FormViewConfig;
+    /** Detail view configuration */
+    detail?: DetailViewConfig;
+    /** Delete confirmation configuration */
+    delete?: DeleteConfig;
+    /** Auto-detection configuration */
+    detection?: DetectionConfig<TDetected, T>;
+    /** Whether records can be created */
+    canCreate?: boolean;
+    /** Whether records can be edited */
+    canEdit?: boolean;
+    /** Whether records can be deleted */
+    canDelete?: boolean;
+    /** Whether records can be duplicated */
+    canDuplicate?: boolean;
+}
+/**
+ * A manifest for record-type configurations (providers, agents, etc.)
+ * Extends ConfigManifest with CRUD metadata for automatic UI generation.
+ */
+export interface RecordManifest<T = unknown, TDetected = unknown> extends ConfigManifest {
+    /** CRUD configuration for list/form/detail views */
+    crud: CRUDConfig<T, TDetected>;
+    /** Schema for individual records (vs the full config) */
+    recordSchema?: ConfigManifest['schema'];
+    /**
+     * Discriminated routing configuration (single discriminator).
+     * When present, a discriminator field value determines which variant
+     * fields, schema, and overrides are active.
+     */
+    routing?: ManifestRouting;
+    /**
+     * Nested routing configurations (multiple discriminators).
+     * Used when a manifest contains multiple independent discriminated unions,
+     * each at a different path. For example, agent role configurations where
+     * each role (orchestration, development, etc.) has its own type discriminator.
+     *
+     * @example
+     * ```typescript
+     * nestedRoutings: [
+     *   { path: 'agents.orchestration', discriminator: 'type', label: 'Orchestration Agent', variants: agentVariants },
+     *   { path: 'agents.development', discriminator: 'type', label: 'Development Agent', variants: agentVariants },
+     * ]
+     * ```
+     */
+    nestedRoutings?: NestedRouting[];
+}
+/**
+ * Type guard to check if manifest has CRUD config
+ */
+export declare function isRecordManifest(manifest: ConfigManifest): manifest is RecordManifest;
+/**
+ * Type guard to check if manifest has nested routings
+ */
+export declare function hasNestedRoutings(manifest: ConfigManifest): manifest is RecordManifest & {
+    nestedRoutings: NestedRouting[];
+};
+/**
+ * Props for the generic CRUD page component
+ */
+export interface CRUDPageProps<T extends BaseRecord = BaseRecord> {
+    /** The record manifest */
+    manifest: RecordManifest<T>;
+    /** Surface for loading extensions (enables extension loading when set) */
+    surface?: ExtensionSurface;
+    /** Whether component is embedded (removes padding and FocusZone) */
+    embedded?: boolean;
+    /** Initial view mode */
+    initialMode?: CRUDViewMode;
+    /** Selected record ID (for edit/view/delete modes) */
+    selectedId?: string;
+    /** Called when navigating between modes */
+    onModeChange?: (mode: CRUDViewMode, recordId?: string) => void;
+    /** Called after successful create */
+    onCreated?: (record: T) => void;
+    /** Called after successful update */
+    onUpdated?: (record: T) => void;
+    /** Called after successful delete */
+    onDeleted?: (recordId: string) => void;
+    /** Custom list row renderer */
+    renderListRow?: (record: T, defaultRender: () => ReactNode) => ReactNode;
+    /** Custom form field renderer */
+    renderFormField?: (field: ConfigFieldMeta, value: unknown, onChange: (value: unknown) => void, defaultRender: () => ReactNode) => ReactNode;
+    /** Custom detail field renderer */
+    renderDetailField?: (field: ConfigFieldMeta, value: unknown, defaultRender: () => ReactNode) => ReactNode;
+    /** Custom empty state */
+    renderEmpty?: () => ReactNode;
+    /** Custom header */
+    renderHeader?: (mode: CRUDViewMode, record?: T) => ReactNode;
+    /** Custom footer */
+    renderFooter?: (mode: CRUDViewMode, record?: T) => ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/crud/types.d.ts.map

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

package/dist/crud/types.js

@@ -0,0 +1,22 @@
+/**
+ * CRUD Metadata Types for Config Manifests
+ *
+ * Extends the manifest system with metadata for rendering
+ * list views, create/edit forms, and delete confirmations.
+ */
+/**
+ * Type guard to check if manifest has CRUD config
+ */
+export function isRecordManifest(manifest) {
+    return 'crud' in manifest && manifest.crud !== undefined;
+}
+/**
+ * Type guard to check if manifest has nested routings
+ */
+export function hasNestedRoutings(manifest) {
+    return (isRecordManifest(manifest) &&
+        'nestedRoutings' in manifest &&
+        Array.isArray(manifest.nestedRoutings) &&
+        manifest.nestedRoutings.length > 0);
+}
+//# sourceMappingURL=types.js.map

package/dist/crud/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/crud/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmOH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAwB;IACxD,OAAO,MAAM,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAChC,QAAwB;IAExB,OAAO,CACN,gBAAgB,CAAC,QAAQ,CAAC;QAC1B,gBAAgB,IAAI,QAAQ;QAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QACtC,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAClC,CAAC;AACH,CAAC"}

package/dist/docs/environment.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=environment.docs.descriptor.d.ts.map

package/dist/docs/environment.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/environment.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBA4XjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/environment.docs.descriptor.js

@@ -0,0 +1,383 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'config.environment',
+    title: 'Environment Configuration',
+    summary: 'Environment variables, secrets management, and resolution',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Environment Configuration
+summary: Environment variables, secrets management, and resolution
+tags: [config, environment, variables, secrets, resolution]
+parent: config
+order: 2
+surfaces: [cli, web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Environment Configuration
+
+Environment configuration manages environment variables, secrets, and runtime environment selection. The config system provides type-safe environment resolution with environment-specific overrides.
+
+## Environment Types
+
+### Defined Environments
+
+\`\`\`ts
+type Environment = 'development' | 'staging' | 'production' | 'test';
+\`\`\`
+
+### Environment Context
+
+\`\`\`ts
+interface EnvironmentContext {
+  name: Environment;
+  origin: string;
+  apiBaseUrl: string;
+  authOrigin: string;
+  features: {
+    analytics: boolean;
+    debugging: boolean;
+    experimental: boolean;
+  };
+}
+\`\`\`
+
+## Loading Environment
+
+### Current Environment
+
+\`\`\`ts
+import { loadCurrentEnvironmentSelection } from '@vibesdotdev/config';
+
+const env = await loadCurrentEnvironmentSelection();
+
+console.log(env.name);  // 'development' | 'staging' | 'production'
+console.log(env.origin);  // 'http://localhost:3000'
+\`\`\`
+
+### Environment Catalog
+
+\`\`\`ts
+import { loadEnvironmentCatalog } from '@vibesdotdev/config';
+
+const catalog = await loadEnvironmentCatalog();
+
+console.log(catalog);
+// {
+//   development: { origin: 'http://localhost:3000', ... },
+//   staging: { origin: 'https://staging.vibes.dev', ... },
+//   production: { origin: 'https://vibes.dev', ... }
+// }
+\`\`\`
+
+## Environment Variables
+
+### Accessing Variables
+
+\`\`\`ts
+import { env } from '@vibesdotdev/config';
+
+const apiKey = env.get('ANTHROPIC_API_KEY');
+const debug = env.get('DEBUG_MODE', 'false') === 'true';
+const port = env.get('PORT', '3000');
+\`\`\`
+
+### Typed Environment Variables
+
+\`\`\`ts
+import { z } from 'zod';
+import { env } from '@vibesdotdev/config';
+
+const config = env.parse(
+  z.object({
+    ANTHROPIC_API_KEY: z.string().min(1),
+    DEBUG_MODE: z.boolean().default(false),
+    PORT: z.number().default(3000),
+    DATABASE_URL: z.string().url()
+  })
+);
+
+console.log(config.ANTHROPIC_API_KEY);  // string
+console.log(config.DEBUG_MODE);         // boolean
+console.log(config.PORT);               // number
+\`\`\`
+
+## Secrets Management
+
+### Secret Resolution
+
+\`\`\`ts
+import { resolveAuthApiBaseUrl } from '@vibesdotdev/auth';
+
+const authUrl = await resolveAuthApiBaseUrl({
+  environment: 'production'
+});
+
+console.log(authUrl);  // 'https://auth.vibes.dev'
+\`\`\`
+
+### Secret Sources
+
+Secrets can come from multiple sources:
+
+\`\`\`ts
+interface SecretResolution {
+  source: 'env' | 'vault' | 'wrangler' | 'encrypted-local';
+  key: string;
+  resolved: string;
+}
+\`\`\`
+
+**Priority order:**
+1. Environment variable (process.env)
+2. Vault secret (if configured)
+3. Wrangler secret (Cloudflare)
+4. Encrypted local file (~/.config/vibes/secrets)
+
+### Credential References
+
+Use credential references in config files:
+
+\`\`\`jsonc
+{
+  "configuration": {
+    // ✅ Secret store reference
+    "apiKey": { "source": "secret", "key": "ANTHROPIC_API_KEY" },
+    
+    // ✅ Environment variable reference
+    "apiKey": { "source": "env", "key": "ANTHROPIC_API_KEY" },
+    
+    // ❌ NEVER — bare credential strings
+    "apiKey": "<raw-api-key>"
+  }
+}
+\`\`\`
+
+## Environment Resolution
+
+### Resolution Order
+
+1. **Explicit override** — \`--environment production\`
+2. **Saved selection** — ~/.config/vibes/environment.json
+3. **Environment detection** — Vercel, Cloudflare, etc.
+4. **Default** — 'development'
+
+### Programmatic Selection
+
+\`\`\`ts
+import { saveCurrentEnvironmentSelection } from '@vibesdotdev/config';
+
+await saveCurrentEnvironmentSelection({
+  name: 'production',
+  origin: 'https://vibes.dev'
+});
+
+// Future loads will use production
+const env = await loadCurrentEnvironmentSelection();
+console.log(env.name);  // 'production'
+\`\`\`
+
+### CLI Selection
+
+\`\`\`bash
+# Set environment
+vibes config environment set production
+
+# View current
+vibes config environment get
+
+# List available
+vibes config environment list
+\`\`\`
+
+## Environment-Specific Configuration
+
+### Config Overrides
+
+\`\`\`ts
+const aiConfigManifest = createConfigManifest({
+  id: 'ai',
+  schema: z.object({
+    baseUrl: z.string(),
+    timeout: z.number()
+  }),
+  fields: [
+    {
+      path: 'baseUrl',
+      label: 'API Base URL',
+      defaults: {
+        type: 'context',
+        rules: [
+          {
+            when: { environment: 'development' },
+            value: 'http://localhost:3000'
+          },
+          {
+            when: { environment: 'production' },
+            value: 'https://api.vibes.dev'
+          }
+        ]
+      }
+    },
+    {
+      path: 'timeout',
+      label: 'Timeout',
+      defaults: {
+        type: 'context',
+        rules: [
+          {
+            when: { environment: 'development' },
+            value: 60000  // 60s for debugging
+          },
+          {
+            when: { environment: 'production' },
+            value: 10000  // 10s for performance
+          }
+        ]
+      }
+    }
+  ]
+});
+\`\`\`
+
+### Feature Flags
+
+\`\`\`ts
+import { loadCurrentEnvironmentSelection } from '@vibesdotdev/config';
+
+const env = await loadCurrentEnvironmentSelection();
+
+if (env.features.experimental) {
+  // Enable experimental features
+  await enableExperimentalFeature('new-ui');
+}
+
+if (env.features.debugging) {
+  // Enable debug logging
+  logger.setLevel('debug');
+}
+\`\`\`
+
+## Platform Detection
+
+### Vercel
+
+\`\`\`ts
+// Auto-detected from VERCEL_ENV
+if (process.env.VERCEL_ENV === 'production') {
+  environment = 'production';
+} else if (process.env.VERCEL_ENV === 'preview') {
+  environment = 'staging';
+}
+\`\`\`
+
+### Cloudflare Workers
+
+\`\`\`ts
+// Auto-detected from worker environment
+if (env.CF_ENV === 'production') {
+  environment = 'production';
+}
+\`\`\`
+
+### Local Development
+
+\`\`\`ts
+// Default when no platform detected
+if (!process.env.VERCEL_ENV && !process.env.CF_ENV) {
+  environment = 'development';
+}
+\`\`\`
+
+## E2E Environment Configuration
+
+### E2E Origins
+
+\`\`\`ts
+import {
+  AUTH_E2E_LOCAL_ORIGIN,
+  AUTH_E2E_DEV_SERVER_ORIGIN,
+  resolveAuthE2EOrigin
+} from '@vibesdotdev/auth';
+
+const e2eOrigin = resolveAuthE2EOrigin({
+  mode: 'local'  // or 'dev-server'
+});
+
+console.log(e2eOrigin);  // 'http://localhost:3000' or dev server
+\`\`\`
+
+### E2E Base URL Resolution
+
+\`\`\`ts
+const authBaseUrl = await resolveAuthE2EBaseUrl({
+  e2eMode: 'local',
+  customOrigin: 'http://localhost:5173'
+});
+\`\`\`
+
+## Environment Validation
+
+### Schema Validation
+
+\`\`\`ts
+import { z } from 'zod';
+import { env } from '@vibesdotdev/config';
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']),
+  DATABASE_URL: z.string().url(),
+  API_KEY: z.string().min(1)
+});
+
+try {
+  const config = env.parse(envSchema);
+} catch (error) {
+  console.error('Invalid environment configuration:', error);
+  process.exit(1);
+}
+\`\`\`
+
+### Required Variables
+
+\`\`\`ts
+const requiredVars = [
+  'DATABASE_URL',
+  'API_KEY',
+  'AUTH_SECRET'
+];
+
+for (const variable of requiredVars) {
+  if (!process.env[variable]) {
+    throw new Error(\`Missing required environment variable: \${variable}\`);
+  }
+}
+\`\`\`
+
+## Best Practices
+
+1. **Use typed environment variables** — Zod schemas for validation
+2. **Never commit secrets** — Use credential references
+3. **Provide sensible defaults** — Especially for local development
+4. **Validate on startup** — Fail fast on missing required vars
+5. **Document required variables** — In README or .env.example
+6. **Use environment-specific configs** — Different settings per environment
+
+:::card{title="See also"}
+- [\`config.manifests\`](config.manifests) — Configuration manifests
+- [\`config.validation\`](config.validation) — Schema validation
+- [\`auth.providers\`](auth.providers) — Auth provider configuration
+:::
+`
+    },
+    parent: 'config',
+    order: 2,
+    tags: ['config', 'environment', 'variables', 'secrets', 'resolution'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=environment.docs.descriptor.js.map

package/dist/docs/environment.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/environment.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,2BAA2B;IAClC,OAAO,EAAE,2DAA2D;IACpE,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4WT;KACC;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC;IACrE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/manifests.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=manifests.docs.descriptor.d.ts.map

package/dist/docs/manifests.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifests.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/manifests.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBAofjB,CAAC;AAEF,eAAe,UAAU,CAAC"}