vite-plugin-ember 0.0.0 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexey Kulakov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# vite-plugin-ember
+
+[![CI](https://github.com/aklkv/vite-plugin-ember/actions/workflows/ci.yml/badge.svg)](https://github.com/aklkv/vite-plugin-ember/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+A [Vite](https://vitejs.dev/) plugin that lets you render live, interactive [Ember](https://emberjs.com/) components inside [VitePress](https://vitepress.dev/) documentation pages.
+
+Write `.gjs` / `.gts` code fences in markdown and see them rendered on the page — no full Ember app required.
+
+**[View the live documentation →](https://aklkv.github.io/vite-plugin-ember/)**
+
+## Features
+
+- **Inline code fences** — use ` ```gjs live ` in markdown for instant interactive previews
+- **Full Ember support** — class components, `@tracked` state, `{{on}}` modifier, and TypeScript via `.gts`
+- **Zero-config compilation** — content-tag preprocessing, Babel template compilation, decorator transforms, and `@ember/*` / `@glimmer/*` module resolution handled automatically
+- **`@embroider/macros` shim** — runtime stubs so `ember-source` ESM imports just work
+- **Vue wrapper** — ships a `<CodePreview>` component for seamless VitePress integration
+
+## Quick Start
+
+### 1. Install
+
+Install the plugin along with Ember packages your components need:
+
+```sh
+pnpm add vite-plugin-ember ember-source @glimmer/component
+```
+
+> **Note:** `ember-source` and `@glimmer/component` are peer dependencies — you manage their versions in your project.
+
+### 2. Configure VitePress
+
+```ts
+// .vitepress/config.ts
+import { defineConfig } from 'vitepress';
+import vitePluginEmber, { emberFence } from 'vite-plugin-ember';
+
+export default defineConfig({
+  vite: {
+    plugins: [vitePluginEmber()],
+  },
+  markdown: {
+    config(md) {
+      emberFence(md);
+    },
+  },
+});
+```
+
+### 3. Register the component
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme';
+import CodePreview from 'vite-plugin-ember/components/code-preview.vue';
+import type { Theme } from 'vitepress';
+
+export default {
+  ...DefaultTheme,
+  enhanceApp({ app }) {
+    app.component('CodePreview', CodePreview);
+  },
+} satisfies Theme;
+```
+
+### 4. Write a live demo
+
+In any markdown file:
+
+````md
+```gjs live
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { on } from '@ember/modifier';
+
+export default class Counter extends Component {
+  @tracked count = 0;
+
+  increment = () => { this.count += 1; };
+
+  <template>
+    <button {{on "click" this.increment}}>
+      Clicked {{this.count}} times
+    </button>
+  </template>
+}
+```
+````
+
+Start the dev server with `pnpm dev` and see it live.
+
+## Documentation
+
+Full docs (built with this plugin!) are in the [`docs/`](./docs) directory. Run locally:
+
+```sh
+pnpm install
+pnpm dev
+```
+
+## Project Structure
+
+````text
+├── vite-plugin-ember/   # The Vite plugin (publishable package)
+│   └── src/
+│       ├── index.ts               # Plugin + Ember compilation pipeline
+│       └── vitepress/
+│           ├── ember-fence.ts     # markdown-it plugin for ```gjs live fences
+│           └── code-preview.vue     # Vue wrapper component
+├── docs/                # VitePress documentation site
+│   ├── demos/           # .gjs/.gts demo components
+│   └── guide/           # Documentation pages
+├── package.json         # Workspace root
+└── pnpm-workspace.yaml
+````
+
+## Requirements
+
+- Node.js ≥ 20
+- pnpm ≥ 10
+
+## License
+
+[MIT](./LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-ember",
-  "version": "0.0.0",
+  "version": "0.0.4",
   "description": "Vite plugin for rendering live Ember components in VitePress documentation",
   "license": "MIT",
   "type": "module",
@@ -42,18 +42,6 @@
     "dist",
     "src/vitepress/code-preview.vue"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "lint": "concurrently 'npm:lint:*(!fix)' --names 'lint:'",
-    "lint:fix": "concurrently 'npm:lint:*:fix' --names 'fix:'",
-    "lint:js": "eslint .",
-    "lint:js:fix": "eslint . --fix",
-    "lint:format": "prettier . --cache --check",
-    "lint:format:fix": "prettier . --cache --write",
-    "lint:types": "tsc --noEmit",
-    "format": "prettier . --cache --write",
-    "format:check": "prettier . --cache --check"
-  },
   "dependencies": {
     "@babel/core": "^7.29.0",
     "@babel/plugin-transform-typescript": "^7.28.6",
@@ -79,8 +67,27 @@
     "vue": "^3.5.28"
   },
   "peerDependencies": {
+    "@glimmer/component": ">=1",
+    "ember-source": ">=5",
     "vite": ">=5",
     "vitepress": ">=1",
     "vue": ">=3"
+  },
+  "peerDependenciesMeta": {
+    "@glimmer/component": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "concurrently 'npm:lint:*(!fix)' --names 'lint:'",
+    "lint:fix": "concurrently 'npm:lint:*:fix' --names 'fix:'",
+    "lint:js": "eslint .",
+    "lint:js:fix": "eslint . --fix",
+    "lint:format": "prettier . --cache --check",
+    "lint:format:fix": "prettier . --cache --write",
+    "lint:types": "tsc --noEmit",
+    "format": "prettier . --cache --write",
+    "format:check": "prettier . --cache --check"
   }
 }