opencode-agent-kit 1.0.0

package/template/.opencode/skills/nuxt-ui/references/layouts/editor.md

@@ -0,0 +1,168 @@
+# Editor Layout
+
+Build a rich text editor with toolbars, slash commands, mentions, and drag-and-drop.
+
+## Component tree
+
+```
+UApp
+├── UHeader
+├── UMain
+│   └── NuxtPage
+│       └── UContainer
+│           └── UEditor
+│               ├── UEditorToolbar (fixed / bubble / floating)
+│               ├── UEditorDragHandle
+│               ├── UEditorSuggestionMenu
+│               ├── UEditorMentionMenu
+│               └── UEditorEmojiMenu
+└── UFooter
+```
+
+## Page
+
+```vue [pages/editor.vue]
+<script setup lang="ts">
+const content = ref({
+  type: 'doc',
+  content: [
+    {
+      type: 'heading',
+      attrs: { level: 1 },
+      content: [{ type: 'text', text: 'Hello World' }]
+    },
+    {
+      type: 'paragraph',
+      content: [{ type: 'text', text: 'Start writing...' }]
+    }
+  ]
+})
+</script>
+
+<template>
+  <UPage>
+    <UPageHeader title="Editor">
+      <template #actions>
+        <UButton label="Save" icon="i-lucide-save" />
+      </template>
+    </UPageHeader>
+
+    <UPageBody>
+      <UEditor v-slot="{ editor }" v-model="content">
+        <UEditorToolbar :editor="editor" />
+        <UEditorSuggestionMenu :editor="editor" />
+        <UEditorMentionMenu
+          :editor="editor"
+          :items="[
+            { label: 'Benjamin', avatar: { src: 'https://github.com/benjamincanac.png' } },
+            { label: 'Sébastien', avatar: { src: 'https://github.com/atinux.png' } }
+          ]"
+        />
+        <UEditorEmojiMenu :editor="editor" />
+        <UEditorDragHandle :editor="editor" />
+      </UEditor>
+    </UPageBody>
+  </UPage>
+</template>
+```
+
+> If you encounter prosemirror-related errors, add prosemirror packages to `vite.optimizeDeps.include` in `nuxt.config.ts`.
+
+## Key components
+
+- `UEditor` — Rich text editor (`v-model` accepts JSON, HTML, or markdown via `content-type` prop)
+- `UEditorToolbar` — Toolbar with `layout`: `'fixed'` (default), `'bubble'` (on selection), `'floating'` (on empty lines)
+- `UEditorDragHandle` — Block drag-and-drop handle
+- `UEditorSuggestionMenu` — Slash command menu
+- `UEditorMentionMenu` — @ mention menu
+- `UEditorEmojiMenu` — Emoji picker
+
+## Toolbar modes
+
+```vue
+<!-- Fixed (default) -->
+<UEditor v-model="content">
+  <UEditorToolbar />
+</UEditor>
+
+<!-- Bubble (appears on text selection) -->
+<UEditor v-model="content">
+  <UEditorToolbar layout="bubble" />
+</UEditor>
+
+<!-- Floating (appears on empty lines) -->
+<UEditor v-model="content">
+  <UEditorToolbar layout="floating" />
+</UEditor>
+```
+
+## Content types
+
+```vue
+<!-- JSON (default) -->
+<UEditor v-model="jsonContent" />
+
+<!-- HTML -->
+<UEditor v-model="htmlContent" content-type="html" />
+
+<!-- Markdown -->
+<UEditor v-model="markdownContent" content-type="markdown" />
+```
+
+## With document sidebar
+
+Combine with Dashboard components for a multi-document editor with a sidebar.
+
+```vue [layouts/editor.vue]
+<template>
+  <UDashboardGroup>
+    <UDashboardSidebar collapsible resizable>
+      <template #header>
+        <UButton icon="i-lucide-plus" label="New document" block />
+      </template>
+
+      <template #default>
+        <UNavigationMenu
+          :items="documents.map(doc => ({
+            label: doc.title,
+            to: `/editor/${doc.id}`,
+            icon: 'i-lucide-file-text'
+          }))"
+          orientation="vertical"
+        />
+      </template>
+    </UDashboardSidebar>
+
+    <slot />
+  </UDashboardGroup>
+</template>
+```
+
+```vue [pages/editor/[id].vue]
+<script setup lang="ts">
+definePageMeta({ layout: 'editor' })
+
+const content = ref({ type: 'doc', content: [] })
+</script>
+
+<template>
+  <UDashboardPanel>
+    <template #header>
+      <UDashboardNavbar title="Editor">
+        <template #right>
+          <UButton label="Save" icon="i-lucide-save" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <UContainer class="py-8">
+      <UEditor v-slot="{ editor }" v-model="content">
+        <UEditorToolbar :editor="editor" />
+        <UEditorSuggestionMenu :editor="editor" />
+        <UEditorEmojiMenu :editor="editor" />
+        <UEditorDragHandle :editor="editor" />
+      </UEditor>
+    </UContainer>
+  </UDashboardPanel>
+</template>
+```

package/template/.opencode/skills/nuxt-ui/references/layouts/page.md

@@ -0,0 +1,260 @@
+# Page Layout
+
+Build public-facing pages — landing, blog, changelog, pricing — using the Header + Main + Footer shell with Page components.
+
+## App shell
+
+```vue [app.vue]
+<script setup lang="ts">
+import type { NavigationMenuItem } from '@nuxt/ui'
+
+const items = computed<NavigationMenuItem[]>(() => [{
+  label: 'Features',
+  to: '#features'
+}, {
+  label: 'Pricing',
+  to: '/pricing'
+}, {
+  label: 'Blog',
+  to: '/blog'
+}])
+</script>
+
+<template>
+  <UApp>
+    <UHeader>
+      <template #title>
+        <Logo class="h-6 w-auto" />
+      </template>
+
+      <UNavigationMenu :items="items" />
+
+      <template #right>
+        <UColorModeButton />
+        <UButton label="Sign in" color="neutral" variant="ghost" />
+        <UButton label="Get started" />
+      </template>
+
+      <template #body>
+        <UNavigationMenu :items="items" orientation="vertical" class="-mx-2.5" />
+      </template>
+    </UHeader>
+
+    <UMain>
+      <NuxtPage />
+    </UMain>
+
+    <UFooter>
+      <template #left>
+        <p class="text-muted text-sm">Copyright © {{ new Date().getFullYear() }}</p>
+      </template>
+      <template #right>
+        <UButton icon="i-simple-icons-github" color="neutral" variant="ghost" to="https://github.com" target="_blank" />
+      </template>
+    </UFooter>
+  </UApp>
+</template>
+```
+
+## Landing page
+
+```vue [pages/index.vue]
+<template>
+  <UPageHero
+    title="Build faster with Nuxt UI"
+    description="A comprehensive Vue UI component library."
+    :links="[
+      { label: 'Get started', to: '/docs', icon: 'i-lucide-square-play' },
+      { label: 'Learn more', color: 'neutral', variant: 'subtle', trailingIcon: 'i-lucide-arrow-right' }
+    ]"
+    orientation="horizontal"
+  >
+    <img src="/hero-image.png" alt="App screenshot" class="rounded-lg shadow-2xl ring ring-default" />
+  </UPageHero>
+
+  <UPageSection
+    id="features"
+    headline="Features"
+    title="Everything you need"
+    description="A comprehensive suite of components and utilities."
+    :features="[
+      { title: 'Accessible', description: 'Built on Reka UI with full ARIA support.', icon: 'i-lucide-accessibility' },
+      { title: 'Customizable', description: 'Tailwind Variants theming with full control.', icon: 'i-lucide-palette' },
+      { title: 'Responsive', description: 'Mobile-first components.', icon: 'i-lucide-monitor-smartphone' }
+    ]"
+  />
+
+  <UPageCTA
+    title="Trusted by thousands of developers"
+    description="Join the community and start building today."
+    :links="[
+      { label: 'Get started', color: 'neutral' },
+      { label: 'Star on GitHub', color: 'neutral', variant: 'subtle', trailingIcon: 'i-lucide-arrow-right' }
+    ]"
+  />
+
+  <UPageSection id="pricing" headline="Pricing" title="Simple, transparent pricing">
+    <UPricingPlans
+      :plans="[
+        { title: 'Free', price: '$0', description: 'For personal projects', features: ['10 components', 'Community support'] },
+        { title: 'Pro', price: '$99', description: 'For teams', features: ['All components', 'Priority support'], highlight: true },
+        { title: 'Enterprise', price: 'Custom', description: 'For large teams', features: ['Custom components', 'Dedicated support'] }
+      ]"
+    />
+  </UPageSection>
+</template>
+```
+
+## Blog listing
+
+```vue [pages/blog/index.vue]
+<script setup lang="ts">
+const { data: posts } = await useAsyncData('posts', () => queryCollection('posts').all())
+</script>
+
+<template>
+  <UPage>
+    <UPageHero title="Blog" description="The latest news and updates from our team." />
+
+    <UPageBody>
+      <UContainer>
+        <UBlogPosts>
+          <UBlogPost
+            v-for="(post, index) in posts"
+            :key="index"
+            v-bind="post"
+            :to="post.path"
+          />
+        </UBlogPosts>
+      </UContainer>
+    </UPageBody>
+  </UPage>
+</template>
+```
+
+## Blog article
+
+```vue [pages/blog/[slug].vue]
+<script setup lang="ts">
+const route = useRoute()
+
+const { data: post } = await useAsyncData(route.path, () => {
+  return queryCollection('posts').path(route.path).first()
+})
+</script>
+
+<template>
+  <UPage>
+    <UPageHeader :title="post.title" :description="post.description" />
+
+    <UPageBody>
+      <ContentRenderer :value="post" />
+    </UPageBody>
+
+    <template #right>
+      <UContentToc :links="post.body.toc.links" />
+    </template>
+  </UPage>
+</template>
+```
+
+## Changelog
+
+```vue [pages/changelog.vue]
+<script setup lang="ts">
+const { data: versions } = await useAsyncData('versions', () => queryCollection('changelog').all())
+</script>
+
+<template>
+  <UPage>
+    <UPageHero title="Changelog" />
+
+    <UPageBody>
+      <UContainer>
+        <UChangelogVersions>
+          <UChangelogVersion v-for="(version, index) in versions" :key="index" v-bind="version" />
+        </UChangelogVersions>
+      </UContainer>
+    </UPageBody>
+  </UPage>
+</template>
+```
+
+## Key components
+
+### Page sections
+
+- `UPageHero` — Hero with title, description, links, and optional media (`orientation`: horizontal/vertical)
+- `UPageSection` — Content section with headline, title, description, and `features` grid
+- `UPageCTA` — Call to action block
+- `UPageHeader` — Page title and description
+- `UPageBody` — Main content area with prose styling
+
+### Grids & cards
+
+- `UPageGrid` / `UPageColumns` — Grid layouts
+- `UPageCard` — Content card for grids
+- `UPageFeature` — Individual feature item
+- `UPageLogos` — Logo wall
+
+### Blog & changelog
+
+- `UBlogPosts` — Responsive grid of posts (`orientation`: horizontal/vertical)
+- `UBlogPost` — Individual post card
+- `UChangelogVersions` / `UChangelogVersion` — Changelog entries
+
+### Pricing
+
+- `UPricingPlans` — Pricing plan cards
+- `UPricingTable` — Feature comparison table
+
+### Footer
+
+- `UFooterColumns` — Multi-column footer with link groups
+
+## Variations
+
+### Alternating sections
+
+```vue
+<UPageSection title="Feature A" orientation="horizontal">
+  <img src="/feature-a.png" />
+</UPageSection>
+
+<UPageSection title="Feature B" orientation="horizontal" reverse>
+  <img src="/feature-b.png" />
+</UPageSection>
+```
+
+### Feature grid
+
+```vue
+<UPageSection headline="Features" title="Why choose us">
+  <UPageGrid>
+    <UPageCard v-for="feature in features" :key="feature.title" v-bind="feature" />
+  </UPageGrid>
+</UPageSection>
+```
+
+### Blog with sidebar
+
+```vue [layouts/blog.vue]
+<template>
+  <UPage>
+    <template #left>
+      <UPageAside>
+        <UNavigationMenu
+          :items="[
+            { label: 'All posts', to: '/blog', icon: 'i-lucide-newspaper' },
+            { label: 'Tutorials', to: '/blog/tutorials', icon: 'i-lucide-graduation-cap' },
+            { label: 'Announcements', to: '/blog/announcements', icon: 'i-lucide-megaphone' }
+          ]"
+          orientation="vertical"
+        />
+      </UPageAside>
+    </template>
+
+    <slot />
+  </UPage>
+</template>
+```