@bendyline/docblocks 1.1.2 → 2.1.0

package/dist/mcp/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/zod.ts"],"sourcesContent":["import { z } from 'zod';\nimport { z as z4 } from 'zod/v4';\nimport {\n  MCP_WIRE_LIMITS,\n  parseArtifactRef,\n  parseComparisonResult,\n  parseConversionResult,\n  parseInspectionResult,\n  parsePreviewResult,\n  parseValidationResult,\n} from './wire.js';\nimport type {\n  DescribeTemplateResult,\n  DescribeThemeResult,\n  DocBlocksMcpToolName,\n  FormatCapabilitySummary,\n  FormatDirectionCapability,\n  InferThemeResult,\n  InspectPptxLayoutsResult,\n  ListFormatsResult,\n  ListRootsResult,\n  ListTemplatesResult,\n  ListThemesResult,\n  ListTransformStylesResult,\n  PptxLayoutSummary,\n  RecommendTemplatesResult,\n  RootGrantSummary,\n  TemplateContentProfile,\n  TemplateInputSummary,\n  TemplateRecommendation,\n  TemplateSummary,\n  ThemeCatalogEntry,\n  ThemeDescription,\n  TransformStyleSummary,\n} from './types.js';\n\n/** Canonical Zod projection of the exact MCP wire contract for protocol SDKs. */\n\nexport const MAX_MARKDOWN_CHARACTERS = 20 * 1024 * 1024;\nexport const MAX_PATH_CHARACTERS = 4_096;\nconst MAX_ID_CHARACTERS = 256;\n\nconst IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/u;\nconst FORMAT_PATTERN = /^[a-z0-9][a-z0-9.+_-]*$/u;\nconst INPUT_FORMAT_PATTERN = /^[A-Za-z0-9][A-Za-z0-9.+_-]*$/u;\nconst MIME_TYPE_PATTERN = /^[a-z0-9!#$&^_.+-]+\\/[a-z0-9!#$&^_.+-]+$/iu;\nconst ARTIFACT_URI_PATTERN = /^docblocks:\\/\\/artifacts\\/[A-Za-z0-9][A-Za-z0-9._:-]*$/u;\nconst ISO_TIMESTAMP_PATTERN = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/u;\n/* eslint-disable no-control-regex -- Wire contracts must publish explicit control-byte exclusions. */\nconst WIRE_STRING_PATTERN = new RegExp('^[^\\\\u0000\\\\u007f]*$', 'u');\nconst WORKSPACE_PATH_PATTERN = new RegExp(\n  '^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)(?:\\\\.{1,2})(?:/|$))(?!.*//)(?!.*[\\\\\\\\\\\\u0000-\\\\u001f\\\\u007f])(?!.*/$).+$',\n  'u',\n);\nconst SAFE_FILENAME_PATTERN = new RegExp('^(?!\\\\.{1,2}$)[^/\\\\\\\\\\\\u0000\\\\u007f]+$', 'u');\n/* eslint-enable no-control-regex */\n\nconst boundedString = z\n  .string()\n  .max(MCP_WIRE_LIMITS.messageCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst boundedNonEmptyString = z\n  .string()\n  .min(1)\n  .max(MCP_WIRE_LIMITS.messageCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst labelSchema = z\n  .string()\n  .max(MCP_WIRE_LIMITS.labelCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst nonEmptyLabelSchema = labelSchema.min(1);\nconst excerptSchema = z\n  .string()\n  .max(MCP_WIRE_LIMITS.excerptCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst uriTextSchema = z\n  .string()\n  .min(1)\n  .max(MCP_WIRE_LIMITS.uriCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst nonNegativeSafeIntegerSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);\nconst idSchema = z.string().min(1).max(MAX_ID_CHARACTERS).regex(IDENTIFIER_PATTERN);\nexport const formatSchema = z\n  .string()\n  .min(1)\n  .max(MCP_WIRE_LIMITS.formatCharacters)\n  .regex(FORMAT_PATTERN);\n/** Case-insensitive format input which handlers normalize before publishing it on the wire. */\nexport const formatInputSchema = z\n  .string()\n  .min(1)\n  .max(MCP_WIRE_LIMITS.formatCharacters)\n  .regex(INPUT_FORMAT_PATTERN);\nconst mimeTypeSchema = z\n  .string()\n  .min(3)\n  .max(MCP_WIRE_LIMITS.mimeTypeCharacters)\n  .regex(MIME_TYPE_PATTERN);\nconst isoTimestampSchema = z\n  .string()\n  .regex(ISO_TIMESTAMP_PATTERN)\n  .refine((value) => {\n    const timestamp = Date.parse(value);\n    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;\n  }, 'Expected a canonical UTC timestamp with millisecond precision');\nconst engineNameSchema = z\n  .string()\n  .min(1)\n  .max(MAX_ID_CHARACTERS)\n  .regex(\n    /^(?:[A-Za-z0-9][A-Za-z0-9._:-]*|@[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9][A-Za-z0-9._-]*)$/u,\n  );\nconst workspacePathSchema = z\n  .string()\n  .min(1)\n  .max(MAX_PATH_CHARACTERS)\n  .regex(WORKSPACE_PATH_PATTERN, 'Expected a canonical root-relative forward-slash path')\n  .refine(\n    (value) =>\n      !value.includes('\\\\') &&\n      !value.startsWith('/') &&\n      !/^[a-zA-Z]:/u.test(value) &&\n      !value.split('/').some((segment) => !segment || segment === '.' || segment === '..') &&\n      ![...value].some((character) => {\n        const codePoint = character.codePointAt(0) ?? 0;\n        return codePoint <= 0x1f || codePoint === 0x7f;\n      }),\n    'Expected a canonical root-relative forward-slash path',\n  );\nexport const artifactUriSchema = z\n  .string()\n  .max('docblocks://artifacts/'.length + MAX_ID_CHARACTERS)\n  .regex(ARTIFACT_URI_PATTERN);\n\nconst assetSourceSchema = z.discriminatedUnion('kind', [\n  z.object({ kind: z.literal('file'), rootId: idSchema, path: workspacePathSchema }).strict(),\n  z.object({ kind: z.literal('artifact'), uri: artifactUriSchema }).strict(),\n]);\n\nexport const bundleAssetSchema = z\n  .object({\n    path: workspacePathSchema,\n    source: assetSourceSchema,\n    mimeType: mimeTypeSchema.nullable(),\n    altText: labelSchema.nullable(),\n    credit: labelSchema.nullable(),\n    license: labelSchema.nullable(),\n  })\n  .strict();\n\nexport const bundleDocumentSourceSchema = z\n  .object({\n    kind: z.literal('bundle'),\n    markdown: z\n      .string()\n      .max(MAX_MARKDOWN_CHARACTERS)\n      .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire'),\n    assets: z.array(bundleAssetSchema).max(MCP_WIRE_LIMITS.bundleAssets),\n    name: labelSchema.nullable(),\n  })\n  .strict();\n\nexport const documentSourceSchema = z.discriminatedUnion('kind', [\n  z\n    .object({\n      kind: z.literal('markdown'),\n      markdown: z\n        .string()\n        .max(MAX_MARKDOWN_CHARACTERS)\n        .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire'),\n      name: labelSchema.nullable(),\n    })\n    .strict(),\n  z\n    .object({\n      kind: z.literal('file'),\n      rootId: idSchema,\n      path: workspacePathSchema,\n      format: formatSchema.nullable(),\n    })\n    .strict(),\n  z.object({ kind: z.literal('artifact'), uri: artifactUriSchema }).strict(),\n  bundleDocumentSourceSchema,\n]);\n\nconst appliedOptionSchema = z\n  .object({\n    name: idSchema,\n    value: z.union([boundedString, z.number().finite(), z.boolean(), z.null()]),\n  })\n  .strict();\nconst engineVersionSchema = z\n  .object({ name: engineNameSchema, version: boundedNonEmptyString })\n  .strict();\n\nexport const artifactRefSchema = z\n  .object({\n    id: idSchema,\n    uri: artifactUriSchema,\n    format: formatSchema,\n    mimeType: mimeTypeSchema,\n    size: z.number().int().nonnegative().max(MCP_WIRE_LIMITS.artifactBytes),\n    sha256: z.string().regex(/^[a-f0-9]{64}$/u),\n    sourceFormat: formatSchema.nullable(),\n    sourceSha256: z\n      .string()\n      .regex(/^[a-f0-9]{64}$/u)\n      .nullable(),\n    suggestedFilename: z\n      .string()\n      .min(1)\n      .max(MCP_WIRE_LIMITS.labelCharacters)\n      .regex(SAFE_FILENAME_PATTERN),\n    appliedOptions: z.array(appliedOptionSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    engineVersions: z.array(engineVersionSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    createdAt: isoTimestampSchema,\n    expiresAt: isoTimestampSchema.nullable(),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parseArtifactRef(value), context));\n\nconst diagnosticLocationSchema = z.discriminatedUnion('kind', [\n  z\n    .object({\n      kind: z.literal('source'),\n      line: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER),\n      column: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER),\n    })\n    .strict(),\n  z.object({ kind: z.literal('block'), blockId: idSchema, nodeType: idSchema }).strict(),\n  z.object({ kind: z.literal('asset'), path: workspacePathSchema }).strict(),\n  z\n    .object({\n      kind: z.literal('item'),\n      itemKind: z.enum(['page', 'slide', 'sheet', 'frame']),\n      index: nonNegativeSafeIntegerSchema,\n    })\n    .strict(),\n]);\n\nexport const diagnosticSchema = z\n  .object({\n    code: idSchema,\n    severity: z.enum(['info', 'warning', 'error']),\n    stage: z.enum([\n      'resolve',\n      'import',\n      'parse',\n      'inspect',\n      'validate',\n      'transform',\n      'convert',\n      'render',\n      'export',\n      'materialize',\n      'compare',\n    ]),\n    format: formatSchema.nullable(),\n    count: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER),\n    message: boundedString,\n    remediation: boundedString.nullable(),\n    retryable: z.boolean(),\n    location: diagnosticLocationSchema.nullable(),\n  })\n  .strict();\n\nexport const mcpErrorDetailSchema = z\n  .object({\n    code: idSchema,\n    message: boundedNonEmptyString,\n    stage: z\n      .enum([\n        'resolve',\n        'import',\n        'parse',\n        'inspect',\n        'validate',\n        'transform',\n        'convert',\n        'render',\n        'export',\n        'materialize',\n        'compare',\n      ])\n      .nullable(),\n    format: formatSchema.nullable(),\n    hint: boundedString.nullable(),\n    retryable: z.boolean(),\n    operationLoad: z\n      .object({\n        active: z.number().int().nonnegative().max(32),\n        capacity: z.number().int().positive().max(32),\n      })\n      .strict()\n      .nullable(),\n  })\n  .strict()\n  .superRefine((value, context) => {\n    if (value.operationLoad && value.operationLoad.active > value.operationLoad.capacity) {\n      context.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['operationLoad', 'active'],\n        message: 'Active operation count cannot exceed capacity',\n      });\n    }\n  });\n\nexport const mcpErrorResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('error'),\n    result: z.null(),\n    error: mcpErrorDetailSchema,\n  })\n  .strict();\n\n/**\n * Root-object output schema compatible with MCP SDK 1.29's object normalizer.\n *\n * The SDK must see an object at the root, while clients must see the two exact\n * wire branches rather than independently-nullable fields. A Zod 4 object lets\n * us publish the branch schemas through standard JSON Schema `oneOf` metadata;\n * runtime validation still delegates to the original Zod 3 schemas so custom\n * exact-wire refinements remain authoritative.\n */\nexport function toolOutputSchema<T extends z.ZodTypeAny>(success: T) {\n  const successEnvelope = z\n    .object({\n      version: z.literal(1),\n      kind: z.literal('success'),\n      result: success,\n      error: z.null(),\n    })\n    .strict();\n  const errorEnvelope = z\n    .object({\n      version: z.literal(1),\n      kind: z.literal('error'),\n      result: z.null(),\n      error: mcpErrorDetailSchema,\n    })\n    .strict();\n  const publishedSuccess = z4\n    .object({\n      version: z4.literal(1),\n      kind: z4.literal('success'),\n      result: projectZod3Schema(success),\n      error: z4.null(),\n    })\n    .strict();\n  const publishedError = z4\n    .object({\n      version: z4.literal(1),\n      kind: z4.literal('error'),\n      result: z4.null(),\n      error: projectZod3Schema(mcpErrorDetailSchema),\n    })\n    .strict();\n  const oneOf = [\n    jsonSchemaWithoutDialect(publishedSuccess),\n    jsonSchemaWithoutDialect(publishedError),\n  ];\n\n  return z4\n    .object({\n      version: z4.literal(1),\n      kind: z4.enum(['success', 'error']),\n      result: z4.unknown(),\n      error: z4.unknown(),\n    })\n    .strict()\n    .superRefine((value, context) => {\n      const branch = value.kind === 'success' ? successEnvelope : errorEnvelope;\n      const parsed = branch.safeParse(value);\n      if (parsed.success) return;\n      for (const issue of parsed.error.issues) {\n        context.addIssue({\n          code: 'custom',\n          path: issue.path,\n          message: issue.message,\n        });\n      }\n    })\n    .meta({ oneOf });\n}\n\nconst assetSummarySchema = z\n  .object({\n    path: workspacePathSchema,\n    mimeType: mimeTypeSchema,\n    size: z.number().int().nonnegative().max(MCP_WIRE_LIMITS.artifactBytes),\n    sha256: z\n      .string()\n      .regex(/^[a-f0-9]{64}$/u)\n      .nullable(),\n    altText: labelSchema.nullable(),\n    credit: labelSchema.nullable(),\n    license: labelSchema.nullable(),\n  })\n  .strict();\n\nexport const conversionResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('conversion'),\n    sourceFormat: formatSchema,\n    targetFormat: formatSchema,\n    artifact: artifactRefSchema,\n    fidelity: z.enum(['semantic', 'editable-native', 'rendered-fidelity', 'hybrid']),\n    appliedThemeId: idSchema.nullable(),\n    appliedTransformId: idSchema.nullable(),\n    sourceAssets: z.array(assetSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    sourceAssetCount: z.number().int().min(0).max(MCP_WIRE_LIMITS.arrayEntries),\n    diagnostics: z.array(diagnosticSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parseConversionResult(value), context));\n\nconst metadataSchema = z\n  .object({\n    title: labelSchema.nullable(),\n    author: labelSchema.nullable(),\n    description: boundedString.nullable(),\n  })\n  .strict();\nconst statisticsSchema = z\n  .object({\n    blockCount: nonNegativeSafeIntegerSchema,\n    wordCount: nonNegativeSafeIntegerSchema,\n    characterCount: nonNegativeSafeIntegerSchema,\n    tableCount: nonNegativeSafeIntegerSchema,\n    linkCount: nonNegativeSafeIntegerSchema,\n    assetCount: nonNegativeSafeIntegerSchema,\n    pageCount: nonNegativeSafeIntegerSchema.nullable(),\n    slideCount: nonNegativeSafeIntegerSchema.nullable(),\n    sheetCount: nonNegativeSafeIntegerSchema.nullable(),\n  })\n  .strict();\nconst outlineEntrySchema = z\n  .object({\n    id: idSchema,\n    title: nonEmptyLabelSchema,\n    level: z.number().int().min(1).max(6),\n    blockIndex: nonNegativeSafeIntegerSchema,\n  })\n  .strict();\nconst blockSummarySchema = z\n  .object({\n    id: idSchema,\n    type: idSchema,\n    text: excerptSchema,\n    wordCount: nonNegativeSafeIntegerSchema,\n    templateId: idSchema.nullable(),\n    sourceRange: z\n      .object({ start: nonNegativeSafeIntegerSchema, end: nonNegativeSafeIntegerSchema })\n      .strict()\n      .nullable(),\n  })\n  .strict();\nconst tableSummarySchema = z\n  .object({\n    index: nonNegativeSafeIntegerSchema,\n    rowCount: nonNegativeSafeIntegerSchema,\n    columnCount: nonNegativeSafeIntegerSchema,\n    headers: z.array(labelSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict();\nconst linkSummarySchema = z\n  .object({\n    index: nonNegativeSafeIntegerSchema,\n    text: labelSchema,\n    target: uriTextSchema,\n  })\n  .strict();\nconst documentItemSummarySchema = z\n  .object({\n    kind: z.enum(['page', 'slide', 'sheet', 'frame']),\n    index: nonNegativeSafeIntegerSchema,\n    label: labelSchema.nullable(),\n    blockIds: z.array(idSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict();\nconst themeSummarySchema = z\n  .object({\n    id: idSchema,\n    name: nonEmptyLabelSchema,\n    source: z.enum(['built-in', 'document', 'inferred']),\n    layouts: z.array(nonEmptyLabelSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict();\n\nexport const inspectionResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('inspection'),\n    sourceFormat: formatSchema,\n    metadata: metadataSchema,\n    statistics: statisticsSchema,\n    outline: z.array(outlineEntrySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    blocks: z.array(blockSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    blockOffset: z.number().int().min(0).max(MCP_WIRE_LIMITS.arrayEntries),\n    nextCursor: z\n      .string()\n      .max(MCP_WIRE_LIMITS.identifierCharacters)\n      .regex(WIRE_STRING_PATTERN)\n      .nullable(),\n    tables: z.array(tableSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    links: z.array(linkSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    items: z.array(documentItemSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    assets: z.array(assetSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    theme: themeSummarySchema.nullable(),\n    truncated: z.boolean(),\n    detailsTruncated: z.boolean(),\n    diagnostics: z.array(diagnosticSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parseInspectionResult(value), context));\n\nexport const validationResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('validation'),\n    sourceFormat: formatSchema,\n    targetFormat: formatSchema.nullable(),\n    valid: z.boolean(),\n    summary: z\n      .object({\n        errorCount: nonNegativeSafeIntegerSchema,\n        warningCount: nonNegativeSafeIntegerSchema,\n        infoCount: nonNegativeSafeIntegerSchema,\n      })\n      .strict(),\n    diagnostics: z.array(diagnosticSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parseValidationResult(value), context));\n\nconst previewItemSchema = z\n  .object({\n    kind: z.enum(['page', 'slide', 'sheet', 'frame']),\n    index: nonNegativeSafeIntegerSchema,\n    label: labelSchema.nullable(),\n    artifact: artifactRefSchema,\n    width: z.number().int().min(1).max(MCP_WIRE_LIMITS.imageDimension),\n    height: z.number().int().min(1).max(MCP_WIRE_LIMITS.imageDimension),\n  })\n  .strict();\nexport const previewResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('preview'),\n    sourceFormat: formatSchema,\n    previewBasis: z.enum(['source-render', 'reconstructed-import', 'native-extracted']),\n    totalItems: nonNegativeSafeIntegerSchema,\n    items: z.array(previewItemSchema).max(MCP_WIRE_LIMITS.previewItems),\n    truncated: z.boolean(),\n    diagnostics: z.array(diagnosticSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parsePreviewResult(value), context));\n\nconst comparisonChangeSchema = z\n  .object({\n    category: z.enum([\n      'text',\n      'structure',\n      'table',\n      'media',\n      'theme',\n      'layout',\n      'metadata',\n      'timing',\n      'accessibility',\n    ]),\n    status: z.enum(['retained', 'changed', 'degraded', 'omitted', 'added']),\n    path: z.string().max(MCP_WIRE_LIMITS.pathCharacters).regex(WIRE_STRING_PATTERN).nullable(),\n    message: boundedNonEmptyString,\n  })\n  .strict();\nconst comparisonMetricSchema = z\n  .object({\n    name: idSchema,\n    leftValue: z.number().finite(),\n    rightValue: z.number().finite(),\n    similarity: z.number().min(0).max(1),\n  })\n  .strict();\nexport const comparisonResultSchema = z\n  .object({\n    version: z.literal(1),\n    kind: z.literal('comparison'),\n    leftFormat: formatSchema,\n    rightFormat: formatSchema,\n    equivalent: z.boolean(),\n    score: z.number().min(0).max(1),\n    changes: z.array(comparisonChangeSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    metrics: z.array(comparisonMetricSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    diagnostics: z.array(diagnosticSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict()\n  .superRefine((value, context) => addExactWireIssue(parseComparisonResult(value), context));\n\nconst boundedPathTextSchema = z\n  .string()\n  .min(1)\n  .max(MCP_WIRE_LIMITS.pathCharacters)\n  .regex(WIRE_STRING_PATTERN, 'NUL and DEL are not permitted on the MCP wire');\nconst sha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);\n\nexport const convertDocumentResultSchema = z\n  .object({ results: z.array(conversionResultSchema).min(1).max(12) })\n  .strict();\n\nexport const rootGrantSummarySchema = z\n  .object({\n    id: idSchema,\n    label: nonEmptyLabelSchema,\n    read: z.boolean(),\n    write: z.boolean(),\n  })\n  .strict() satisfies z.ZodType<RootGrantSummary>;\n\nexport const listRootsResultSchema = z\n  .object({ roots: z.array(rootGrantSummarySchema).max(64) })\n  .strict() satisfies z.ZodType<ListRootsResult>;\n\nexport const saveArtifactResultSchema = z\n  .object({\n    artifact: artifactRefSchema,\n    destination: z.object({ rootId: idSchema, path: workspacePathSchema }).strict(),\n    sha256: sha256Schema,\n  })\n  .strict();\n\nexport const formatDirectionCapabilitySchema = z.discriminatedUnion('supported', [\n  z\n    .object({\n      supported: z.literal(true),\n      tool: z.enum(['inspect_document', 'convert_document']),\n    })\n    .strict(),\n  z.object({ supported: z.literal(false), excludedReason: boundedString }).strict(),\n]) satisfies z.ZodType<FormatDirectionCapability>;\n\nexport const formatCapabilitySummarySchema = z\n  .object({\n    id: formatSchema,\n    label: nonEmptyLabelSchema,\n    mimeType: mimeTypeSchema,\n    extensions: z.array(nonEmptyLabelSchema).max(64),\n    import: formatDirectionCapabilitySchema,\n    export: formatDirectionCapabilitySchema,\n  })\n  .strict() satisfies z.ZodType<FormatCapabilitySummary>;\n\nexport const listFormatsResultSchema = z\n  .object({ formats: z.array(formatCapabilitySummarySchema).max(64) })\n  .strict() satisfies z.ZodType<ListFormatsResult>;\n\nexport const themeCatalogEntrySchema = z\n  .object({\n    id: idSchema,\n    name: nonEmptyLabelSchema,\n    description: boundedString.optional(),\n  })\n  .strict() satisfies z.ZodType<ThemeCatalogEntry>;\n\nexport const listThemesResultSchema = z\n  .object({ themes: z.array(themeCatalogEntrySchema).max(MCP_WIRE_LIMITS.arrayEntries) })\n  .strict() satisfies z.ZodType<ListThemesResult>;\n\nexport const transformStyleSummarySchema = z\n  .object({ id: idSchema, name: nonEmptyLabelSchema, description: boundedString })\n  .strict() satisfies z.ZodType<TransformStyleSummary>;\n\nexport const listTransformStylesResultSchema = z\n  .object({\n    styles: z.array(transformStyleSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict() satisfies z.ZodType<ListTransformStylesResult>;\n\nexport const templateSummarySchema = z\n  .object({ id: idSchema, label: nonEmptyLabelSchema, description: boundedString })\n  .strict() satisfies z.ZodType<TemplateSummary>;\n\nexport const listTemplatesResultSchema = z\n  .object({ templates: z.array(templateSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries) })\n  .strict() satisfies z.ZodType<ListTemplatesResult>;\n\nexport const templateInputSummarySchema = z\n  .object({\n    key: idSchema,\n    description: boundedString,\n    type: nonEmptyLabelSchema,\n    required: z.boolean(),\n    values: z.array(labelSchema).max(MCP_WIRE_LIMITS.arrayEntries),\n    valueHint: labelSchema.nullable(),\n  })\n  .strict() satisfies z.ZodType<TemplateInputSummary>;\n\nexport const describeTemplateResultSchema = z\n  .object({\n    template: templateSummarySchema\n      .extend({ inputs: z.array(templateInputSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries) })\n      .strict(),\n    annotationExample: boundedString,\n  })\n  .strict() satisfies z.ZodType<DescribeTemplateResult>;\n\nexport const templateContentProfileSchema = z\n  .object({\n    hasImage: z.boolean(),\n    imageCount: nonNegativeSafeIntegerSchema,\n    hasVideo: z.boolean(),\n    hasBlockquote: z.boolean(),\n    hasList: z.boolean(),\n    hasTable: z.boolean(),\n    hasDate: z.boolean(),\n    hasNumberHighlight: z.boolean(),\n    wordCount: nonNegativeSafeIntegerSchema,\n    hasAsciiDiagram: z.boolean(),\n    hasTimeline: z.boolean(),\n    hasTree: z.boolean(),\n  })\n  .strict() satisfies z.ZodType<TemplateContentProfile>;\n\nexport const templateRecommendationSchema = z\n  .object({\n    blockId: idSchema,\n    title: labelSchema.nullable(),\n    profile: templateContentProfileSchema,\n    recommendedTemplateIds: z.array(idSchema).max(256),\n  })\n  .strict() satisfies z.ZodType<TemplateRecommendation>;\n\nexport const recommendTemplatesResultSchema = z\n  .object({\n    recommendations: z.array(templateRecommendationSchema).max(100),\n    totalBlocks: nonNegativeSafeIntegerSchema,\n    truncated: z.boolean(),\n  })\n  .strict() satisfies z.ZodType<RecommendTemplatesResult>;\n\nexport const themeDescriptionSchema = z\n  .object({\n    id: idSchema,\n    name: nonEmptyLabelSchema,\n    description: boundedString,\n    colors: z\n      .object({\n        primary: nonEmptyLabelSchema,\n        secondary: nonEmptyLabelSchema,\n        background: nonEmptyLabelSchema,\n        text: nonEmptyLabelSchema,\n        highlight: nonEmptyLabelSchema,\n      })\n      .strict(),\n    bodyFont: boundedString,\n    titleFont: boundedString,\n  })\n  .strict() satisfies z.ZodType<ThemeDescription>;\n\nexport const describeThemeResultSchema = z\n  .object({ theme: themeDescriptionSchema, source: z.enum(['built-in', 'document']) })\n  .strict() satisfies z.ZodType<DescribeThemeResult>;\n\nexport const inferredLayoutSummarySchema = z\n  .object({ id: nonEmptyLabelSchema, name: nonEmptyLabelSchema, description: boundedString })\n  .strict();\n\nexport const inferThemeResultSchema = z\n  .object({\n    sourceFormat: formatSchema,\n    sourceSha256: sha256Schema,\n    theme: themeDescriptionSchema,\n    layouts: z.array(inferredLayoutSummarySchema).max(1_000),\n    warnings: z.array(boundedString).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict() satisfies z.ZodType<InferThemeResult>;\n\nexport const pptxLayoutSummarySchema = z\n  .object({\n    layoutPath: boundedPathTextSchema,\n    name: nonEmptyLabelSchema,\n    masterName: labelSchema.nullable(),\n    type: labelSchema.nullable(),\n    slideCount: nonNegativeSafeIntegerSchema,\n    verdict: z.enum(['builtin', 'custom', 'plain', 'skip']),\n    templateId: labelSchema.nullable(),\n    notes: z.array(boundedString).max(1_000),\n  })\n  .strict() satisfies z.ZodType<PptxLayoutSummary>;\n\nexport const inspectPptxLayoutsResultSchema = z\n  .object({\n    slideSize: z\n      .object({ cx: nonNegativeSafeIntegerSchema, cy: nonNegativeSafeIntegerSchema })\n      .strict(),\n    layouts: z.array(pptxLayoutSummarySchema).max(2_048),\n  })\n  .strict() satisfies z.ZodType<InspectPptxLayoutsResult>;\n\nexport const applyInferredThemeResultSchema = z\n  .object({\n    result: conversionResultSchema,\n    theme: themeDescriptionSchema,\n    layoutIds: z.array(labelSchema).max(1_000),\n    warnings: z.array(boundedString).max(MCP_WIRE_LIMITS.arrayEntries),\n  })\n  .strict();\n\n/** Core-owned success payload schemas for every advertised canonical MCP tool. */\nexport const DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS: Readonly<\n  Record<DocBlocksMcpToolName, z.ZodTypeAny>\n> = Object.freeze({\n  list_roots: listRootsResultSchema,\n  get_conversion_report: conversionResultSchema,\n  convert_document: convertDocumentResultSchema,\n  create_document_bundle: conversionResultSchema,\n  save_artifact: saveArtifactResultSchema,\n  inspect_document: inspectionResultSchema,\n  validate_document: validationResultSchema,\n  preview_document: previewResultSchema,\n  compare_documents: comparisonResultSchema,\n  list_templates: listTemplatesResultSchema,\n  describe_template: describeTemplateResultSchema,\n  recommend_templates: recommendTemplatesResultSchema,\n  describe_theme: describeThemeResultSchema,\n  infer_theme_from_file: inferThemeResultSchema,\n  inspect_pptx_layouts: inspectPptxLayoutsResultSchema,\n  apply_inferred_theme: applyInferredThemeResultSchema,\n  list_formats: listFormatsResultSchema,\n  list_themes: listThemesResultSchema,\n  list_transform_styles: listTransformStylesResultSchema,\n});\n\n/** Exact success/error envelopes consumed directly by MCP tool registration. */\ntype DocBlocksMcpToolOutputSchema = ReturnType<typeof toolOutputSchema>;\nexport const DOCBLOCKS_MCP_TOOL_OUTPUT_SCHEMAS: Readonly<\n  Record<DocBlocksMcpToolName, DocBlocksMcpToolOutputSchema>\n> = Object.freeze({\n  list_roots: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_roots),\n  get_conversion_report: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.get_conversion_report),\n  convert_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.convert_document),\n  create_document_bundle: toolOutputSchema(\n    DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.create_document_bundle,\n  ),\n  save_artifact: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.save_artifact),\n  inspect_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.inspect_document),\n  validate_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.validate_document),\n  preview_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.preview_document),\n  compare_documents: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.compare_documents),\n  list_templates: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_templates),\n  describe_template: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.describe_template),\n  recommend_templates: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.recommend_templates),\n  describe_theme: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.describe_theme),\n  infer_theme_from_file: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.infer_theme_from_file),\n  inspect_pptx_layouts: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.inspect_pptx_layouts),\n  apply_inferred_theme: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.apply_inferred_theme),\n  list_formats: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_formats),\n  list_themes: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_themes),\n  list_transform_styles: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_transform_styles),\n});\n\nexport const materializationOptionsSchema = z.discriminatedUnion('ifExists', [\n  z\n    .object({\n      rootId: idSchema,\n      path: workspacePathSchema,\n      ifExists: z.literal('error'),\n      expectedSha256: z.null(),\n    })\n    .strict(),\n  z\n    .object({\n      rootId: idSchema,\n      path: workspacePathSchema,\n      ifExists: z.literal('replace'),\n      expectedSha256: z.string().regex(/^[a-f0-9]{64}$/u),\n    })\n    .strict(),\n]);\n\nfunction addExactWireIssue<T>(parsed: T | null, context: z.RefinementCtx): void {\n  if (parsed !== null) return;\n  context.addIssue({\n    code: z.ZodIssueCode.custom,\n    message: 'Value does not satisfy the exact DocBlocks MCP wire invariants',\n  });\n}\n\n/** Project the Zod 3 subset used by tool outputs into Zod 4 for SDK JSON Schema publication. */\nfunction projectZod3Schema(schema: z.ZodTypeAny): z4.ZodType {\n  if (schema instanceof z.ZodEffects) return projectZod3Schema(schema.innerType());\n  if (schema instanceof z.ZodOptional) return projectZod3Schema(schema.unwrap()).optional();\n  if (schema instanceof z.ZodNullable) return projectZod3Schema(schema.unwrap()).nullable();\n  if (schema instanceof z.ZodString) {\n    let projected = z4.string();\n    for (const check of schema._def.checks) {\n      switch (check.kind) {\n        case 'min':\n          projected = projected.min(check.value);\n          break;\n        case 'max':\n          projected = projected.max(check.value);\n          break;\n        case 'length':\n          projected = projected.length(check.value);\n          break;\n        case 'regex':\n          projected = projected.regex(check.regex);\n          break;\n        default:\n          throw new Error(`Unsupported Zod string check in MCP output schema: ${check.kind}`);\n      }\n    }\n    return projected;\n  }\n  if (schema instanceof z.ZodNumber) {\n    let projected = z4.number();\n    for (const check of schema._def.checks) {\n      switch (check.kind) {\n        case 'min':\n          projected = check.inclusive ? projected.min(check.value) : projected.gt(check.value);\n          break;\n        case 'max':\n          projected = check.inclusive ? projected.max(check.value) : projected.lt(check.value);\n          break;\n        case 'int':\n          projected = projected.int();\n          break;\n        case 'multipleOf':\n          projected = projected.multipleOf(check.value);\n          break;\n        case 'finite':\n          // Zod 4 numbers reject infinities by default.\n          break;\n      }\n    }\n    return projected;\n  }\n  if (schema instanceof z.ZodBoolean) return z4.boolean();\n  if (schema instanceof z.ZodNull) return z4.null();\n  if (schema instanceof z.ZodAny) return z4.any();\n  if (schema instanceof z.ZodUnknown) return z4.unknown();\n  if (schema instanceof z.ZodNever) return z4.never();\n  if (schema instanceof z.ZodLiteral) {\n    const value: unknown = schema.value;\n    if (\n      typeof value === 'string' ||\n      typeof value === 'number' ||\n      typeof value === 'boolean' ||\n      typeof value === 'bigint' ||\n      value === null\n    ) {\n      return z4.literal(value);\n    }\n    throw new Error('Unsupported Zod literal in MCP output schema');\n  }\n  if (schema instanceof z.ZodEnum) {\n    const [first, ...rest] = schema.options;\n    if (first === undefined) throw new Error('Empty Zod enum in MCP output schema');\n    return z4.enum([first, ...rest]);\n  }\n  if (schema instanceof z.ZodArray) {\n    let projected = z4.array(projectZod3Schema(schema.element));\n    if (schema._def.minLength) projected = projected.min(schema._def.minLength.value);\n    if (schema._def.maxLength) projected = projected.max(schema._def.maxLength.value);\n    if (schema._def.exactLength) projected = projected.length(schema._def.exactLength.value);\n    return projected;\n  }\n  if (schema instanceof z.ZodObject) {\n    const sourceShape = schema.shape as z.ZodRawShape;\n    const shape = Object.fromEntries(\n      Object.entries(sourceShape).map(([key, value]) => [key, projectZod3Schema(value)]),\n    );\n    if (schema._def.unknownKeys === 'passthrough') return z4.looseObject(shape);\n    return z4.object(shape);\n  }\n  if (schema instanceof z.ZodDiscriminatedUnion) {\n    const options = schema.options as readonly z.ZodTypeAny[];\n    return projectUnion(options.map((option) => projectZod3Schema(option)));\n  }\n  if (schema instanceof z.ZodUnion) {\n    const options = schema.options as readonly z.ZodTypeAny[];\n    return projectUnion(options.map((option) => projectZod3Schema(option)));\n  }\n  throw new Error(`Unsupported Zod type in MCP output schema: ${schema._def.typeName}`);\n}\n\nfunction projectUnion(options: z4.ZodType[]): z4.ZodType {\n  const [first, second, ...rest] = options;\n  if (!first || !second) throw new Error('MCP output unions require at least two alternatives');\n  return z4.union([first, second, ...rest]);\n}\n\nfunction jsonSchemaWithoutDialect(schema: z4.ZodType): Record<string, unknown> {\n  const { $schema: _dialect, ...jsonSchema } = z4.toJSONSchema(schema, { target: 'draft-7' });\n  return jsonSchema;\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,SAAS;AAClB,SAAS,KAAK,UAAU;AAqCjB,IAAM,0BAA0B,KAAK,OAAO;AAC5C,IAAM,sBAAsB;AACnC,IAAM,oBAAoB;AAE1B,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAC7B,IAAM,oBAAoB;AAC1B,IAAM,uBAAuB;AAC7B,IAAM,wBAAwB;AAE9B,IAAM,sBAAsB,IAAI,OAAO,wBAAwB,GAAG;AAClE,IAAM,yBAAyB,IAAI;AAAA,EACjC;AAAA,EACA;AACF;AACA,IAAM,wBAAwB,IAAI,OAAO,0CAA0C,GAAG;AAGtF,IAAM,gBAAgB,EACnB,OAAO,EACP,IAAI,gBAAgB,iBAAiB,EACrC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,wBAAwB,EAC3B,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,iBAAiB,EACrC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,cAAc,EACjB,OAAO,EACP,IAAI,gBAAgB,eAAe,EACnC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,sBAAsB,YAAY,IAAI,CAAC;AAC7C,IAAM,gBAAgB,EACnB,OAAO,EACP,IAAI,gBAAgB,iBAAiB,EACrC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,gBAAgB,EACnB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,aAAa,EACjC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,+BAA+B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,gBAAgB;AACxF,IAAM,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,iBAAiB,EAAE,MAAM,kBAAkB;AAC3E,IAAM,eAAe,EACzB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,gBAAgB,EACpC,MAAM,cAAc;AAEhB,IAAM,oBAAoB,EAC9B,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,gBAAgB,EACpC,MAAM,oBAAoB;AAC7B,IAAM,iBAAiB,EACpB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,kBAAkB,EACtC,MAAM,iBAAiB;AAC1B,IAAM,qBAAqB,EACxB,OAAO,EACP,MAAM,qBAAqB,EAC3B,OAAO,CAAC,UAAU;AACjB,QAAM,YAAY,KAAK,MAAM,KAAK;AAClC,SAAO,OAAO,SAAS,SAAS,KAAK,IAAI,KAAK,SAAS,EAAE,YAAY,MAAM;AAC7E,GAAG,+DAA+D;AACpE,IAAM,mBAAmB,EACtB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,iBAAiB,EACrB;AAAA,EACC;AACF;AACF,IAAM,sBAAsB,EACzB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,mBAAmB,EACvB,MAAM,wBAAwB,uDAAuD,EACrF;AAAA,EACC,CAAC,UACC,CAAC,MAAM,SAAS,IAAI,KACpB,CAAC,MAAM,WAAW,GAAG,KACrB,CAAC,cAAc,KAAK,KAAK,KACzB,CAAC,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,YAAY,OAAO,YAAY,IAAI,KACnF,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,cAAc;AAC9B,UAAM,YAAY,UAAU,YAAY,CAAC,KAAK;AAC9C,WAAO,aAAa,MAAQ,cAAc;AAAA,EAC5C,CAAC;AAAA,EACH;AACF;AACK,IAAM,oBAAoB,EAC9B,OAAO,EACP,IAAI,yBAAyB,SAAS,iBAAiB,EACvD,MAAM,oBAAoB;AAE7B,IAAM,oBAAoB,EAAE,mBAAmB,QAAQ;AAAA,EACrD,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,MAAM,GAAG,QAAQ,UAAU,MAAM,oBAAoB,CAAC,EAAE,OAAO;AAAA,EAC1F,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,UAAU,GAAG,KAAK,kBAAkB,CAAC,EAAE,OAAO;AAC3E,CAAC;AAEM,IAAM,oBAAoB,EAC9B,OAAO;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,UAAU,eAAe,SAAS;AAAA,EAClC,SAAS,YAAY,SAAS;AAAA,EAC9B,QAAQ,YAAY,SAAS;AAAA,EAC7B,SAAS,YAAY,SAAS;AAChC,CAAC,EACA,OAAO;AAEH,IAAM,6BAA6B,EACvC,OAAO;AAAA,EACN,MAAM,EAAE,QAAQ,QAAQ;AAAA,EACxB,UAAU,EACP,OAAO,EACP,IAAI,uBAAuB,EAC3B,MAAM,qBAAqB,+CAA+C;AAAA,EAC7E,QAAQ,EAAE,MAAM,iBAAiB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACnE,MAAM,YAAY,SAAS;AAC7B,CAAC,EACA,OAAO;AAEH,IAAM,uBAAuB,EAAE,mBAAmB,QAAQ;AAAA,EAC/D,EACG,OAAO;AAAA,IACN,MAAM,EAAE,QAAQ,UAAU;AAAA,IAC1B,UAAU,EACP,OAAO,EACP,IAAI,uBAAuB,EAC3B,MAAM,qBAAqB,+CAA+C;AAAA,IAC7E,MAAM,YAAY,SAAS;AAAA,EAC7B,CAAC,EACA,OAAO;AAAA,EACV,EACG,OAAO;AAAA,IACN,MAAM,EAAE,QAAQ,MAAM;AAAA,IACtB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,QAAQ,aAAa,SAAS;AAAA,EAChC,CAAC,EACA,OAAO;AAAA,EACV,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,UAAU,GAAG,KAAK,kBAAkB,CAAC,EAAE,OAAO;AAAA,EACzE;AACF,CAAC;AAED,IAAM,sBAAsB,EACzB,OAAO;AAAA,EACN,MAAM;AAAA,EACN,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;AAC5E,CAAC,EACA,OAAO;AACV,IAAM,sBAAsB,EACzB,OAAO,EAAE,MAAM,kBAAkB,SAAS,sBAAsB,CAAC,EACjE,OAAO;AAEH,IAAM,oBAAoB,EAC9B,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,gBAAgB,aAAa;AAAA,EACtE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC1C,cAAc,aAAa,SAAS;AAAA,EACpC,cAAc,EACX,OAAO,EACP,MAAM,iBAAiB,EACvB,SAAS;AAAA,EACZ,mBAAmB,EAChB,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,eAAe,EACnC,MAAM,qBAAqB;AAAA,EAC9B,gBAAgB,EAAE,MAAM,mBAAmB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC7E,gBAAgB,EAAE,MAAM,mBAAmB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC7E,WAAW;AAAA,EACX,WAAW,mBAAmB,SAAS;AACzC,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,iBAAiB,KAAK,GAAG,OAAO,CAAC;AAEtF,IAAM,2BAA2B,EAAE,mBAAmB,QAAQ;AAAA,EAC5D,EACG,OAAO;AAAA,IACN,MAAM,EAAE,QAAQ,QAAQ;AAAA,IACxB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,gBAAgB;AAAA,IACzD,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,gBAAgB;AAAA,EAC7D,CAAC,EACA,OAAO;AAAA,EACV,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,OAAO,GAAG,SAAS,UAAU,UAAU,SAAS,CAAC,EAAE,OAAO;AAAA,EACrF,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,OAAO,GAAG,MAAM,oBAAoB,CAAC,EAAE,OAAO;AAAA,EACzE,EACG,OAAO;AAAA,IACN,MAAM,EAAE,QAAQ,MAAM;AAAA,IACtB,UAAU,EAAE,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,CAAC;AAAA,IACpD,OAAO;AAAA,EACT,CAAC,EACA,OAAO;AACZ,CAAC;AAEM,IAAM,mBAAmB,EAC7B,OAAO;AAAA,EACN,MAAM;AAAA,EACN,UAAU,EAAE,KAAK,CAAC,QAAQ,WAAW,OAAO,CAAC;AAAA,EAC7C,OAAO,EAAE,KAAK;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,QAAQ,aAAa,SAAS;AAAA,EAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,gBAAgB;AAAA,EAC1D,SAAS;AAAA,EACT,aAAa,cAAc,SAAS;AAAA,EACpC,WAAW,EAAE,QAAQ;AAAA,EACrB,UAAU,yBAAyB,SAAS;AAC9C,CAAC,EACA,OAAO;AAEH,IAAM,uBAAuB,EACjC,OAAO;AAAA,EACN,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO,EACJ,KAAK;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,EACA,SAAS;AAAA,EACZ,QAAQ,aAAa,SAAS;AAAA,EAC9B,MAAM,cAAc,SAAS;AAAA,EAC7B,WAAW,EAAE,QAAQ;AAAA,EACrB,eAAe,EACZ,OAAO;AAAA,IACN,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;AAAA,IAC7C,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;AAAA,EAC9C,CAAC,EACA,OAAO,EACP,SAAS;AACd,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,MAAI,MAAM,iBAAiB,MAAM,cAAc,SAAS,MAAM,cAAc,UAAU;AACpF,YAAQ,SAAS;AAAA,MACf,MAAM,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,iBAAiB,QAAQ;AAAA,MAChC,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;AAEI,IAAM,uBAAuB,EACjC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,OAAO;AAAA,EACvB,QAAQ,EAAE,KAAK;AAAA,EACf,OAAO;AACT,CAAC,EACA,OAAO;AAWH,SAAS,iBAAyC,SAAY;AACnE,QAAM,kBAAkB,EACrB,OAAO;AAAA,IACN,SAAS,EAAE,QAAQ,CAAC;AAAA,IACpB,MAAM,EAAE,QAAQ,SAAS;AAAA,IACzB,QAAQ;AAAA,IACR,OAAO,EAAE,KAAK;AAAA,EAChB,CAAC,EACA,OAAO;AACV,QAAM,gBAAgB,EACnB,OAAO;AAAA,IACN,SAAS,EAAE,QAAQ,CAAC;AAAA,IACpB,MAAM,EAAE,QAAQ,OAAO;AAAA,IACvB,QAAQ,EAAE,KAAK;AAAA,IACf,OAAO;AAAA,EACT,CAAC,EACA,OAAO;AACV,QAAM,mBAAmB,GACtB,OAAO;AAAA,IACN,SAAS,GAAG,QAAQ,CAAC;AAAA,IACrB,MAAM,GAAG,QAAQ,SAAS;AAAA,IAC1B,QAAQ,kBAAkB,OAAO;AAAA,IACjC,OAAO,GAAG,KAAK;AAAA,EACjB,CAAC,EACA,OAAO;AACV,QAAM,iBAAiB,GACpB,OAAO;AAAA,IACN,SAAS,GAAG,QAAQ,CAAC;AAAA,IACrB,MAAM,GAAG,QAAQ,OAAO;AAAA,IACxB,QAAQ,GAAG,KAAK;AAAA,IAChB,OAAO,kBAAkB,oBAAoB;AAAA,EAC/C,CAAC,EACA,OAAO;AACV,QAAM,QAAQ;AAAA,IACZ,yBAAyB,gBAAgB;AAAA,IACzC,yBAAyB,cAAc;AAAA,EACzC;AAEA,SAAO,GACJ,OAAO;AAAA,IACN,SAAS,GAAG,QAAQ,CAAC;AAAA,IACrB,MAAM,GAAG,KAAK,CAAC,WAAW,OAAO,CAAC;AAAA,IAClC,QAAQ,GAAG,QAAQ;AAAA,IACnB,OAAO,GAAG,QAAQ;AAAA,EACpB,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,UAAM,SAAS,MAAM,SAAS,YAAY,kBAAkB;AAC5D,UAAM,SAAS,OAAO,UAAU,KAAK;AACrC,QAAI,OAAO,QAAS;AACpB,eAAW,SAAS,OAAO,MAAM,QAAQ;AACvC,cAAQ,SAAS;AAAA,QACf,MAAM;AAAA,QACN,MAAM,MAAM;AAAA,QACZ,SAAS,MAAM;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,CAAC,EACA,KAAK,EAAE,MAAM,CAAC;AACnB;AAEA,IAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,gBAAgB,aAAa;AAAA,EACtE,QAAQ,EACL,OAAO,EACP,MAAM,iBAAiB,EACvB,SAAS;AAAA,EACZ,SAAS,YAAY,SAAS;AAAA,EAC9B,QAAQ,YAAY,SAAS;AAAA,EAC7B,SAAS,YAAY,SAAS;AAChC,CAAC,EACA,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,cAAc;AAAA,EACd,cAAc;AAAA,EACd,UAAU;AAAA,EACV,UAAU,EAAE,KAAK,CAAC,YAAY,mBAAmB,qBAAqB,QAAQ,CAAC;AAAA,EAC/E,gBAAgB,SAAS,SAAS;AAAA,EAClC,oBAAoB,SAAS,SAAS;AAAA,EACtC,cAAc,EAAE,MAAM,kBAAkB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC1E,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC1E,aAAa,EAAE,MAAM,gBAAgB,EAAE,IAAI,gBAAgB,YAAY;AACzE,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,sBAAsB,KAAK,GAAG,OAAO,CAAC;AAE3F,IAAM,iBAAiB,EACpB,OAAO;AAAA,EACN,OAAO,YAAY,SAAS;AAAA,EAC5B,QAAQ,YAAY,SAAS;AAAA,EAC7B,aAAa,cAAc,SAAS;AACtC,CAAC,EACA,OAAO;AACV,IAAM,mBAAmB,EACtB,OAAO;AAAA,EACN,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,WAAW,6BAA6B,SAAS;AAAA,EACjD,YAAY,6BAA6B,SAAS;AAAA,EAClD,YAAY,6BAA6B,SAAS;AACpD,CAAC,EACA,OAAO;AACV,IAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;AAAA,EACpC,YAAY;AACd,CAAC,EACA,OAAO;AACV,IAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,WAAW;AAAA,EACX,YAAY,SAAS,SAAS;AAAA,EAC9B,aAAa,EACV,OAAO,EAAE,OAAO,8BAA8B,KAAK,6BAA6B,CAAC,EACjF,OAAO,EACP,SAAS;AACd,CAAC,EACA,OAAO;AACV,IAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,OAAO;AAAA,EACP,UAAU;AAAA,EACV,aAAa;AAAA,EACb,SAAS,EAAE,MAAM,WAAW,EAAE,IAAI,gBAAgB,YAAY;AAChE,CAAC,EACA,OAAO;AACV,IAAM,oBAAoB,EACvB,OAAO;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,QAAQ;AACV,CAAC,EACA,OAAO;AACV,IAAM,4BAA4B,EAC/B,OAAO;AAAA,EACN,MAAM,EAAE,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,CAAC;AAAA,EAChD,OAAO;AAAA,EACP,OAAO,YAAY,SAAS;AAAA,EAC5B,UAAU,EAAE,MAAM,QAAQ,EAAE,IAAI,gBAAgB,YAAY;AAC9D,CAAC,EACA,OAAO;AACV,IAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,QAAQ,EAAE,KAAK,CAAC,YAAY,YAAY,UAAU,CAAC;AAAA,EACnD,SAAS,EAAE,MAAM,mBAAmB,EAAE,IAAI,gBAAgB,YAAY;AACxE,CAAC,EACA,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,cAAc;AAAA,EACd,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,SAAS,EAAE,MAAM,kBAAkB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACrE,QAAQ,EAAE,MAAM,kBAAkB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACpE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACrE,YAAY,EACT,OAAO,EACP,IAAI,gBAAgB,oBAAoB,EACxC,MAAM,mBAAmB,EACzB,SAAS;AAAA,EACZ,QAAQ,EAAE,MAAM,kBAAkB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACpE,OAAO,EAAE,MAAM,iBAAiB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAClE,OAAO,EAAE,MAAM,yBAAyB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC1E,QAAQ,EAAE,MAAM,kBAAkB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACpE,OAAO,mBAAmB,SAAS;AAAA,EACnC,WAAW,EAAE,QAAQ;AAAA,EACrB,kBAAkB,EAAE,QAAQ;AAAA,EAC5B,aAAa,EAAE,MAAM,gBAAgB,EAAE,IAAI,gBAAgB,YAAY;AACzE,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,sBAAsB,KAAK,GAAG,OAAO,CAAC;AAEpF,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,cAAc;AAAA,EACd,cAAc,aAAa,SAAS;AAAA,EACpC,OAAO,EAAE,QAAQ;AAAA,EACjB,SAAS,EACN,OAAO;AAAA,IACN,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,WAAW;AAAA,EACb,CAAC,EACA,OAAO;AAAA,EACV,aAAa,EAAE,MAAM,gBAAgB,EAAE,IAAI,gBAAgB,YAAY;AACzE,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,sBAAsB,KAAK,GAAG,OAAO,CAAC;AAE3F,IAAM,oBAAoB,EACvB,OAAO;AAAA,EACN,MAAM,EAAE,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,CAAC;AAAA,EAChD,OAAO;AAAA,EACP,OAAO,YAAY,SAAS;AAAA,EAC5B,UAAU;AAAA,EACV,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,gBAAgB,cAAc;AAAA,EACjE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,gBAAgB,cAAc;AACpE,CAAC,EACA,OAAO;AACH,IAAM,sBAAsB,EAChC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,SAAS;AAAA,EACzB,cAAc;AAAA,EACd,cAAc,EAAE,KAAK,CAAC,iBAAiB,wBAAwB,kBAAkB,CAAC;AAAA,EAClF,YAAY;AAAA,EACZ,OAAO,EAAE,MAAM,iBAAiB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAClE,WAAW,EAAE,QAAQ;AAAA,EACrB,aAAa,EAAE,MAAM,gBAAgB,EAAE,IAAI,gBAAgB,YAAY;AACzE,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,mBAAmB,KAAK,GAAG,OAAO,CAAC;AAExF,IAAM,yBAAyB,EAC5B,OAAO;AAAA,EACN,UAAU,EAAE,KAAK;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,QAAQ,EAAE,KAAK,CAAC,YAAY,WAAW,YAAY,WAAW,OAAO,CAAC;AAAA,EACtE,MAAM,EAAE,OAAO,EAAE,IAAI,gBAAgB,cAAc,EAAE,MAAM,mBAAmB,EAAE,SAAS;AAAA,EACzF,SAAS;AACX,CAAC,EACA,OAAO;AACV,IAAM,yBAAyB,EAC5B,OAAO;AAAA,EACN,MAAM;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,OAAO;AAAA,EAC7B,YAAY,EAAE,OAAO,EAAE,OAAO;AAAA,EAC9B,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;AACrC,CAAC,EACA,OAAO;AACH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,YAAY,EAAE,QAAQ;AAAA,EACtB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;AAAA,EAC9B,SAAS,EAAE,MAAM,sBAAsB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACzE,SAAS,EAAE,MAAM,sBAAsB,EAAE,IAAI,gBAAgB,YAAY;AAAA,EACzE,aAAa,EAAE,MAAM,gBAAgB,EAAE,IAAI,gBAAgB,YAAY;AACzE,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY,kBAAkB,sBAAsB,KAAK,GAAG,OAAO,CAAC;AAE3F,IAAM,wBAAwB,EAC3B,OAAO,EACP,IAAI,CAAC,EACL,IAAI,gBAAgB,cAAc,EAClC,MAAM,qBAAqB,+CAA+C;AAC7E,IAAM,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAEhD,IAAM,8BAA8B,EACxC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAClE,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,MAAM,EAAE,QAAQ;AAAA,EAChB,OAAO,EAAE,QAAQ;AACnB,CAAC,EACA,OAAO;AAEH,IAAM,wBAAwB,EAClC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,EAAE,IAAI,EAAE,EAAE,CAAC,EACzD,OAAO;AAEH,IAAM,2BAA2B,EACrC,OAAO;AAAA,EACN,UAAU;AAAA,EACV,aAAa,EAAE,OAAO,EAAE,QAAQ,UAAU,MAAM,oBAAoB,CAAC,EAAE,OAAO;AAAA,EAC9E,QAAQ;AACV,CAAC,EACA,OAAO;AAEH,IAAM,kCAAkC,EAAE,mBAAmB,aAAa;AAAA,EAC/E,EACG,OAAO;AAAA,IACN,WAAW,EAAE,QAAQ,IAAI;AAAA,IACzB,MAAM,EAAE,KAAK,CAAC,oBAAoB,kBAAkB,CAAC;AAAA,EACvD,CAAC,EACA,OAAO;AAAA,EACV,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,KAAK,GAAG,gBAAgB,cAAc,CAAC,EAAE,OAAO;AAClF,CAAC;AAEM,IAAM,gCAAgC,EAC1C,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,UAAU;AAAA,EACV,YAAY,EAAE,MAAM,mBAAmB,EAAE,IAAI,EAAE;AAAA,EAC/C,QAAQ;AAAA,EACR,QAAQ;AACV,CAAC,EACA,OAAO;AAEH,IAAM,0BAA0B,EACpC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,EAAE,IAAI,EAAE,EAAE,CAAC,EAClE,OAAO;AAEH,IAAM,0BAA0B,EACpC,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aAAa,cAAc,SAAS;AACtC,CAAC,EACA,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,EAAE,IAAI,gBAAgB,YAAY,EAAE,CAAC,EACrF,OAAO;AAEH,IAAM,8BAA8B,EACxC,OAAO,EAAE,IAAI,UAAU,MAAM,qBAAqB,aAAa,cAAc,CAAC,EAC9E,OAAO;AAEH,IAAM,kCAAkC,EAC5C,OAAO;AAAA,EACN,QAAQ,EAAE,MAAM,2BAA2B,EAAE,IAAI,gBAAgB,YAAY;AAC/E,CAAC,EACA,OAAO;AAEH,IAAM,wBAAwB,EAClC,OAAO,EAAE,IAAI,UAAU,OAAO,qBAAqB,aAAa,cAAc,CAAC,EAC/E,OAAO;AAEH,IAAM,4BAA4B,EACtC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,EAAE,IAAI,gBAAgB,YAAY,EAAE,CAAC,EACtF,OAAO;AAEH,IAAM,6BAA6B,EACvC,OAAO;AAAA,EACN,KAAK;AAAA,EACL,aAAa;AAAA,EACb,MAAM;AAAA,EACN,UAAU,EAAE,QAAQ;AAAA,EACpB,QAAQ,EAAE,MAAM,WAAW,EAAE,IAAI,gBAAgB,YAAY;AAAA,EAC7D,WAAW,YAAY,SAAS;AAClC,CAAC,EACA,OAAO;AAEH,IAAM,+BAA+B,EACzC,OAAO;AAAA,EACN,UAAU,sBACP,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,EAAE,IAAI,gBAAgB,YAAY,EAAE,CAAC,EACxF,OAAO;AAAA,EACV,mBAAmB;AACrB,CAAC,EACA,OAAO;AAEH,IAAM,+BAA+B,EACzC,OAAO;AAAA,EACN,UAAU,EAAE,QAAQ;AAAA,EACpB,YAAY;AAAA,EACZ,UAAU,EAAE,QAAQ;AAAA,EACpB,eAAe,EAAE,QAAQ;AAAA,EACzB,SAAS,EAAE,QAAQ;AAAA,EACnB,UAAU,EAAE,QAAQ;AAAA,EACpB,SAAS,EAAE,QAAQ;AAAA,EACnB,oBAAoB,EAAE,QAAQ;AAAA,EAC9B,WAAW;AAAA,EACX,iBAAiB,EAAE,QAAQ;AAAA,EAC3B,aAAa,EAAE,QAAQ;AAAA,EACvB,SAAS,EAAE,QAAQ;AACrB,CAAC,EACA,OAAO;AAEH,IAAM,+BAA+B,EACzC,OAAO;AAAA,EACN,SAAS;AAAA,EACT,OAAO,YAAY,SAAS;AAAA,EAC5B,SAAS;AAAA,EACT,wBAAwB,EAAE,MAAM,QAAQ,EAAE,IAAI,GAAG;AACnD,CAAC,EACA,OAAO;AAEH,IAAM,iCAAiC,EAC3C,OAAO;AAAA,EACN,iBAAiB,EAAE,MAAM,4BAA4B,EAAE,IAAI,GAAG;AAAA,EAC9D,aAAa;AAAA,EACb,WAAW,EAAE,QAAQ;AACvB,CAAC,EACA,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aAAa;AAAA,EACb,QAAQ,EACL,OAAO;AAAA,IACN,SAAS;AAAA,IACT,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,MAAM;AAAA,IACN,WAAW;AAAA,EACb,CAAC,EACA,OAAO;AAAA,EACV,UAAU;AAAA,EACV,WAAW;AACb,CAAC,EACA,OAAO;AAEH,IAAM,4BAA4B,EACtC,OAAO,EAAE,OAAO,wBAAwB,QAAQ,EAAE,KAAK,CAAC,YAAY,UAAU,CAAC,EAAE,CAAC,EAClF,OAAO;AAEH,IAAM,8BAA8B,EACxC,OAAO,EAAE,IAAI,qBAAqB,MAAM,qBAAqB,aAAa,cAAc,CAAC,EACzF,OAAO;AAEH,IAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,cAAc;AAAA,EACd,cAAc;AAAA,EACd,OAAO;AAAA,EACP,SAAS,EAAE,MAAM,2BAA2B,EAAE,IAAI,GAAK;AAAA,EACvD,UAAU,EAAE,MAAM,aAAa,EAAE,IAAI,gBAAgB,YAAY;AACnE,CAAC,EACA,OAAO;AAEH,IAAM,0BAA0B,EACpC,OAAO;AAAA,EACN,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,YAAY,YAAY,SAAS;AAAA,EACjC,MAAM,YAAY,SAAS;AAAA,EAC3B,YAAY;AAAA,EACZ,SAAS,EAAE,KAAK,CAAC,WAAW,UAAU,SAAS,MAAM,CAAC;AAAA,EACtD,YAAY,YAAY,SAAS;AAAA,EACjC,OAAO,EAAE,MAAM,aAAa,EAAE,IAAI,GAAK;AACzC,CAAC,EACA,OAAO;AAEH,IAAM,iCAAiC,EAC3C,OAAO;AAAA,EACN,WAAW,EACR,OAAO,EAAE,IAAI,8BAA8B,IAAI,6BAA6B,CAAC,EAC7E,OAAO;AAAA,EACV,SAAS,EAAE,MAAM,uBAAuB,EAAE,IAAI,IAAK;AACrD,CAAC,EACA,OAAO;AAEH,IAAM,iCAAiC,EAC3C,OAAO;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW,EAAE,MAAM,WAAW,EAAE,IAAI,GAAK;AAAA,EACzC,UAAU,EAAE,MAAM,aAAa,EAAE,IAAI,gBAAgB,YAAY;AACnE,CAAC,EACA,OAAO;AAGH,IAAM,oCAET,OAAO,OAAO;AAAA,EAChB,YAAY;AAAA,EACZ,uBAAuB;AAAA,EACvB,kBAAkB;AAAA,EAClB,wBAAwB;AAAA,EACxB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,cAAc;AAAA,EACd,aAAa;AAAA,EACb,uBAAuB;AACzB,CAAC;AAIM,IAAM,oCAET,OAAO,OAAO;AAAA,EAChB,YAAY,iBAAiB,kCAAkC,UAAU;AAAA,EACzE,uBAAuB,iBAAiB,kCAAkC,qBAAqB;AAAA,EAC/F,kBAAkB,iBAAiB,kCAAkC,gBAAgB;AAAA,EACrF,wBAAwB;AAAA,IACtB,kCAAkC;AAAA,EACpC;AAAA,EACA,eAAe,iBAAiB,kCAAkC,aAAa;AAAA,EAC/E,kBAAkB,iBAAiB,kCAAkC,gBAAgB;AAAA,EACrF,mBAAmB,iBAAiB,kCAAkC,iBAAiB;AAAA,EACvF,kBAAkB,iBAAiB,kCAAkC,gBAAgB;AAAA,EACrF,mBAAmB,iBAAiB,kCAAkC,iBAAiB;AAAA,EACvF,gBAAgB,iBAAiB,kCAAkC,cAAc;AAAA,EACjF,mBAAmB,iBAAiB,kCAAkC,iBAAiB;AAAA,EACvF,qBAAqB,iBAAiB,kCAAkC,mBAAmB;AAAA,EAC3F,gBAAgB,iBAAiB,kCAAkC,cAAc;AAAA,EACjF,uBAAuB,iBAAiB,kCAAkC,qBAAqB;AAAA,EAC/F,sBAAsB,iBAAiB,kCAAkC,oBAAoB;AAAA,EAC7F,sBAAsB,iBAAiB,kCAAkC,oBAAoB;AAAA,EAC7F,cAAc,iBAAiB,kCAAkC,YAAY;AAAA,EAC7E,aAAa,iBAAiB,kCAAkC,WAAW;AAAA,EAC3E,uBAAuB,iBAAiB,kCAAkC,qBAAqB;AACjG,CAAC;AAEM,IAAM,+BAA+B,EAAE,mBAAmB,YAAY;AAAA,EAC3E,EACG,OAAO;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,UAAU,EAAE,QAAQ,OAAO;AAAA,IAC3B,gBAAgB,EAAE,KAAK;AAAA,EACzB,CAAC,EACA,OAAO;AAAA,EACV,EACG,OAAO;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,UAAU,EAAE,QAAQ,SAAS;AAAA,IAC7B,gBAAgB,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EACpD,CAAC,EACA,OAAO;AACZ,CAAC;AAED,SAAS,kBAAqB,QAAkB,SAAgC;AAC9E,MAAI,WAAW,KAAM;AACrB,UAAQ,SAAS;AAAA,IACf,MAAM,EAAE,aAAa;AAAA,IACrB,SAAS;AAAA,EACX,CAAC;AACH;AAGA,SAAS,kBAAkB,QAAkC;AAC3D,MAAI,kBAAkB,EAAE,WAAY,QAAO,kBAAkB,OAAO,UAAU,CAAC;AAC/E,MAAI,kBAAkB,EAAE,YAAa,QAAO,kBAAkB,OAAO,OAAO,CAAC,EAAE,SAAS;AACxF,MAAI,kBAAkB,EAAE,YAAa,QAAO,kBAAkB,OAAO,OAAO,CAAC,EAAE,SAAS;AACxF,MAAI,kBAAkB,EAAE,WAAW;AACjC,QAAI,YAAY,GAAG,OAAO;AAC1B,eAAW,SAAS,OAAO,KAAK,QAAQ;AACtC,cAAQ,MAAM,MAAM;AAAA,QAClB,KAAK;AACH,sBAAY,UAAU,IAAI,MAAM,KAAK;AACrC;AAAA,QACF,KAAK;AACH,sBAAY,UAAU,IAAI,MAAM,KAAK;AACrC;AAAA,QACF,KAAK;AACH,sBAAY,UAAU,OAAO,MAAM,KAAK;AACxC;AAAA,QACF,KAAK;AACH,sBAAY,UAAU,MAAM,MAAM,KAAK;AACvC;AAAA,QACF;AACE,gBAAM,IAAI,MAAM,sDAAsD,MAAM,IAAI,EAAE;AAAA,MACtF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,MAAI,kBAAkB,EAAE,WAAW;AACjC,QAAI,YAAY,GAAG,OAAO;AAC1B,eAAW,SAAS,OAAO,KAAK,QAAQ;AACtC,cAAQ,MAAM,MAAM;AAAA,QAClB,KAAK;AACH,sBAAY,MAAM,YAAY,UAAU,IAAI,MAAM,KAAK,IAAI,UAAU,GAAG,MAAM,KAAK;AACnF;AAAA,QACF,KAAK;AACH,sBAAY,MAAM,YAAY,UAAU,IAAI,MAAM,KAAK,IAAI,UAAU,GAAG,MAAM,KAAK;AACnF;AAAA,QACF,KAAK;AACH,sBAAY,UAAU,IAAI;AAC1B;AAAA,QACF,KAAK;AACH,sBAAY,UAAU,WAAW,MAAM,KAAK;AAC5C;AAAA,QACF,KAAK;AAEH;AAAA,MACJ;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,MAAI,kBAAkB,EAAE,WAAY,QAAO,GAAG,QAAQ;AACtD,MAAI,kBAAkB,EAAE,QAAS,QAAO,GAAG,KAAK;AAChD,MAAI,kBAAkB,EAAE,OAAQ,QAAO,GAAG,IAAI;AAC9C,MAAI,kBAAkB,EAAE,WAAY,QAAO,GAAG,QAAQ;AACtD,MAAI,kBAAkB,EAAE,SAAU,QAAO,GAAG,MAAM;AAClD,MAAI,kBAAkB,EAAE,YAAY;AAClC,UAAM,QAAiB,OAAO;AAC9B,QACE,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,aACjB,OAAO,UAAU,YACjB,UAAU,MACV;AACA,aAAO,GAAG,QAAQ,KAAK;AAAA,IACzB;AACA,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,MAAI,kBAAkB,EAAE,SAAS;AAC/B,UAAM,CAAC,OAAO,GAAG,IAAI,IAAI,OAAO;AAChC,QAAI,UAAU,OAAW,OAAM,IAAI,MAAM,qCAAqC;AAC9E,WAAO,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;AAAA,EACjC;AACA,MAAI,kBAAkB,EAAE,UAAU;AAChC,QAAI,YAAY,GAAG,MAAM,kBAAkB,OAAO,OAAO,CAAC;AAC1D,QAAI,OAAO,KAAK,UAAW,aAAY,UAAU,IAAI,OAAO,KAAK,UAAU,KAAK;AAChF,QAAI,OAAO,KAAK,UAAW,aAAY,UAAU,IAAI,OAAO,KAAK,UAAU,KAAK;AAChF,QAAI,OAAO,KAAK,YAAa,aAAY,UAAU,OAAO,OAAO,KAAK,YAAY,KAAK;AACvF,WAAO;AAAA,EACT;AACA,MAAI,kBAAkB,EAAE,WAAW;AACjC,UAAM,cAAc,OAAO;AAC3B,UAAM,QAAQ,OAAO;AAAA,MACnB,OAAO,QAAQ,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,kBAAkB,KAAK,CAAC,CAAC;AAAA,IACnF;AACA,QAAI,OAAO,KAAK,gBAAgB,cAAe,QAAO,GAAG,YAAY,KAAK;AAC1E,WAAO,GAAG,OAAO,KAAK;AAAA,EACxB;AACA,MAAI,kBAAkB,EAAE,uBAAuB;AAC7C,UAAM,UAAU,OAAO;AACvB,WAAO,aAAa,QAAQ,IAAI,CAAC,WAAW,kBAAkB,MAAM,CAAC,CAAC;AAAA,EACxE;AACA,MAAI,kBAAkB,EAAE,UAAU;AAChC,UAAM,UAAU,OAAO;AACvB,WAAO,aAAa,QAAQ,IAAI,CAAC,WAAW,kBAAkB,MAAM,CAAC,CAAC;AAAA,EACxE;AACA,QAAM,IAAI,MAAM,8CAA8C,OAAO,KAAK,QAAQ,EAAE;AACtF;AAEA,SAAS,aAAa,SAAmC;AACvD,QAAM,CAAC,OAAO,QAAQ,GAAG,IAAI,IAAI;AACjC,MAAI,CAAC,SAAS,CAAC,OAAQ,OAAM,IAAI,MAAM,qDAAqD;AAC5F,SAAO,GAAG,MAAM,CAAC,OAAO,QAAQ,GAAG,IAAI,CAAC;AAC1C;AAEA,SAAS,yBAAyB,QAA6C;AAC7E,QAAM,EAAE,SAAS,UAAU,GAAG,WAAW,IAAI,GAAG,aAAa,QAAQ,EAAE,QAAQ,UAAU,CAAC;AAC1F,SAAO;AACT;","names":[]}

package/dist/share/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Canonical wire format for a document embedded in a DocBlocks URL hash.
+ *
+ * The base64 payload is deliberately small and versioned:
+ *
+ *   "DBSHARE" + version byte + mode byte + bounded DBK bytes
+ *
+ * The DBK itself is validated at the filesystem import boundary. Keeping the
+ * launch mode outside the archive means the copied Markdown is never mutated
+ * merely to choose its initial presentation.
+ */
+type SharedDocumentMode = 'slideshow' | 'video' | 'page' | 'document' | 'narrate';
+interface SharedDocumentPayload {
+    readonly archive: Uint8Array;
+    readonly mode: SharedDocumentMode | null;
+}
+type SharedDocumentHashParseResult = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'valid';
+    readonly payload: SharedDocumentPayload;
+} | {
+    readonly kind: 'invalid';
+    readonly message: string;
+};
+declare const SHARED_DOCUMENT_LIMITS: Readonly<{
+    /** A conservative interoperability threshold, not a universal browser limit. */
+    portableUrlCharacters: 4096;
+    /** Hard cap applied before a hash is copied or decoded. */
+    urlCharacters: 32768;
+    /** Maximum UTF-8 Markdown accepted by the first-party link generator. */
+    markdownBytes: number;
+    /** Maximum compressed DBK bytes carried by the versioned envelope. */
+    archiveBytes: number;
+}>;
+/** Build the exact `#shared(<base64>)` fragment for a bounded DBK archive. */
+declare function createSharedDocumentHash(archive: Uint8Array, mode?: SharedDocumentMode | null): string;
+/** Replace any existing hash on a base URL with a validated shared payload. */
+declare function createSharedDocumentUrl(baseUrl: string, archive: Uint8Array, mode?: SharedDocumentMode | null): string;
+/** Parse a hash without ever treating malformed shared input as workspace routing. */
+declare function parseSharedDocumentHash(hash: string): SharedDocumentHashParseResult;
+
+export { SHARED_DOCUMENT_LIMITS, type SharedDocumentHashParseResult, type SharedDocumentMode, type SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash };

package/dist/share/index.js

@@ -0,0 +1,13 @@
+import {
+  SHARED_DOCUMENT_LIMITS,
+  createSharedDocumentHash,
+  createSharedDocumentUrl,
+  parseSharedDocumentHash
+} from "../chunk-BXMF5YQJ.js";
+export {
+  SHARED_DOCUMENT_LIMITS,
+  createSharedDocumentHash,
+  createSharedDocumentUrl,
+  parseSharedDocumentHash
+};
+//# sourceMappingURL=index.js.map

package/dist/share/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-BEg5SQ1_.d.ts

@@ -0,0 +1,301 @@
+import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
+
+/** Stable error codes shared by every filesystem transport and backend. */
+type FsErrorCode = 'invalid-path' | 'path-escape' | 'not-found' | 'already-exists' | 'type-mismatch' | 'not-empty' | 'permission-denied' | 'conflict' | 'corrupt' | 'quota-exceeded' | 'not-supported' | 'busy' | 'disposed' | 'closed' | 'aborted' | 'io';
+type FsOperation = 'parse-path' | 'read' | 'stat' | 'list' | 'write' | 'create-directory' | 'remove' | 'move' | 'snapshot' | 'watch' | 'dispose';
+/** Plain-data form safe to send over IPC, postMessage, or JSON. */
+interface SerializedFsError {
+    readonly name: 'FsError';
+    readonly code: FsErrorCode;
+    readonly message: string;
+    readonly operation: FsOperation | null;
+    readonly path: string | null;
+    readonly destinationPath: string | null;
+    readonly retryable: boolean;
+}
+interface FsErrorContext {
+    readonly operation?: FsOperation;
+    readonly path?: string;
+    readonly destinationPath?: string;
+    readonly retryable?: boolean;
+    readonly defaultCode?: FsErrorCode;
+}
+/** Error with a stable code and a deliberately serializable public shape. */
+declare class FsError extends Error {
+    readonly code: FsErrorCode;
+    readonly operation: FsOperation | null;
+    readonly path: string | null;
+    readonly destinationPath: string | null;
+    readonly retryable: boolean;
+    constructor(code: FsErrorCode, message: string, context?: FsErrorContext);
+    toJSON(): SerializedFsError;
+}
+declare function mapDomExceptionToFsErrorCode(name: string): FsErrorCode;
+declare function mapNodeErrorCodeToFsErrorCode(code: string): FsErrorCode;
+declare function isSerializedFsError(value: unknown): value is SerializedFsError;
+declare function deserializeFsError(value: SerializedFsError): FsError;
+declare function fsErrorFromUnknown(error: unknown, context?: FsErrorContext): FsError;
+declare function serializeFsError(error: unknown, context?: FsErrorContext): SerializedFsError;
+/**
+ * True when a storage backend rejected an operation because the origin or
+ * device is out of space. Covers typed `FsError`s (`'quota-exceeded'`, from
+ * DOMException `QuotaExceededError` or Node `ENOSPC`/`EDQUOT`), serialized
+ * transport copies, and raw DOMExceptions from backends that do not wrap
+ * their errors (e.g. the File System Access API) — including cross-realm
+ * instances where `instanceof DOMException` would fail.
+ */
+declare function isQuotaExceededError(error: unknown): boolean;
+
+/**
+ * Opaque provider-issued token representing one observed entry/tree state.
+ * Tokens support equality only within the issuing provider; callers must not
+ * parse them or assume a move or byte-identical rewrite changes the token.
+ * A token need not be a content hash, but it must change whenever the issuing
+ * provider observes a potentially different kind, payload, or descendant
+ * state. Detection of non-cooperating external changes is bounded by the
+ * backend's declared capabilities and metadata precision.
+ */
+declare const fileSystemVersionBrand: unique symbol;
+type FileSystemVersion = string & {
+    readonly [fileSystemVersionBrand]: 'FileSystemVersion';
+};
+/** Validate/rebrand a version received from a provider transport. */
+declare function parseFileSystemVersion(value: unknown): FileSystemVersion;
+declare function tryParseFileSystemVersion(value: unknown): FileSystemVersion | null;
+/** `process` excludes this provider's local peers; `cross-context` also excludes cooperating tabs/processes. */
+type FileSystemAtomicity = 'none' | 'process' | 'cross-context';
+type FileSystemCaseSensitivity = 'sensitive' | 'insensitive' | 'platform';
+type FileSystemDurability = 'volatile' | 'best-effort' | 'durable';
+type FileSystemConditionalWriteStrength = 'none' | 'process' | 'cross-context' | 'storage-atomic';
+type FileSystemSymlinkPolicy = 'unsupported' | 'reject' | 'follow-contained' | 'preserve';
+/** Serializable feature declaration; consumers never need provider instanceof checks. */
+interface FileSystemProviderCapabilities {
+    /** Isolation of one successful file replacement from cooperating writers. */
+    readonly writeAtomicity: FileSystemAtomicity;
+    /** Isolation of one successful source-to-destination move. */
+    readonly moveAtomicity: FileSystemAtomicity;
+    /** Writers excluded while one complete snapshot is captured. */
+    readonly snapshotAtomicity: FileSystemAtomicity;
+    /** Strongest boundary at which expectedVersion is checked with mutation. */
+    readonly conditionalWrite: FileSystemConditionalWriteStrength;
+    readonly recursiveRemove: boolean;
+    /** True only when watch has a real ready barrier and sequenced events. */
+    readonly watch: boolean;
+    readonly caseSensitivity: FileSystemCaseSensitivity;
+    readonly symlinkPolicy: FileSystemSymlinkPolicy;
+    readonly durability: FileSystemDurability;
+}
+interface FileSystemEntrySnapshotBase {
+    readonly path: WorkspacePath;
+    readonly name: string;
+    readonly version: FileSystemVersion;
+    /** ISO-8601 timestamp supplied by the backend; versions remain authoritative. */
+    readonly lastModified: string;
+}
+interface FileSystemFileSnapshot extends FileSystemEntrySnapshotBase {
+    readonly kind: 'file';
+    readonly size: number;
+}
+interface FileSystemDirectorySnapshot extends FileSystemEntrySnapshotBase {
+    readonly kind: 'directory';
+    readonly size: null;
+}
+type FileSystemEntrySnapshot = FileSystemFileSnapshot | FileSystemDirectorySnapshot;
+/** A read always couples owned bytes to the exact metadata version they represent. */
+interface FileSystemFileRead {
+    readonly entry: FileSystemFileSnapshot;
+    readonly data: ArrayBuffer;
+}
+interface FileSystemSnapshotFile extends FileSystemFileSnapshot {
+    readonly data: ArrayBuffer;
+}
+type FileSystemSnapshotEntry = FileSystemSnapshotFile | FileSystemDirectorySnapshot;
+/**
+ * Complete best-available tree traversal. `snapshotAtomicity` declares
+ * whether concurrent local/cross-context mutations are excluded while it is
+ * captured. Implementations must never expose aliased buffers.
+ */
+interface FileSystemSnapshot {
+    readonly version: FileSystemVersion;
+    readonly entries: readonly FileSystemSnapshotEntry[];
+}
+type FileSystemWriteMode = 'upsert' | 'create' | 'replace';
+interface FileSystemWriteOptions {
+    /** Defaults to upsert. */
+    readonly mode?: FileSystemWriteMode;
+    /** Defaults to false so structure creation is never implicit. */
+    readonly createParents?: boolean;
+    /** null means the entry must not exist; a token requires an exact match. */
+    readonly expectedVersion?: FileSystemVersion | null;
+}
+type FileSystemCreateDirectoryMode = 'ensure' | 'create';
+interface FileSystemCreateDirectoryOptions {
+    /** Defaults to ensure (idempotently return an existing directory). */
+    readonly mode?: FileSystemCreateDirectoryMode;
+    /** Defaults to false. */
+    readonly createParents?: boolean;
+}
+interface FileSystemRemoveOptions {
+    /** Defaults to false; non-empty directories otherwise fail with not-empty. */
+    readonly recursive?: boolean;
+    /** Defaults to error. */
+    readonly missing?: 'ignore' | 'error';
+    readonly expectedVersion?: FileSystemVersion;
+}
+interface FileSystemRemoveResult {
+    readonly removed: boolean;
+    /** Version of the complete tree after the removal attempt. */
+    readonly version: FileSystemVersion;
+}
+interface FileSystemMoveOptions {
+    /** Defaults to false. Destinations are never overwritten. */
+    readonly createParents?: boolean;
+    readonly expectedVersion?: FileSystemVersion;
+}
+type FileSystemWatchEventType = 'created' | 'modified' | 'removed' | 'moved' | 'overflow';
+type FileSystemWatchEventOrigin = 'local' | 'external' | 'unknown';
+interface FileSystemWatchEventBase {
+    readonly sequence: number;
+    readonly origin: FileSystemWatchEventOrigin;
+    readonly path: WorkspacePath;
+}
+interface FileSystemEntryWatchEvent extends FileSystemWatchEventBase {
+    readonly type: Exclude<FileSystemWatchEventType, 'overflow'>;
+    readonly kind: 'file' | 'directory';
+    readonly destinationPath: WorkspacePath | null;
+    readonly version: FileSystemVersion | null;
+    readonly previousVersion: FileSystemVersion | null;
+}
+interface FileSystemOverflowWatchEvent extends FileSystemWatchEventBase {
+    readonly type: 'overflow';
+    readonly kind: null;
+    readonly destinationPath: null;
+    readonly version: null;
+    readonly previousVersion: null;
+}
+type FileSystemWatchEvent = FileSystemEntryWatchEvent | FileSystemOverflowWatchEvent;
+type FileSystemWatchListener = (event: FileSystemWatchEvent) => void;
+type FileSystemWatchErrorListener = (error: FsError) => void;
+interface FileSystemWatchOptions {
+    readonly onError?: FileSystemWatchErrorListener;
+}
+interface FileSystemWatchSubscription {
+    readonly closed: boolean;
+    /** Resolves after the backend watch is installed and no initial event can be missed. */
+    readonly ready: Promise<void>;
+    /** Idempotent and awaitable so resource release can join provider shutdown. */
+    dispose(): Promise<void>;
+}
+/**
+ * Correctness-first filesystem contract. Every logical path has exactly one
+ * kind and one byte payload; conditional writes and lifecycle disposal are
+ * mandatory rather than optional provider extensions.
+ */
+interface FileSystemProviderV2 {
+    readonly id: string;
+    readonly label: string;
+    readonly capabilities: FileSystemProviderCapabilities;
+    /** Absence is represented only by null; permission/I/O/wrong-kind errors throw FsError. */
+    stat(path: WorkspacePath): Promise<FileSystemEntrySnapshot | null>;
+    /** Absence is represented only by null; a directory at path is type-mismatch. */
+    readFile(path: WorkspacePath): Promise<FileSystemFileRead | null>;
+    /** Missing paths and file paths throw; results are canonical and deterministic. */
+    readDirectory(path: WorkspacePath): Promise<readonly FileSystemEntrySnapshot[]>;
+    writeFile(path: WorkspacePath, data: ArrayBuffer | Uint8Array, options?: FileSystemWriteOptions): Promise<FileSystemFileSnapshot>;
+    createDirectory(path: WorkspacePath, options?: FileSystemCreateDirectoryOptions): Promise<FileSystemDirectorySnapshot>;
+    remove(path: WorkspacePath, options?: FileSystemRemoveOptions): Promise<FileSystemRemoveResult>;
+    move(oldPath: WorkspacePath, newPath: WorkspacePath, options?: FileSystemMoveOptions): Promise<FileSystemEntrySnapshot>;
+    snapshot(): Promise<FileSystemSnapshot>;
+    /**
+     * Always returns a disposable subscription. When `capabilities.watch` is
+     * false, `ready` rejects with `FsError('not-supported')` and `onError`
+     * observes the same failure; callers can therefore use one cleanup path.
+     */
+    watch(listener: FileSystemWatchListener, options?: FileSystemWatchOptions): FileSystemWatchSubscription;
+    dispose(): Promise<void>;
+}
+
+/**
+ * FileSystemProvider — abstract interface for a virtual filesystem.
+ *
+ * Legacy text-oriented facade retained while consumers migrate to
+ * FileSystemProviderV2. New persistence code must use the provider's `v2`
+ * contract so paths, errors, operation modes, and capabilities are explicit.
+ */
+
+interface FileEntry {
+    kind: 'file';
+    name: string;
+    path: string;
+}
+interface FolderEntry {
+    kind: 'directory';
+    name: string;
+    path: string;
+}
+type FileSystemEntry = FileEntry | FolderEntry;
+interface FileMeta {
+    name: string;
+    path: string;
+    size: number;
+    lastModified: string;
+}
+type FileCommitResult = {
+    status: 'committed';
+    version: string | null;
+} | {
+    status: 'conflict';
+    content: string | null;
+    version: string | null;
+};
+/**
+ * @deprecated Compatibility facade for external providers and older callers.
+ * Implement new backends with `FileSystemProviderV2`; built-in facades expose
+ * their authoritative implementation through `v2`.
+ */
+interface FileSystemProvider {
+    /** Unique identifier for this provider instance. */
+    readonly id: string;
+    /** Human-readable label (e.g., folder name or "Browser Storage"). */
+    readonly label: string;
+    /** Optional correctness-first implementation exposed during the v1-to-v2 migration. */
+    readonly v2?: FileSystemProviderV2;
+    /** Read the text content of a file. Returns null if the file doesn't exist. */
+    readFile(path: string): Promise<string | null>;
+    /** Write text content to a file, creating it (and parent dirs) if needed. */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Conditionally replace a text file when it still matches the caller's
+     * persisted baseline. Production providers implement this at their
+     * strongest available serialization boundary.
+     */
+    commitFile?(path: string, content: string, expectedContent: string | null): Promise<FileCommitResult>;
+    /**
+     * Legacy recursive removal of a file or directory subtree. Workspace root
+     * deletion is forbidden. Prefer v2 `remove({ recursive })`.
+     */
+    delete(path: string): Promise<void>;
+    /** Rename or move an entry. Rejects missing sources and existing destinations. */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** List immediate children of a directory. */
+    readDirectory(path: string): Promise<FileSystemEntry[]>;
+    /** Check whether a path exists. */
+    exists(path: string): Promise<boolean>;
+    /** Create a directory (and parents if needed). */
+    createDirectory(path: string): Promise<void>;
+    /** Get metadata for a file. Returns null if not found. */
+    stat(path: string): Promise<FileMeta | null>;
+    /** Read raw binary content. Returns null if not found. */
+    readBinary(path: string): Promise<ArrayBuffer | null>;
+    /** Write raw binary content. */
+    writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
+}
+type FileSystemProviderWithV2 = FileSystemProvider & {
+    readonly v2: FileSystemProviderV2;
+};
+/** Discover a provider-owned v2 implementation without coupling consumers to a concrete class. */
+declare function hasFileSystemProviderV2(provider: FileSystemProvider): provider is FileSystemProviderWithV2;
+/** Return the provider-owned v2 implementation when migration support is available. */
+declare function getFileSystemProviderV2(provider: FileSystemProvider): FileSystemProviderV2 | null;
+
+export { tryParseFileSystemVersion as $, type FileSystemVersion as A, type FileSystemWatchErrorListener as B, type FileSystemWatchEvent as C, type FileSystemWatchEventOrigin as D, type FileSystemWatchEventType as E, type FileCommitResult as F, type FileSystemWatchListener as G, type FileSystemWatchOptions as H, type FileSystemWatchSubscription as I, type FileSystemWriteMode as J, type FileSystemWriteOptions as K, type FolderEntry as L, FsError as M, type FsErrorCode as N, type FsErrorContext as O, type FsOperation as P, deserializeFsError as Q, fsErrorFromUnknown as R, type SerializedFsError as S, getFileSystemProviderV2 as T, hasFileSystemProviderV2 as U, isQuotaExceededError as V, isSerializedFsError as W, mapDomExceptionToFsErrorCode as X, mapNodeErrorCodeToFsErrorCode as Y, parseFileSystemVersion as Z, serializeFsError as _, type FileEntry as a, type FileMeta as b, type FileSystemAtomicity as c, type FileSystemCaseSensitivity as d, type FileSystemConditionalWriteStrength as e, type FileSystemCreateDirectoryMode as f, type FileSystemCreateDirectoryOptions as g, type FileSystemDirectorySnapshot as h, type FileSystemDurability as i, type FileSystemEntry as j, type FileSystemEntrySnapshot as k, type FileSystemEntryWatchEvent as l, type FileSystemFileRead as m, type FileSystemFileSnapshot as n, type FileSystemMoveOptions as o, type FileSystemOverflowWatchEvent as p, type FileSystemProvider as q, type FileSystemProviderCapabilities as r, type FileSystemProviderV2 as s, type FileSystemProviderWithV2 as t, type FileSystemRemoveOptions as u, type FileSystemRemoveResult as v, type FileSystemSnapshot as w, type FileSystemSnapshotEntry as x, type FileSystemSnapshotFile as y, type FileSystemSymlinkPolicy as z };