@zpress/kit 0.1.1 → 0.1.2
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/LICENSE +1 -1
- package/README.md +79 -0
- package/dist/cli.d.ts +1 -0
- package/dist/config.d.ts +32 -0
- package/dist/index.d.ts +92 -0
- package/package.json +21 -7
package/LICENSE
CHANGED
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/joggrdocs/zpress/main/assets/banner.svg" alt="zpress" width="90%" />
|
|
3
|
+
<p><strong>An opinionated documentation framework for monorepos. Just point it at your code.</strong></p>
|
|
4
|
+
|
|
5
|
+
<a href="https://github.com/joggrdocs/zpress/actions/workflows/ci.yml"><img src="https://github.com/joggrdocs/zpress/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI" /></a>
|
|
6
|
+
<a href="https://www.npmjs.com/package/@zpress/kit"><img src="https://img.shields.io/npm/v/@zpress/kit" alt="npm version" /></a>
|
|
7
|
+
<a href="https://github.com/joggrdocs/zpress/blob/main/LICENSE"><img src="https://img.shields.io/github/license/joggrdocs/zpress" alt="License" /></a>
|
|
8
|
+
|
|
9
|
+
</div>
|
|
10
|
+
|
|
11
|
+
## Features
|
|
12
|
+
|
|
13
|
+
- :gear: **Config over convention** — Define sections, pages, and nav in one declarative config.
|
|
14
|
+
- :zap: **Zero-config defaults** — Smart conventions for sidebars, nav, icons, and landing pages.
|
|
15
|
+
- :package: **Monorepo-native** — Workspace metadata with auto-generated package cards.
|
|
16
|
+
- :mag: **Auto-discovery** — Glob patterns to find and organize markdown files.
|
|
17
|
+
- :art: **Beautiful out of the box** — Catppuccin-themed UI with responsive layouts.
|
|
18
|
+
|
|
19
|
+
## Install
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install @zpress/kit
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
### Define your docs
|
|
28
|
+
|
|
29
|
+
```ts
|
|
30
|
+
// zpress.config.ts
|
|
31
|
+
import { defineConfig } from '@zpress/kit'
|
|
32
|
+
|
|
33
|
+
export default defineConfig({
|
|
34
|
+
title: 'my-project',
|
|
35
|
+
description: 'Internal developer docs',
|
|
36
|
+
sections: [
|
|
37
|
+
{
|
|
38
|
+
text: 'Getting Started',
|
|
39
|
+
link: '/getting-started',
|
|
40
|
+
from: 'docs/getting-started.md',
|
|
41
|
+
icon: 'pixelarticons:speed-fast',
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
text: 'Guides',
|
|
45
|
+
prefix: '/guides',
|
|
46
|
+
icon: 'pixelarticons:book-open',
|
|
47
|
+
from: 'docs/guides/*.md',
|
|
48
|
+
textFrom: 'heading',
|
|
49
|
+
sort: 'alpha',
|
|
50
|
+
},
|
|
51
|
+
],
|
|
52
|
+
nav: 'auto',
|
|
53
|
+
})
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Run it
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npx zpress dev # start dev server with hot reload
|
|
60
|
+
npx zpress build # build for production
|
|
61
|
+
npx zpress serve # preview production build
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Packages
|
|
65
|
+
|
|
66
|
+
| Package | Description |
|
|
67
|
+
| ------------------------------------------------------------ | ----------------------------------- |
|
|
68
|
+
| [`@zpress/core`](https://www.npmjs.com/package/@zpress/core) | Config loading, sync engine, assets |
|
|
69
|
+
| [`@zpress/cli`](https://www.npmjs.com/package/@zpress/cli) | CLI commands and file watcher |
|
|
70
|
+
| [`@zpress/ui`](https://www.npmjs.com/package/@zpress/ui) | Rspress plugin, theme, and styles |
|
|
71
|
+
|
|
72
|
+
## Why `@zpress/kit`?
|
|
73
|
+
|
|
74
|
+
> [!NOTE]
|
|
75
|
+
> Published as `@zpress/kit` because npm's overly aggressive moniker rules block the `zpress` name.
|
|
76
|
+
|
|
77
|
+
## License
|
|
78
|
+
|
|
79
|
+
[MIT](https://github.com/joggrdocs/zpress/blob/main/LICENSE) - Joggr, Inc.
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { }
|
package/dist/config.d.ts
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { CardConfig } from '@zpress/core';
|
|
2
|
+
import { defineConfig } from '@zpress/core';
|
|
3
|
+
import { Entry } from '@zpress/core';
|
|
4
|
+
import { Feature } from '@zpress/core';
|
|
5
|
+
import { Frontmatter } from '@zpress/core';
|
|
6
|
+
import { NavItem } from '@zpress/core';
|
|
7
|
+
import { OpenAPIConfig } from '@zpress/core';
|
|
8
|
+
import { WorkspaceGroup } from '@zpress/core';
|
|
9
|
+
import { WorkspaceItem } from '@zpress/core';
|
|
10
|
+
import { ZpressConfig } from '@zpress/core';
|
|
11
|
+
|
|
12
|
+
export { CardConfig }
|
|
13
|
+
|
|
14
|
+
export { defineConfig }
|
|
15
|
+
|
|
16
|
+
export { Entry }
|
|
17
|
+
|
|
18
|
+
export { Feature }
|
|
19
|
+
|
|
20
|
+
export { Frontmatter }
|
|
21
|
+
|
|
22
|
+
export { NavItem }
|
|
23
|
+
|
|
24
|
+
export { OpenAPIConfig }
|
|
25
|
+
|
|
26
|
+
export { WorkspaceGroup }
|
|
27
|
+
|
|
28
|
+
export { WorkspaceItem }
|
|
29
|
+
|
|
30
|
+
export { ZpressConfig }
|
|
31
|
+
|
|
32
|
+
export { }
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { CardConfig } from '@zpress/core';
|
|
2
|
+
import { createPaths } from '@zpress/core';
|
|
3
|
+
import { createRspressConfig } from '@zpress/ui';
|
|
4
|
+
import { defineConfig } from '@zpress/core';
|
|
5
|
+
import { Entry } from '@zpress/core';
|
|
6
|
+
import { Feature } from '@zpress/core';
|
|
7
|
+
import { Frontmatter } from '@zpress/core';
|
|
8
|
+
import { hasGlobChars } from '@zpress/core';
|
|
9
|
+
import { loadConfig } from '@zpress/core';
|
|
10
|
+
import { loadManifest } from '@zpress/core';
|
|
11
|
+
import { Manifest } from '@zpress/core';
|
|
12
|
+
import { ManifestEntry } from '@zpress/core';
|
|
13
|
+
import { NavItem } from '@zpress/core';
|
|
14
|
+
import { OpenAPIConfig } from '@zpress/core';
|
|
15
|
+
import { PageData } from '@zpress/core';
|
|
16
|
+
import { Paths } from '@zpress/core';
|
|
17
|
+
import { ResolvedEntry } from '@zpress/core';
|
|
18
|
+
import { ResolvedPage } from '@zpress/core';
|
|
19
|
+
import { ResolvedSection } from '@zpress/core';
|
|
20
|
+
import { resolveEntries } from '@zpress/core';
|
|
21
|
+
import { Result } from '@zpress/core';
|
|
22
|
+
import { SidebarItem } from '@zpress/core';
|
|
23
|
+
import { sync } from '@zpress/core';
|
|
24
|
+
import { SyncContext } from '@zpress/core';
|
|
25
|
+
import { SyncOptions } from '@zpress/core';
|
|
26
|
+
import { SyncResult } from '@zpress/core';
|
|
27
|
+
import { WorkspaceGroup } from '@zpress/core';
|
|
28
|
+
import { WorkspaceItem } from '@zpress/core';
|
|
29
|
+
import { ZpressConfig } from '@zpress/core';
|
|
30
|
+
import { zpressPlugin } from '@zpress/ui';
|
|
31
|
+
|
|
32
|
+
export { CardConfig }
|
|
33
|
+
|
|
34
|
+
export { createPaths }
|
|
35
|
+
|
|
36
|
+
export { createRspressConfig }
|
|
37
|
+
|
|
38
|
+
export { defineConfig }
|
|
39
|
+
|
|
40
|
+
export { Entry }
|
|
41
|
+
|
|
42
|
+
export { Feature }
|
|
43
|
+
|
|
44
|
+
export { Frontmatter }
|
|
45
|
+
|
|
46
|
+
export { hasGlobChars }
|
|
47
|
+
|
|
48
|
+
export { loadConfig }
|
|
49
|
+
|
|
50
|
+
export { loadManifest }
|
|
51
|
+
|
|
52
|
+
export { Manifest }
|
|
53
|
+
|
|
54
|
+
export { ManifestEntry }
|
|
55
|
+
|
|
56
|
+
export { NavItem }
|
|
57
|
+
|
|
58
|
+
export { OpenAPIConfig }
|
|
59
|
+
|
|
60
|
+
export { PageData }
|
|
61
|
+
|
|
62
|
+
export { Paths }
|
|
63
|
+
|
|
64
|
+
export { ResolvedEntry }
|
|
65
|
+
|
|
66
|
+
export { ResolvedPage }
|
|
67
|
+
|
|
68
|
+
export { ResolvedSection }
|
|
69
|
+
|
|
70
|
+
export { resolveEntries }
|
|
71
|
+
|
|
72
|
+
export { Result }
|
|
73
|
+
|
|
74
|
+
export { SidebarItem }
|
|
75
|
+
|
|
76
|
+
export { sync }
|
|
77
|
+
|
|
78
|
+
export { SyncContext }
|
|
79
|
+
|
|
80
|
+
export { SyncOptions }
|
|
81
|
+
|
|
82
|
+
export { SyncResult }
|
|
83
|
+
|
|
84
|
+
export { WorkspaceGroup }
|
|
85
|
+
|
|
86
|
+
export { WorkspaceItem }
|
|
87
|
+
|
|
88
|
+
export { ZpressConfig }
|
|
89
|
+
|
|
90
|
+
export { zpressPlugin }
|
|
91
|
+
|
|
92
|
+
export { }
|
package/package.json
CHANGED
|
@@ -1,7 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zpress/kit",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Documentation framework powered by Rspress with a config-driven information architecture",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"docs",
|
|
7
|
+
"documentation",
|
|
8
|
+
"rspress",
|
|
9
|
+
"zpress"
|
|
10
|
+
],
|
|
11
|
+
"homepage": "https://github.com/joggrdocs/zpress/tree/main/packages/zpress#readme",
|
|
12
|
+
"bugs": "https://github.com/joggrdocs/zpress/issues",
|
|
5
13
|
"license": "MIT",
|
|
6
14
|
"repository": {
|
|
7
15
|
"type": "git",
|
|
@@ -17,26 +25,32 @@
|
|
|
17
25
|
"type": "module",
|
|
18
26
|
"exports": {
|
|
19
27
|
".": {
|
|
20
|
-
"types": "./
|
|
28
|
+
"types": "./dist/index.d.ts",
|
|
21
29
|
"import": "./dist/index.mjs"
|
|
22
30
|
},
|
|
23
31
|
"./config": {
|
|
24
|
-
"types": "./
|
|
32
|
+
"types": "./dist/config.d.ts",
|
|
25
33
|
"import": "./dist/config.mjs"
|
|
26
34
|
}
|
|
27
35
|
},
|
|
28
36
|
"publishConfig": {
|
|
29
|
-
"access": "public"
|
|
37
|
+
"access": "public",
|
|
38
|
+
"provenance": true
|
|
30
39
|
},
|
|
31
40
|
"dependencies": {
|
|
32
|
-
"@zpress/
|
|
33
|
-
"@zpress/
|
|
34
|
-
"@zpress/
|
|
41
|
+
"@zpress/cli": "0.1.2",
|
|
42
|
+
"@zpress/core": "0.2.1",
|
|
43
|
+
"@zpress/ui": "0.2.1"
|
|
35
44
|
},
|
|
36
45
|
"devDependencies": {
|
|
37
46
|
"@rslib/core": "^0.20.0",
|
|
38
47
|
"typescript": "^5.9.3"
|
|
39
48
|
},
|
|
49
|
+
"peerDependencies": {
|
|
50
|
+
"@rspress/core": "^2.0.5",
|
|
51
|
+
"react": "^19.2.4",
|
|
52
|
+
"react-dom": "^19.2.4"
|
|
53
|
+
},
|
|
40
54
|
"engines": {
|
|
41
55
|
"node": ">=24.0.0"
|
|
42
56
|
},
|