@zpress/kit 0.1.1 → 0.1.3

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 CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2025 Joggr
3
+ Copyright (c) 2026 Joggr, Inc.
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
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 { }
@@ -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 { }
@@ -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.1",
3
+ "version": "0.1.3",
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": "./src/index.ts",
28
+ "types": "./dist/index.d.ts",
21
29
  "import": "./dist/index.mjs"
22
30
  },
23
31
  "./config": {
24
- "types": "./src/config.ts",
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/core": "0.2.0",
33
- "@zpress/ui": "0.2.0",
34
- "@zpress/cli": "0.1.1"
41
+ "@zpress/cli": "0.1.3",
42
+ "@zpress/core": "0.2.1",
43
+ "@zpress/ui": "0.2.2"
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
  },