@storyshelf/core 0.7.0 → 0.8.0

package/dist/adapters/validate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validate.mjs","names":[],"sources":["../../src/adapters/validate.ts"],"sourcesContent":["/**\n * Boot-time adapter validation: fail fast on third-party adapters that\n * cannot satisfy their slot contract.\n *\n * Types alone cannot stop a bad adapter — this module checks shape at\n * runtime before any I/O runs. `createShelfApp` throws synchronously;\n * the lifecycle runner returns failures without executing hooks.\n */\nimport { z } from \"zod\";\nimport type { Auth } from \"../auth.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"./database.ts\";\nimport type { AdapterSetupFailure, AdapterSetupSources } from \"./setup.ts\";\n\nconst metadataSchema = z.object({\n  name: z.string().min(1),\n  version: z.string().min(1),\n  kind: z.string().min(1),\n  category: z.string().min(1),\n});\n\nconst DATABASE_METHODS = [\"insert\", \"update\", \"get\", \"remove\", \"list\", \"count\", \"all\"];\n\nconst STORAGE_METHODS = [\"read\", \"write\", \"delete\", \"exists\", \"list\", \"writeStream\", \"readStream\"];\n\nconst RUNNER_METHODS = [\"render\", \"cancel\"];\n\nconst QUEUE_METHODS = [\"enqueue\", \"status\", \"active\", \"recent\"];\n\n/** Unknown value narrowed to a property bag for shape checks. */\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null ? (value as Record<string, unknown>) : null;\n}\n\n/** String field of a record, or null when absent/non-string. */\nfunction stringField(record: Record<string, unknown> | null, key: string): string | null {\n  const value = record?.[key];\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Reasons the adapter identity fails for the expected slot. */\nfunction metadataReasons(adapter: Record<string, unknown>, expected: string): string[] {\n  const parsed = metadataSchema.safeParse(adapter[\"metadata\"]);\n  if (!parsed.success) {\n    return [`invalid metadata: ${parsed.error.issues.map((i) => i.path.join(\".\")).join(\",\")}`];\n  }\n  const category = (parsed.data as { category: string }).category;\n  return category === expected ? [] : [`category \"${category}\" does not match slot \"${expected}\"`];\n}\n\n/** Reasons the optional lifecycle violates the all-or-nothing rule. */\nfunction lifecycleReasons(adapter: Record<string, unknown>): string[] {\n  const lifecycle = adapter[\"lifecycle\"];\n  if (lifecycle === undefined) {\n    return [];\n  }\n  const hooks = asRecord(lifecycle);\n  if (!hooks) {\n    return [\"lifecycle must be an object with setup/teardown/health\"];\n  }\n  const missing = [\"setup\", \"teardown\", \"health\"].filter(\n    (hook) => typeof hooks[hook] !== \"function\",\n  );\n  return missing.length > 0 ? [`partial lifecycle (missing: ${missing.join(\",\")})`] : [];\n}\n\n/** Reasons the adapter lacks required slot methods. */\nfunction methodReasons(adapter: Record<string, unknown>, methods: string[]): string[] {\n  const missing = methods.filter((method) => typeof adapter[method] !== \"function\");\n  return missing.length > 0 ? [`missing methods: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a database adapter lacks its table map. */\nfunction tableReasons(adapter: Record<string, unknown>): string[] {\n  const tables = asRecord(adapter[\"tables\"]);\n  if (!tables) {\n    return [\"missing tables map\"];\n  }\n  const missing = REQUIRED_TABLE_KEYS.filter((table) => tables[table] === undefined);\n  return missing.length > 0 ? [`missing tables: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a queue adapter has a partial poll extension. */\nfunction queuePollReasons(record: Record<string, unknown>): string[] {\n  const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n  if (present.length === 0 || present.length === 3) {\n    const mistyped = [\"poll\", \"ack\", \"nack\"].filter(\n      (method) => record[method] !== undefined && typeof record[method] !== \"function\",\n    );\n    return mistyped.map((method) => `queue poll extension \"${method}\" must be a function`);\n  }\n  return [`partial poll extension (present: ${present.join(\",\")}; need poll+ack+nack)`];\n}\n\n/** Whether a metadata schema looks like a zod schema (has parse). */\nfunction hasSchemaParse(provider: unknown): boolean {\n  const schema = asRecord(asRecord(provider)?.[\"metadata\"])?.[\"schema\"];\n  return typeof (schema as { parse?: unknown } | undefined)?.parse === \"function\";\n}\n\n/** Reasons a notifier provider lacks its descriptor shape. */\nfunction notifierReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"notifier provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"create\"] !== \"function\") {\n    reasons.push(\"missing methods: create\");\n  }\n  if (!hasSchemaParse(provider)) {\n    reasons.push(\"metadata.schema must be a zod schema\");\n  }\n  return reasons;\n}\n\n/** Reasons an email sender lacks its transport shape. */\nfunction emailSenderReasons(sender: unknown): string[] {\n  const record = asRecord(sender);\n  if (!record) {\n    return [\"email sender must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"send\"] !== \"function\") {\n    reasons.push(\"missing methods: send\");\n  }\n  return reasons;\n}\n\n/** Reasons a design provider lacks its descriptor shape. */\nfunction designReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"design provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"design\");\n  const missing = [\"parseUrl\", \"create\"].filter((name) => typeof record[name] !== \"function\");\n  if (missing.length > 0) {\n    reasons.push(`missing methods: ${missing.join(\", \")}`);\n  }\n  return reasons;\n}\n\n/** Required methods for a slot category. */\nfunction slotMethods(category: string): string[] {\n  if (category === \"database\") {\n    return DATABASE_METHODS;\n  }\n  if (category === \"storage\") {\n    return STORAGE_METHODS;\n  }\n  if (category === \"capture-runner\") {\n    return RUNNER_METHODS;\n  }\n  return QUEUE_METHODS;\n}\n\n/** Extra per-slot reasons (table map for databases, poll rule for queues). */\nfunction slotExtraReasons(record: Record<string, unknown>, category: string): string[] {\n  if (category === \"database\") {\n    return tableReasons(record);\n  }\n  return category === \"capture-queue\" ? queuePollReasons(record) : [];\n}\n\n/**\n * Validate one adapter against its slot. Returns human-readable reasons\n * (empty when valid). Never throws — callers decide fail-fast vs collect.\n */\nexport function validateAdapter(\n  adapter: unknown,\n  expectedCategory: string,\n  slot: string,\n): string[] {\n  const record = asRecord(adapter);\n  if (!record) {\n    return [`${slot} adapter must be an object`];\n  }\n  const reasons = metadataReasons(record, expectedCategory).map((r) => `${slot}: ${r}`);\n  const extra = [\n    ...lifecycleReasons(record),\n    ...methodReasons(record, slotMethods(expectedCategory)),\n    ...slotExtraReasons(record, expectedCategory),\n  ];\n  for (const reason of extra) {\n    reasons.push(`${slot}: ${reason}`);\n  }\n  return reasons;\n}\n\n/** Auth surface methods every engine must expose. */\nconst AUTH_METHODS = [\n  \"handler\",\n  \"loginMethods\",\n  \"setup\",\n  \"issueInvite\",\n  \"verifyInvite\",\n  \"acceptInvite\",\n  \"passkeysEnabled\",\n  \"listSessions\",\n  \"listPasskeys\",\n  \"hasPassword\",\n  \"setDisabled\",\n  \"check\",\n  \"createSession\",\n  \"destroySession\",\n];\n\n/** Reasons a method-id list is unusable (blank or duplicate ids). */\nfunction methodIdReasons(ids: string[]): string[] {\n  const reasons: string[] = [];\n  if (ids.some((id) => id.length === 0)) {\n    reasons.push(\"login method with blank id\");\n  }\n  if (new Set(ids).size !== ids.length) {\n    reasons.push(\"duplicate login method ids\");\n  }\n  return reasons;\n}\n\n/** Reasons login method descriptors are unusable (duplicate/blank ids). */\nfunction loginMethodReasons(auth: Auth): string[] {\n  let ids: string[];\n  try {\n    ids = auth.loginMethods().map((method) => method.id);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return [`loginMethods() threw: ${message}`];\n  }\n  return methodIdReasons(ids);\n}\n\n/**\n * Validate the auth engine shape (auth is optional — undefined is valid).\n * Returns human-readable reasons, empty when sound.\n */\nexport function validateAuth(auth?: unknown): string[] {\n  if (auth === undefined) {\n    return [];\n  }\n  const record = asRecord(auth);\n  if (!record) {\n    return [\"auth must be an object\"];\n  }\n  const reasons = methodReasons(record, AUTH_METHODS).map((reason) => `auth: ${reason}`);\n  if (reasons.length === 0) {\n    for (const reason of loginMethodReasons(auth as Auth)) {\n      reasons.push(`auth: ${reason}`);\n    }\n  }\n  return reasons;\n}\n\n/** Failure entry for an invalid auth engine. */\nfunction checkAuth(auth: unknown): AdapterSetupFailure[] {\n  const reasons = validateAuth(auth);\n  if (reasons.length === 0) {\n    return [];\n  }\n  return [{ category: \"auth\", kind: \"auth\", name: \"auth\", error: reasons.join(\"; \") }];\n}\n\n/** One slot check for source validation. */\ninterface SlotCheck {\n  adapter: unknown;\n  category: string;\n  slot: string;\n}\n\n/** Descriptor check for provider lists (design providers, notifiers). */\ninterface ProviderCheck {\n  provider: unknown;\n  index: number;\n  kinds: \"design\" | \"notifier\";\n}\n\nconst PROVIDER_KINDS = {\n  design: { reasons: designReasons, list: \"design\", category: \"design\" },\n  notifier: { reasons: notifierReasons, list: \"notifiers\", category: \"notifier\" },\n} as const;\n\n/** Failures for design or notifier provider lists. */\nfunction checkProviders(checks: ProviderCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const kind = PROVIDER_KINDS[check.kinds];\n    const reasons = kind.reasons(check.provider);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const slot = `${kind.list}[${check.index}]`;\n    const metadata = asRecord(asRecord(check.provider)?.[\"metadata\"]);\n    failures.push({\n      category: kind.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? slot,\n      error: reasons.map((reason) => `${slot}: ${reason}`).join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/** Failure for the email sender slot. */\nfunction checkEmailSender(sender: unknown): AdapterSetupFailure[] {\n  if (sender === undefined) {\n    return [];\n  }\n  const reasons = emailSenderReasons(sender);\n  if (reasons.length === 0) {\n    return [];\n  }\n  const metadata = asRecord(asRecord(sender)?.[\"metadata\"]);\n  return [\n    {\n      category: \"notifier\",\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? \"emailSender\",\n      error: reasons.map((reason) => `emailSender: ${reason}`).join(\"; \"),\n    },\n  ];\n}\n\n/** Failures for the core database/storage/runner/queue slots. */\nfunction checkSlots(checks: SlotCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const reasons = validateAdapter(check.adapter, check.category, check.slot);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const metadata = asRecord(asRecord(check.adapter)?.[\"metadata\"]);\n    failures.push({\n      category: check.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? check.slot,\n      error: reasons.join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/**\n * Validate every adapter in the boot sources. Returns per-adapter failures\n * (empty when the whole assembly is sound).\n */\nexport function validateAdapterSources(sources: AdapterSetupSources): AdapterSetupFailure[] {\n  const checks: SlotCheck[] = [\n    { adapter: sources.database, category: \"database\", slot: \"database\" },\n    { adapter: sources.storage, category: \"storage\", slot: \"storage\" },\n  ];\n  if (sources.captureRunner !== undefined) {\n    checks.push({\n      adapter: sources.captureRunner,\n      category: \"capture-runner\",\n      slot: \"captureRunner\",\n    });\n  }\n  const providers: ProviderCheck[] = [\n    ...(sources.design ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"design\" as const,\n    })),\n    ...(sources.notifiers ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"notifier\" as const,\n    })),\n  ];\n  return [\n    ...checkSlots(checks),\n    ...checkProviders(providers),\n    ...checkEmailSender(sources.emailSender),\n  ];\n}\n\n/**\n * Validate a full boot assembly: adapters plus the optional auth engine.\n * App assembly calls this — `ShelfOptions` carries `auth` alongside the\n * adapter slots, and an invalid engine fails boot like any adapter.\n */\nexport function validateBootAssembly(\n  sources: AdapterSetupSources & { auth?: unknown },\n): AdapterSetupFailure[] {\n  return [...validateAdapterSources(sources), ...checkAuth(sources.auth)];\n}\n"],"mappings":"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"}
+{"version":3,"file":"validate.mjs","names":[],"sources":["../../src/adapters/validate.ts"],"sourcesContent":["/**\n * Boot-time adapter validation: fail fast on third-party adapters that\n * cannot satisfy their slot contract.\n *\n * Types alone cannot stop a bad adapter — this module checks shape at\n * runtime before any I/O runs. `createShelfApp` throws synchronously;\n * the lifecycle runner returns failures without executing hooks.\n */\nimport { z } from \"zod\";\nimport type { Auth } from \"../auth.ts\";\nimport { REQUIRED_TABLE_KEYS } from \"./database.ts\";\nimport type { AdapterSetupFailure, AdapterSetupSources } from \"./setup.ts\";\n\nconst metadataSchema = z.object({\n  name: z.string().min(1),\n  version: z.string().min(1),\n  kind: z.string().min(1),\n  category: z.string().min(1),\n});\n\nconst DATABASE_METHODS = [\n  \"insert\",\n  \"update\",\n  \"updateWhere\",\n  \"get\",\n  \"remove\",\n  \"list\",\n  \"count\",\n  \"all\",\n];\n\nconst STORAGE_METHODS = [\"read\", \"write\", \"delete\", \"exists\", \"list\", \"writeStream\", \"readStream\"];\n\nconst RUNNER_METHODS = [\"render\", \"cancel\"];\n\nconst QUEUE_METHODS = [\"enqueue\", \"status\", \"active\", \"recent\"];\n\n/** Unknown value narrowed to a property bag for shape checks. */\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null ? (value as Record<string, unknown>) : null;\n}\n\n/** String field of a record, or null when absent/non-string. */\nfunction stringField(record: Record<string, unknown> | null, key: string): string | null {\n  const value = record?.[key];\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Reasons the adapter identity fails for the expected slot. */\nfunction metadataReasons(adapter: Record<string, unknown>, expected: string): string[] {\n  const parsed = metadataSchema.safeParse(adapter[\"metadata\"]);\n  if (!parsed.success) {\n    return [`invalid metadata: ${parsed.error.issues.map((i) => i.path.join(\".\")).join(\",\")}`];\n  }\n  const category = (parsed.data as { category: string }).category;\n  return category === expected ? [] : [`category \"${category}\" does not match slot \"${expected}\"`];\n}\n\n/** Reasons the optional lifecycle violates the all-or-nothing rule. */\nfunction lifecycleReasons(adapter: Record<string, unknown>): string[] {\n  const lifecycle = adapter[\"lifecycle\"];\n  if (lifecycle === undefined) {\n    return [];\n  }\n  const hooks = asRecord(lifecycle);\n  if (!hooks) {\n    return [\"lifecycle must be an object with setup/teardown/health\"];\n  }\n  const missing = [\"setup\", \"teardown\", \"health\"].filter(\n    (hook) => typeof hooks[hook] !== \"function\",\n  );\n  return missing.length > 0 ? [`partial lifecycle (missing: ${missing.join(\",\")})`] : [];\n}\n\n/** Reasons the adapter lacks required slot methods. */\nfunction methodReasons(adapter: Record<string, unknown>, methods: string[]): string[] {\n  const missing = methods.filter((method) => typeof adapter[method] !== \"function\");\n  return missing.length > 0 ? [`missing methods: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a database adapter lacks its table map. */\nfunction tableReasons(adapter: Record<string, unknown>): string[] {\n  const tables = asRecord(adapter[\"tables\"]);\n  if (!tables) {\n    return [\"missing tables map\"];\n  }\n  const missing = REQUIRED_TABLE_KEYS.filter((table) => tables[table] === undefined);\n  return missing.length > 0 ? [`missing tables: ${missing.join(\",\")}`] : [];\n}\n\n/** Reasons a queue adapter has a partial poll extension. */\nfunction queuePollReasons(record: Record<string, unknown>): string[] {\n  const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n  if (present.length === 0 || present.length === 3) {\n    const mistyped = [\"poll\", \"ack\", \"nack\"].filter(\n      (method) => record[method] !== undefined && typeof record[method] !== \"function\",\n    );\n    return mistyped.map((method) => `queue poll extension \"${method}\" must be a function`);\n  }\n  return [`partial poll extension (present: ${present.join(\",\")}; need poll+ack+nack)`];\n}\n\n/** Whether a metadata schema looks like a zod schema (has parse). */\nfunction hasSchemaParse(provider: unknown): boolean {\n  const schema = asRecord(asRecord(provider)?.[\"metadata\"])?.[\"schema\"];\n  return typeof (schema as { parse?: unknown } | undefined)?.parse === \"function\";\n}\n\n/** Reasons a notifier provider lacks its descriptor shape. */\nfunction notifierReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"notifier provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"create\"] !== \"function\") {\n    reasons.push(\"missing methods: create\");\n  }\n  if (!hasSchemaParse(provider)) {\n    reasons.push(\"metadata.schema must be a zod schema\");\n  }\n  return reasons;\n}\n\n/** Reasons an email sender lacks its transport shape. */\nfunction emailSenderReasons(sender: unknown): string[] {\n  const record = asRecord(sender);\n  if (!record) {\n    return [\"email sender must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"notifier\");\n  if (typeof record[\"send\"] !== \"function\") {\n    reasons.push(\"missing methods: send\");\n  }\n  return reasons;\n}\n\n/** Reasons a design provider lacks its descriptor shape. */\nfunction designReasons(provider: unknown): string[] {\n  const record = asRecord(provider);\n  if (!record) {\n    return [\"design provider must be an object\"];\n  }\n  const reasons = metadataReasons(record, \"design\");\n  const missing = [\"parseUrl\", \"create\"].filter((name) => typeof record[name] !== \"function\");\n  if (missing.length > 0) {\n    reasons.push(`missing methods: ${missing.join(\", \")}`);\n  }\n  return reasons;\n}\n\n/** Required methods for a slot category. */\nfunction slotMethods(category: string): string[] {\n  if (category === \"database\") {\n    return DATABASE_METHODS;\n  }\n  if (category === \"storage\") {\n    return STORAGE_METHODS;\n  }\n  if (category === \"capture-runner\") {\n    return RUNNER_METHODS;\n  }\n  return QUEUE_METHODS;\n}\n\n/** Extra per-slot reasons (table map for databases, poll rule for queues). */\nfunction slotExtraReasons(record: Record<string, unknown>, category: string): string[] {\n  if (category === \"database\") {\n    return tableReasons(record);\n  }\n  return category === \"capture-queue\" ? queuePollReasons(record) : [];\n}\n\n/**\n * Validate one adapter against its slot. Returns human-readable reasons\n * (empty when valid). Never throws — callers decide fail-fast vs collect.\n */\nexport function validateAdapter(\n  adapter: unknown,\n  expectedCategory: string,\n  slot: string,\n): string[] {\n  const record = asRecord(adapter);\n  if (!record) {\n    return [`${slot} adapter must be an object`];\n  }\n  const reasons = metadataReasons(record, expectedCategory).map((r) => `${slot}: ${r}`);\n  const extra = [\n    ...lifecycleReasons(record),\n    ...methodReasons(record, slotMethods(expectedCategory)),\n    ...slotExtraReasons(record, expectedCategory),\n  ];\n  for (const reason of extra) {\n    reasons.push(`${slot}: ${reason}`);\n  }\n  return reasons;\n}\n\n/** Auth surface methods every engine must expose. */\nconst AUTH_METHODS = [\n  \"handler\",\n  \"loginMethods\",\n  \"setup\",\n  \"issueInvite\",\n  \"verifyInvite\",\n  \"acceptInvite\",\n  \"passkeysEnabled\",\n  \"listSessions\",\n  \"listPasskeys\",\n  \"hasPassword\",\n  \"setDisabled\",\n  \"check\",\n  \"createSession\",\n  \"destroySession\",\n];\n\n/** Reasons a method-id list is unusable (blank or duplicate ids). */\nfunction methodIdReasons(ids: string[]): string[] {\n  const reasons: string[] = [];\n  if (ids.some((id) => id.length === 0)) {\n    reasons.push(\"login method with blank id\");\n  }\n  if (new Set(ids).size !== ids.length) {\n    reasons.push(\"duplicate login method ids\");\n  }\n  return reasons;\n}\n\n/** Reasons login method descriptors are unusable (duplicate/blank ids). */\nfunction loginMethodReasons(auth: Auth): string[] {\n  let ids: string[];\n  try {\n    ids = auth.loginMethods().map((method) => method.id);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return [`loginMethods() threw: ${message}`];\n  }\n  return methodIdReasons(ids);\n}\n\n/**\n * Validate the auth engine shape (auth is optional — undefined is valid).\n * Returns human-readable reasons, empty when sound.\n */\nexport function validateAuth(auth?: unknown): string[] {\n  if (auth === undefined) {\n    return [];\n  }\n  const record = asRecord(auth);\n  if (!record) {\n    return [\"auth must be an object\"];\n  }\n  const reasons = methodReasons(record, AUTH_METHODS).map((reason) => `auth: ${reason}`);\n  if (reasons.length === 0) {\n    for (const reason of loginMethodReasons(auth as Auth)) {\n      reasons.push(`auth: ${reason}`);\n    }\n  }\n  return reasons;\n}\n\n/** Failure entry for an invalid auth engine. */\nfunction checkAuth(auth: unknown): AdapterSetupFailure[] {\n  const reasons = validateAuth(auth);\n  if (reasons.length === 0) {\n    return [];\n  }\n  return [{ category: \"auth\", kind: \"auth\", name: \"auth\", error: reasons.join(\"; \") }];\n}\n\n/** One slot check for source validation. */\ninterface SlotCheck {\n  adapter: unknown;\n  category: string;\n  slot: string;\n}\n\n/** Descriptor check for provider lists (design providers, notifiers). */\ninterface ProviderCheck {\n  provider: unknown;\n  index: number;\n  kinds: \"design\" | \"notifier\";\n}\n\nconst PROVIDER_KINDS = {\n  design: { reasons: designReasons, list: \"design\", category: \"design\" },\n  notifier: { reasons: notifierReasons, list: \"notifiers\", category: \"notifier\" },\n} as const;\n\n/** Failures for design or notifier provider lists. */\nfunction checkProviders(checks: ProviderCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const kind = PROVIDER_KINDS[check.kinds];\n    const reasons = kind.reasons(check.provider);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const slot = `${kind.list}[${check.index}]`;\n    const metadata = asRecord(asRecord(check.provider)?.[\"metadata\"]);\n    failures.push({\n      category: kind.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? slot,\n      error: reasons.map((reason) => `${slot}: ${reason}`).join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/** Failure for the email sender slot. */\nfunction checkEmailSender(sender: unknown): AdapterSetupFailure[] {\n  if (sender === undefined) {\n    return [];\n  }\n  const reasons = emailSenderReasons(sender);\n  if (reasons.length === 0) {\n    return [];\n  }\n  const metadata = asRecord(asRecord(sender)?.[\"metadata\"]);\n  return [\n    {\n      category: \"notifier\",\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? \"emailSender\",\n      error: reasons.map((reason) => `emailSender: ${reason}`).join(\"; \"),\n    },\n  ];\n}\n\n/** Failures for the core database/storage/runner/queue slots. */\nfunction checkSlots(checks: SlotCheck[]): AdapterSetupFailure[] {\n  const failures: AdapterSetupFailure[] = [];\n  for (const check of checks) {\n    const reasons = validateAdapter(check.adapter, check.category, check.slot);\n    if (reasons.length === 0) {\n      continue;\n    }\n    const metadata = asRecord(asRecord(check.adapter)?.[\"metadata\"]);\n    failures.push({\n      category: check.category,\n      kind: stringField(metadata, \"kind\") ?? \"unknown\",\n      name: stringField(metadata, \"name\") ?? check.slot,\n      error: reasons.join(\"; \"),\n    });\n  }\n  return failures;\n}\n\n/**\n * Validate every adapter in the boot sources. Returns per-adapter failures\n * (empty when the whole assembly is sound).\n */\nexport function validateAdapterSources(sources: AdapterSetupSources): AdapterSetupFailure[] {\n  const checks: SlotCheck[] = [\n    { adapter: sources.database, category: \"database\", slot: \"database\" },\n    { adapter: sources.storage, category: \"storage\", slot: \"storage\" },\n  ];\n  if (sources.captureRunner !== undefined) {\n    checks.push({\n      adapter: sources.captureRunner,\n      category: \"capture-runner\",\n      slot: \"captureRunner\",\n    });\n  }\n  const providers: ProviderCheck[] = [\n    ...(sources.design ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"design\" as const,\n    })),\n    ...(sources.notifiers ?? []).map((provider, index) => ({\n      provider,\n      index,\n      kinds: \"notifier\" as const,\n    })),\n  ];\n  return [\n    ...checkSlots(checks),\n    ...checkProviders(providers),\n    ...checkEmailSender(sources.emailSender),\n  ];\n}\n\n/**\n * Validate a full boot assembly: adapters plus the optional auth engine.\n * App assembly calls this — `ShelfOptions` carries `auth` alongside the\n * adapter slots, and an invalid engine fails boot like any adapter.\n */\nexport function validateBootAssembly(\n  sources: AdapterSetupSources & { auth?: unknown },\n): AdapterSetupFailure[] {\n  return [...validateAdapterSources(sources), ...checkAuth(sources.auth)];\n}\n"],"mappings":"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"}

package/dist/ai.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Logger } from "./logger.mjs";
 import { EvidenceLimits } from "./insights/limits.mjs";
 import { z } from "zod";
-//#region src/ai.d.ts
 /** Tasks the AI surface routes: build triage and project health. */
 type AiTask = "triage" | "health";
 /** One screenshot sent to a vision-capable model. */
@@ -100,6 +99,5 @@ interface Ai {
   /** Release resources (unregisters nothing global). */
   teardown(): Promise<void>;
 }
-//#endregion
 export { Ai, AiBudget, AiError, AiErrorCode, AiEvidence, AiHealth, AiImage, AiSummarizeInput, AiSummarizeResult, AiTask, AiUsageReport };
 //# sourceMappingURL=ai.d.mts.map

package/dist/ai.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/ai.ts
+// src/ai.ts
 /** Failure from {@link Ai.summarize}; carries usage the provider still billed. */
 var AiError = class extends Error {
 	code;
@@ -13,7 +13,6 @@ var AiError = class extends Error {
 		this.name = "AiError";
 	}
 };
-//#endregion
 export { AiError };
 
 //# sourceMappingURL=ai.mjs.map

package/dist/auth.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { AuthUser } from "./types.mjs";
-//#region src/auth.d.ts
 /** Login widget kinds in display order (the shelf plugin contract). */
 type EngineLoginMethodKind = "password" | "oauth" | "passkey" | "sso";
 /**
@@ -96,6 +95,5 @@ declare const MIN_PASSWORD_LENGTH = 12;
  * Single shared parser: cookies, CSRF binding, and table lookups must agree.
  */
 declare function unsignedToken(value: string): string;
-//#endregion
 export { Auth, EngineLoginMethod, EngineLoginMethodKind, EnginePasskeyInfo, EngineSessionInfo, MIN_PASSWORD_LENGTH, unsignedToken };
 //# sourceMappingURL=auth.d.mts.map

package/dist/auth.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/auth.ts
+// src/auth.ts
 /** Minimum password length for local accounts (matches legacy policy). */
 const MIN_PASSWORD_LENGTH = 12;
 /**
@@ -11,7 +11,6 @@ const MIN_PASSWORD_LENGTH = 12;
 function unsignedToken(value) {
 	return value.split(".")[0] ?? "";
 }
-//#endregion
 export { MIN_PASSWORD_LENGTH, unsignedToken };
 
 //# sourceMappingURL=auth.mjs.map

package/dist/brand-packs.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BrandTheme } from "./config.mjs";
-//#region src/brand-packs.d.ts
 /** One named light/dark theme pair. */
 interface BrandPack {
   light: BrandTheme;
@@ -11,6 +10,5 @@ interface BrandPack {
 declare const brandPacks: Record<string, BrandPack>;
 /** Look up a brand pack by name (undefined for unknown names). */
 declare function brandPack(name: string): BrandPack | undefined;
-//#endregion
 export { BrandPack, brandPack, brandPacks };
 //# sourceMappingURL=brand-packs.d.mts.map

package/dist/brand-packs.mjs

@@ -124,7 +124,6 @@ const brandPacks = {
 function brandPack(name) {
 	return brandPacks[name];
 }
-//#endregion
 export { brandPack, brandPacks };
 
 //# sourceMappingURL=brand-packs.mjs.map

package/dist/capture/a11y/axe-source.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/a11y/axe-source.d.ts
 /** Lazy, cached loader for the axe-core browser bundle. */
 /**
  * Read `axe.min.js` (~550 KB) once per process, on first use. Lazy on purpose: servers that never run
@@ -13,6 +12,5 @@ declare function loadAxeSource(): Promise<string>;
  * source travels over the wire instead of a file path).
  */
 declare function axeInjectionScript(source: string): string;
-//#endregion
 export { axeInjectionScript, loadAxeSource };
 //# sourceMappingURL=axe-source.d.mts.map

package/dist/capture/a11y/axe-source.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
-//#region src/capture/a11y/axe-source.ts
+// src/capture/a11y/axe-source.ts
 /** Lazy, cached loader for the axe-core browser bundle. */
 let cached;
 /**
@@ -31,7 +31,6 @@ async function readAxeSource() {
 	const path = createRequire(import.meta.url).resolve("axe-core/axe.min.js");
 	return await readFile(path, "utf8");
 }
-//#endregion
 export { axeInjectionScript, loadAxeSource };
 
 //# sourceMappingURL=axe-source.mjs.map

package/dist/capture/a11y/in-page.d.mts

@@ -2,11 +2,10 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { SlimViolation } from "./map.mjs";
 import { A11yRunPlan } from "./options.mjs";
-//#region src/capture/a11y/in-page.d.ts
 /** What {@link inPageReadA11yParameters} found: the plain-data `parameters.a11y` and what was dropped. */
 interface A11yParametersRead {
   params: unknown;
-  /** Function values (and items that held nothing else) left out because a page cannot hand them over. */
+  /** Function, symbol and undefined values left out because a page cannot hand them over. */
   dropped: number;
 }
 /**
@@ -22,6 +21,5 @@ declare function inPageReadA11yParameters(): A11yParametersRead | undefined;
  * target, node count). Throws when axe is not present in the page.
  */
 declare function inPageRunAxe(plan: A11yRunPlan): Promise<SlimViolation[]>;
-//#endregion
 export { A11yParametersRead, inPageReadA11yParameters, inPageRunAxe };
 //# sourceMappingURL=in-page.d.mts.map

package/dist/capture/a11y/in-page.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/a11y/in-page.ts
+// src/capture/a11y/in-page.ts
 /**
 * Read the current story's `parameters.a11y` from the running Storybook preview as plain data.
 * Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are
@@ -29,8 +29,8 @@ function inPageReadA11yParameters() {
 	};
 	try {
 		const params = clean(a11y, 0);
-		return params === DROP ? void 0 : {
-			params,
+		return {
+			params: params === DROP ? void 0 : params,
 			dropped: state.dropped
 		};
 	} catch {
@@ -54,7 +54,6 @@ async function inPageRunAxe(plan) {
 		count: v.nodes.length
 	}));
 }
-//#endregion
 export { inPageReadA11yParameters, inPageRunAxe };
 
 //# sourceMappingURL=in-page.mjs.map

package/dist/capture/a11y/in-page.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"in-page.mjs","names":["win"],"sources":["../../../src/capture/a11y/in-page.ts"],"sourcesContent":["/**\n * Functions evaluated inside the story page. Playwright and Puppeteer serialise only a function's\n * source, so each must stay ONE self-contained function: no imports, helpers or module bindings\n * (`in-page.test.ts` rebuilds them from source in a bare scope to guard that).\n */\n\nimport type { SlimViolation } from \"./map.ts\";\nimport type { A11yRunPlan } from \"./options.ts\";\n\n/** What {@link inPageReadA11yParameters} found: the plain-data `parameters.a11y` and what was dropped. */\nexport interface A11yParametersRead {\n  params: unknown;\n  /** Function values (and items that held nothing else) left out because a page cannot hand them over. */\n  dropped: number;\n}\n\n/**\n * Read the current story's `parameters.a11y` from the running Storybook preview as plain data.\n * Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are\n * dropped, and an object or array item that held nothing else goes with them (an emptied rule item\n * would otherwise reset to axe's default). Returns undefined when there is no `a11y` parameter or it\n * cannot be read at all (cyclic).\n */\n// oxlint-disable-next-line eslint/max-statements -- must stay one self-contained function (see above)\nexport function inPageReadA11yParameters(): A11yParametersRead | undefined {\n  const win = globalThis as unknown as {\n    // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n    __STORYBOOK_PREVIEW__?: {\n      currentRender?: { story?: { parameters?: { a11y?: unknown } } };\n    };\n  };\n  // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n  const a11y = win.__STORYBOOK_PREVIEW__?.currentRender?.story?.parameters?.a11y;\n  if (a11y === undefined) return undefined;\n  const state = { dropped: 0 };\n  const DROP = Symbol(\"drop\");\n  const clean = (value: unknown, depth: number): unknown => {\n    if (depth > 32) throw new Error(\"too deep\");\n    if (typeof value === \"function\" || typeof value === \"symbol\" || value === undefined) {\n      state.dropped += 1;\n      return DROP;\n    }\n    if (value === null || typeof value !== \"object\") return value;\n    const before = state.dropped;\n    const entries: [string, unknown][] = Array.isArray(value)\n      ? value.map((item, index): [string, unknown] => [String(index), item])\n      : Object.entries(value);\n    const kept = entries\n      .map(([key, item]): [string, unknown] => [key, clean(item, depth + 1)])\n      .filter(([, item]) => item !== DROP);\n    if (kept.length === 0 && entries.length > 0 && state.dropped > before) return DROP;\n    return Array.isArray(value) ? kept.map(([, item]) => item) : Object.fromEntries(kept);\n  };\n  try {\n    const params = clean(a11y, 0);\n    return params === DROP ? undefined : { params, dropped: state.dropped };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Run the injected axe over the plan's context and return only slim fields (id, impact, help, first\n * target, node count). Throws when axe is not present in the page.\n */\n// oxlint-disable-next-line eslint/max-statements, eslint/max-lines-per-function -- must stay one self-contained function (see above)\nexport async function inPageRunAxe(plan: A11yRunPlan): Promise<SlimViolation[]> {\n  const win = globalThis as unknown as {\n    axe?: {\n      configure: (config: unknown) => void;\n      run: (context: unknown, options: unknown) => Promise<{ violations: AxeViolation[] }>;\n    };\n    document: { querySelector: (selector: string) => unknown };\n  };\n  interface AxeViolation {\n    id: string;\n    impact?: string | null;\n    help: string;\n    nodes: { target: unknown[] }[];\n  }\n  if (!win.axe) throw new Error(\"axe is not loaded in the page\");\n  if (typeof plan.context === \"string\" && !win.document.querySelector(plan.context)) return [];\n  if (Object.keys(plan.config).length > 0) win.axe.configure(plan.config);\n  const results = await win.axe.run(plan.context, plan.options);\n  return results.violations.map((v) => ({\n    id: v.id,\n    impact: v.impact ?? null,\n    help: v.help,\n    target: (v.nodes[0]?.target ?? []).flat(Infinity).join(\" \"),\n    count: v.nodes.length,\n  }));\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,2BAA2D;CAQzE,MAAM,OAAOA,WAAI,uBAAuB,eAAe,OAAO,YAAY;CAC1E,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,MAAM,QAAQ,EAAE,SAAS,EAAE;CAC3B,MAAM,OAAO,OAAO,MAAM;CAC1B,MAAM,SAAS,OAAgB,UAA2B;EACxD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,UAAU;EAC1C,IAAI,OAAO,UAAU,cAAc,OAAO,UAAU,YAAY,UAAU,KAAA,GAAW;GACnF,MAAM,WAAW;GACjB,OAAO;EACT;EACA,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;EACxD,MAAM,SAAS,MAAM;EACrB,MAAM,UAA+B,MAAM,QAAQ,KAAK,IACpD,MAAM,KAAK,MAAM,UAA6B,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC,IACnE,OAAO,QAAQ,KAAK;EACxB,MAAM,OAAO,QACV,KAAK,CAAC,KAAK,UAA6B,CAAC,KAAK,MAAM,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,CACtE,QAAQ,GAAG,UAAU,SAAS,IAAI;EACrC,IAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,KAAK,MAAM,UAAU,QAAQ,OAAO;EAC9E,OAAO,MAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,GAAG,UAAU,IAAI,IAAI,OAAO,YAAY,IAAI;CACtF;CACA,IAAI;EACF,MAAM,SAAS,MAAM,MAAM,CAAC;EAC5B,OAAO,WAAW,OAAO,KAAA,IAAY;GAAE;GAAQ,SAAS,MAAM;EAAQ;CACxE,QAAQ;EACN;CACF;AACF;;;;;AAOA,eAAsB,aAAa,MAA6C;CAC9E,MAAM,MAAM;CAaZ,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,+BAA+B;CAC7D,IAAI,OAAO,KAAK,YAAY,YAAY,CAAC,IAAI,SAAS,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC;CAC3F,IAAI,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,UAAU,KAAK,MAAM;CAEtE,QAAO,MADe,IAAI,IAAI,IAAI,KAAK,SAAS,KAAK,OAAO,EAAA,CAC7C,WAAW,KAAK,OAAO;EACpC,IAAI,EAAE;EACN,QAAQ,EAAE,UAAU;EACpB,MAAM,EAAE;EACR,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAA,CAAG,KAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;EAC1D,OAAO,EAAE,MAAM;CACjB,EAAE;AACJ"}
+{"version":3,"file":"in-page.mjs","names":["win"],"sources":["../../../src/capture/a11y/in-page.ts"],"sourcesContent":["/**\n * Functions evaluated inside the story page. Playwright and Puppeteer serialise only a function's\n * source, so each must stay ONE self-contained function: no imports, helpers or module bindings\n * (`in-page.test.ts` rebuilds them from source in a bare scope to guard that).\n */\n\nimport type { SlimViolation } from \"./map.ts\";\nimport type { A11yRunPlan } from \"./options.ts\";\n\n/** What {@link inPageReadA11yParameters} found: the plain-data `parameters.a11y` and what was dropped. */\nexport interface A11yParametersRead {\n  params: unknown;\n  /** Function, symbol and undefined values left out because a page cannot hand them over. */\n  dropped: number;\n}\n\n/**\n * Read the current story's `parameters.a11y` from the running Storybook preview as plain data.\n * Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are\n * dropped, and an object or array item that held nothing else goes with them (an emptied rule item\n * would otherwise reset to axe's default). Returns undefined when there is no `a11y` parameter or it\n * cannot be read at all (cyclic).\n */\n// oxlint-disable-next-line eslint/max-statements -- must stay one self-contained function (see above)\nexport function inPageReadA11yParameters(): A11yParametersRead | undefined {\n  const win = globalThis as unknown as {\n    // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n    __STORYBOOK_PREVIEW__?: {\n      currentRender?: { story?: { parameters?: { a11y?: unknown } } };\n    };\n  };\n  // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n  const a11y = win.__STORYBOOK_PREVIEW__?.currentRender?.story?.parameters?.a11y;\n  if (a11y === undefined) return undefined;\n  const state = { dropped: 0 };\n  const DROP = Symbol(\"drop\");\n  const clean = (value: unknown, depth: number): unknown => {\n    if (depth > 32) throw new Error(\"too deep\");\n    if (typeof value === \"function\" || typeof value === \"symbol\" || value === undefined) {\n      state.dropped += 1;\n      return DROP;\n    }\n    if (value === null || typeof value !== \"object\") return value;\n    const before = state.dropped;\n    const entries: [string, unknown][] = Array.isArray(value)\n      ? value.map((item, index): [string, unknown] => [String(index), item])\n      : Object.entries(value);\n    const kept = entries\n      .map(([key, item]): [string, unknown] => [key, clean(item, depth + 1)])\n      .filter(([, item]) => item !== DROP);\n    if (kept.length === 0 && entries.length > 0 && state.dropped > before) return DROP;\n    return Array.isArray(value) ? kept.map(([, item]) => item) : Object.fromEntries(kept);\n  };\n  try {\n    const params = clean(a11y, 0);\n    return { params: params === DROP ? undefined : params, dropped: state.dropped };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Run the injected axe over the plan's context and return only slim fields (id, impact, help, first\n * target, node count). Throws when axe is not present in the page.\n */\n// oxlint-disable-next-line eslint/max-statements, eslint/max-lines-per-function -- must stay one self-contained function (see above)\nexport async function inPageRunAxe(plan: A11yRunPlan): Promise<SlimViolation[]> {\n  const win = globalThis as unknown as {\n    axe?: {\n      configure: (config: unknown) => void;\n      run: (context: unknown, options: unknown) => Promise<{ violations: AxeViolation[] }>;\n    };\n    document: { querySelector: (selector: string) => unknown };\n  };\n  interface AxeViolation {\n    id: string;\n    impact?: string | null;\n    help: string;\n    nodes: { target: unknown[] }[];\n  }\n  if (!win.axe) throw new Error(\"axe is not loaded in the page\");\n  if (typeof plan.context === \"string\" && !win.document.querySelector(plan.context)) return [];\n  if (Object.keys(plan.config).length > 0) win.axe.configure(plan.config);\n  const results = await win.axe.run(plan.context, plan.options);\n  return results.violations.map((v) => ({\n    id: v.id,\n    impact: v.impact ?? null,\n    help: v.help,\n    target: (v.nodes[0]?.target ?? []).flat(Infinity).join(\" \"),\n    count: v.nodes.length,\n  }));\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,2BAA2D;CAQzE,MAAM,OAAOA,WAAI,uBAAuB,eAAe,OAAO,YAAY;CAC1E,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,MAAM,QAAQ,EAAE,SAAS,EAAE;CAC3B,MAAM,OAAO,OAAO,MAAM;CAC1B,MAAM,SAAS,OAAgB,UAA2B;EACxD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,UAAU;EAC1C,IAAI,OAAO,UAAU,cAAc,OAAO,UAAU,YAAY,UAAU,KAAA,GAAW;GACnF,MAAM,WAAW;GACjB,OAAO;EACT;EACA,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;EACxD,MAAM,SAAS,MAAM;EACrB,MAAM,UAA+B,MAAM,QAAQ,KAAK,IACpD,MAAM,KAAK,MAAM,UAA6B,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC,IACnE,OAAO,QAAQ,KAAK;EACxB,MAAM,OAAO,QACV,KAAK,CAAC,KAAK,UAA6B,CAAC,KAAK,MAAM,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,CACtE,QAAQ,GAAG,UAAU,SAAS,IAAI;EACrC,IAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,KAAK,MAAM,UAAU,QAAQ,OAAO;EAC9E,OAAO,MAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,GAAG,UAAU,IAAI,IAAI,OAAO,YAAY,IAAI;CACtF;CACA,IAAI;EACF,MAAM,SAAS,MAAM,MAAM,CAAC;EAC5B,OAAO;GAAE,QAAQ,WAAW,OAAO,KAAA,IAAY;GAAQ,SAAS,MAAM;EAAQ;CAChF,QAAQ;EACN;CACF;AACF;;;;;AAOA,eAAsB,aAAa,MAA6C;CAC9E,MAAM,MAAM;CAaZ,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,+BAA+B;CAC7D,IAAI,OAAO,KAAK,YAAY,YAAY,CAAC,IAAI,SAAS,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC;CAC3F,IAAI,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,UAAU,KAAK,MAAM;CAEtE,QAAO,MADe,IAAI,IAAI,IAAI,KAAK,SAAS,KAAK,OAAO,EAAA,CAC7C,WAAW,KAAK,OAAO;EACpC,IAAI,EAAE;EACN,QAAQ,EAAE,UAAU;EACpB,MAAM,EAAE;EACR,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAA,CAAG,KAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;EAC1D,OAAO,EAAE,MAAM;CACjB,EAAE;AACJ"}

package/dist/capture/a11y/map.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/a11y/map.d.ts
 /** Map slim in-page axe results to `a11y:` violation strings. */
 /** Most violations reported per snapshot; the rest collapse into "…and N more". */
 declare const MAX_REPORTED_VIOLATIONS = 10;
@@ -19,6 +18,5 @@ interface SlimViolation {
  * first. `;` is reserved (the pipeline joins annotations with it), so it never appears in a string.
  */
 declare function mapAxeViolations(violations: readonly SlimViolation[]): string[];
-//#endregion
 export { MAX_REPORTED_VIOLATIONS, SlimViolation, mapAxeViolations };
 //# sourceMappingURL=map.d.mts.map

package/dist/capture/a11y/map.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/a11y/map.ts
+// src/capture/a11y/map.ts
 /** Map slim in-page axe results to `a11y:` violation strings. */
 /** Most violations reported per snapshot; the rest collapse into "…and N more". */
 const MAX_REPORTED_VIOLATIONS = 10;
@@ -42,7 +42,6 @@ function truncate(text, max) {
 function clean(text) {
 	return text.replaceAll(/\s+/gu, " ").replaceAll(";", ",");
 }
-//#endregion
 export { MAX_REPORTED_VIOLATIONS, mapAxeViolations };
 
 //# sourceMappingURL=map.mjs.map

package/dist/capture/a11y/options.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/a11y/options.d.ts
 /** Turn Storybook's `parameters.a11y` into an axe run plan. */
 /** The story root axe scans unless `parameters.a11y.element`/`context` says otherwise. */
 declare const A11Y_ROOT_SELECTOR = "#storybook-root";
@@ -18,6 +17,5 @@ interface A11yRunPlan {
  * still only annotate, results never fail a build.
  */
 declare function resolveA11yRun(raw: unknown): A11yRunPlan;
-//#endregion
 export { A11Y_ROOT_SELECTOR, A11yRunPlan, resolveA11yRun };
 //# sourceMappingURL=options.d.mts.map

package/dist/capture/a11y/options.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/a11y/options.ts
+// src/capture/a11y/options.ts
 /** Turn Storybook's `parameters.a11y` into an axe run plan. */
 /** The story root axe scans unless `parameters.a11y.element`/`context` says otherwise. */
 const A11Y_ROOT_SELECTOR = "#storybook-root";
@@ -69,7 +69,6 @@ function skipReason(params) {
 function asRecord(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
-//#endregion
 export { A11Y_ROOT_SELECTOR, resolveA11yRun };
 
 //# sourceMappingURL=options.mjs.map

package/dist/capture/adapter.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DepGraph } from "@storyshelf/affected";
-//#region src/capture/adapter.d.ts
 /** A custom viewport registered on a story via `parameters.viewport`. */
 interface StoryViewportDefinition {
   name?: string;
@@ -56,6 +55,11 @@ interface StoryParameters {
   waitForFonts?: boolean;
   /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */
   viewport?: StoryViewportConfig;
+  /**
+   * CSS selectors hidden (`visibility: hidden`) before the screenshot. `storyshelf` replaces
+   * `chromatic`; `[data-storyshelf-ignore]` and the Chromatic markers always apply.
+   */
+  ignoreSelectors?: string[];
   /** Named modes: extra captures of this story under different globals/viewports. */
   modes?: ModeMap;
 }
@@ -126,6 +130,5 @@ interface Viewport {
 }
 /** Default viewport used when none is configured. */
 declare const DEFAULT_VIEWPORTS: Viewport[];
-//#endregion
 export { CapturePage, DEFAULT_VIEWPORTS, DiscoverOptions, ModeDefinition, ModeMap, ModeViewportValue, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory };
 //# sourceMappingURL=adapter.d.mts.map

package/dist/capture/adapter.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/adapter.ts
+// src/capture/adapter.ts
 /** Return whether a story is marked flaky (failures stay non-blocking). */
 function isFlakyStory(entry) {
 	if (entry.parameters?.flakyTest) return true;
@@ -25,7 +25,6 @@ const DEFAULT_VIEWPORTS = [{
 	width: 1280,
 	height: 720
 }];
-//#endregion
 export { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory };
 
 //# sourceMappingURL=adapter.mjs.map

package/dist/capture/adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */\nexport type ModeViewportValue = number | string | { width: number; height: number };\n\n/**\n * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the\n * page, `disable` removes an inherited mode, every other key is a Storybook\n * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.\n */\nexport interface ModeDefinition {\n  viewport?: ModeViewportValue;\n  disable?: boolean;\n  [global: string]: unknown;\n}\n\n/** Named modes keyed by display name (the slug of the name is the baseline identity). */\nexport type ModeMap = Record<string, ModeDefinition>;\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n  /** Named modes: extra captures of this story under different globals/viewports. */\n  modes?: ModeMap;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  /**\n   * Set on a Storybook 10 `.test()` entry (index `subtype: \"test\"`): the id of the story it is\n   * written under. Test entries are never captured; a project that runs tests runs them in the\n   * iframe (ADR 0004, decision 10).\n   */\n  parentId?: string;\n  parameters?: StoryParameters;\n  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */\n  designUrl?: string;\n  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */\n  designInvalid?: string;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Optional discovery inputs. */\nexport interface DiscoverOptions {\n  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */\n  parseDesignUrl?: (raw: string) => { url: string } | null;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n  /** Storybook globals applied for this capture (set for modes only). */\n  globals?: Record<string, unknown>;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AA+DA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAsEA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}
+{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */\nexport type ModeViewportValue = number | string | { width: number; height: number };\n\n/**\n * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the\n * page, `disable` removes an inherited mode, every other key is a Storybook\n * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.\n */\nexport interface ModeDefinition {\n  viewport?: ModeViewportValue;\n  disable?: boolean;\n  [global: string]: unknown;\n}\n\n/** Named modes keyed by display name (the slug of the name is the baseline identity). */\nexport type ModeMap = Record<string, ModeDefinition>;\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n  /**\n   * CSS selectors hidden (`visibility: hidden`) before the screenshot. `storyshelf` replaces\n   * `chromatic`; `[data-storyshelf-ignore]` and the Chromatic markers always apply.\n   */\n  ignoreSelectors?: string[];\n  /** Named modes: extra captures of this story under different globals/viewports. */\n  modes?: ModeMap;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  /**\n   * Set on a Storybook 10 `.test()` entry (index `subtype: \"test\"`): the id of the story it is\n   * written under. Test entries are never captured; a project that runs tests runs them in the\n   * iframe (ADR 0004, decision 10).\n   */\n  parentId?: string;\n  parameters?: StoryParameters;\n  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */\n  designUrl?: string;\n  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */\n  designInvalid?: string;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Optional discovery inputs. */\nexport interface DiscoverOptions {\n  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */\n  parseDesignUrl?: (raw: string) => { url: string } | null;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n  /** Storybook globals applied for this capture (set for modes only). */\n  globals?: Record<string, unknown>;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AAoEA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAsEA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}

package/dist/capture/affected.d.mts

@@ -4,7 +4,6 @@ import { StoryEntry, Viewport } from "./adapter.mjs";
 import "../adapter/database.mjs";
 import { Baseline } from "../schema/baseline.mjs";
 import "../models/baseline.mjs";
-//#region src/capture/affected.d.ts
 /** An inherit candidate paired with the baseline it reuses. */
 interface InheritedStory {
   story: StoryEntry;
@@ -13,6 +12,5 @@ interface InheritedStory {
   /** Engine whose baseline is reused (chromium when absent). */
   browser?: string;
 }
-//#endregion
 export { InheritedStory };
 //# sourceMappingURL=affected.d.mts.map

package/dist/capture/affected.mjs

@@ -5,7 +5,7 @@ import { resolveStoryViewports } from "./storybook.mjs";
 import { BuildModel } from "../models/build.mjs";
 import { BaselineModel } from "../models/baseline.mjs";
 import { selectAffectedStories } from "@storyshelf/affected";
-//#region src/capture/affected.ts
+// src/capture/affected.ts
 /**
 * Resolve the affected import paths for a build, or `null` for full capture (affected capture
 * disabled, or no computation was posted). The one rule for the whole and the sharded path alike.
@@ -67,7 +67,6 @@ async function partitionAffectedStories(input) {
 		inherited: merged.inherited
 	};
 }
-//#endregion
 export { affectedPathsFor, partitionAffectedStories };
 
 //# sourceMappingURL=affected.mjs.map

package/dist/capture/attempt-logger.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { redactSecrets } from "../utils/redact.mjs";
 import { emitAttemptLog } from "../models/capture-attempt.mjs";
-//#region src/capture/attempt-logger.ts
+// src/capture/attempt-logger.ts
 /** Longest error text recorded on an attempt-log line. */
 const ERROR_TEXT_MAX = 500;
 /** Mirrored levels; `debug` stays in pino only so attempt logs keep the signal. */
@@ -78,7 +78,6 @@ function silentLogger() {
 	stub["child"] = () => stub;
 	return stub;
 }
-//#endregion
 export { mirrorAttemptLog };
 
 //# sourceMappingURL=attempt-logger.mjs.map

package/dist/capture/browsers.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { CaptureTarget, RunnerTarget } from "../adapters/capture-target.mjs";
-//#region src/capture/browsers.d.ts
 /** Upper bound on targets per project (each multiplies render time). */
 declare const MAX_BROWSERS = 3;
 /** Parse the project's JSON `browsers` column; `null` when unset or malformed. */
@@ -30,6 +29,5 @@ declare function refusalFor(target: CaptureTarget, offered?: readonly RunnerTarg
 declare function listTargets(offered: readonly RunnerTarget[]): string;
 /** Throw, naming every refusal, when the runner cannot render one of `targets`. */
 declare function assertSupportedBrowsers(targets: readonly CaptureTarget[], offered?: readonly RunnerTarget[]): void;
-//#endregion
 export { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers };
 //# sourceMappingURL=browsers.d.mts.map

package/dist/capture/browsers.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { DEFAULT_BROWSER, isCaptureTarget, unavailableReason } from "../adapters/capture-target.mjs";
-//#region src/capture/browsers.ts
+// src/capture/browsers.ts
 /** Which capture targets a project renders on, and the guards around that list (ADR 0007). */
 /** Upper bound on targets per project (each multiplies render time). */
 const MAX_BROWSERS = 3;
@@ -61,7 +61,6 @@ function assertSupportedBrowsers(targets, offered) {
 function dedupe(browsers) {
 	return [...new Set(browsers)];
 }
-//#endregion
 export { MAX_BROWSERS, assertBrowserCount, assertSupportedBrowsers, listTargets, parseBrowsers, primaryTargetOf, refusalFor, resolveBrowsers };
 
 //# sourceMappingURL=browsers.mjs.map

package/dist/capture/build-state/deliver.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Build } from "../../schema/build.mjs";
 import { Project } from "../../schema/project.mjs";
 import { BuildStateDeps, SkipReason, StateTarget } from "./types.mjs";
-//#region src/capture/build-state/deliver.d.ts
 /**
  * Show the build's current state on one channel. Throws when the host refuses a status, so the
  * caller can retry; resolves to why nothing was written when the build or channel is gone.
@@ -27,6 +26,5 @@ declare function writeTo(deps: BuildStateDeps, loaded: {
 }): Promise<void>;
 /** The project's enabled channels with a wired `state` provider; unreadable secrets are logged and skipped. */
 declare function stateTargets(deps: BuildStateDeps, projectId: string): Promise<StateTarget[]>;
-//#endregion
 export { deliverBuildState, loadBuild, stateTargets, writeTo };
 //# sourceMappingURL=deliver.d.mts.map

package/dist/capture/build-state/deliver.mjs

@@ -12,7 +12,7 @@ import { BuildReviewModel } from "../../models/build-review.mjs";
 import { NotificationChannelModel } from "../../models/notification-channel.mjs";
 import { createUrlBuilder } from "../../urls.mjs";
 import { publishingOf } from "../publish/published.mjs";
-//#region src/capture/build-state/deliver.ts
+// src/capture/build-state/deliver.ts
 /**
 * Delivering a build's state to git channels: read the build now, compute what each channel shows
 * ({@link statusesForBuild}), write it. Reading at delivery time is what makes a retried, delayed
@@ -112,7 +112,6 @@ async function approvalsOf(deps, build, project) {
 async function changesOf(deps, build, project) {
 	return deps.flags(project).testing && build.changedCount > 0 ? await new SnapshotModel(deps.db).listByBuild(build.id) : void 0;
 }
-//#endregion
 export { deliverBuildState, loadBuild, stateTargets, writeTo };
 
 //# sourceMappingURL=deliver.mjs.map

package/dist/capture/build-state/notify-job.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { BuildStateDeps } from "./types.mjs";
 import { ConsumerJob, KindHandler } from "../consumer/types.mjs";
 import { QueueJobInput } from "../db-queue/types.mjs";
-//#region src/capture/build-state/notify-job.d.ts
 /** Attempts a delivery gets before it is given up (the first try and four retries). */
 declare const NOTIFY_MAX_ATTEMPTS = 5;
 /** Retry delay of a delivery: 10 s, then doubling to at most five minutes. */
@@ -51,6 +50,5 @@ declare function createNotifyEnqueuer(deps: Pick<BuildStateDeps, "db">, queue: N
   channelId: string;
   buildId: string;
 }) => Promise<void>;
-//#endregion
 export { NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, NotifyFailure, NotifyHandlerOptions, NotifyJobQueue, createNotifyEnqueuer, createNotifyHandler, notifyExhausted };
 //# sourceMappingURL=notify-job.d.mts.map

package/dist/capture/build-state/notify-job.mjs

@@ -7,7 +7,7 @@ import { deliverBuildState } from "./deliver.mjs";
 import { CaptureJobModel } from "../../models/capture-job.mjs";
 import { isFinalAttempt } from "../consumer/retry.mjs";
 import { decodePayload } from "../db-queue/codec.mjs";
-//#region src/capture/build-state/notify-job.ts
+// src/capture/build-state/notify-job.ts
 /**
 * The `notify` job kind (ADR 0014, decision 7; ADR 0006, decision 4): one job per `(channel,
 * build)` state change. The job names a channel and a build, never a status: the handler reads the
@@ -127,7 +127,6 @@ function createNotifyEnqueuer(deps, queue) {
 		});
 	};
 }
-//#endregion
 export { NOTIFY_BACKOFF, NOTIFY_MAX_ATTEMPTS, createNotifyEnqueuer, createNotifyHandler, notifyExhausted };
 
 //# sourceMappingURL=notify-job.mjs.map

package/dist/capture/build-state/publisher.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BuildStateDeps, BuildStatePublisher } from "./types.mjs";
-//#region src/capture/build-state/publisher.d.ts
 /** What {@link createBuildStatePublisher} needs. */
 interface BuildStatePublisherOptions {
   deps: BuildStateDeps;
@@ -18,6 +17,5 @@ interface BuildStatePublisherOptions {
 declare const PAUSED_MESSAGE = "notifications are paused until a public URL is set (PUBLIC_BASE_URL or a confirmed detected origin)";
 /** A publisher over `options.deps`. */
 declare function createBuildStatePublisher(options: BuildStatePublisherOptions): BuildStatePublisher;
-//#endregion
 export { BuildStatePublisherOptions, PAUSED_MESSAGE, createBuildStatePublisher };
 //# sourceMappingURL=publisher.d.mts.map