@acryldev/plugin-context 0.1.0 → 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 +13 -0
- package/docs/extending/tui-command.md +1 -1
- package/docs/extending/tui-components.md +3 -3
- package/example-plugins/packages/tui-command-basic/index.js +1 -1
- package/example-plugins/packages/tui-overlay-themed/index.js +1 -1
- package/example-plugins/packages/web-page-branding/index.js +1 -1
- package/package.json +7 -5
- package/scripts/lib/maps.mjs +1 -1
package/LICENSE
CHANGED
package/README.md
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# @acryldev/plugin-context
|
|
2
|
+
|
|
3
|
+
Extension Context Pack: routed docs, verified examples and authoring skills that let the ACRYL agent write its own plugins (spec 037).
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm install @acryldev/plugin-context
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Source and license
|
|
12
|
+
|
|
13
|
+
Part of [ACRYL](https://github.com/acryldev/acryl): [`plugins/plugin-context`](https://github.com/acryldev/acryl/tree/main/plugins/plugin-context). MIT license.
|
|
@@ -5,4 +5,4 @@ with `ctx.get('tuiCommands')` (optional, absent on web and desktop, never `injec
|
|
|
5
5
|
`commands.register({ command: '/name', description, packageName, open({ tui, close }) => Component })`,
|
|
6
6
|
inside `ctx.effect` (it returns a disposer). A `Component` is a pi-tui object:
|
|
7
7
|
`render(width) => string[]`, `handleInput?(data)`, `invalidate()`. Name collisions never throw; they are
|
|
8
|
-
addressed as `/name:<package>`. Source: `apps/acryl-cli/src/tui/tui-commands-service.ts`.
|
|
8
|
+
addressed as `/name:<package>`. Source: `acryl-terminal/apps/acryl-cli/src/tui/tui-commands-service.ts`.
|
|
@@ -32,7 +32,7 @@ commands (`ctx.commands`) and prompts, which have no visual design.
|
|
|
32
32
|
- Keep a semantic `PALETTE` (primary, secondary, muted, success, warning, error, info) in one object and build the theme
|
|
33
33
|
objects from it (the example does). Use 24-bit color (`\x1b[38;2;r;g;bm`); do not assume a light or dark terminal.
|
|
34
34
|
- The CLI's own palette is generated from the semantic role file `plugins/ui/contracts/tokens.json` (the same roles the web library uses) into
|
|
35
|
-
`apps/acryl-cli/src/tui/palette.generated.ts`, read through `apps/acryl-cli/src/tui/theme.ts` and adapted to pi-tui in `tui/piTheme.ts`. It has a dark and a
|
|
35
|
+
`acryl-terminal/apps/acryl-cli/src/tui/palette.generated.ts`, read through `acryl-terminal/apps/acryl-cli/src/tui/theme.ts` and adapted to pi-tui in `tui/piTheme.ts`. It has a dark and a
|
|
36
36
|
light palette for nine roles (dark: `primary #4F6BFE`, `secondary #38BDF8`, `accent #818CF8`, `reasoning #A855F7`, `success #34D399`, `warning #FBBF24`,
|
|
37
37
|
`error #F87171`, `info #4F6BFE`, `muted #94A3B8`). The palette follows the terminal: at startup ACRYL asks the terminal whether its background is light or dark and follows it when it changes;
|
|
38
38
|
`ACRYL_TUI_THEME=dark|light` pins it, `COLORFGBG` is the fallback, dark the default. A plugin reads it through the read-only `tuiTheme` service (`ctx.get('tuiTheme')`: `mode`, `hex(role)`, `color(role)`,
|
|
@@ -40,8 +40,8 @@ commands (`ctx.commands`) and prompts, which have no visual design.
|
|
|
40
40
|
|
|
41
41
|
## Branding in the terminal (source change and rebuild)
|
|
42
42
|
|
|
43
|
-
Banner and wordmark: `apps/acryl-cli/src/tui/acrylMark.ts` (half-block art), `bannerText.ts`, `logoArt.generated.ts`, the mascot in
|
|
44
|
-
`apps/acryl-cli/src/yly/`, the palette in `tui/theme.ts`. Changing these means editing the repository and rebuilding
|
|
43
|
+
Banner and wordmark: `acryl-terminal/apps/acryl-cli/src/tui/acrylMark.ts` (half-block art), `bannerText.ts`, `logoArt.generated.ts`, the mascot in
|
|
44
|
+
`acryl-terminal/apps/acryl-cli/src/yly/`, the palette in `tui/theme.ts`. Changing these means editing the repository and rebuilding
|
|
45
45
|
(`corepack pnpm run tui` runs the dev build). Only when working inside the ACRYL repository; an installed CLI cannot be restyled by a
|
|
46
46
|
plugin. Say that, and offer a themed overlay instead.
|
|
47
47
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// Teaches: ctx.get('tuiCommands') exists only in the CLI host: read it OPTIONALLY, never inject it. Register returns a disposer; wrap it in ctx.effect.
|
|
5
5
|
// Expect: ACTIVE everywhere; the /hello command exists only on tui.
|
|
6
6
|
// Docs: extending.tui-command
|
|
7
|
-
// Pattern: apps/acryl-cli/src/tui/tui-commands-service.ts
|
|
7
|
+
// Pattern: acryl-terminal/apps/acryl-cli/src/tui/tui-commands-service.ts
|
|
8
8
|
export const name = 'acryl-example-tui-command'
|
|
9
9
|
|
|
10
10
|
export function apply(ctx) {
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
// The CLI's own palette is compiled into the app and NOT readable by a plugin, so a plugin carries its own.
|
|
10
10
|
// Expect: `/themed` opens a small centered popup with a colored title and a list; Enter or Esc closes it.
|
|
11
11
|
// Docs: extending.tui-components
|
|
12
|
-
// Pattern: apps/acryl-cli/src/tui/piTheme.ts and tui/theme.ts (the same shape), tui-commands-service.ts (open/close)
|
|
12
|
+
// Pattern: acryl-terminal/apps/acryl-cli/src/tui/piTheme.ts and tui/theme.ts (the same shape), tui-commands-service.ts (open/close)
|
|
13
13
|
import { Container, SelectList, Text, truncateToWidth } from '@earendil-works/pi-tui'
|
|
14
14
|
|
|
15
15
|
export const name = 'acryl-example-tui-themed'
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
// at call time, never assume it exists.
|
|
12
12
|
// Expect: the served index.html gets <title>My Studio</title>, a favicon link and a style row.
|
|
13
13
|
// Docs: extending.ui-branding
|
|
14
|
-
// Pattern: apps/acryl-web (tapIndex sets <title>ACRYL</title>), deepseek-harness/packages/host/webserver/src/injections.ts
|
|
14
|
+
// Pattern: acryl-terminal/apps/acryl-web (tapIndex sets <title>ACRYL</title>), deepseek-harness/packages/host/webserver/src/injections.ts
|
|
15
15
|
export const name = 'acryl-example-page-branding'
|
|
16
16
|
|
|
17
17
|
const TITLE = 'My Studio'
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@acryldev/plugin-context",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Extension Context Pack: routed docs, verified examples and authoring skills that let the ACRYL agent write its own plugins (spec 037)",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"publishConfig": {
|
|
@@ -28,17 +28,19 @@
|
|
|
28
28
|
"docs/**",
|
|
29
29
|
"example-plugins/**",
|
|
30
30
|
"skills/**",
|
|
31
|
-
"scripts/lib/**"
|
|
31
|
+
"scripts/lib/**",
|
|
32
|
+
"README.md",
|
|
33
|
+
"LICENSE"
|
|
32
34
|
],
|
|
33
35
|
"engines": {
|
|
34
36
|
"node": "^22.19.0 || >=24.0.0"
|
|
35
37
|
},
|
|
36
38
|
"main": "./index.js",
|
|
37
39
|
"dependencies": {
|
|
38
|
-
"@acryldev/blends-core": "0.6.
|
|
39
|
-
"@acryldev/plugin-hub-core": "0.2.
|
|
40
|
+
"@acryldev/blends-core": "0.6.2",
|
|
41
|
+
"@acryldev/plugin-hub-core": "0.2.4",
|
|
40
42
|
"@deepseek-ai/dsh-tools": "0.2.0-rc.2",
|
|
41
|
-
"@acryldev/blends": "^1.7.
|
|
43
|
+
"@acryldev/blends": "^1.7.28",
|
|
42
44
|
"yaml": "^2.9.0"
|
|
43
45
|
},
|
|
44
46
|
"devDependencies": {
|
package/scripts/lib/maps.mjs
CHANGED
|
@@ -54,7 +54,7 @@ const read = file => { try { return readFileSync(file, 'utf8') } catch { return
|
|
|
54
54
|
/** Every `interface SlotMap` entry declared in source: name, kind, scope, owner, first doc line, declaring package. */
|
|
55
55
|
export function collectSlots(repo, index) {
|
|
56
56
|
const slots = new Map()
|
|
57
|
-
const roots = [join(repo, 'deepseek-harness/packages/client'), join(repo, '
|
|
57
|
+
const roots = [join(repo, 'deepseek-harness/packages/client'), join(repo, 'plugins')]
|
|
58
58
|
const files = []
|
|
59
59
|
for (const root of roots) walk(root, 7, (file, name) => { if (/\.(ts|tsx)$/u.test(name) && !/\.(test|spec)\./u.test(name)) files.push(file) })
|
|
60
60
|
const packageOf = file => {
|