blume 0.5.3 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. package/dist/cli/index.js +3349 -7024
  2. package/dist/cli/index.js.map +39 -69
  3. package/dist/types/core/config.d.ts +0 -8
  4. package/dist/types/core/data.d.ts +6 -2
  5. package/dist/types/core/i18n-ui.d.ts +50 -0
  6. package/dist/types/core/schema.d.ts +379 -485
  7. package/dist/types/core/types.d.ts +8 -6
  8. package/docs/advanced/meta.ts +1 -8
  9. package/docs/advanced/skills.mdx +28 -0
  10. package/docs/configuration/ai.mdx +58 -0
  11. package/docs/configuration/index.mdx +13 -17
  12. package/docs/configuration/seo.mdx +59 -1
  13. package/docs/configuration/theming.mdx +15 -18
  14. package/docs/content/components.mdx +2 -53
  15. package/docs/content/i18n.mdx +0 -4
  16. package/docs/content/meta.mdx +3 -17
  17. package/docs/content/navigation.mdx +41 -4
  18. package/docs/content/syntax.mdx +1 -1
  19. package/docs/index.mdx +0 -1
  20. package/docs/reference/cli.mdx +12 -13
  21. package/package.json +6 -6
  22. package/skills/blume/SKILL.md +71 -0
  23. package/skills/blume-update-docs/SKILL.md +52 -0
  24. package/skills/blume-update-docs/references/audit-checklist.md +46 -0
  25. package/src/ai/agent-readability.ts +97 -0
  26. package/src/ai/ask-context.ts +131 -8
  27. package/src/ai/ask-data.ts +4 -1
  28. package/src/astro/generate.ts +19 -12
  29. package/src/astro/integration.ts +0 -21
  30. package/src/astro/templates.ts +33 -21
  31. package/src/cli/commands/build.ts +15 -0
  32. package/src/cli/commands/dev.ts +31 -20
  33. package/src/cli/commands/validate.ts +0 -2
  34. package/src/cli/dev-lock.ts +94 -21
  35. package/src/cli/index.ts +0 -2
  36. package/src/components/BlumePage.astro +0 -6
  37. package/src/components/Icon.astro +1 -12
  38. package/src/components/content/AccordionItem.astro +3 -6
  39. package/src/components/content/Badge.astro +1 -3
  40. package/src/components/content/Callout.astro +3 -9
  41. package/src/components/content/Card.astro +2 -3
  42. package/src/components/content/ColorItem.astro +2 -2
  43. package/src/components/content/Column.astro +1 -1
  44. package/src/components/content/GithubInfo.astro +11 -10
  45. package/src/components/content/Prompt.astro +1 -1
  46. package/src/components/content/Step.astro +3 -4
  47. package/src/components/content/Tab.astro +2 -3
  48. package/src/components/content/TypeTable.astro +13 -8
  49. package/src/components/content/Update.astro +1 -1
  50. package/src/components/islands/AskAI.astro +66 -2
  51. package/src/components/islands/ask-ai.tsx +289 -53
  52. package/src/components/layout/Header.astro +27 -4
  53. package/src/components/layout/Logo.astro +5 -1
  54. package/src/components/layout/NavSelector.astro +1 -1
  55. package/src/components/layout/NavTree.astro +15 -15
  56. package/src/components/layout/PageActions.astro +73 -30
  57. package/src/components/layout/PageLayout.astro +42 -0
  58. package/src/components/layout/ReferenceLayout.astro +1 -0
  59. package/src/components/layout/RootLayout.astro +79 -4
  60. package/src/components/layout/Search.astro +5 -5
  61. package/src/components/layout/nav-utils.ts +9 -4
  62. package/src/components/openapi/ApiOverview.astro +4 -50
  63. package/src/components/openapi/ApiTagOperations.astro +42 -0
  64. package/src/core/builtin-tags.ts +1 -3
  65. package/src/core/config.ts +5 -28
  66. package/src/core/data.ts +6 -2
  67. package/src/core/graph.ts +8 -6
  68. package/src/core/i18n-ui.ts +5 -0
  69. package/src/core/links.ts +5 -19
  70. package/src/core/meta.ts +1 -1
  71. package/src/core/nav-diagnostics.ts +7 -0
  72. package/src/core/navigation.ts +38 -17
  73. package/src/core/project-graph.ts +0 -5
  74. package/src/core/schema.ts +133 -95
  75. package/src/core/sources/filesystem.ts +5 -1
  76. package/src/core/sources/resolve.ts +0 -13
  77. package/src/core/sources/watch.ts +43 -11
  78. package/src/core/types.ts +8 -6
  79. package/src/deploy/robots.ts +37 -4
  80. package/src/openapi/parse.ts +197 -14
  81. package/src/openapi/render-mdx.ts +44 -10
  82. package/src/openapi/scalar.ts +1 -1
  83. package/src/openapi/source.ts +19 -2
  84. package/src/search/documents.ts +9 -2
  85. package/src/theme/entry.ts +45 -17
  86. package/src/theme/icons.ts +18 -109
  87. package/src/theme/palette.ts +25 -51
  88. package/src/theme/twoslash.ts +6 -1
  89. package/dist/types/core/bridge.d.ts +0 -24
  90. package/dist/types/core/package-json.d.ts +0 -12
  91. package/dist/types/migrate/mintlify/assets.d.ts +0 -8
  92. package/dist/types/migrate/mintlify/config.d.ts +0 -16
  93. package/dist/types/migrate/mintlify/i18n.d.ts +0 -7
  94. package/dist/types/migrate/shared.d.ts +0 -153
  95. package/docs/advanced/bridge.mdx +0 -76
  96. package/docs/advanced/migrate.mdx +0 -124
  97. package/src/astro/static-assets.ts +0 -124
  98. package/src/cli/commands/migrate.ts +0 -39
  99. package/src/components/content/ApiField.astro +0 -75
  100. package/src/components/content/ParamField.astro +0 -39
  101. package/src/components/content/RequestField.astro +0 -23
  102. package/src/components/content/ResponseField.astro +0 -23
  103. package/src/components/content/Warning.astro +0 -9
  104. package/src/core/assets.ts +0 -31
  105. package/src/core/bridge.ts +0 -102
  106. package/src/core/sources/mintlify.ts +0 -190
  107. package/src/migrate/fumadocs/config.ts +0 -155
  108. package/src/migrate/fumadocs/content.ts +0 -376
  109. package/src/migrate/fumadocs/frontmatter.ts +0 -18
  110. package/src/migrate/fumadocs/groups.ts +0 -237
  111. package/src/migrate/fumadocs/index.ts +0 -355
  112. package/src/migrate/fumadocs/meta.ts +0 -244
  113. package/src/migrate/migrate.ts +0 -53
  114. package/src/migrate/mintlify/assets.ts +0 -46
  115. package/src/migrate/mintlify/config.ts +0 -954
  116. package/src/migrate/mintlify/content.ts +0 -120
  117. package/src/migrate/mintlify/frontmatter.ts +0 -126
  118. package/src/migrate/mintlify/i18n.ts +0 -51
  119. package/src/migrate/mintlify/icons.ts +0 -128
  120. package/src/migrate/mintlify/index.ts +0 -459
  121. package/src/migrate/mintlify/snippets.ts +0 -315
  122. package/src/migrate/mintlify/transform.ts +0 -82
  123. package/src/migrate/nextra/content.ts +0 -46
  124. package/src/migrate/nextra/frontmatter.ts +0 -40
  125. package/src/migrate/nextra/index.ts +0 -389
  126. package/src/migrate/nextra/meta.ts +0 -266
  127. package/src/migrate/shared.ts +0 -801
  128. package/src/migrate/starlight/config.ts +0 -455
  129. package/src/migrate/starlight/content.ts +0 -75
  130. package/src/migrate/starlight/frontmatter.ts +0 -111
  131. package/src/migrate/starlight/i18n.ts +0 -54
  132. package/src/migrate/starlight/index.ts +0 -131
@@ -54,19 +54,11 @@ declare const pageMetaBaseSchema: z.ZodObject<{
54
54
  deprecated: z.ZodDefault<z.ZodBoolean>;
55
55
  description: z.ZodOptional<z.ZodString>;
56
56
  draft: z.ZodDefault<z.ZodBoolean>;
57
- groups: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
58
57
  hidden: z.ZodDefault<z.ZodBoolean>;
59
- hideApiMarker: z.ZodDefault<z.ZodBoolean>;
60
- hideFooterPagination: z.ZodOptional<z.ZodBoolean>;
61
58
  icon: z.ZodOptional<z.ZodString>;
62
- iconType: z.ZodOptional<z.ZodString>;
63
- keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
64
59
  /** Overrides the git-derived last-modified date when `lastModified` is on. */
65
60
  lastModified: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
66
- mode: z.ZodOptional<z.ZodString>;
67
61
  noindex: z.ZodDefault<z.ZodBoolean>;
68
- public: z.ZodOptional<z.ZodBoolean>;
69
- rss: z.ZodOptional<z.ZodBoolean>;
70
62
  search: z.ZodDefault<z.ZodObject<{
71
63
  boost: z.ZodOptional<z.ZodNumber>;
72
64
  exclude: z.ZodDefault<z.ZodBoolean>;
@@ -118,9 +110,7 @@ declare const pageMetaBaseSchema: z.ZodObject<{
118
110
  badge?: string | undefined;
119
111
  order?: number | undefined;
120
112
  }>>;
121
- sidebarTitle: z.ZodOptional<z.ZodString>;
122
113
  slug: z.ZodOptional<z.ZodString>;
123
- tag: z.ZodOptional<z.ZodString>;
124
114
  title: z.ZodOptional<z.ZodString>;
125
115
  type: z.ZodDefault<z.ZodString>;
126
116
  }, "strict", z.ZodTypeAny, {
@@ -133,7 +123,6 @@ declare const pageMetaBaseSchema: z.ZodObject<{
133
123
  deprecated: boolean;
134
124
  draft: boolean;
135
125
  hidden: boolean;
136
- hideApiMarker: boolean;
137
126
  noindex: boolean;
138
127
  seo: {
139
128
  noindex: boolean;
@@ -168,18 +157,9 @@ declare const pageMetaBaseSchema: z.ZodObject<{
168
157
  category?: string | undefined;
169
158
  version?: string | undefined;
170
159
  } | undefined;
171
- groups?: string | string[] | undefined;
172
- hideFooterPagination?: boolean | undefined;
173
160
  icon?: string | undefined;
174
- iconType?: string | undefined;
175
- keywords?: string[] | undefined;
176
161
  lastModified?: string | undefined;
177
- mode?: string | undefined;
178
- public?: boolean | undefined;
179
- rss?: boolean | undefined;
180
- sidebarTitle?: string | undefined;
181
162
  slug?: string | undefined;
182
- tag?: string | undefined;
183
163
  }, {
184
164
  type?: string | undefined;
185
165
  date?: string | Date | undefined;
@@ -208,18 +188,10 @@ declare const pageMetaBaseSchema: z.ZodObject<{
208
188
  } | undefined;
209
189
  deprecated?: boolean | undefined;
210
190
  draft?: boolean | undefined;
211
- groups?: string | string[] | undefined;
212
191
  hidden?: boolean | undefined;
213
- hideApiMarker?: boolean | undefined;
214
- hideFooterPagination?: boolean | undefined;
215
192
  icon?: string | undefined;
216
- iconType?: string | undefined;
217
- keywords?: string[] | undefined;
218
193
  lastModified?: string | Date | undefined;
219
- mode?: string | undefined;
220
194
  noindex?: boolean | undefined;
221
- public?: boolean | undefined;
222
- rss?: boolean | undefined;
223
195
  seo?: {
224
196
  title?: string | undefined;
225
197
  description?: string | undefined;
@@ -234,9 +206,7 @@ declare const pageMetaBaseSchema: z.ZodObject<{
234
206
  badge?: string | undefined;
235
207
  order?: number | undefined;
236
208
  } | undefined;
237
- sidebarTitle?: string | undefined;
238
209
  slug?: string | undefined;
239
- tag?: string | undefined;
240
210
  }>;
241
211
  export declare const pageMetaSchema: z.ZodObject<{
242
212
  /** Post author(s) for blog/changelog content; preserved, not yet rendered. */
@@ -289,19 +259,11 @@ export declare const pageMetaSchema: z.ZodObject<{
289
259
  deprecated: z.ZodDefault<z.ZodBoolean>;
290
260
  description: z.ZodOptional<z.ZodString>;
291
261
  draft: z.ZodDefault<z.ZodBoolean>;
292
- groups: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
293
262
  hidden: z.ZodDefault<z.ZodBoolean>;
294
- hideApiMarker: z.ZodDefault<z.ZodBoolean>;
295
- hideFooterPagination: z.ZodOptional<z.ZodBoolean>;
296
263
  icon: z.ZodOptional<z.ZodString>;
297
- iconType: z.ZodOptional<z.ZodString>;
298
- keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
299
264
  /** Overrides the git-derived last-modified date when `lastModified` is on. */
300
265
  lastModified: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
301
- mode: z.ZodOptional<z.ZodString>;
302
266
  noindex: z.ZodDefault<z.ZodBoolean>;
303
- public: z.ZodOptional<z.ZodBoolean>;
304
- rss: z.ZodOptional<z.ZodBoolean>;
305
267
  search: z.ZodDefault<z.ZodObject<{
306
268
  boost: z.ZodOptional<z.ZodNumber>;
307
269
  exclude: z.ZodDefault<z.ZodBoolean>;
@@ -353,9 +315,7 @@ export declare const pageMetaSchema: z.ZodObject<{
353
315
  badge?: string | undefined;
354
316
  order?: number | undefined;
355
317
  }>>;
356
- sidebarTitle: z.ZodOptional<z.ZodString>;
357
318
  slug: z.ZodOptional<z.ZodString>;
358
- tag: z.ZodOptional<z.ZodString>;
359
319
  title: z.ZodOptional<z.ZodString>;
360
320
  type: z.ZodDefault<z.ZodString>;
361
321
  }, "strict", z.ZodTypeAny, {
@@ -368,7 +328,6 @@ export declare const pageMetaSchema: z.ZodObject<{
368
328
  deprecated: boolean;
369
329
  draft: boolean;
370
330
  hidden: boolean;
371
- hideApiMarker: boolean;
372
331
  noindex: boolean;
373
332
  seo: {
374
333
  noindex: boolean;
@@ -403,18 +362,9 @@ export declare const pageMetaSchema: z.ZodObject<{
403
362
  category?: string | undefined;
404
363
  version?: string | undefined;
405
364
  } | undefined;
406
- groups?: string | string[] | undefined;
407
- hideFooterPagination?: boolean | undefined;
408
365
  icon?: string | undefined;
409
- iconType?: string | undefined;
410
- keywords?: string[] | undefined;
411
366
  lastModified?: string | undefined;
412
- mode?: string | undefined;
413
- public?: boolean | undefined;
414
- rss?: boolean | undefined;
415
- sidebarTitle?: string | undefined;
416
367
  slug?: string | undefined;
417
- tag?: string | undefined;
418
368
  }, {
419
369
  type?: string | undefined;
420
370
  date?: string | Date | undefined;
@@ -443,18 +393,10 @@ export declare const pageMetaSchema: z.ZodObject<{
443
393
  } | undefined;
444
394
  deprecated?: boolean | undefined;
445
395
  draft?: boolean | undefined;
446
- groups?: string | string[] | undefined;
447
396
  hidden?: boolean | undefined;
448
- hideApiMarker?: boolean | undefined;
449
- hideFooterPagination?: boolean | undefined;
450
397
  icon?: string | undefined;
451
- iconType?: string | undefined;
452
- keywords?: string[] | undefined;
453
398
  lastModified?: string | Date | undefined;
454
- mode?: string | undefined;
455
399
  noindex?: boolean | undefined;
456
- public?: boolean | undefined;
457
- rss?: boolean | undefined;
458
400
  seo?: {
459
401
  title?: string | undefined;
460
402
  description?: string | undefined;
@@ -469,9 +411,7 @@ export declare const pageMetaSchema: z.ZodObject<{
469
411
  badge?: string | undefined;
470
412
  order?: number | undefined;
471
413
  } | undefined;
472
- sidebarTitle?: string | undefined;
473
414
  slug?: string | undefined;
474
- tag?: string | undefined;
475
415
  }>;
476
416
  export type PageMeta = z.infer<typeof pageMetaBaseSchema>;
477
417
  export type PageMetaInput = z.input<typeof pageMetaBaseSchema>;
@@ -486,21 +426,18 @@ declare const sidebarDisplaySchema: z.ZodEnum<["flat", "group", "page"]>;
486
426
  export type SidebarDisplay = z.infer<typeof sidebarDisplaySchema>;
487
427
  export declare const folderMetaSchema: z.ZodObject<{
488
428
  collapsed: z.ZodOptional<z.ZodBoolean>;
489
- display: z.ZodOptional<z.ZodEnum<["flat", "group", "page"]>>;
490
429
  icon: z.ZodOptional<z.ZodString>;
491
430
  order: z.ZodOptional<z.ZodNumber>;
492
431
  /** Explicit child ordering by slug segment (without numeric prefix). */
493
432
  pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
494
433
  title: z.ZodOptional<z.ZodString>;
495
434
  }, "strict", z.ZodTypeAny, {
496
- display?: "flat" | "page" | "group" | undefined;
497
435
  title?: string | undefined;
498
436
  icon?: string | undefined;
499
437
  order?: number | undefined;
500
438
  pages?: string[] | undefined;
501
439
  collapsed?: boolean | undefined;
502
440
  }, {
503
- display?: "flat" | "page" | "group" | undefined;
504
441
  title?: string | undefined;
505
442
  icon?: string | undefined;
506
443
  order?: number | undefined;
@@ -732,36 +669,6 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
732
669
  slug?: string | undefined;
733
670
  } | undefined;
734
671
  publishedValue?: string | undefined;
735
- }>, z.ZodObject<{
736
- /** Absolute path of the `docs.json`/`mint.json`, watched for changes in dev. */
737
- configFile: z.ZodOptional<z.ZodString>;
738
- /** Patterns excluded from page discovery (Mintlify defaults are merged in). */
739
- exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
740
- /** Glob patterns for Mintlify content files. */
741
- include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
742
- /** Namespaces the source's routes under `/<prefix>/`. */
743
- prefix: z.ZodOptional<z.ZodString>;
744
- /** Content root, absolute or relative to the project root (Mintlify: `.`). */
745
- root: z.ZodDefault<z.ZodString>;
746
- type: z.ZodLiteral<"mintlify">;
747
- /** `docs.json` variables, inlined into content (`{{name}}`) at scan time. */
748
- variables: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
749
- }, "strict", z.ZodTypeAny, {
750
- type: "mintlify";
751
- exclude: string[];
752
- include: string[];
753
- root: string;
754
- variables: Record<string, string>;
755
- prefix?: string | undefined;
756
- configFile?: string | undefined;
757
- }, {
758
- type: "mintlify";
759
- exclude?: string[] | undefined;
760
- include?: string[] | undefined;
761
- root?: string | undefined;
762
- prefix?: string | undefined;
763
- configFile?: string | undefined;
764
- variables?: Record<string, string> | undefined;
765
672
  }>, z.ZodObject<{
766
673
  source: z.ZodType<ContentSource, z.ZodTypeDef, ContentSource>;
767
674
  type: z.ZodLiteral<"custom">;
@@ -798,10 +705,24 @@ declare const aiConfigSchema: z.ZodObject<{
798
705
  enabled: z.ZodDefault<z.ZodBoolean>;
799
706
  model: z.ZodDefault<z.ZodString>;
800
707
  provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
708
+ suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
709
+ icon: z.ZodOptional<z.ZodString>;
710
+ label: z.ZodString;
711
+ }, "strict", z.ZodTypeAny, {
712
+ label: string;
713
+ icon?: string | undefined;
714
+ }, {
715
+ label: string;
716
+ icon?: string | undefined;
717
+ }>, "many">>;
801
718
  }, "strict", z.ZodTypeAny, {
802
719
  enabled: boolean;
803
720
  model: string;
804
721
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
722
+ suggestions: {
723
+ label: string;
724
+ icon?: string | undefined;
725
+ }[];
805
726
  apiKeyEnv?: string | undefined;
806
727
  baseUrl?: string | undefined;
807
728
  }, {
@@ -810,10 +731,18 @@ declare const aiConfigSchema: z.ZodObject<{
810
731
  enabled?: boolean | undefined;
811
732
  model?: string | undefined;
812
733
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
734
+ suggestions?: {
735
+ label: string;
736
+ icon?: string | undefined;
737
+ }[] | undefined;
813
738
  }>, {
814
739
  enabled: boolean;
815
740
  model: string;
816
741
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
742
+ suggestions: {
743
+ label: string;
744
+ icon?: string | undefined;
745
+ }[];
817
746
  apiKeyEnv?: string | undefined;
818
747
  baseUrl?: string | undefined;
819
748
  }, {
@@ -822,6 +751,10 @@ declare const aiConfigSchema: z.ZodObject<{
822
751
  enabled?: boolean | undefined;
823
752
  model?: string | undefined;
824
753
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
754
+ suggestions?: {
755
+ label: string;
756
+ icon?: string | undefined;
757
+ }[] | undefined;
825
758
  }>>;
826
759
  llmsTxt: z.ZodDefault<z.ZodBoolean>;
827
760
  }, "strict", z.ZodTypeAny, {
@@ -830,6 +763,10 @@ declare const aiConfigSchema: z.ZodObject<{
830
763
  enabled: boolean;
831
764
  model: string;
832
765
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
766
+ suggestions: {
767
+ label: string;
768
+ icon?: string | undefined;
769
+ }[];
833
770
  apiKeyEnv?: string | undefined;
834
771
  baseUrl?: string | undefined;
835
772
  } | undefined;
@@ -840,6 +777,10 @@ declare const aiConfigSchema: z.ZodObject<{
840
777
  enabled?: boolean | undefined;
841
778
  model?: string | undefined;
842
779
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
780
+ suggestions?: {
781
+ label: string;
782
+ icon?: string | undefined;
783
+ }[] | undefined;
843
784
  } | undefined;
844
785
  llmsTxt?: boolean | undefined;
845
786
  }>;
@@ -934,6 +875,34 @@ declare const i18nConfigSchema: z.ZodEffects<z.ZodObject<{
934
875
  parser?: "dir" | "dot" | undefined;
935
876
  ui?: Record<string, Record<string, Record<string, string>>> | undefined;
936
877
  }>;
878
+ /**
879
+ * Content signals accept a boolean shorthand or a per-signal object, and
880
+ * normalize to `{ search, aiInput, aiTrain }` — or `null` when disabled, so
881
+ * robots.txt omits the declaration entirely. On by default (`true`): Blume
882
+ * declares the docs open to search and agents. `false` opts out; an object
883
+ * restricts individual signals (unset signals stay `yes`).
884
+ */
885
+ declare const contentSignalsSchema: z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
886
+ aiInput: z.ZodDefault<z.ZodBoolean>;
887
+ aiTrain: z.ZodDefault<z.ZodBoolean>;
888
+ search: z.ZodDefault<z.ZodBoolean>;
889
+ }, "strict", z.ZodTypeAny, {
890
+ search: boolean;
891
+ aiInput: boolean;
892
+ aiTrain: boolean;
893
+ }, {
894
+ search?: boolean | undefined;
895
+ aiInput?: boolean | undefined;
896
+ aiTrain?: boolean | undefined;
897
+ }>]>, {
898
+ search: boolean;
899
+ aiInput: boolean;
900
+ aiTrain: boolean;
901
+ } | null, boolean | {
902
+ search?: boolean | undefined;
903
+ aiInput?: boolean | undefined;
904
+ aiTrain?: boolean | undefined;
905
+ }>;
937
906
  /**
938
907
  * A single spec rendered by the API reference. `spec` is a local path or an
939
908
  * `http(s)` URL (OpenAPI for the Blume renderer; OpenAPI or AsyncAPI for Scalar).
@@ -963,10 +932,24 @@ export declare const blumeConfigSchema: z.ZodObject<{
963
932
  enabled: z.ZodDefault<z.ZodBoolean>;
964
933
  model: z.ZodDefault<z.ZodString>;
965
934
  provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
935
+ suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
936
+ icon: z.ZodOptional<z.ZodString>;
937
+ label: z.ZodString;
938
+ }, "strict", z.ZodTypeAny, {
939
+ label: string;
940
+ icon?: string | undefined;
941
+ }, {
942
+ label: string;
943
+ icon?: string | undefined;
944
+ }>, "many">>;
966
945
  }, "strict", z.ZodTypeAny, {
967
946
  enabled: boolean;
968
947
  model: string;
969
948
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
949
+ suggestions: {
950
+ label: string;
951
+ icon?: string | undefined;
952
+ }[];
970
953
  apiKeyEnv?: string | undefined;
971
954
  baseUrl?: string | undefined;
972
955
  }, {
@@ -975,10 +958,18 @@ export declare const blumeConfigSchema: z.ZodObject<{
975
958
  enabled?: boolean | undefined;
976
959
  model?: string | undefined;
977
960
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
961
+ suggestions?: {
962
+ label: string;
963
+ icon?: string | undefined;
964
+ }[] | undefined;
978
965
  }>, {
979
966
  enabled: boolean;
980
967
  model: string;
981
968
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
969
+ suggestions: {
970
+ label: string;
971
+ icon?: string | undefined;
972
+ }[];
982
973
  apiKeyEnv?: string | undefined;
983
974
  baseUrl?: string | undefined;
984
975
  }, {
@@ -987,6 +978,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
987
978
  enabled?: boolean | undefined;
988
979
  model?: string | undefined;
989
980
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
981
+ suggestions?: {
982
+ label: string;
983
+ icon?: string | undefined;
984
+ }[] | undefined;
990
985
  }>>;
991
986
  llmsTxt: z.ZodDefault<z.ZodBoolean>;
992
987
  }, "strict", z.ZodTypeAny, {
@@ -995,6 +990,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
995
990
  enabled: boolean;
996
991
  model: string;
997
992
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
993
+ suggestions: {
994
+ label: string;
995
+ icon?: string | undefined;
996
+ }[];
998
997
  apiKeyEnv?: string | undefined;
999
998
  baseUrl?: string | undefined;
1000
999
  } | undefined;
@@ -1005,6 +1004,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
1005
1004
  enabled?: boolean | undefined;
1006
1005
  model?: string | undefined;
1007
1006
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
1007
+ suggestions?: {
1008
+ label: string;
1009
+ icon?: string | undefined;
1010
+ }[] | undefined;
1008
1011
  } | undefined;
1009
1012
  llmsTxt?: boolean | undefined;
1010
1013
  }>>;
@@ -1114,23 +1117,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1114
1117
  theme?: string | undefined;
1115
1118
  }>>;
1116
1119
  banner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
1117
- /** Background color override (Mintlify compatibility). */
1118
- color: z.ZodOptional<z.ZodEffects<z.ZodObject<{
1119
- dark: z.ZodOptional<z.ZodString>;
1120
- light: z.ZodOptional<z.ZodString>;
1121
- }, "strict", z.ZodTypeAny, {
1122
- dark?: string | undefined;
1123
- light?: string | undefined;
1124
- }, {
1125
- dark?: string | undefined;
1126
- light?: string | undefined;
1127
- }>, {
1128
- dark?: string | undefined;
1129
- light?: string | undefined;
1130
- }, {
1131
- dark?: string | undefined;
1132
- light?: string | undefined;
1133
- }>>;
1134
1120
  content: z.ZodString;
1135
1121
  /** Show a dismiss button; the choice is remembered per visitor. */
1136
1122
  dismissible: z.ZodDefault<z.ZodBoolean>;
@@ -1146,29 +1132,17 @@ export declare const blumeConfigSchema: z.ZodObject<{
1146
1132
  href: string;
1147
1133
  text: string;
1148
1134
  }>>;
1149
- /** Tone (Mintlify compatibility). */
1150
- type: z.ZodOptional<z.ZodEnum<["info", "warning", "critical"]>>;
1151
1135
  }, "strict", z.ZodTypeAny, {
1152
1136
  content: string;
1153
1137
  dismissible: boolean;
1154
- type?: "warning" | "info" | "critical" | undefined;
1155
1138
  id?: string | undefined;
1156
- color?: {
1157
- dark?: string | undefined;
1158
- light?: string | undefined;
1159
- } | undefined;
1160
1139
  link?: {
1161
1140
  href: string;
1162
1141
  text: string;
1163
1142
  } | undefined;
1164
1143
  }, {
1165
1144
  content: string;
1166
- type?: "warning" | "info" | "critical" | undefined;
1167
1145
  id?: string | undefined;
1168
- color?: {
1169
- dark?: string | undefined;
1170
- light?: string | undefined;
1171
- } | undefined;
1172
1146
  dismissible?: boolean | undefined;
1173
1147
  link?: {
1174
1148
  href: string;
@@ -1176,13 +1150,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1176
1150
  } | undefined;
1177
1151
  }>]>>;
1178
1152
  content: z.ZodDefault<z.ZodObject<{
1179
- /**
1180
- * Extra top-level directories (relative to the project root) served as
1181
- * static assets at the site root, alongside `public/`. Lets projects keep
1182
- * root-served asset folders in place — e.g. a Mintlify migration keeps
1183
- * `images/` where it is instead of relocating it under `public/`.
1184
- */
1185
- assets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1186
1153
  defaultType: z.ZodDefault<z.ZodString>;
1187
1154
  exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1188
1155
  include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1416,36 +1383,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1416
1383
  slug?: string | undefined;
1417
1384
  } | undefined;
1418
1385
  publishedValue?: string | undefined;
1419
- }>, z.ZodObject<{
1420
- /** Absolute path of the `docs.json`/`mint.json`, watched for changes in dev. */
1421
- configFile: z.ZodOptional<z.ZodString>;
1422
- /** Patterns excluded from page discovery (Mintlify defaults are merged in). */
1423
- exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1424
- /** Glob patterns for Mintlify content files. */
1425
- include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1426
- /** Namespaces the source's routes under `/<prefix>/`. */
1427
- prefix: z.ZodOptional<z.ZodString>;
1428
- /** Content root, absolute or relative to the project root (Mintlify: `.`). */
1429
- root: z.ZodDefault<z.ZodString>;
1430
- type: z.ZodLiteral<"mintlify">;
1431
- /** `docs.json` variables, inlined into content (`{{name}}`) at scan time. */
1432
- variables: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
1433
- }, "strict", z.ZodTypeAny, {
1434
- type: "mintlify";
1435
- exclude: string[];
1436
- include: string[];
1437
- root: string;
1438
- variables: Record<string, string>;
1439
- prefix?: string | undefined;
1440
- configFile?: string | undefined;
1441
- }, {
1442
- type: "mintlify";
1443
- exclude?: string[] | undefined;
1444
- include?: string[] | undefined;
1445
- root?: string | undefined;
1446
- prefix?: string | undefined;
1447
- configFile?: string | undefined;
1448
- variables?: Record<string, string> | undefined;
1449
1386
  }>, z.ZodObject<{
1450
1387
  source: z.ZodType<ContentSource, z.ZodTypeDef, ContentSource>;
1451
1388
  type: z.ZodLiteral<"custom">;
@@ -1458,7 +1395,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1458
1395
  }>]>, "many">>;
1459
1396
  }, "strict", z.ZodTypeAny, {
1460
1397
  exclude: string[];
1461
- assets: string[];
1462
1398
  defaultType: string;
1463
1399
  include: string[];
1464
1400
  pages: string;
@@ -1519,14 +1455,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1519
1455
  slug?: string | undefined;
1520
1456
  } | undefined;
1521
1457
  publishedValue?: string | undefined;
1522
- } | {
1523
- type: "mintlify";
1524
- exclude: string[];
1525
- include: string[];
1526
- root: string;
1527
- variables: Record<string, string>;
1528
- prefix?: string | undefined;
1529
- configFile?: string | undefined;
1530
1458
  } | {
1531
1459
  type: "custom";
1532
1460
  source: ContentSource;
@@ -1589,19 +1517,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
1589
1517
  slug?: string | undefined;
1590
1518
  } | undefined;
1591
1519
  publishedValue?: string | undefined;
1592
- } | {
1593
- type: "mintlify";
1594
- exclude?: string[] | undefined;
1595
- include?: string[] | undefined;
1596
- root?: string | undefined;
1597
- prefix?: string | undefined;
1598
- configFile?: string | undefined;
1599
- variables?: Record<string, string> | undefined;
1600
1520
  } | {
1601
1521
  type: "custom";
1602
1522
  source: ContentSource;
1603
1523
  })[] | undefined;
1604
- assets?: string[] | undefined;
1605
1524
  defaultType?: string | undefined;
1606
1525
  include?: string[] | undefined;
1607
1526
  pages?: string | undefined;
@@ -1654,16 +1573,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1654
1573
  epub?: boolean | undefined;
1655
1574
  pdf?: boolean | undefined;
1656
1575
  }>>;
1657
- favicon: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
1658
- dark: z.ZodOptional<z.ZodString>;
1659
- light: z.ZodOptional<z.ZodString>;
1660
- }, "strict", z.ZodTypeAny, {
1661
- dark?: string | undefined;
1662
- light?: string | undefined;
1663
- }, {
1664
- dark?: string | undefined;
1665
- light?: string | undefined;
1666
- }>]>>;
1667
1576
  feedback: z.ZodDefault<z.ZodBoolean>;
1668
1577
  github: z.ZodOptional<z.ZodObject<{
1669
1578
  branch: z.ZodDefault<z.ZodString>;
@@ -1751,13 +1660,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
1751
1660
  parser?: "dir" | "dot" | undefined;
1752
1661
  ui?: Record<string, Record<string, Record<string, string>>> | undefined;
1753
1662
  }>>;
1754
- icons: z.ZodDefault<z.ZodObject<{
1755
- library: z.ZodDefault<z.ZodEnum<["lucide", "fontawesome", "tabler"]>>;
1756
- }, "strict", z.ZodTypeAny, {
1757
- library: "lucide" | "fontawesome" | "tabler";
1758
- }, {
1759
- library?: "lucide" | "fontawesome" | "tabler" | undefined;
1760
- }>>;
1761
1663
  lastModified: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
1762
1664
  type: z.ZodDefault<z.ZodEnum<["git", "frontmatter"]>>;
1763
1665
  }, "strict", z.ZodTypeAny, {
@@ -1766,20 +1668,37 @@ export declare const blumeConfigSchema: z.ZodObject<{
1766
1668
  type?: "git" | "frontmatter" | undefined;
1767
1669
  }>]>>;
1768
1670
  logo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
1769
- alt: z.ZodOptional<z.ZodString>;
1770
- dark: z.ZodOptional<z.ZodString>;
1771
1671
  href: z.ZodOptional<z.ZodString>;
1772
- light: z.ZodOptional<z.ZodString>;
1672
+ image: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
1673
+ alt: z.ZodOptional<z.ZodString>;
1674
+ dark: z.ZodOptional<z.ZodString>;
1675
+ light: z.ZodOptional<z.ZodString>;
1676
+ }, "strict", z.ZodTypeAny, {
1677
+ alt?: string | undefined;
1678
+ dark?: string | undefined;
1679
+ light?: string | undefined;
1680
+ }, {
1681
+ alt?: string | undefined;
1682
+ dark?: string | undefined;
1683
+ light?: string | undefined;
1684
+ }>]>>;
1685
+ text: z.ZodOptional<z.ZodString>;
1773
1686
  }, "strict", z.ZodTypeAny, {
1774
- dark?: string | undefined;
1775
- light?: string | undefined;
1687
+ image?: string | {
1688
+ alt?: string | undefined;
1689
+ dark?: string | undefined;
1690
+ light?: string | undefined;
1691
+ } | undefined;
1776
1692
  href?: string | undefined;
1777
- alt?: string | undefined;
1693
+ text?: string | undefined;
1778
1694
  }, {
1779
- dark?: string | undefined;
1780
- light?: string | undefined;
1695
+ image?: string | {
1696
+ alt?: string | undefined;
1697
+ dark?: string | undefined;
1698
+ light?: string | undefined;
1699
+ } | undefined;
1781
1700
  href?: string | undefined;
1782
- alt?: string | undefined;
1701
+ text?: string | undefined;
1783
1702
  }>]>>;
1784
1703
  markdown: z.ZodDefault<z.ZodObject<{
1785
1704
  /** Code-block rendering: language icons and line wrapping. */
@@ -1897,102 +1816,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
1897
1816
  instructions?: string | undefined;
1898
1817
  }>>;
1899
1818
  navigation: z.ZodDefault<z.ZodObject<{
1900
- chromeVariants: z.ZodDefault<z.ZodArray<z.ZodObject<{
1901
- banner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
1902
- /** Background color override (Mintlify compatibility). */
1903
- color: z.ZodOptional<z.ZodEffects<z.ZodObject<{
1904
- dark: z.ZodOptional<z.ZodString>;
1905
- light: z.ZodOptional<z.ZodString>;
1906
- }, "strict", z.ZodTypeAny, {
1907
- dark?: string | undefined;
1908
- light?: string | undefined;
1909
- }, {
1910
- dark?: string | undefined;
1911
- light?: string | undefined;
1912
- }>, {
1913
- dark?: string | undefined;
1914
- light?: string | undefined;
1915
- }, {
1916
- dark?: string | undefined;
1917
- light?: string | undefined;
1918
- }>>;
1919
- content: z.ZodString;
1920
- /** Show a dismiss button; the choice is remembered per visitor. */
1921
- dismissible: z.ZodDefault<z.ZodBoolean>;
1922
- /** Stable key for remembering dismissal; defaults to the content. */
1923
- id: z.ZodOptional<z.ZodString>;
1924
- link: z.ZodOptional<z.ZodObject<{
1925
- href: z.ZodString;
1926
- text: z.ZodString;
1927
- }, "strict", z.ZodTypeAny, {
1928
- href: string;
1929
- text: string;
1930
- }, {
1931
- href: string;
1932
- text: string;
1933
- }>>;
1934
- /** Tone (Mintlify compatibility). */
1935
- type: z.ZodOptional<z.ZodEnum<["info", "warning", "critical"]>>;
1936
- }, "strict", z.ZodTypeAny, {
1937
- content: string;
1938
- dismissible: boolean;
1939
- type?: "warning" | "info" | "critical" | undefined;
1940
- id?: string | undefined;
1941
- color?: {
1942
- dark?: string | undefined;
1943
- light?: string | undefined;
1944
- } | undefined;
1945
- link?: {
1946
- href: string;
1947
- text: string;
1948
- } | undefined;
1949
- }, {
1950
- content: string;
1951
- type?: "warning" | "info" | "critical" | undefined;
1952
- id?: string | undefined;
1953
- color?: {
1954
- dark?: string | undefined;
1955
- light?: string | undefined;
1956
- } | undefined;
1957
- dismissible?: boolean | undefined;
1958
- link?: {
1959
- href: string;
1960
- text: string;
1961
- } | undefined;
1962
- }>]>>;
1963
- path: z.ZodString;
1819
+ /** Pinned links shown above the generated sidebar sections. */
1820
+ featured: z.ZodDefault<z.ZodArray<z.ZodObject<{
1821
+ href: z.ZodString;
1822
+ icon: z.ZodOptional<z.ZodString>;
1823
+ label: z.ZodString;
1964
1824
  }, "strict", z.ZodTypeAny, {
1965
- path: string;
1966
- banner?: string | {
1967
- content: string;
1968
- dismissible: boolean;
1969
- type?: "warning" | "info" | "critical" | undefined;
1970
- id?: string | undefined;
1971
- color?: {
1972
- dark?: string | undefined;
1973
- light?: string | undefined;
1974
- } | undefined;
1975
- link?: {
1976
- href: string;
1977
- text: string;
1978
- } | undefined;
1979
- } | undefined;
1825
+ label: string;
1826
+ href: string;
1827
+ icon?: string | undefined;
1980
1828
  }, {
1981
- path: string;
1982
- banner?: string | {
1983
- content: string;
1984
- type?: "warning" | "info" | "critical" | undefined;
1985
- id?: string | undefined;
1986
- color?: {
1987
- dark?: string | undefined;
1988
- light?: string | undefined;
1989
- } | undefined;
1990
- dismissible?: boolean | undefined;
1991
- link?: {
1992
- href: string;
1993
- text: string;
1994
- } | undefined;
1995
- } | undefined;
1829
+ label: string;
1830
+ href: string;
1831
+ icon?: string | undefined;
1996
1832
  }>, "many">>;
1997
1833
  /** Show a GitHub repo link in the header (requires `github` configured). */
1998
1834
  repo: z.ZodDefault<z.ZodBoolean>;
@@ -2039,8 +1875,28 @@ export declare const blumeConfigSchema: z.ZodObject<{
2039
1875
  tag?: string | undefined;
2040
1876
  }[] | undefined;
2041
1877
  }>, "many">>;
2042
- /** Explicit sidebar override; when omitted the sidebar is generated. */
2043
- sidebar: z.ZodOptional<z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">>;
1878
+ /**
1879
+ * Sidebar behavior. `display` sets how every group renders (a group in an
1880
+ * explicit `items` config may still override it); `items` is an explicit
1881
+ * sidebar — when omitted the sidebar is generated from the content tree.
1882
+ * A bare array is shorthand for `{ items }`.
1883
+ */
1884
+ sidebar: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">, z.ZodObject<{
1885
+ display: z.ZodDefault<z.ZodEnum<["flat", "group", "page"]>>;
1886
+ items: z.ZodOptional<z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">>;
1887
+ }, "strict", z.ZodTypeAny, {
1888
+ display: "flat" | "page" | "group";
1889
+ items?: SidebarItemConfig[] | undefined;
1890
+ }, {
1891
+ display?: "flat" | "page" | "group" | undefined;
1892
+ items?: SidebarItemConfig[] | undefined;
1893
+ }>]>>, {
1894
+ display: "flat" | "page" | "group";
1895
+ items?: SidebarItemConfig[] | undefined;
1896
+ }, SidebarItemConfig[] | {
1897
+ display?: "flat" | "page" | "group" | undefined;
1898
+ items?: SidebarItemConfig[] | undefined;
1899
+ } | undefined>;
2044
1900
  tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
2045
1901
  icon: z.ZodOptional<z.ZodString>;
2046
1902
  items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2088,23 +1944,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
2088
1944
  }[] | undefined;
2089
1945
  }>, "many">>;
2090
1946
  }, "strict", z.ZodTypeAny, {
1947
+ sidebar: {
1948
+ display: "flat" | "page" | "group";
1949
+ items?: SidebarItemConfig[] | undefined;
1950
+ };
2091
1951
  repo: boolean;
2092
- chromeVariants: {
2093
- path: string;
2094
- banner?: string | {
2095
- content: string;
2096
- dismissible: boolean;
2097
- type?: "warning" | "info" | "critical" | undefined;
2098
- id?: string | undefined;
2099
- color?: {
2100
- dark?: string | undefined;
2101
- light?: string | undefined;
2102
- } | undefined;
2103
- link?: {
2104
- href: string;
2105
- text: string;
2106
- } | undefined;
2107
- } | undefined;
1952
+ featured: {
1953
+ label: string;
1954
+ href: string;
1955
+ icon?: string | undefined;
2108
1956
  }[];
2109
1957
  selectors: {
2110
1958
  label: string;
@@ -2117,7 +1965,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2117
1965
  }[];
2118
1966
  kind: "version" | "dropdown" | "language" | "product";
2119
1967
  }[];
2120
- sidebar?: SidebarItemConfig[] | undefined;
2121
1968
  tabs?: {
2122
1969
  path: string;
2123
1970
  label: string;
@@ -2131,24 +1978,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
2131
1978
  }[] | undefined;
2132
1979
  }[] | undefined;
2133
1980
  }, {
2134
- sidebar?: SidebarItemConfig[] | undefined;
1981
+ sidebar?: SidebarItemConfig[] | {
1982
+ display?: "flat" | "page" | "group" | undefined;
1983
+ items?: SidebarItemConfig[] | undefined;
1984
+ } | undefined;
2135
1985
  repo?: boolean | undefined;
2136
- chromeVariants?: {
2137
- path: string;
2138
- banner?: string | {
2139
- content: string;
2140
- type?: "warning" | "info" | "critical" | undefined;
2141
- id?: string | undefined;
2142
- color?: {
2143
- dark?: string | undefined;
2144
- light?: string | undefined;
2145
- } | undefined;
2146
- dismissible?: boolean | undefined;
2147
- link?: {
2148
- href: string;
2149
- text: string;
2150
- } | undefined;
2151
- } | undefined;
1986
+ featured?: {
1987
+ label: string;
1988
+ href: string;
1989
+ icon?: string | undefined;
2152
1990
  }[] | undefined;
2153
1991
  selectors?: {
2154
1992
  label: string;
@@ -2287,7 +2125,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2287
2125
  endpoint: string;
2288
2126
  indexId?: string | undefined;
2289
2127
  }>>;
2290
- prompt: z.ZodOptional<z.ZodString>;
2291
2128
  provider: z.ZodDefault<z.ZodEnum<["orama", "pagefind", "flexsearch", "algolia", "orama-cloud", "typesense", "mixedbread", "none"]>>;
2292
2129
  typesense: z.ZodOptional<z.ZodObject<{
2293
2130
  collection: z.ZodString;
@@ -2326,7 +2163,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2326
2163
  endpoint: string;
2327
2164
  indexId?: string | undefined;
2328
2165
  } | undefined;
2329
- prompt?: string | undefined;
2330
2166
  typesense?: {
2331
2167
  host: string;
2332
2168
  searchApiKey: string;
@@ -2352,7 +2188,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2352
2188
  endpoint: string;
2353
2189
  indexId?: string | undefined;
2354
2190
  } | undefined;
2355
- prompt?: string | undefined;
2356
2191
  typesense?: {
2357
2192
  host: string;
2358
2193
  searchApiKey: string;
@@ -2378,7 +2213,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2378
2213
  endpoint: string;
2379
2214
  indexId?: string | undefined;
2380
2215
  } | undefined;
2381
- prompt?: string | undefined;
2382
2216
  typesense?: {
2383
2217
  host: string;
2384
2218
  searchApiKey: string;
@@ -2404,7 +2238,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2404
2238
  endpoint: string;
2405
2239
  indexId?: string | undefined;
2406
2240
  } | undefined;
2407
- prompt?: string | undefined;
2408
2241
  typesense?: {
2409
2242
  host: string;
2410
2243
  searchApiKey: string;
@@ -2414,7 +2247,34 @@ export declare const blumeConfigSchema: z.ZodObject<{
2414
2247
  } | undefined;
2415
2248
  }>>;
2416
2249
  seo: z.ZodDefault<z.ZodObject<{
2417
- metatags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
2250
+ /**
2251
+ * Emit `agent-readability.json` at the site root: a manifest that indexes
2252
+ * the agent-facing surface (llms.txt, Markdown mirrors, MCP server, feeds)
2253
+ * so agents can discover it without scraping HTML.
2254
+ */
2255
+ agentReadability: z.ZodDefault<z.ZodBoolean>;
2256
+ /** robots.txt `Content-Signal` usage declaration (on by default). */
2257
+ contentSignals: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
2258
+ aiInput: z.ZodDefault<z.ZodBoolean>;
2259
+ aiTrain: z.ZodDefault<z.ZodBoolean>;
2260
+ search: z.ZodDefault<z.ZodBoolean>;
2261
+ }, "strict", z.ZodTypeAny, {
2262
+ search: boolean;
2263
+ aiInput: boolean;
2264
+ aiTrain: boolean;
2265
+ }, {
2266
+ search?: boolean | undefined;
2267
+ aiInput?: boolean | undefined;
2268
+ aiTrain?: boolean | undefined;
2269
+ }>]>, {
2270
+ search: boolean;
2271
+ aiInput: boolean;
2272
+ aiTrain: boolean;
2273
+ } | null, boolean | {
2274
+ search?: boolean | undefined;
2275
+ aiInput?: boolean | undefined;
2276
+ aiTrain?: boolean | undefined;
2277
+ }>>;
2418
2278
  og: z.ZodDefault<z.ZodObject<{
2419
2279
  /**
2420
2280
  * Generate a per-page Open Graph image. Defaults to on once a deployment
@@ -2450,41 +2310,92 @@ export declare const blumeConfigSchema: z.ZodObject<{
2450
2310
  /** Emit schema.org JSON-LD in each page's <head>. */
2451
2311
  structuredData: z.ZodDefault<z.ZodBoolean>;
2452
2312
  }, "strict", z.ZodTypeAny, {
2313
+ agentReadability: boolean;
2314
+ contentSignals: {
2315
+ search: boolean;
2316
+ aiInput: boolean;
2317
+ aiTrain: boolean;
2318
+ } | null;
2319
+ og: {
2320
+ enabled?: boolean | undefined;
2321
+ };
2322
+ robots: boolean;
2453
2323
  rss: {
2454
2324
  enabled: boolean;
2455
2325
  limit: number;
2456
2326
  types: string[];
2457
2327
  };
2458
- metatags: Record<string, string>;
2459
- og: {
2460
- enabled?: boolean | undefined;
2461
- };
2462
- robots: boolean;
2463
2328
  sitemap: boolean;
2464
2329
  structuredData: boolean;
2465
2330
  }, {
2466
- rss?: {
2467
- enabled?: boolean | undefined;
2468
- limit?: number | undefined;
2469
- types?: string[] | undefined;
2331
+ agentReadability?: boolean | undefined;
2332
+ contentSignals?: boolean | {
2333
+ search?: boolean | undefined;
2334
+ aiInput?: boolean | undefined;
2335
+ aiTrain?: boolean | undefined;
2470
2336
  } | undefined;
2471
- metatags?: Record<string, string> | undefined;
2472
2337
  og?: {
2473
2338
  enabled?: boolean | undefined;
2474
2339
  } | undefined;
2475
2340
  robots?: boolean | undefined;
2341
+ rss?: {
2342
+ enabled?: boolean | undefined;
2343
+ limit?: number | undefined;
2344
+ types?: string[] | undefined;
2345
+ } | undefined;
2476
2346
  sitemap?: boolean | undefined;
2477
2347
  structuredData?: boolean | undefined;
2478
2348
  }>>;
2479
2349
  theme: z.ZodDefault<z.ZodObject<{
2480
- accent: z.ZodDefault<z.ZodString>;
2481
- accentDark: z.ZodOptional<z.ZodString>;
2350
+ accent: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodObject<{
2351
+ dark: z.ZodString;
2352
+ light: z.ZodString;
2353
+ }, "strict", z.ZodTypeAny, {
2354
+ dark: string;
2355
+ light: string;
2356
+ }, {
2357
+ dark: string;
2358
+ light: string;
2359
+ }>]>>, {
2360
+ dark: string;
2361
+ light: string;
2362
+ }, string | {
2363
+ dark: string;
2364
+ light: string;
2365
+ } | undefined>;
2482
2366
  action: z.ZodOptional<z.ZodString>;
2483
- background: z.ZodOptional<z.ZodString>;
2484
- backgroundDark: z.ZodOptional<z.ZodString>;
2485
- backgroundDecoration: z.ZodOptional<z.ZodEnum<["gradient", "grid", "windows"]>>;
2486
- backgroundImage: z.ZodOptional<z.ZodString>;
2487
- backgroundImageDark: z.ZodOptional<z.ZodString>;
2367
+ background: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
2368
+ dark: z.ZodOptional<z.ZodString>;
2369
+ light: z.ZodOptional<z.ZodString>;
2370
+ }, "strict", z.ZodTypeAny, {
2371
+ dark?: string | undefined;
2372
+ light?: string | undefined;
2373
+ }, {
2374
+ dark?: string | undefined;
2375
+ light?: string | undefined;
2376
+ }>]>>, {
2377
+ dark?: string | undefined;
2378
+ light?: string | undefined;
2379
+ } | undefined, string | {
2380
+ dark?: string | undefined;
2381
+ light?: string | undefined;
2382
+ } | undefined>;
2383
+ backgroundImage: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
2384
+ dark: z.ZodOptional<z.ZodString>;
2385
+ light: z.ZodOptional<z.ZodString>;
2386
+ }, "strict", z.ZodTypeAny, {
2387
+ dark?: string | undefined;
2388
+ light?: string | undefined;
2389
+ }, {
2390
+ dark?: string | undefined;
2391
+ light?: string | undefined;
2392
+ }>]>>, {
2393
+ dark?: string | undefined;
2394
+ light?: string | undefined;
2395
+ } | undefined, string | {
2396
+ dark?: string | undefined;
2397
+ light?: string | undefined;
2398
+ } | undefined>;
2488
2399
  fonts: z.ZodDefault<z.ZodObject<{
2489
2400
  body: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
2490
2401
  display: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
@@ -2504,39 +2415,49 @@ export declare const blumeConfigSchema: z.ZodObject<{
2504
2415
  strict: z.ZodDefault<z.ZodBoolean>;
2505
2416
  }, "strict", z.ZodTypeAny, {
2506
2417
  strict: boolean;
2507
- mode: "dark" | "light" | "system";
2508
- accent: string;
2418
+ accent: {
2419
+ dark: string;
2420
+ light: string;
2421
+ };
2509
2422
  fonts: {
2510
2423
  mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2511
2424
  display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2512
2425
  body: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2513
2426
  };
2514
2427
  layout: "sidebar";
2428
+ mode: "dark" | "light" | "system";
2515
2429
  radius: "md" | "none" | "sm" | "lg";
2516
- accentDark?: string | undefined;
2517
2430
  action?: string | undefined;
2518
- background?: string | undefined;
2519
- backgroundDark?: string | undefined;
2520
- backgroundDecoration?: "gradient" | "grid" | "windows" | undefined;
2521
- backgroundImage?: string | undefined;
2522
- backgroundImageDark?: string | undefined;
2431
+ background?: {
2432
+ dark?: string | undefined;
2433
+ light?: string | undefined;
2434
+ } | undefined;
2435
+ backgroundImage?: {
2436
+ dark?: string | undefined;
2437
+ light?: string | undefined;
2438
+ } | undefined;
2523
2439
  }, {
2524
2440
  strict?: boolean | undefined;
2525
- mode?: "dark" | "light" | "system" | undefined;
2526
- accent?: string | undefined;
2527
- accentDark?: string | undefined;
2441
+ accent?: string | {
2442
+ dark: string;
2443
+ light: string;
2444
+ } | undefined;
2528
2445
  action?: string | undefined;
2529
- background?: string | undefined;
2530
- backgroundDark?: string | undefined;
2531
- backgroundDecoration?: "gradient" | "grid" | "windows" | undefined;
2532
- backgroundImage?: string | undefined;
2533
- backgroundImageDark?: string | undefined;
2446
+ background?: string | {
2447
+ dark?: string | undefined;
2448
+ light?: string | undefined;
2449
+ } | undefined;
2450
+ backgroundImage?: string | {
2451
+ dark?: string | undefined;
2452
+ light?: string | undefined;
2453
+ } | undefined;
2534
2454
  fonts?: {
2535
2455
  mono?: string | undefined;
2536
2456
  display?: string | undefined;
2537
2457
  body?: string | undefined;
2538
2458
  } | undefined;
2539
2459
  layout?: "sidebar" | undefined;
2460
+ mode?: "dark" | "light" | "system" | undefined;
2540
2461
  radius?: "md" | "none" | "sm" | "lg" | undefined;
2541
2462
  }>>;
2542
2463
  title: z.ZodDefault<z.ZodString>;
@@ -2557,7 +2478,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2557
2478
  maxHeadingLevel?: number | undefined;
2558
2479
  minHeadingLevel?: number | undefined;
2559
2480
  } | undefined>;
2560
- variables: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
2561
2481
  }, "strict", z.ZodTypeAny, {
2562
2482
  title: string;
2563
2483
  feedback: boolean;
@@ -2579,7 +2499,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2579
2499
  endpoint: string;
2580
2500
  indexId?: string | undefined;
2581
2501
  } | undefined;
2582
- prompt?: string | undefined;
2583
2502
  typesense?: {
2584
2503
  host: string;
2585
2504
  searchApiKey: string;
@@ -2597,16 +2516,21 @@ export declare const blumeConfigSchema: z.ZodObject<{
2597
2516
  type: "git" | "frontmatter";
2598
2517
  };
2599
2518
  seo: {
2519
+ agentReadability: boolean;
2520
+ contentSignals: {
2521
+ search: boolean;
2522
+ aiInput: boolean;
2523
+ aiTrain: boolean;
2524
+ } | null;
2525
+ og: {
2526
+ enabled?: boolean | undefined;
2527
+ };
2528
+ robots: boolean;
2600
2529
  rss: {
2601
2530
  enabled: boolean;
2602
2531
  limit: number;
2603
2532
  types: string[];
2604
2533
  };
2605
- metatags: Record<string, string>;
2606
- og: {
2607
- enabled?: boolean | undefined;
2608
- };
2609
- robots: boolean;
2610
2534
  sitemap: boolean;
2611
2535
  structuredData: boolean;
2612
2536
  };
@@ -2616,13 +2540,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
2616
2540
  enabled: boolean;
2617
2541
  model: string;
2618
2542
  provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
2543
+ suggestions: {
2544
+ label: string;
2545
+ icon?: string | undefined;
2546
+ }[];
2619
2547
  apiKeyEnv?: string | undefined;
2620
2548
  baseUrl?: string | undefined;
2621
2549
  } | undefined;
2622
2550
  };
2623
2551
  content: {
2624
2552
  exclude: string[];
2625
- assets: string[];
2626
2553
  defaultType: string;
2627
2554
  include: string[];
2628
2555
  pages: string;
@@ -2683,14 +2610,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2683
2610
  slug?: string | undefined;
2684
2611
  } | undefined;
2685
2612
  publishedValue?: string | undefined;
2686
- } | {
2687
- type: "mintlify";
2688
- exclude: string[];
2689
- include: string[];
2690
- root: string;
2691
- variables: Record<string, string>;
2692
- prefix?: string | undefined;
2693
- configFile?: string | undefined;
2694
2613
  } | {
2695
2614
  type: "custom";
2696
2615
  source: ContentSource;
@@ -2698,22 +2617,27 @@ export declare const blumeConfigSchema: z.ZodObject<{
2698
2617
  };
2699
2618
  theme: {
2700
2619
  strict: boolean;
2701
- mode: "dark" | "light" | "system";
2702
- accent: string;
2620
+ accent: {
2621
+ dark: string;
2622
+ light: string;
2623
+ };
2703
2624
  fonts: {
2704
2625
  mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2705
2626
  display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2706
2627
  body: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
2707
2628
  };
2708
2629
  layout: "sidebar";
2630
+ mode: "dark" | "light" | "system";
2709
2631
  radius: "md" | "none" | "sm" | "lg";
2710
- accentDark?: string | undefined;
2711
2632
  action?: string | undefined;
2712
- background?: string | undefined;
2713
- backgroundDark?: string | undefined;
2714
- backgroundDecoration?: "gradient" | "grid" | "windows" | undefined;
2715
- backgroundImage?: string | undefined;
2716
- backgroundImageDark?: string | undefined;
2633
+ background?: {
2634
+ dark?: string | undefined;
2635
+ light?: string | undefined;
2636
+ } | undefined;
2637
+ backgroundImage?: {
2638
+ dark?: string | undefined;
2639
+ light?: string | undefined;
2640
+ } | undefined;
2717
2641
  };
2718
2642
  asyncapi: {
2719
2643
  enabled: boolean;
@@ -2726,7 +2650,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2726
2650
  spec?: string | undefined;
2727
2651
  theme?: string | undefined;
2728
2652
  };
2729
- variables: Record<string, string>;
2730
2653
  deployment: {
2731
2654
  adapter: "vercel" | "node" | "netlify" | "cloudflare" | null;
2732
2655
  output: "static" | "server";
@@ -2738,9 +2661,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2738
2661
  epub: boolean;
2739
2662
  pdf: boolean;
2740
2663
  };
2741
- icons: {
2742
- library: "lucide" | "fontawesome" | "tabler";
2743
- };
2744
2664
  markdown: {
2745
2665
  code: {
2746
2666
  icons: boolean;
@@ -2764,23 +2684,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
2764
2684
  instructions?: string | undefined;
2765
2685
  };
2766
2686
  navigation: {
2687
+ sidebar: {
2688
+ display: "flat" | "page" | "group";
2689
+ items?: SidebarItemConfig[] | undefined;
2690
+ };
2767
2691
  repo: boolean;
2768
- chromeVariants: {
2769
- path: string;
2770
- banner?: string | {
2771
- content: string;
2772
- dismissible: boolean;
2773
- type?: "warning" | "info" | "critical" | undefined;
2774
- id?: string | undefined;
2775
- color?: {
2776
- dark?: string | undefined;
2777
- light?: string | undefined;
2778
- } | undefined;
2779
- link?: {
2780
- href: string;
2781
- text: string;
2782
- } | undefined;
2783
- } | undefined;
2692
+ featured: {
2693
+ label: string;
2694
+ href: string;
2695
+ icon?: string | undefined;
2784
2696
  }[];
2785
2697
  selectors: {
2786
2698
  label: string;
@@ -2793,7 +2705,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2793
2705
  }[];
2794
2706
  kind: "version" | "dropdown" | "language" | "product";
2795
2707
  }[];
2796
- sidebar?: SidebarItemConfig[] | undefined;
2797
2708
  tabs?: {
2798
2709
  path: string;
2799
2710
  label: string;
@@ -2843,12 +2754,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
2843
2754
  banner?: string | {
2844
2755
  content: string;
2845
2756
  dismissible: boolean;
2846
- type?: "warning" | "info" | "critical" | undefined;
2847
2757
  id?: string | undefined;
2848
- color?: {
2849
- dark?: string | undefined;
2850
- light?: string | undefined;
2851
- } | undefined;
2852
2758
  link?: {
2853
2759
  href: string;
2854
2760
  text: string;
@@ -2860,10 +2766,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2860
2766
  branch: string;
2861
2767
  dir?: string | undefined;
2862
2768
  } | undefined;
2863
- favicon?: string | {
2864
- dark?: string | undefined;
2865
- light?: string | undefined;
2866
- } | undefined;
2867
2769
  i18n?: {
2868
2770
  defaultLocale: string;
2869
2771
  hideDefaultLocalePrefix: boolean;
@@ -2877,10 +2779,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
2877
2779
  ui?: Record<string, Record<string, Record<string, string>>> | undefined;
2878
2780
  } | undefined;
2879
2781
  logo?: string | {
2880
- dark?: string | undefined;
2881
- light?: string | undefined;
2782
+ image?: string | {
2783
+ alt?: string | undefined;
2784
+ dark?: string | undefined;
2785
+ light?: string | undefined;
2786
+ } | undefined;
2882
2787
  href?: string | undefined;
2883
- alt?: string | undefined;
2788
+ text?: string | undefined;
2884
2789
  } | undefined;
2885
2790
  }, {
2886
2791
  title?: string | undefined;
@@ -2903,7 +2808,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
2903
2808
  endpoint: string;
2904
2809
  indexId?: string | undefined;
2905
2810
  } | undefined;
2906
- prompt?: string | undefined;
2907
2811
  typesense?: {
2908
2812
  host: string;
2909
2813
  searchApiKey: string;
@@ -2921,16 +2825,21 @@ export declare const blumeConfigSchema: z.ZodObject<{
2921
2825
  type?: "git" | "frontmatter" | undefined;
2922
2826
  } | undefined;
2923
2827
  seo?: {
2924
- rss?: {
2925
- enabled?: boolean | undefined;
2926
- limit?: number | undefined;
2927
- types?: string[] | undefined;
2828
+ agentReadability?: boolean | undefined;
2829
+ contentSignals?: boolean | {
2830
+ search?: boolean | undefined;
2831
+ aiInput?: boolean | undefined;
2832
+ aiTrain?: boolean | undefined;
2928
2833
  } | undefined;
2929
- metatags?: Record<string, string> | undefined;
2930
2834
  og?: {
2931
2835
  enabled?: boolean | undefined;
2932
2836
  } | undefined;
2933
2837
  robots?: boolean | undefined;
2838
+ rss?: {
2839
+ enabled?: boolean | undefined;
2840
+ limit?: number | undefined;
2841
+ types?: string[] | undefined;
2842
+ } | undefined;
2934
2843
  sitemap?: boolean | undefined;
2935
2844
  structuredData?: boolean | undefined;
2936
2845
  } | undefined;
@@ -2941,6 +2850,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
2941
2850
  enabled?: boolean | undefined;
2942
2851
  model?: string | undefined;
2943
2852
  provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
2853
+ suggestions?: {
2854
+ label: string;
2855
+ icon?: string | undefined;
2856
+ }[] | undefined;
2944
2857
  } | undefined;
2945
2858
  llmsTxt?: boolean | undefined;
2946
2859
  } | undefined;
@@ -3002,19 +2915,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
3002
2915
  slug?: string | undefined;
3003
2916
  } | undefined;
3004
2917
  publishedValue?: string | undefined;
3005
- } | {
3006
- type: "mintlify";
3007
- exclude?: string[] | undefined;
3008
- include?: string[] | undefined;
3009
- root?: string | undefined;
3010
- prefix?: string | undefined;
3011
- configFile?: string | undefined;
3012
- variables?: Record<string, string> | undefined;
3013
2918
  } | {
3014
2919
  type: "custom";
3015
2920
  source: ContentSource;
3016
2921
  })[] | undefined;
3017
- assets?: string[] | undefined;
3018
2922
  defaultType?: string | undefined;
3019
2923
  include?: string[] | undefined;
3020
2924
  pages?: string | undefined;
@@ -3035,21 +2939,26 @@ export declare const blumeConfigSchema: z.ZodObject<{
3035
2939
  } | undefined;
3036
2940
  theme?: {
3037
2941
  strict?: boolean | undefined;
3038
- mode?: "dark" | "light" | "system" | undefined;
3039
- accent?: string | undefined;
3040
- accentDark?: string | undefined;
2942
+ accent?: string | {
2943
+ dark: string;
2944
+ light: string;
2945
+ } | undefined;
3041
2946
  action?: string | undefined;
3042
- background?: string | undefined;
3043
- backgroundDark?: string | undefined;
3044
- backgroundDecoration?: "gradient" | "grid" | "windows" | undefined;
3045
- backgroundImage?: string | undefined;
3046
- backgroundImageDark?: string | undefined;
2947
+ background?: string | {
2948
+ dark?: string | undefined;
2949
+ light?: string | undefined;
2950
+ } | undefined;
2951
+ backgroundImage?: string | {
2952
+ dark?: string | undefined;
2953
+ light?: string | undefined;
2954
+ } | undefined;
3047
2955
  fonts?: {
3048
2956
  mono?: string | undefined;
3049
2957
  display?: string | undefined;
3050
2958
  body?: string | undefined;
3051
2959
  } | undefined;
3052
2960
  layout?: "sidebar" | undefined;
2961
+ mode?: "dark" | "light" | "system" | undefined;
3053
2962
  radius?: "md" | "none" | "sm" | "lg" | undefined;
3054
2963
  } | undefined;
3055
2964
  asyncapi?: {
@@ -3065,12 +2974,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
3065
2974
  } | undefined;
3066
2975
  banner?: string | {
3067
2976
  content: string;
3068
- type?: "warning" | "info" | "critical" | undefined;
3069
2977
  id?: string | undefined;
3070
- color?: {
3071
- dark?: string | undefined;
3072
- light?: string | undefined;
3073
- } | undefined;
3074
2978
  dismissible?: boolean | undefined;
3075
2979
  link?: {
3076
2980
  href: string;
@@ -3083,7 +2987,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
3083
2987
  branch?: string | undefined;
3084
2988
  dir?: string | undefined;
3085
2989
  } | undefined;
3086
- variables?: Record<string, string> | undefined;
3087
2990
  deployment?: {
3088
2991
  adapter?: "vercel" | "node" | "netlify" | "cloudflare" | null | undefined;
3089
2992
  base?: string | undefined;
@@ -3095,10 +2998,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
3095
2998
  epub?: boolean | undefined;
3096
2999
  pdf?: boolean | undefined;
3097
3000
  } | undefined;
3098
- favicon?: string | {
3099
- dark?: string | undefined;
3100
- light?: string | undefined;
3101
- } | undefined;
3102
3001
  i18n?: {
3103
3002
  locales: {
3104
3003
  code: string;
@@ -3111,14 +3010,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
3111
3010
  parser?: "dir" | "dot" | undefined;
3112
3011
  ui?: Record<string, Record<string, Record<string, string>>> | undefined;
3113
3012
  } | undefined;
3114
- icons?: {
3115
- library?: "lucide" | "fontawesome" | "tabler" | undefined;
3116
- } | undefined;
3117
3013
  logo?: string | {
3118
- dark?: string | undefined;
3119
- light?: string | undefined;
3014
+ image?: string | {
3015
+ alt?: string | undefined;
3016
+ dark?: string | undefined;
3017
+ light?: string | undefined;
3018
+ } | undefined;
3120
3019
  href?: string | undefined;
3121
- alt?: string | undefined;
3020
+ text?: string | undefined;
3122
3021
  } | undefined;
3123
3022
  markdown?: {
3124
3023
  code?: {
@@ -3143,24 +3042,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
3143
3042
  instructions?: string | undefined;
3144
3043
  } | undefined;
3145
3044
  navigation?: {
3146
- sidebar?: SidebarItemConfig[] | undefined;
3045
+ sidebar?: SidebarItemConfig[] | {
3046
+ display?: "flat" | "page" | "group" | undefined;
3047
+ items?: SidebarItemConfig[] | undefined;
3048
+ } | undefined;
3147
3049
  repo?: boolean | undefined;
3148
- chromeVariants?: {
3149
- path: string;
3150
- banner?: string | {
3151
- content: string;
3152
- type?: "warning" | "info" | "critical" | undefined;
3153
- id?: string | undefined;
3154
- color?: {
3155
- dark?: string | undefined;
3156
- light?: string | undefined;
3157
- } | undefined;
3158
- dismissible?: boolean | undefined;
3159
- link?: {
3160
- href: string;
3161
- text: string;
3162
- } | undefined;
3163
- } | undefined;
3050
+ featured?: {
3051
+ label: string;
3052
+ href: string;
3053
+ icon?: string | undefined;
3164
3054
  }[] | undefined;
3165
3055
  selectors?: {
3166
3056
  label: string;
@@ -3216,4 +3106,8 @@ export type LocaleConfig = z.infer<typeof localeSchema>;
3216
3106
  export type BlumeConfig = z.input<typeof blumeConfigSchema>;
3217
3107
  /** A configured search backend. */
3218
3108
  export type SearchProvider = (typeof searchProviders)[number];
3109
+ /** Resolved robots.txt `Content-Signal` preferences (`null` when disabled). */
3110
+ export type ContentSignals = z.infer<typeof contentSignalsSchema>;
3111
+ /** The resolved per-signal policy object (present when signals are enabled). */
3112
+ export type ContentSignalPolicy = NonNullable<ContentSignals>;
3219
3113
  export {};