valaxy 1.1.0 → 1.2.1

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.
@@ -433,6 +433,14 @@ declare module 'vue-router' {
433
433
  * Layout name
434
434
  */
435
435
  layout?: string
436
+ /**
437
+ * Props passed to the layout component
438
+ */
439
+ layoutProps?: Record<string, unknown>
440
+ /**
441
+ * Set on the parent routes generated by `setupLayouts`
442
+ */
443
+ isLayout?: boolean
436
444
  }
437
445
  }
438
446
 
@@ -939,6 +947,41 @@ interface SiteConfig {
939
947
  * @default ['posts\/**\/*.md']
940
948
  */
941
949
  include?: string[];
950
+ /**
951
+ * @zh 从 `llms.txt` 和 `llms-full.txt` 排除的 glob(相对于 `pages/`,语法与 `include` 相同)。
952
+ * `files` 仍会写出对应的 `.md` 文件。
953
+ * 不设置时不做排除,因此只开启 `enable` 的站点保持原有输出。
954
+ * @en Glob patterns, relative to `pages/` and using the same syntax as `include`, omitted from `llms.txt` and `llms-full.txt`.
955
+ * Individual `.md` files are still written when `files` is true.
956
+ * Unset means nothing is excluded, so sites that only enable llms keep their previous output.
957
+ */
958
+ exclude?: string[];
959
+ /**
960
+ * @zh `llms.txt` 分组标题的顺序,例如 `['Guide', 'Posts']`。未列出的分组按原顺序排在后面。匹配时忽略大小写。
961
+ * @en Section headings in `llms.txt`, first to last, for example `['Guide', 'Posts']`. Headings you omit keep their original order after these. Matching ignores case.
962
+ */
963
+ sectionOrder?: string[];
964
+ /**
965
+ * @zh 作为语言而不是栏目的 URL 前缀,例如 `['zh']`。
966
+ * `/zh/guide/why` 会归入 `Guide (zh)`,而不是把所有中文页放进一个 `Zh` 分组。
967
+ * 不设置时仍用路径的第一段作为分组名。
968
+ * @en URL prefixes that are languages rather than sections, for example `['zh']`.
969
+ * `/zh/guide/why` is grouped as `Guide (zh)` instead of placing every Chinese page in one `Zh` section.
970
+ * Unset keeps the first path segment as the section name.
971
+ */
972
+ locales?: string[];
973
+ /**
974
+ * @zh 在 `llms.txt` 开头置顶的页面。
975
+ * @en Pages pinned to the start of `llms.txt`.
976
+ */
977
+ featured?: LlmsFeatured;
978
+ /**
979
+ * @zh 把一批页面折叠成 `llms.txt` 中的一条链接,并从不写入 `llms-full.txt`。
980
+ * 对应的 `.md` 文件仍会生成。适合把 API 参考收成一个 `/api/` 入口。
981
+ * @en Replace a set of pages with one `llms.txt` link and omit them from `llms-full.txt`.
982
+ * The `.md` files are still generated. Use this to collapse an API reference to a single `/api/` entry.
983
+ */
984
+ collapse?: LlmsCollapse[];
942
985
  };
943
986
  /**
944
987
  * @description:en-US client redirect rules
@@ -949,6 +992,52 @@ interface SiteConfig {
949
992
  rules?: RedirectRule[];
950
993
  };
951
994
  }
995
+ /**
996
+ * One `llms.txt` link that stands in for every page matching `match`.
997
+ */
998
+ interface LlmsCollapse {
999
+ /**
1000
+ * @zh 相对于 `pages/` 的 glob,语法与 `include` 相同,例如 `api/**\/*.md`。
1001
+ * @en Glob relative to `pages/`, same syntax as `include`, for example `api/**\/*.md`.
1002
+ */
1003
+ match: string;
1004
+ /**
1005
+ * @zh 索引里这条链接的标题
1006
+ * @en Title of the index link
1007
+ */
1008
+ title: string;
1009
+ /**
1010
+ * @zh 链接路径。以 `/` 结尾时保持目录地址(如 `/api/`);否则像普通条目一样补上 `.md`。
1011
+ * @en Link path. A trailing slash stays a directory URL (for example `/api/`). Other paths gain a `.md` suffix, like normal entries.
1012
+ */
1013
+ href: string;
1014
+ /**
1015
+ * @zh 可选描述,写在链接后面
1016
+ * @en Optional description appended after the link
1017
+ */
1018
+ description?: string;
1019
+ /**
1020
+ * @zh 可选分组标题。默认由 `href` 推断:`/api/` 为 `Api`;设置 `locales: ['zh']` 时 `/zh/api/` 为 `Api (zh)`。
1021
+ * @en Optional section heading. Defaults from `href`: `/api/` becomes `Api`, and `/zh/api/` becomes `Api (zh)` when `locales` includes `zh`.
1022
+ */
1023
+ section?: string;
1024
+ }
1025
+ /**
1026
+ * Pages lifted to the front of `llms.txt`.
1027
+ */
1028
+ interface LlmsFeatured {
1029
+ /**
1030
+ * @zh 置顶分组的标题
1031
+ * @en Heading for the leading section
1032
+ * @default 'Docs'
1033
+ */
1034
+ title?: string;
1035
+ /**
1036
+ * @zh 按此顺序置顶的站点路径,例如 `/guide/getting-started`。这些页面不会在后面的分组里再次出现。
1037
+ * @en Site paths pinned first, in this order, for example `/guide/getting-started`. They are not repeated in later sections.
1038
+ */
1039
+ paths: string[];
1040
+ }
952
1041
  type PartialDeep<T> = {
953
1042
  [P in keyof T]?: T[P] extends object ? PartialDeep<T[P]> : T[P];
954
1043
  };
@@ -1012,4 +1101,4 @@ type UserSiteConfig = PartialDeep<SiteConfig>;
1012
1101
  type UserValaxyConfig<ThemeConfig = DefaultTheme.Config> = PartialDeep<ValaxyConfig<ThemeConfig>>;
1013
1102
 
1014
1103
  export { DefaultTheme as D };
1015
- export type { Album as A, BaseFrontMatter as B, ExcerptType as E, FuseListItem as F, PartialDeep as P, RuntimeConfig as R, SiteConfig as S, UserSiteConfig as U, ValaxyConfig as V, RedirectItem as a, ValaxyAddon as b, Post as c, Page as d, PageFrontMatter as e, Photo as f, Pkg as g, PostFrontMatter as h, RedirectRule as i, SocialLink as j, UserValaxyConfig as k };
1104
+ export type { Album as A, BaseFrontMatter as B, ExcerptType as E, FuseListItem as F, LlmsCollapse as L, PartialDeep as P, RuntimeConfig as R, SiteConfig as S, UserSiteConfig as U, ValaxyConfig as V, RedirectItem as a, ValaxyAddon as b, Post as c, LlmsFeatured as d, Page as e, PageFrontMatter as f, Photo as g, Pkg as h, PostFrontMatter as i, RedirectRule as j, SocialLink as k, UserValaxyConfig as l };
@@ -1,5 +1,5 @@
1
- import { c as Post } from '../shared/valaxy.I4MpBkZO.mjs';
2
- export { A as Album, B as BaseFrontMatter, D as DefaultTheme, E as ExcerptType, F as FuseListItem, d as Page, e as PageFrontMatter, P as PartialDeep, f as Photo, g as Pkg, h as PostFrontMatter, a as RedirectItem, i as RedirectRule, R as RuntimeConfig, S as SiteConfig, j as SocialLink, U as UserSiteConfig, k as UserValaxyConfig, b as ValaxyAddon, V as ValaxyConfig } from '../shared/valaxy.I4MpBkZO.mjs';
1
+ import { c as Post } from '../shared/valaxy.EzGcrVef.mjs';
2
+ export { A as Album, B as BaseFrontMatter, D as DefaultTheme, E as ExcerptType, F as FuseListItem, L as LlmsCollapse, d as LlmsFeatured, e as Page, f as PageFrontMatter, P as PartialDeep, g as Photo, h as Pkg, i as PostFrontMatter, a as RedirectItem, j as RedirectRule, R as RuntimeConfig, S as SiteConfig, k as SocialLink, U as UserSiteConfig, l as UserValaxyConfig, b as ValaxyAddon, V as ValaxyConfig } from '../shared/valaxy.EzGcrVef.mjs';
3
3
  import { Header } from '@valaxyjs/utils';
4
4
  import '@vueuse/integrations/useFuse';
5
5
  import 'medium-zoom';
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "valaxy",
3
3
  "type": "module",
4
- "version": "1.1.0",
4
+ "version": "1.2.1",
5
5
  "description": "📄 Vite & Vue powered static blog generator.",
6
6
  "author": {
7
7
  "email": "me@yunyoujun.cn",
@@ -68,22 +68,16 @@
68
68
  "@antfu/install-pkg": "^2.1.0",
69
69
  "@antfu/utils": "^9.3.0",
70
70
  "@clack/prompts": "^1.8.1",
71
- "@eslint-community/eslint-utils": "^4.4.0",
72
71
  "@iconify-json/ri": "^1.2.10",
73
- "@intlify/bundle-utils": "11.2.5",
74
- "@intlify/shared": "~11.4.2",
75
- "@intlify/vue-i18n-extensions": "^8.0.0",
76
- "@rollup/pluginutils": "^5.1.0",
72
+ "@intlify/unplugin-vue-i18n": "11.2.8",
77
73
  "@shikijs/transformers": "^4.4.3",
78
74
  "@types/katex": "^0.16.8",
79
- "@typescript-eslint/scope-manager": "^8.13.0",
80
- "@typescript-eslint/typescript-estree": "^8.13.0",
81
75
  "@unhead/bundler": "^3.4.1",
82
76
  "@unhead/schema-org": "^3.4.1",
83
77
  "@unhead/vue": "^3.4.1",
84
- "@valaxyjs/devtools": "1.1.0",
85
- "@valaxyjs/utils": "1.1.0",
86
- "@vitejs/devtools": "0.7.5",
78
+ "@valaxyjs/devtools": "1.2.1",
79
+ "@valaxyjs/utils": "1.2.1",
80
+ "@vitejs/devtools": "0.8.0",
87
81
  "@vitejs/plugin-vue": "^6.0.9",
88
82
  "@vueuse/core": "^15.0.0",
89
83
  "@vueuse/integrations": "^15.0.0",
@@ -110,9 +104,9 @@
110
104
  "katex": "^0.18.7",
111
105
  "local-pkg": "^1.2.1",
112
106
  "lru-cache": "^11.5.3",
113
- "magic-string": "^0.30.21",
107
+ "magic-string": "^1.4.3",
114
108
  "markdown-exit": "^1.3.0",
115
- "markdown-it": "^15.0.2",
109
+ "markdown-it": "^15.0.3",
116
110
  "markdown-it-anchor": "^10.0.0",
117
111
  "markdown-it-attrs": "^5.0.1",
118
112
  "markdown-it-container": "^4.0.0",
@@ -131,7 +125,6 @@
131
125
  "p-map": "^7.0.8",
132
126
  "pascalcase": "^2.0.0",
133
127
  "pathe": "^2.0.3",
134
- "picocolors": "^1.0.0",
135
128
  "picomatch": "^4.0.4",
136
129
  "pinia": "^4.0.3",
137
130
  "qrcode": "^1.5.4",
@@ -139,21 +132,21 @@
139
132
  "resolve-global": "^2.0.0",
140
133
  "sass": "^1.104.1",
141
134
  "shiki": "^4.4.3",
142
- "star-markdown-css": "^0.5.3",
135
+ "star-markdown-css": "^0.6.1",
143
136
  "table": "^6.9.0",
144
137
  "tinyglobby": "^0.2.17",
145
138
  "unhead": "^3.4.1",
146
- "unocss": "66.10.5",
139
+ "unocss": "^66.11.0",
147
140
  "unplugin": "^3.0.0",
148
141
  "unplugin-utils": "^0.3.1",
149
142
  "unplugin-vue-components": "32.1.0",
150
143
  "unplugin-vue-markdown": "^32.1.1",
151
144
  "vanilla-lazyload": "^19.1.3",
152
- "vite": "^8.3.0",
145
+ "vite": "^8.3.6",
153
146
  "vite-plugin-vue-devtools": "^8.2.1",
154
147
  "vite-ssg-sitemap": "^0.10.0",
155
148
  "vitepress-plugin-group-icons": "^1.7.6",
156
- "vue-i18n": "^11.4.12",
149
+ "vue-i18n": "^11.4.18",
157
150
  "yargs": "^18.1.0"
158
151
  },
159
152
  "devDependencies": {
package/types/config.ts CHANGED
@@ -480,6 +480,41 @@ export interface SiteConfig {
480
480
  * @default ['posts\/**\/*.md']
481
481
  */
482
482
  include?: string[]
483
+ /**
484
+ * @zh 从 `llms.txt` 和 `llms-full.txt` 排除的 glob(相对于 `pages/`,语法与 `include` 相同)。
485
+ * `files` 仍会写出对应的 `.md` 文件。
486
+ * 不设置时不做排除,因此只开启 `enable` 的站点保持原有输出。
487
+ * @en Glob patterns, relative to `pages/` and using the same syntax as `include`, omitted from `llms.txt` and `llms-full.txt`.
488
+ * Individual `.md` files are still written when `files` is true.
489
+ * Unset means nothing is excluded, so sites that only enable llms keep their previous output.
490
+ */
491
+ exclude?: string[]
492
+ /**
493
+ * @zh `llms.txt` 分组标题的顺序,例如 `['Guide', 'Posts']`。未列出的分组按原顺序排在后面。匹配时忽略大小写。
494
+ * @en Section headings in `llms.txt`, first to last, for example `['Guide', 'Posts']`. Headings you omit keep their original order after these. Matching ignores case.
495
+ */
496
+ sectionOrder?: string[]
497
+ /**
498
+ * @zh 作为语言而不是栏目的 URL 前缀,例如 `['zh']`。
499
+ * `/zh/guide/why` 会归入 `Guide (zh)`,而不是把所有中文页放进一个 `Zh` 分组。
500
+ * 不设置时仍用路径的第一段作为分组名。
501
+ * @en URL prefixes that are languages rather than sections, for example `['zh']`.
502
+ * `/zh/guide/why` is grouped as `Guide (zh)` instead of placing every Chinese page in one `Zh` section.
503
+ * Unset keeps the first path segment as the section name.
504
+ */
505
+ locales?: string[]
506
+ /**
507
+ * @zh 在 `llms.txt` 开头置顶的页面。
508
+ * @en Pages pinned to the start of `llms.txt`.
509
+ */
510
+ featured?: LlmsFeatured
511
+ /**
512
+ * @zh 把一批页面折叠成 `llms.txt` 中的一条链接,并从不写入 `llms-full.txt`。
513
+ * 对应的 `.md` 文件仍会生成。适合把 API 参考收成一个 `/api/` 入口。
514
+ * @en Replace a set of pages with one `llms.txt` link and omit them from `llms-full.txt`.
515
+ * The `.md` files are still generated. Use this to collapse an API reference to a single `/api/` entry.
516
+ */
517
+ collapse?: LlmsCollapse[]
483
518
  }
484
519
 
485
520
  /**
@@ -492,6 +527,54 @@ export interface SiteConfig {
492
527
  }
493
528
  }
494
529
 
530
+ /**
531
+ * One `llms.txt` link that stands in for every page matching `match`.
532
+ */
533
+ export interface LlmsCollapse {
534
+ /**
535
+ * @zh 相对于 `pages/` 的 glob,语法与 `include` 相同,例如 `api/**\/*.md`。
536
+ * @en Glob relative to `pages/`, same syntax as `include`, for example `api/**\/*.md`.
537
+ */
538
+ match: string
539
+ /**
540
+ * @zh 索引里这条链接的标题
541
+ * @en Title of the index link
542
+ */
543
+ title: string
544
+ /**
545
+ * @zh 链接路径。以 `/` 结尾时保持目录地址(如 `/api/`);否则像普通条目一样补上 `.md`。
546
+ * @en Link path. A trailing slash stays a directory URL (for example `/api/`). Other paths gain a `.md` suffix, like normal entries.
547
+ */
548
+ href: string
549
+ /**
550
+ * @zh 可选描述,写在链接后面
551
+ * @en Optional description appended after the link
552
+ */
553
+ description?: string
554
+ /**
555
+ * @zh 可选分组标题。默认由 `href` 推断:`/api/` 为 `Api`;设置 `locales: ['zh']` 时 `/zh/api/` 为 `Api (zh)`。
556
+ * @en Optional section heading. Defaults from `href`: `/api/` becomes `Api`, and `/zh/api/` becomes `Api (zh)` when `locales` includes `zh`.
557
+ */
558
+ section?: string
559
+ }
560
+
561
+ /**
562
+ * Pages lifted to the front of `llms.txt`.
563
+ */
564
+ export interface LlmsFeatured {
565
+ /**
566
+ * @zh 置顶分组的标题
567
+ * @en Heading for the leading section
568
+ * @default 'Docs'
569
+ */
570
+ title?: string
571
+ /**
572
+ * @zh 按此顺序置顶的站点路径,例如 `/guide/getting-started`。这些页面不会在后面的分组里再次出现。
573
+ * @en Site paths pinned first, in this order, for example `/guide/getting-started`. They are not repeated in later sections.
574
+ */
575
+ paths: string[]
576
+ }
577
+
495
578
  export type PartialDeep<T> = {
496
579
  [P in keyof T]?: T[P] extends object ? PartialDeep<T[P]> : T[P]
497
580
  }
@@ -25,5 +25,13 @@ declare module 'vue-router' {
25
25
  * Layout name
26
26
  */
27
27
  layout?: string
28
+ /**
29
+ * Props passed to the layout component
30
+ */
31
+ layoutProps?: Record<string, unknown>
32
+ /**
33
+ * Set on the parent routes generated by `setupLayouts`
34
+ */
35
+ isLayout?: boolean
28
36
  }
29
37
  }
package/vendor/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Build plugin snapshots
2
2
 
3
- These MIT-licensed distribution snapshots keep Valaxy's stable compiler and layout
3
+ These MIT-licensed distribution snapshots keep Valaxy's component discovery
4
4
  behavior while removing the vulnerable `fast-glob → micromatch → braces` chain
5
5
  from published packages. `sources.json` records the original npm versions, source
6
6
  repositories and SHA-256 hashes of every copied file. Each directory includes its
@@ -8,13 +8,6 @@ upstream license. Other runtime dependencies remain explicit in Valaxy's manifes
8
8
 
9
9
  Changes relative to the recorded distributions:
10
10
 
11
- - `@intlify/unplugin-vue-i18n@11.2.5`: replace its async file scanner with
12
- `tinyglobby.glob`, requesting absolute locale paths for Windows cross-drive
13
- projects. Keep the stable message compiler and SFC transforms.
14
- - `vite-plugin-vue-layouts-next@3.2.0`: replace async/sync scanners with
15
- `tinyglobby.glob`/`globSync`; resolve directory globs against Vite's root;
16
- import the included browser runtime through `valaxy/vendor/layouts/runtime.mjs`.
17
- Browser runtime and layout-name normalization are otherwise unchanged.
18
11
  - `unplugin-vue-components@32.1.0`: sort component paths by the configured glob
19
12
  priority when rebuilding the registry. This preserves core → theme → addon →
20
13
  user overrides after initial discovery and file additions/removals, independent
@@ -27,3 +20,10 @@ and compiled JSON/YAML locales. Full Yun/Press SSG and packed-consumer tests ver
27
20
  the published artifacts. No audit exemptions or consumer overrides are needed
28
21
  for the replacement scanners. Remove a snapshot once its upstream stable release
29
22
  provides the same scanning/ordering behavior and passes these regressions.
23
+
24
+ The layout system was vendored from `vite-plugin-vue-layouts-next@3.2.0` until Valaxy
25
+ replaced it with its own `node/plugins/layouts.ts` and `client/utils/layouts.ts`,
26
+ which keep that plugin's options, layout-name normalization and runtime behavior.
27
+
28
+ `@intlify/unplugin-vue-i18n` was vendored at 11.2.5 until upstream 11.2.7 adopted
29
+ `tinyglobby` with absolute paths; Valaxy now depends on the npm release directly.
@@ -1,35 +1,4 @@
1
1
  [
2
- {
3
- "package": "@intlify/unplugin-vue-i18n",
4
- "version": "11.2.5",
5
- "repository": {
6
- "type": "git",
7
- "url": "git+https://github.com/intlify/bundle-tools.git",
8
- "directory": "packages/unplugin-vue-i18n"
9
- },
10
- "files": {
11
- "lib/index.mjs": "0b9279529baf89e0c027a9d4db94dd69fef9d357e457606db3ccf6e178e21268",
12
- "lib/types.d.ts": "d1315ab34c1eb6588ba2fd8a040146f940fb37d1c5ba72e19daa2f46e9615190",
13
- "LICENSE": "5332a7645b0acec33bef55f24b5c16ffaa60c097e2aade91a7945c2f12607636"
14
- }
15
- },
16
- {
17
- "package": "vite-plugin-vue-layouts-next",
18
- "version": "3.2.0",
19
- "repository": {
20
- "type": "git",
21
- "url": "git+https://github.com/loicduong/vite-plugin-vue-layouts-next.git"
22
- },
23
- "files": {
24
- "dist/index.mjs": "edab37ca837b9261f651e567af175942934b161726a45ca9b22a291c1a1be465",
25
- "dist/index.d.mts": "d622d03bc14a55d033fb4c164b8ce7256a9c042a328b0bd42849483359d9e915",
26
- "dist/runtime.mjs": "70d6c6164ab2e3211e393b3044c03aa96c10b3cf0dee90da38881c8a4e33b454",
27
- "dist/runtime.d.mts": "450f7f97295a601a412358e2fa2e57828b86611e8bc01e9b135a1dea4b0f8b7f",
28
- "dist/layoutName-DVkP7Qpo.mjs": "80eaa8258117a0f35a86855a5c749c6090da04df13169675715ab6ffce908e88",
29
- "client.d.ts": "5faf3587eae88f0a014a6ddc5693376fe7a153bb36bbabf622e65dda4e9f1422",
30
- "LICENSE": "3b66548ac8a2385a8756e574acdcff245cebb4dfae4ab277183dd3ce276e1330"
31
- }
32
- },
33
2
  {
34
3
  "package": "unplugin-vue-components",
35
4
  "version": "32.1.0",
@@ -1,20 +0,0 @@
1
- The MIT License (MIT)
2
-
3
- Copyright (c) 2022-present, kazuya kawaguchi
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy of
6
- this software and associated documentation files (the "Software"), to deal in
7
- the Software without restriction, including without limitation the rights to
8
- use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
9
- the Software, and to permit persons to whom the Software is furnished to do so,
10
- subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
17
- FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
18
- COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
19
- IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
20
- CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -1,7 +0,0 @@
1
- import type { UnpluginInstance, UnpluginFactory } from 'unplugin'
2
- import type { PluginOptions } from './types.js'
3
- export type { PluginOptions, SFCLangFormat, TreeShakingOptions, VueI18nModule } from './types.js'
4
- declare const unpluginFactory: UnpluginFactory<PluginOptions | undefined>
5
- declare const unplugin: UnpluginInstance<PluginOptions | undefined, boolean>
6
- export { unplugin, unpluginFactory }
7
- export default unplugin