@oneie/plugin-docs 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneie/plugin-docs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "ONE docs — Astro content collection with sidebar nav, search, code blocks, and versioning",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -15,17 +15,12 @@
   },
   "peerDependencies": {
     "astro": ">=6.0.0",
-    "@oneie/frontend": "*",
+    "@oneie/frontend": "^0.1.1",
     "react": ">=19.0.0"
   },
   "devDependencies": {
     "astro": "^6.2.2",
     "react": "^19.0.0",
     "typescript": "^5.7.3"
-  },
-  "peerDependenciesMeta": {
-    "@oneie/frontend": {
-      "optional": true
-    }
   }
 }

package/src/DocsLayout.astro

@@ -1,17 +1,38 @@
 ---
 import type { CollectionEntry, MarkdownHeading } from 'astro:content'
+import { getCollection, render } from 'astro:content'
 import { SidebarDocs } from './SidebarDocs.tsx'
 import { DocSearch } from './DocSearch.tsx'
 
 export interface Props {
-  entry: CollectionEntry<'docs'>
-  entries: CollectionEntry<'docs'>[]
+  /** Omit both `entry` and `entries` when this file is used directly as an
+   *  injected route — it then self-resolves from Astro.params.slug and
+   *  renders its own <Content/> in place of the default slot. Pass them
+   *  explicitly when wrapping this layout in your own page. */
+  entry?: CollectionEntry<'docs'>
+  entries?: CollectionEntry<'docs'>[]
   headings?: MarkdownHeading[]
   editBaseUrl?: string
   sidebar?: Array<{ folder: string; label: string; icon?: string }>
 }
 
-const { entry, entries, headings = [], editBaseUrl, sidebar } = Astro.props
+let { entry, entries, headings, editBaseUrl, sidebar } = Astro.props
+let Content: (() => any) | undefined
+
+if (!entry) {
+  const slug = Astro.params.slug as string
+  const all = await getCollection('docs')
+  const found = all.find((d) => d.id === slug)
+  if (!found) return Astro.redirect('/docs')
+  entry = found
+  entries = all
+  const rendered = await render(entry)
+  Content = rendered.Content
+  headings ??= rendered.headings
+}
+
+entries ??= []
+headings ??= []
 
 const searchQuery = Astro.url.searchParams.get('search') ?? ''
 
@@ -70,7 +91,7 @@ const tocHeadings = headings.filter((h) => h.depth === 2 || h.depth === 3)
               <p class="mb-8 text-lg text-muted-foreground">{entry.data.description}</p>
             )}
             <div class="prose prose-slate dark:prose-invert max-w-none">
-              <slot />
+              {Content ? <Content /> : <slot />}
             </div>
 
             <!-- Edit this page -->

package/src/index.ts

@@ -1,3 +1,4 @@
+import type { AstroIntegration } from 'astro'
 import type { OnePluginFactory } from '@oneie/frontend'
 
 export interface SidebarFolder {
@@ -17,12 +18,39 @@ export interface OneDocsConfig {
   editBaseUrl?: string
 }
 
-export const docs: OnePluginFactory<OneDocsConfig> = (config = {}) => ({
-  name: 'plugin-docs',
-  tier: 'free',
-  config: undefined,
-  integration: undefined,
-  entitlement: undefined,
-})
+const defaults: Required<Pick<OneDocsConfig, 'injectRoutes'>> = {
+  injectRoutes: true,
+}
+
+export const docs: OnePluginFactory<OneDocsConfig> = (config = {}) => {
+  const resolved = { ...defaults, ...config }
+
+  const integration = (): AstroIntegration => ({
+    name: '@oneie/plugin-docs',
+    hooks: {
+      'astro:config:setup': ({ injectRoute }) => {
+        if (resolved.injectRoutes) {
+          injectRoute({
+            pattern: '/docs',
+            entrypoint: '@oneie/plugin-docs/DocsIndex.astro',
+          })
+          injectRoute({
+            pattern: '/docs/[slug]',
+            entrypoint: '@oneie/plugin-docs/DocsLayout.astro',
+          })
+        }
+      },
+    },
+  })
+
+  return {
+    name: 'plugin-docs',
+    tier: 'free',
+    config: undefined,
+    integration,
+    entitlement: undefined,
+    serves: undefined,
+  }
+}
 
-export type { OneDocsConfig as DocsConfig, SidebarFolder }
+export type { OneDocsConfig as DocsConfig }

package/tsconfig.json

@@ -1,10 +1,10 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
     "jsx": "react-jsx",
     "jsxImportSource": "react",
     "paths": {
-      "@/*": ["../../apps/web/src/*"]
+      "@/*": ["../../template/site/src/*"]
     }
   },
   "include": ["src"]