feat: add example

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-composition/{{name.kebabCase}}/hooks/use-{{name.kebabCase}}-business.hook.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useContext } from 'react'
+import { {{name.pascalCase}}BusinessContext } from '../providers/{{name.kebabCase}}-business.provider'
+import type { {{name.pascalCase}}Business } from '../types/{{name.kebabCase}}-business.type'
+
+/**
+ * Возвращает business API, доступный внутри композиционного модуля {{name.pascalCase}}.
+ */
+export const use{{name.pascalCase}}Business = (): {{name.pascalCase}}Business => {
+  const business = useContext({{name.pascalCase}}BusinessContext)
+
+  if (!business) {
+    throw new Error('use{{name.pascalCase}}Business must be used within {{name.pascalCase}}BusinessProvider')
+  }
+
+  return business
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-composition/{{name.kebabCase}}/index.ts

@@ -0,0 +1,4 @@
+export { {{name.pascalCase}}BusinessProvider } from './providers/{{name.kebabCase}}-business.provider'
+export { use{{name.pascalCase}}Business } from './hooks/use-{{name.kebabCase}}-business.hook'
+export type { {{name.pascalCase}}Business } from './types/{{name.kebabCase}}-business.type'
+export type { {{name.pascalCase}}BusinessProviderProps } from './types/{{name.kebabCase}}-business-provider-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-composition/{{name.kebabCase}}/providers/{{name.kebabCase}}-business.provider.tsx

@@ -0,0 +1,27 @@
+'use client'
+
+import { createContext } from 'react'
+import type { {{name.pascalCase}}Business } from '../types/{{name.kebabCase}}-business.type'
+import type { {{name.pascalCase}}BusinessProviderProps } from '../types/{{name.kebabCase}}-business-provider-props.type'
+
+/**
+ * Context business API для композиционного модуля {{name.pascalCase}}.
+ */
+export const {{name.pascalCase}}BusinessContext = createContext<{{name.pascalCase}}Business | null>(null)
+
+/**
+ * Провайдер business API для композиционного модуля {{name.pascalCase}}.
+ *
+ * Используется для:
+ *  - передачи собранных business-фабрик вложенным модулям
+ *  - сохранения единой client boundary для business API
+ */
+export const {{name.pascalCase}}BusinessProvider = (props: {{name.pascalCase}}BusinessProviderProps) => {
+  const { children, value } = props
+
+  return (
+    <{{name.pascalCase}}BusinessContext.Provider value={value}>
+      {children}
+    </{{name.pascalCase}}BusinessContext.Provider>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-composition/{{name.kebabCase}}/types/{{name.kebabCase}}-business-provider-props.type.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react'
+import type { {{name.pascalCase}}Business } from './{{name.kebabCase}}-business.type'
+
+/**
+ * Параметры провайдера business API для {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}BusinessProviderProps = {
+  /** Вложенное дерево композиционного модуля. */
+  children: ReactNode
+  /** Собранный business API. */
+  value: {{name.pascalCase}}Business
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-composition/{{name.kebabCase}}/types/{{name.kebabCase}}-business.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Business API, доступный внутри композиционного модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Business = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/index.ts

@@ -0,0 +1,5 @@
+export { {{name.camelCase}}Factory } from './{{name.kebabCase}}.factory'
+export type { {{name.pascalCase}} } from './types/{{name.kebabCase}}.type'
+export type { {{name.pascalCase}}Api } from './types/{{name.kebabCase}}-api.type'
+export type { {{name.pascalCase}}Deps } from './types/{{name.kebabCase}}-deps.type'
+export type { {{name.pascalCase}}Factory } from './types/{{name.kebabCase}}-factory.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/types/{{name.kebabCase}}-api.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Публичный API бизнес-модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Api = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/types/{{name.kebabCase}}-deps.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Зависимости бизнес-модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Deps = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/types/{{name.kebabCase}}-factory.type.ts

@@ -0,0 +1,7 @@
+import type { {{name.pascalCase}}Api } from './{{name.kebabCase}}-api.type'
+import type { {{name.pascalCase}}Deps } from './{{name.kebabCase}}-deps.type'
+
+/**
+ * Фабрика публичного API бизнес-модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Factory = (deps: {{name.pascalCase}}Deps) => {{name.pascalCase}}Api

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/types/{{name.kebabCase}}.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Доменная сущность {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}} = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business-with-deps/{{name.kebabCase}}/{{name.kebabCase}}.factory.ts

@@ -0,0 +1,8 @@
+import type { {{name.pascalCase}}Factory } from './types/{{name.kebabCase}}-factory.type'
+
+/**
+ * Создаёт публичный API бизнес-модуля {{name.pascalCase}}.
+ */
+export const {{name.camelCase}}Factory: {{name.pascalCase}}Factory = (_deps) => {
+  return {}
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business/{{name.kebabCase}}/index.ts

@@ -0,0 +1,4 @@
+export { {{name.camelCase}}Factory } from './{{name.kebabCase}}.factory'
+export type { {{name.pascalCase}} } from './types/{{name.kebabCase}}.type'
+export type { {{name.pascalCase}}Api } from './types/{{name.kebabCase}}-api.type'
+export type { {{name.pascalCase}}Factory } from './types/{{name.kebabCase}}-factory.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business/{{name.kebabCase}}/types/{{name.kebabCase}}-api.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Публичный API бизнес-модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Api = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business/{{name.kebabCase}}/types/{{name.kebabCase}}-factory.type.ts

@@ -0,0 +1,6 @@
+import type { {{name.pascalCase}}Api } from './{{name.kebabCase}}-api.type'
+
+/**
+ * Фабрика публичного API бизнес-модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Factory = () => {{name.pascalCase}}Api

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business/{{name.kebabCase}}/types/{{name.kebabCase}}.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Доменная сущность {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}} = object

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/business/{{name.kebabCase}}/{{name.kebabCase}}.factory.ts

@@ -0,0 +1,8 @@
+import type { {{name.pascalCase}}Factory } from './types/{{name.kebabCase}}-factory.type'
+
+/**
+ * Создаёт публичный API бизнес-модуля {{name.pascalCase}}.
+ */
+export const {{name.camelCase}}Factory: {{name.pascalCase}}Factory = () => {
+  return {}
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/component/{{name.kebabCase}}/index.ts

@@ -0,0 +1,2 @@
+export { {{name.pascalCase}} } from './{{name.kebabCase}}'
+export type { {{name.pascalCase}}Props } from './types/{{name.kebabCase}}-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/component/{{name.kebabCase}}/styles/{{name.kebabCase}}.module.css

@@ -0,0 +1,3 @@
+.root {
+  display: block;
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/component/{{name.kebabCase}}/types/{{name.kebabCase}}-props.type.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithoutRef } from 'react'
+
+/**
+ * Параметры {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Params = object
+
+/**
+ * Атрибуты корневого элемента {{name.pascalCase}}.
+ */
+type RootAttrs = ComponentPropsWithoutRef<'div'>
+
+/**
+ * Props компонента {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Props = RootAttrs & {{name.pascalCase}}Params

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/component/{{name.kebabCase}}/{{name.kebabCase}}.tsx

@@ -0,0 +1,20 @@
+import cl from 'clsx'
+import type { {{name.pascalCase}}Props } from './types/{{name.kebabCase}}-props.type'
+import styles from './styles/{{name.kebabCase}}.module.css'
+
+/**
+ * <Назначение компонента {{name.pascalCase}} в 1 строке>.
+ *
+ * Используется для:
+ *  - <сценарий 1>
+ *  - <сценарий 2>
+ */
+export const {{name.pascalCase}} = (props: {{name.pascalCase}}Props) => {
+  const { children, className, ...rootAttrs } = props
+
+  return (
+    <div {...rootAttrs} className={cl(styles.root, className)}>
+      {children}
+    </div>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/layout/{{name.kebabCase}}/index.ts

@@ -0,0 +1,2 @@
+export { {{name.pascalCase}}Layout } from './{{name.kebabCase}}.layout'
+export type { {{name.pascalCase}}LayoutProps } from './types/{{name.kebabCase}}-layout-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/layout/{{name.kebabCase}}/styles/{{name.kebabCase}}.module.css

@@ -0,0 +1,3 @@
+.root {
+  display: block;
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/layout/{{name.kebabCase}}/types/{{name.kebabCase}}-layout-props.type.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithoutRef } from 'react'
+
+/**
+ * Параметры layout {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}LayoutParams = object
+
+/**
+ * Атрибуты корневого элемента layout {{name.pascalCase}}.
+ */
+type RootAttrs = ComponentPropsWithoutRef<'div'>
+
+/**
+ * Props layout {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}LayoutProps = RootAttrs & {{name.pascalCase}}LayoutParams

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/layout/{{name.kebabCase}}/{{name.kebabCase}}.layout.tsx

@@ -0,0 +1,20 @@
+import cl from 'clsx'
+import type { {{name.pascalCase}}LayoutProps } from './types/{{name.kebabCase}}-layout-props.type'
+import styles from './styles/{{name.kebabCase}}.module.css'
+
+/**
+ * <Назначение layout {{name.pascalCase}} в 1 строке>.
+ *
+ * Используется для:
+ *  - <сценарий 1>
+ *  - <сценарий 2>
+ */
+export const {{name.pascalCase}}Layout = (props: {{name.pascalCase}}LayoutProps) => {
+  const { children, className, ...rootAttrs } = props
+
+  return (
+    <div {...rootAttrs} className={cl(styles.root, className)}>
+      {children}
+    </div>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/module/{{name.kebabCase}}/index.ts

@@ -0,0 +1,2 @@
+export { {{name.pascalCase}} } from './{{name.kebabCase}}'
+export type { {{name.pascalCase}}Props } from './types/{{name.kebabCase}}-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/module/{{name.kebabCase}}/styles/{{name.kebabCase}}.module.css

@@ -0,0 +1,3 @@
+.root {
+  display: block;
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/module/{{name.kebabCase}}/types/{{name.kebabCase}}-props.type.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithoutRef } from 'react'
+
+/**
+ * Параметры модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Params = object
+
+/**
+ * Атрибуты корневого элемента модуля {{name.pascalCase}}.
+ */
+type RootAttrs = ComponentPropsWithoutRef<'div'>
+
+/**
+ * Props модуля {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Props = RootAttrs & {{name.pascalCase}}Params

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/module/{{name.kebabCase}}/{{name.kebabCase}}.tsx

@@ -0,0 +1,20 @@
+import cl from 'clsx'
+import type { {{name.pascalCase}}Props } from './types/{{name.kebabCase}}-props.type'
+import styles from './styles/{{name.kebabCase}}.module.css'
+
+/**
+ * <Назначение компонента {{name.pascalCase}} в 1 строке>.
+ *
+ * Используется для:
+ *  - <сценарий 1>
+ *  - <сценарий 2>
+ */
+export const {{name.pascalCase}} = (props: {{name.pascalCase}}Props) => {
+  const { children, className, ...rootAttrs } = props
+
+  return (
+    <div {...rootAttrs} className={cl(styles.root, className)}>
+      {children}
+    </div>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/page-entry/{{name.kebabCase}}/index.ts

@@ -0,0 +1 @@
+export { {{name.pascalCase}}PageEntry } from './{{name.kebabCase}}.entry'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/page-entry/{{name.kebabCase}}/{{name.kebabCase}}.entry.tsx

@@ -0,0 +1,23 @@
+import { ComponentRenderer } from 'infra/cms/component-renderer'
+import { digitalPlatformApi } from '@biocadless/digital-platform-api'
+import type { CmsPageEntryProps } from 'infra/cms/cms-page-entry-registry'
+
+/**
+ * Входная точка CMS-страницы {{name.pascalCase}}.
+ *
+ * Используется для:
+ *  - загрузки дерева CMS-компонентов страницы
+ *  - подключения страницы к dynamic CMS routing
+ */
+export const {{name.pascalCase}}PageEntry = async (props: CmsPageEntryProps) => {
+  const { pageId } = props
+  const components = await digitalPlatformApi.componentInstances.listV1({ pageId })
+
+  return (
+    <>
+      {components.map((component) => (
+        <ComponentRenderer key={component.id} data={component} />
+      ))}
+    </>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/screen/{{name.kebabCase}}/index.ts

@@ -0,0 +1,2 @@
+export { {{name.pascalCase}}Screen } from './{{name.kebabCase}}.screen'
+export type { {{name.pascalCase}}ScreenProps } from './types/{{name.kebabCase}}-screen-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/screen/{{name.kebabCase}}/styles/{{name.kebabCase}}.module.css

@@ -0,0 +1,3 @@
+.root {
+  display: block;
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/screen/{{name.kebabCase}}/types/{{name.kebabCase}}-screen-props.type.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithoutRef } from 'react'
+
+/**
+ * Параметры экрана {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}ScreenParams = object
+
+/**
+ * Атрибуты корневого элемента экрана {{name.pascalCase}}.
+ */
+type RootAttrs = ComponentPropsWithoutRef<'main'>
+
+/**
+ * Props экрана {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}ScreenProps = RootAttrs & {{name.pascalCase}}ScreenParams

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/screen/{{name.kebabCase}}/{{name.kebabCase}}.screen.tsx

@@ -0,0 +1,20 @@
+import cl from 'clsx'
+import type { {{name.pascalCase}}ScreenProps } from './types/{{name.kebabCase}}-screen-props.type'
+import styles from './styles/{{name.kebabCase}}.module.css'
+
+/**
+ * <Назначение экрана {{name.pascalCase}} в 1 строке>.
+ *
+ * Используется для:
+ *  - <сценарий 1>
+ *  - <сценарий 2>
+ */
+export const {{name.pascalCase}}Screen = (props: {{name.pascalCase}}ScreenProps) => {
+  const { children, className, ...rootAttrs } = props
+
+  return (
+    <main {...rootAttrs} className={cl(styles.root, className)}>
+      {children}
+    </main>
+  )
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/store/{{name.kebabCase}}.store.ts

@@ -0,0 +1,7 @@
+import { create } from 'zustand'
+import type { {{name.pascalCase}}Store } from './{{name.kebabCase}}.type'
+
+/**
+ * Стор {{name.pascalCase}}.
+ */
+export const use{{name.pascalCase}}Store = create<{{name.pascalCase}}Store>()(() => ({}))

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/store/{{name.kebabCase}}.type.ts

@@ -0,0 +1,14 @@
+/**
+ * Состояние {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}State = object
+
+/**
+ * Действия {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}Actions = object
+
+/**
+ * Стор {{name.pascalCase}} с состоянием и действиями.
+ */
+export type {{name.pascalCase}}Store = {{name.pascalCase}}State & {{name.pascalCase}}Actions

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/widget/{{name.kebabCase}}/index.ts

@@ -0,0 +1,2 @@
+export { {{name.pascalCase}}Widget } from './{{name.kebabCase}}.widget'
+export type { {{name.pascalCase}}WidgetProps } from './types/{{name.kebabCase}}-widget-props.type'

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/widget/{{name.kebabCase}}/styles/{{name.kebabCase}}.module.css

@@ -0,0 +1,3 @@
+.root {
+  display: block;
+}

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/widget/{{name.kebabCase}}/types/{{name.kebabCase}}-widget-props.type.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithoutRef } from 'react'
+
+/**
+ * Параметры виджета {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}WidgetParams = object
+
+/**
+ * Атрибуты корневого элемента виджета {{name.pascalCase}}.
+ */
+type RootAttrs = ComponentPropsWithoutRef<'div'>
+
+/**
+ * Props виджета {{name.pascalCase}}.
+ */
+export type {{name.pascalCase}}WidgetProps = RootAttrs & {{name.pascalCase}}WidgetParams

.opencode/skills/template-generation/reference/examples/nextjs-app-router-slm/.templates/widget/{{name.kebabCase}}/{{name.kebabCase}}.widget.tsx

@@ -0,0 +1,20 @@
+import cl from 'clsx'
+import type { {{name.pascalCase}}WidgetProps } from './types/{{name.kebabCase}}-widget-props.type'
+import styles from './styles/{{name.kebabCase}}.module.css'
+
+/**
+ * <Назначение виджета {{name.pascalCase}} в 1 строке>.
+ *
+ * Используется для:
+ *  - <сценарий 1>
+ *  - <сценарий 2>
+ */
+export const {{name.pascalCase}}Widget = (props: {{name.pascalCase}}WidgetProps) => {
+  const { children, className, ...rootAttrs } = props
+
+  return (
+    <div {...rootAttrs} className={cl(styles.root, className)}>
+      {children}
+    </div>
+  )
+}