markstream-vue 0.0.10-beta.0 → 0.0.10-beta.2

package/.agents/skills/markstream-angular/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: markstream-angular
+description: Integrate markstream-angular into an Angular app. Use when Codex needs standalone component imports, signal-based examples, CSS wiring, custom HTML tags or customComponents setup, or optional peer integration in an Angular repository.
+---
+
+# Markstream Angular
+
+Use this skill when the host app is Angular and the task is to adopt the Angular package cleanly.
+
+## Workflow
+
+1. Confirm the repo is Angular.
+2. Install `markstream-angular` plus only the requested optional peers.
+3. Import `markstream-angular/index.css` from the app shell.
+   - Add `katex/dist/katex.min.css` when math is enabled.
+4. Prefer standalone Angular integration.
+   - Use `MarkstreamAngularComponent` in `imports` and keep examples signal-friendly.
+5. Start with `[content]`.
+   - Use `[final]`, `[codeBlockStream]`, and other streaming inputs only when the UI actually streams.
+6. Use `[customHtmlTags]` and `[customComponents]` for trusted tag workflows.
+7. Validate with the smallest useful Angular dev or build command.
+
+## Default Decisions
+
+- Standalone Angular first, NgModule-era patterns only when the repo still depends on them.
+- Treat streaming flags as opt-in.
+- Keep optional peers minimal and explicit.
+
+## Useful Doc Targets
+
+- `docs/guide/angular-quick-start.md`
+- `docs/guide/angular-installation.md`
+- `docs/guide/playground.md`
+- `docs/guide/troubleshooting.md`

package/.agents/skills/markstream-angular/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Angular
+  short_description: Install and wire markstream-angular in Angular apps
+  default_prompt: 'Use $markstream-angular to integrate markstream-angular into this Angular repository with the right CSS, optional peers, and standalone setup.'

package/.agents/skills/markstream-custom-components/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Markstream Custom Components"
-  short_description: "Override Markstream nodes and add trusted custom tags"
-  default_prompt: "Use $markstream-custom-components to add scoped Markstream overrides or trusted custom tags in this repository."
+  display_name: Markstream Custom Components
+  short_description: Override Markstream nodes and add trusted custom tags
+  default_prompt: Use $markstream-custom-components to add scoped Markstream overrides or trusted custom tags in this repository.

package/.agents/skills/markstream-install/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Markstream Install"
-  short_description: "Install markstream with the right peers and CSS order"
-  default_prompt: "Use $markstream-install to add the correct Markstream package to this repository with the smallest peer-dependency set."
+  display_name: Markstream Install
+  short_description: Install markstream with the right peers and CSS order
+  default_prompt: Use $markstream-install to add the correct Markstream package to this repository with the smallest peer-dependency set.

package/.agents/skills/markstream-migration/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Markstream Migration"
-  short_description: "Audit and migrate existing Markdown rendering to Markstream"
+  display_name: Markstream Migration
+  short_description: Audit and migrate existing Markdown rendering to Markstream
   default_prompt: "Use $markstream-migration to audit this repository's current Markdown renderer and migrate it to the appropriate Markstream package."

package/.agents/skills/markstream-nuxt/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: markstream-nuxt
+description: Integrate markstream-vue into a Nuxt 3 or Nuxt 4 app. Use when Codex needs client-only boundaries, SSR-safe setup, browser-only peer gating, worker-aware initialization, or a safe `MarkdownRender` integration inside pages, components, or Nuxt plugins.
+---
+
+# Markstream Nuxt
+
+Use this skill when the host app is Nuxt and SSR boundaries matter.
+
+## Workflow
+
+1. Confirm the repo is Nuxt 3 or 4.
+2. Install `markstream-vue` plus only the optional peers required by the requested features.
+3. Keep browser-only peers behind client-only boundaries.
+   - Prefer `<client-only>` wrappers, `.client` plugins, or guarded setup paths.
+4. Import `markstream-vue/index.css` from a client-safe app shell or plugin.
+5. Start with `content`, and move to `nodes` plus `final` only when the UI is streaming.
+6. Validate with the smallest relevant Nuxt dev, build, or typecheck command.
+
+## Default Decisions
+
+- SSR safety comes before feature completeness.
+- Avoid import-time access to browser globals from server code paths.
+- Treat Monaco, Mermaid workers, and similar heavy peers as client-only unless the repo already has a proven SSR pattern.
+
+## Useful Doc Targets
+
+- `docs/nuxt-ssr.md`
+- `docs/guide/installation.md`
+- `docs/guide/usage.md`
+- `docs/guide/troubleshooting.md`

package/.agents/skills/markstream-nuxt/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Nuxt
+  short_description: Wire markstream-vue safely in a Nuxt SSR app
+  default_prompt: Use $markstream-nuxt to add markstream-vue to this Nuxt app with safe client-only boundaries and the right optional peers.

package/.agents/skills/markstream-react/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: markstream-react
+description: Integrate markstream-react into a React 18+ or Next app. Use when Codex needs to add the React renderer, import CSS correctly, choose between `content` and `nodes`, keep Next client boundaries safe, convert renderer overrides, or prepare a repo for `react-markdown` migration.
+---
+
+# Markstream React
+
+Use this skill when the host app is React or Next and the task is to wire Markstream safely.
+
+## Workflow
+
+1. Confirm the repo is React, Next, or another React-based host.
+2. Install `markstream-react` plus only the requested optional peers.
+3. Import `markstream-react/index.css` from the app shell or client entry.
+4. Start with `content`.
+   - Move to `nodes` plus `final` only when the UI receives streaming or high-frequency updates.
+5. Respect SSR boundaries in Next.
+   - Prefer `use client`, dynamic imports with `ssr: false`, or other client-only boundaries when browser-only peers are involved.
+6. Use scoped Markstream overrides before custom parser work.
+7. Validate with the smallest useful dev, build, or typecheck command.
+
+## Default Decisions
+
+- Renderer wiring first, migration cleanup second.
+- If the repo already uses `react-markdown`, pair this skill with `markstream-migration`.
+- Prefer the smallest client-only boundary that solves the SSR issue.
+
+## Useful Doc Targets
+
+- `docs/guide/react-quick-start.md`
+- `docs/guide/react-installation.md`
+- `docs/guide/react-markdown-migration.md`
+- `docs/guide/component-overrides.md`

package/.agents/skills/markstream-react/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream React
+  short_description: Install and wire markstream-react in React or Next
+  default_prompt: Use $markstream-react to integrate markstream-react into this React or Next repository with safe client boundaries and the right optional peers.

package/.agents/skills/markstream-vue/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: markstream-vue
+description: Integrate markstream-vue into a Vue 3 app. Use when Codex needs to add the Vue 3 renderer, import CSS in the right order, choose between `content` and `nodes`, enable optional peers like Mermaid, KaTeX, D2, Monaco, or Shiki, or wire scoped custom components in a non-Nuxt Vue repository.
+---
+
+# Markstream Vue 3
+
+Use this skill when the host app is plain Vue 3, typically Vite-based, and not Nuxt.
+
+## Workflow
+
+1. Confirm the repo is Vue 3 and not Nuxt.
+2. Install `markstream-vue` plus only the optional peers required by the requested features.
+3. Import `markstream-vue/index.css` after resets.
+   - In Tailwind or UnoCSS projects, keep Markstream styles inside `@layer components`.
+4. Start with `<MarkdownRender :content="markdown" />`.
+   - Switch to `nodes` plus `final` only for streaming, SSE, or high-frequency updates.
+5. Use `custom-id` plus scoped `setCustomComponents(...)` for overrides.
+6. Validate with the smallest useful dev, build, or typecheck command.
+
+## Default Decisions
+
+- Vue 3 apps default to `content`.
+- Prefer local component registration unless the repo already uses a shared plugin entry.
+- If the host is actually Nuxt, leave SSR-specific setup to `markstream-nuxt`.
+
+## Useful Doc Targets
+
+- `docs/guide/quick-start.md`
+- `docs/guide/installation.md`
+- `docs/guide/usage.md`
+- `docs/guide/component-overrides.md`

package/.agents/skills/markstream-vue/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Vue 3
+  short_description: Install and wire markstream-vue in a Vue 3 app
+  default_prompt: Use $markstream-vue to integrate markstream-vue into this Vue 3 repository with the right CSS order and optional peers.

package/.agents/skills/markstream-vue2/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: markstream-vue2
+description: Integrate markstream-vue2 into a Vue 2.6 or 2.7 app. Use when Codex needs Vue 2-compatible setup, `@vue/composition-api` decisions, CSS wiring, optional peer setup, or scoped Markstream overrides in a Vue 2 repository that is not specifically Vue CLI / Webpack 4 constrained.
+---
+
+# Markstream Vue 2
+
+Use this skill when the host app is Vue 2 and not specifically a Vue CLI / Webpack 4 edge case.
+
+## Workflow
+
+1. Confirm the repo is Vue 2.6 or 2.7.
+2. Install `markstream-vue2`.
+   - Add `@vue/composition-api` only when the repo is Vue 2.6 and uses Composition API patterns.
+3. Import `markstream-vue2/index.css` after resets.
+4. Start with `<MarkdownRender :content="markdown" />`.
+5. Use scoped custom component mappings when the task needs overrides or trusted tags.
+6. Validate with the smallest useful dev or build command.
+
+## Default Decisions
+
+- Vue 2.7 can use built-in Composition API support.
+- Vue 2.6 needs `@vue/composition-api` only when the codebase actually relies on Composition API.
+- If the repo is Vue CLI / Webpack 4, prefer `markstream-vue2-cli`.
+- If the repo is Vue 2 plus Vite worker imports, prefer `markstream-vue2-vite`.
+
+## Useful Doc Targets
+
+- `docs/guide/vue2-quick-start.md`
+- `docs/guide/vue2-installation.md`
+- `docs/guide/vue2-components.md`
+- `docs/guide/troubleshooting.md`

package/.agents/skills/markstream-vue2/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Vue 2
+  short_description: Install and wire markstream-vue2 in a Vue 2 app
+  default_prompt: 'Use $markstream-vue2 to integrate markstream-vue2 into this Vue 2 repository with the right CSS, optional peers, and Composition API setup.'

package/.agents/skills/markstream-vue2-cli/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: markstream-vue2-cli
+description: Integrate markstream-vue2 into a Vue 2 Vue CLI or Webpack 4 app. Use when Codex needs Webpack 4-friendly setup, CDN worker fallbacks for Mermaid or KaTeX, `dist/index.css` imports, Vue 2 composition-api shims, or safer code block defaults that avoid fragile Monaco worker setups.
+---
+
+# Markstream Vue 2 CLI
+
+Use this skill when the host app is Vue 2 on Vue CLI or another Webpack 4-style stack.
+
+## Workflow
+
+1. Confirm the repo uses Vue 2 plus Vue CLI or Webpack 4-era tooling.
+2. Install `markstream-vue2` and only the peers required for the requested features.
+3. Import `markstream-vue2/dist/index.css` in the app shell.
+4. Avoid Vite-style `?worker` imports.
+   - Use `createKaTeXWorkerFromCDN(...)` and `createMermaidWorkerFromCDN(...)` when workers are needed.
+5. Prefer stable code block defaults over brittle Monaco wiring.
+   - `MarkdownCodeBlockNode` plus `stream-markdown` is safer than Monaco in Webpack 4-era repos.
+6. Validate with the smallest useful local dev or build command.
+
+## Default Decisions
+
+- Treat Monaco and worker-heavy setups as opt-in and fragile on Webpack 4.
+- Prefer CDN workers over bundler workers for Mermaid and KaTeX.
+- Keep the Vue 2 composition-api shim explicit when the repo is on Vue 2.6.
+
+## Useful Doc Targets
+
+- `docs/guide/vue2-quick-start.md`
+- `docs/guide/vue2-installation.md`
+- `docs/guide/troubleshooting.md`

package/.agents/skills/markstream-vue2-cli/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Vue 2 CLI
+  short_description: Wire markstream-vue2 in Vue CLI / Webpack 4 apps
+  default_prompt: Use $markstream-vue2-cli to add markstream-vue2 to this Vue CLI or Webpack 4 app with CDN workers and Webpack-safe defaults.

package/.agents/skills/markstream-vue2-vite/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: markstream-vue2-vite
+description: Integrate markstream-vue2 into a Vue 2 plus Vite app. Use when Codex needs Vite-friendly worker imports, `?worker` or `?worker&inline` setup for Mermaid or KaTeX, modern CSS ordering, or Vue 2 compatibility in a Vite-based repository.
+---
+
+# Markstream Vue 2 Vite
+
+Use this skill when the host app is Vue 2 and the bundler is Vite.
+
+## Workflow
+
+1. Confirm the repo is Vue 2 with Vite-based tooling.
+2. Install `markstream-vue2` plus only the requested optional peers.
+3. Import `markstream-vue2/index.css` after resets.
+4. Use Vite worker imports when the repo needs bundled workers.
+   - `markstream-vue2/workers/... ?worker` or `?worker&inline` patterns are allowed here.
+5. Keep Composition API decisions explicit for Vue 2.6 repos.
+6. Validate with the smallest useful Vite dev or build command.
+
+## Default Decisions
+
+- Prefer bundled workers over CDN workers in Vite-based Vue 2 repos.
+- Keep UnoCSS or Tailwind resets before Markstream CSS.
+- Use the generic `markstream-vue2` skill only when the bundler-specific choice does not matter.
+
+## Useful Doc Targets
+
+- `docs/guide/vue2-quick-start.md`
+- `docs/guide/vue2-installation.md`
+- `docs/guide/tailwind.md`
+- `docs/guide/troubleshooting.md`

package/.agents/skills/markstream-vue2-vite/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Markstream Vue 2 Vite
+  short_description: 'Wire markstream-vue2 in Vue 2 + Vite apps'
+  default_prompt: Use $markstream-vue2-vite to integrate markstream-vue2 into this Vue 2 Vite repository with Vite-friendly worker setup.