blodemd 0.0.10 → 0.0.11
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.
- package/dist/cli.mjs +370 -286
- package/dist/cli.mjs.map +1 -1
- package/package.json +2 -2
- package/packages/@repo/models/dist/docs-config.d.ts +3 -0
- package/packages/@repo/models/dist/docs-config.d.ts.map +1 -1
- package/packages/@repo/models/dist/docs-config.js +6 -0
- package/packages/@repo/models/src/docs-config.ts +6 -0
- package/packages/@repo/previewing/dist/index.d.ts +1 -0
- package/packages/@repo/previewing/dist/index.d.ts.map +1 -1
- package/packages/@repo/previewing/dist/index.js +5 -2
- package/packages/@repo/previewing/src/index.ts +8 -2
- package/packages/@repo/validation/src/blodemd-docs-schema.json +7 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "blodemd",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.11",
|
|
4
4
|
"description": "Blode.md CLI",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -40,7 +40,6 @@
|
|
|
40
40
|
"@base-ui/react": "^1.3.0",
|
|
41
41
|
"@clack/prompts": "^1.0.0",
|
|
42
42
|
"@mdx-js/mdx": "^3.1.1",
|
|
43
|
-
"@repo/common": "*",
|
|
44
43
|
"@shikijs/rehype": "^4.0.2",
|
|
45
44
|
"@tailwindcss/postcss": "^4.2.2",
|
|
46
45
|
"@types/node": "^22.19.15",
|
|
@@ -74,6 +73,7 @@
|
|
|
74
73
|
"zod": "^4.3.6"
|
|
75
74
|
},
|
|
76
75
|
"devDependencies": {
|
|
76
|
+
"@repo/common": "*",
|
|
77
77
|
"@repo/previewing": "*",
|
|
78
78
|
"@repo/typescript-config": "*",
|
|
79
79
|
"oxfmt": "^0.42.0",
|
|
@@ -443,6 +443,7 @@ export declare const DocsConfigSchema: z.ZodObject<{
|
|
|
443
443
|
all: "all";
|
|
444
444
|
}>>;
|
|
445
445
|
}, z.core.$strict>>;
|
|
446
|
+
slug: z.ZodOptional<z.ZodString>;
|
|
446
447
|
}, z.core.$strict>;
|
|
447
448
|
export type DocsConfig = z.infer<typeof DocsConfigSchema>;
|
|
448
449
|
export declare const MintlifyDocsConfigSchema: z.ZodObject<{
|
|
@@ -639,6 +640,7 @@ export declare const MintlifyDocsConfigSchema: z.ZodObject<{
|
|
|
639
640
|
all: "all";
|
|
640
641
|
}>>;
|
|
641
642
|
}, z.core.$strict>>;
|
|
643
|
+
slug: z.ZodOptional<z.ZodString>;
|
|
642
644
|
}, z.core.$strict>;
|
|
643
645
|
export type MintlifyDocsConfig = DocsConfig;
|
|
644
646
|
export declare const ContentTypeSchema: z.ZodEnum<{
|
|
@@ -1138,6 +1140,7 @@ export declare const SiteConfigSchema: z.ZodObject<{
|
|
|
1138
1140
|
all: "all";
|
|
1139
1141
|
}>>;
|
|
1140
1142
|
}, z.core.$strict>>;
|
|
1143
|
+
slug: z.ZodOptional<z.ZodString>;
|
|
1141
1144
|
theme: z.ZodOptional<z.ZodString>;
|
|
1142
1145
|
}, z.core.$strict>;
|
|
1143
1146
|
export type SiteConfig = z.infer<typeof SiteConfigSchema>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"docs-config.d.ts","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
const UrlOrPathSchema = z.string().min(1);
|
|
3
|
+
const SlugSchema = z
|
|
4
|
+
.string()
|
|
5
|
+
.min(1)
|
|
6
|
+
.regex(/^[a-z0-9-]+$/);
|
|
3
7
|
export const DocsColorsSchema = z
|
|
4
8
|
.object({
|
|
5
9
|
background: z.string().optional(),
|
|
@@ -370,6 +374,7 @@ export const DocsConfigSchema = z
|
|
|
370
374
|
navigation: MintlifyNavigationSchema,
|
|
371
375
|
search: MintlifySearchSchema.optional(),
|
|
372
376
|
seo: DocsSeoSchema.optional(),
|
|
377
|
+
slug: SlugSchema.optional(),
|
|
373
378
|
})
|
|
374
379
|
.strict();
|
|
375
380
|
export const MintlifyDocsConfigSchema = DocsConfigSchema;
|
|
@@ -518,6 +523,7 @@ export const SiteConfigSchema = z
|
|
|
518
523
|
openapiProxy: DocsOpenApiProxySchema.optional(),
|
|
519
524
|
scripts: DocsScriptsSchema.optional(),
|
|
520
525
|
seo: DocsSeoSchema.optional(),
|
|
526
|
+
slug: SlugSchema.optional(),
|
|
521
527
|
theme: z.string().optional(),
|
|
522
528
|
})
|
|
523
529
|
.strict();
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
|
|
3
3
|
const UrlOrPathSchema = z.string().min(1);
|
|
4
|
+
const SlugSchema = z
|
|
5
|
+
.string()
|
|
6
|
+
.min(1)
|
|
7
|
+
.regex(/^[a-z0-9-]+$/);
|
|
4
8
|
|
|
5
9
|
export const DocsColorsSchema = z
|
|
6
10
|
.object({
|
|
@@ -432,6 +436,7 @@ export const DocsConfigSchema = z
|
|
|
432
436
|
navigation: MintlifyNavigationSchema,
|
|
433
437
|
search: MintlifySearchSchema.optional(),
|
|
434
438
|
seo: DocsSeoSchema.optional(),
|
|
439
|
+
slug: SlugSchema.optional(),
|
|
435
440
|
})
|
|
436
441
|
.strict();
|
|
437
442
|
|
|
@@ -610,6 +615,7 @@ export const SiteConfigSchema = z
|
|
|
610
615
|
openapiProxy: DocsOpenApiProxySchema.optional(),
|
|
611
616
|
scripts: DocsScriptsSchema.optional(),
|
|
612
617
|
seo: DocsSeoSchema.optional(),
|
|
618
|
+
slug: SlugSchema.optional(),
|
|
613
619
|
theme: z.string().optional(),
|
|
614
620
|
})
|
|
615
621
|
.strict();
|
|
@@ -13,6 +13,7 @@ export declare const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
|
|
|
13
13
|
export declare const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
|
|
14
14
|
export declare const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
|
|
15
15
|
export declare const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
|
|
16
|
+
export declare const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
|
|
16
17
|
export type SiteConfigResult = {
|
|
17
18
|
ok: true;
|
|
18
19
|
config: SiteConfig;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,WAAW,EAEX,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAC9D,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -15,6 +15,7 @@ export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
|
|
|
15
15
|
export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
|
|
16
16
|
export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
|
|
17
17
|
export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
|
|
18
|
+
export const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
|
|
18
19
|
const validModes = new Set(PageModeSchema.options);
|
|
19
20
|
export const buildPageMetadataMap = (index) => {
|
|
20
21
|
const map = new Map();
|
|
@@ -203,8 +204,10 @@ const mapDocsConfig = (docs) => {
|
|
|
203
204
|
Boolean(docs.api?.openapi || docs.api?.asyncapi),
|
|
204
205
|
},
|
|
205
206
|
seo: docs.seo,
|
|
207
|
+
slug: docs.slug,
|
|
206
208
|
};
|
|
207
209
|
};
|
|
210
|
+
const getProjectWarnings = (config) => config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
|
|
208
211
|
const readJsonConfig = async (source, relativePath) => JSON.parse(await source.readFile(relativePath));
|
|
209
212
|
const normalizeRefPath = (baseDirectory, reference) => {
|
|
210
213
|
if (reference.startsWith("/") ||
|
|
@@ -277,7 +280,7 @@ const loadDocsConfig = async (source) => {
|
|
|
277
280
|
return {
|
|
278
281
|
config: siteResult.data,
|
|
279
282
|
ok: true,
|
|
280
|
-
warnings:
|
|
283
|
+
warnings: getProjectWarnings(siteResult.data),
|
|
281
284
|
};
|
|
282
285
|
}
|
|
283
286
|
// Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
|
|
@@ -286,7 +289,7 @@ const loadDocsConfig = async (source) => {
|
|
|
286
289
|
return {
|
|
287
290
|
config: mapDocsConfig(docsResult.data),
|
|
288
291
|
ok: true,
|
|
289
|
-
warnings:
|
|
292
|
+
warnings: getProjectWarnings(docsResult.data),
|
|
290
293
|
};
|
|
291
294
|
}
|
|
292
295
|
return { errors: docsResult.errors, ok: false };
|
|
@@ -40,6 +40,8 @@ export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
|
|
|
40
40
|
export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
|
|
41
41
|
export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
|
|
42
42
|
export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
|
|
43
|
+
export const LEGACY_PROJECT_NAME_FALLBACK_WARNING =
|
|
44
|
+
"docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
|
|
43
45
|
|
|
44
46
|
export type SiteConfigResult =
|
|
45
47
|
| { ok: true; config: SiteConfig; warnings: string[] }
|
|
@@ -334,9 +336,13 @@ const mapDocsConfig = (docs: DocsConfig): SiteConfig => {
|
|
|
334
336
|
Boolean(docs.api?.openapi || docs.api?.asyncapi),
|
|
335
337
|
},
|
|
336
338
|
seo: docs.seo,
|
|
339
|
+
slug: docs.slug,
|
|
337
340
|
};
|
|
338
341
|
};
|
|
339
342
|
|
|
343
|
+
const getProjectWarnings = (config: { slug?: string }): string[] =>
|
|
344
|
+
config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
|
|
345
|
+
|
|
340
346
|
const readJsonConfig = async (source: ContentSource, relativePath: string) =>
|
|
341
347
|
JSON.parse(await source.readFile(relativePath)) as unknown;
|
|
342
348
|
|
|
@@ -463,7 +469,7 @@ const loadDocsConfig = async (
|
|
|
463
469
|
return {
|
|
464
470
|
config: siteResult.data,
|
|
465
471
|
ok: true,
|
|
466
|
-
warnings:
|
|
472
|
+
warnings: getProjectWarnings(siteResult.data),
|
|
467
473
|
};
|
|
468
474
|
}
|
|
469
475
|
|
|
@@ -473,7 +479,7 @@ const loadDocsConfig = async (
|
|
|
473
479
|
return {
|
|
474
480
|
config: mapDocsConfig(docsResult.data),
|
|
475
481
|
ok: true,
|
|
476
|
-
warnings:
|
|
482
|
+
warnings: getProjectWarnings(docsResult.data),
|
|
477
483
|
};
|
|
478
484
|
}
|
|
479
485
|
|
|
@@ -3233,7 +3233,7 @@
|
|
|
3233
3233
|
"name": {
|
|
3234
3234
|
"type": "string",
|
|
3235
3235
|
"minLength": 1,
|
|
3236
|
-
"description": "
|
|
3236
|
+
"description": "Display name for your site, project, or organization."
|
|
3237
3237
|
},
|
|
3238
3238
|
"description": {
|
|
3239
3239
|
"type": "string",
|
|
@@ -3561,6 +3561,12 @@
|
|
|
3561
3561
|
},
|
|
3562
3562
|
"additionalProperties": false,
|
|
3563
3563
|
"description": "Metadata configuration for documentation pages"
|
|
3564
|
+
},
|
|
3565
|
+
"slug": {
|
|
3566
|
+
"description": "URL-safe project slug used for deployments and the default `{slug}.blode.md` hostname.",
|
|
3567
|
+
"minLength": 1,
|
|
3568
|
+
"pattern": "^[a-z0-9-]+$",
|
|
3569
|
+
"type": "string"
|
|
3564
3570
|
}
|
|
3565
3571
|
},
|
|
3566
3572
|
"required": ["name", "navigation"],
|