grapes-vue-lite 0.1.2 → 0.1.3

package/README.md

@@ -16,8 +16,7 @@ For local validation before publishing:
 
 ```bash
 pnpm build
-npm pack
-pnpm add ./grapes-vue-lite-0.1.0.tgz
+pnpm check:release
 ```
 
 ## Commands
@@ -26,12 +25,22 @@ pnpm add ./grapes-vue-lite-0.1.0.tgz
 pnpm install
 pnpm dev
 pnpm test:run
+pnpm check:dist-import
+pnpm check:package
+pnpm check:release
+pnpm check:types-consumer
+pnpm pack:dry-run
 pnpm build:lib
 pnpm build
 ```
 
-`pnpm build` runs smoke tests, type checks, the demo app build, and the library build.
+`pnpm check:package` verifies package export paths, generated declaration files, peer dependency shape, and embeddable library CSS.
+`pnpm check:dist-import` verifies the built ESM and UMD/CJS entrypoints can be imported and expose the expected public exports.
+`pnpm check:types-consumer` compiles a temporary TypeScript consumer that imports the built package through `package.json` exports.
+`pnpm pack:dry-run` prints the exact npm tarball file list with a workspace-local npm cache; run it before publishing.
+`pnpm build` runs smoke tests, type checks, the demo app build, the library build, and the package check.
 `pnpm build:lib` emits the third-party integration package into `dist-lib`.
+`pnpm check:release` runs the full publish gate: default build, built entrypoint import checks, consumer type checks, and npm pack dry-run. It is intentionally separate from `pnpm build` because it exercises npm and TypeScript entrypoints as an external consumer would.
 
 ## Third-party Vue Integration
 
@@ -102,6 +111,8 @@ function handleChange(projectJson: string) {
 
 The package treats `vue` as a peer dependency, so the host application owns the Vue runtime version.
 
+### Embedding Checklist
+
 The editor fills its parent container by default. When embedding it in a dialog, drawer, tab pane, or any constrained area, set the host container height explicitly:
 
 ```vue
@@ -119,7 +130,15 @@ The editor fills its parent container by default. When embedding it in a dialog,
 </style>
 ```
 
-For full-screen usage, set the host container to `100dvh`. The library stylesheet avoids forcing `body`, `html`, or `#app` height so it does not override the host application's page layout.
+For full-screen usage, set the host container to `100dvh`. The library stylesheet scopes editor tokens, box sizing, form-control font rules, and overlays under `.app-shell`; it avoids forcing `body`, `html`, `#app`, or viewport-height layout so it does not override the host application's page layout.
+
+Keyboard shortcuts are scoped to the active editor instance. Focus or pointer interaction inside an editor marks it active, typing targets are ignored, and multiple editors on the same page do not share command handling. Disable built-in shortcuts when a host application owns all keyboard handling:
+
+```vue
+<GrapesVueEditor :options="options" :shortcuts="false" />
+```
+
+Use `:emit-changes="false"` when the host only needs `@ready` and will pull project JSON manually, for example before saving a larger form.
 
 ## Current Editor Modules