@owlmeans/create-app 0.1.18-rc.6 → 0.1.18-rc.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/create-app",
-  "version": "0.1.18-rc.6",
+  "version": "0.1.18-rc.8",
   "license": "MIT",
   "description": "Scaffold a minimal fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource. Deploys agent skills via @owlmeans/agent-skills by default.",
   "type": "module",
@@ -29,7 +29,7 @@
     "template"
   ],
   "dependencies": {
-    "@owlmeans/agent-skills": "^0.1.18-rc.6"
+    "@owlmeans/agent-skills": "^0.1.18-rc.7"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/template/sources/api/package.json

@@ -11,12 +11,12 @@
     "typecheck": "tsc -b"
   },
   "dependencies": {
-    "@owlmeans/server-app": "^0.1.16",
-    "@owlmeans/static-resource": "^0.1.16",
+    "@owlmeans/server-app": "^0.1.18-rc.0",
+    "@owlmeans/static-resource": "^0.1.18-rc.0",
     "__APP_SLUG__-common": "workspace:^"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "^0.1.16",
+    "@owlmeans/dep-config": "^0.1.18-rc.0",
     "@types/node": "^24.10.1",
     "typescript": "^7.0.2"
   }

package/template/sources/api/src/context.ts

@@ -10,5 +10,9 @@ export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T =
   // data lives in process memory and is cleared when the api restarts.
   appendStaticResource<C, T>(context, SESSION_ITEMS)
 
+  // A child context has to inherit THIS factory, not the layer's — otherwise a derived context
+  // is built without the resource registered above and every lookup on it throws.
+  context.makeContext = makeContext as typeof context.makeContext
+
   return context
 }

package/template/sources/common/package.json

@@ -19,15 +19,15 @@
     "typecheck": "tsc -b"
   },
   "dependencies": {
-    "@owlmeans/config": "^0.1.16",
-    "@owlmeans/entrypoint": "^0.1.16",
-    "@owlmeans/error": "^0.1.16",
-    "@owlmeans/resource": "^0.1.16",
-    "@owlmeans/route": "^0.1.16",
+    "@owlmeans/config": "^0.1.18-rc.0",
+    "@owlmeans/entrypoint": "^0.1.18-rc.0",
+    "@owlmeans/error": "^0.1.18-rc.0",
+    "@owlmeans/resource": "^0.1.18-rc.0",
+    "@owlmeans/route": "^0.1.18-rc.0",
     "ajv": "^8.17.1"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "^0.1.16",
+    "@owlmeans/dep-config": "^0.1.18-rc.0",
     "@types/node": "^24.10.1",
     "typescript": "^7.0.2"
   }

package/template/sources/common/src/consts.ts

@@ -18,4 +18,5 @@ export const session = {
 /** Frontend (web) entrypoint identifiers. */
 export const web = {
   session: '__APP_SLUG__:web:session',
+  about: '__APP_SLUG__:web:about',
 }

package/template/sources/web/package.json

@@ -11,19 +11,21 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.16",
-    "@owlmeans/client-config": "^0.1.16",
-    "@owlmeans/client-context": "^0.1.16",
-    "@owlmeans/client-entrypoint": "^0.1.16",
-    "@owlmeans/client-i18n": "^0.1.16",
-    "@owlmeans/entrypoint": "^0.1.16",
-    "@owlmeans/route": "^0.1.16",
-    "@owlmeans/web-client": "^0.1.16",
-    "@owlmeans/web-panel": "^0.1.16",
-    "__APP_SLUG__-common": "workspace:^",
+    "@owlmeans/client": "^0.1.18-rc.0",
+    "@owlmeans/client-config": "^0.1.18-rc.0",
+    "@owlmeans/client-context": "^0.1.18-rc.0",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.0",
+    "@owlmeans/client-i18n": "^0.1.18-rc.0",
+    "@owlmeans/entrypoint": "^0.1.18-rc.0",
+    "@owlmeans/route": "^0.1.18-rc.0",
+    "@owlmeans/state": "^0.1.18-rc.0",
+    "@owlmeans/web-client": "^0.1.18-rc.0",
+    "@owlmeans/web-panel": "^0.1.18-rc.0",
     "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-navigation-menu": "^1.2.14",
     "@radix-ui/react-progress": "^1.1.0",
     "@radix-ui/react-slot": "^1.1.0",
+    "__APP_SLUG__-common": "workspace:^",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.0",
@@ -37,7 +39,7 @@
     "tailwindcss": "^4.1.13"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "^0.1.16",
+    "@owlmeans/dep-config": "^0.1.18-rc.0",
     "@tailwindcss/vite": "^4.1.13",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",

package/template/sources/web/src/components/ui/navigation-menu.tsx

@@ -0,0 +1,169 @@
+// shadcn navigation-menu — sourced from shadcn/ui (new-york) 2026-08-24
+import * as React from "react"
+import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu"
+import { cva } from "class-variance-authority"
+import { ChevronDownIcon } from "lucide-react"
+
+import { cn } from "@/lib/utils"
+
+function NavigationMenu({
+  className,
+  children,
+  viewport = true,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
+  viewport?: boolean
+}) {
+  return (
+    <NavigationMenuPrimitive.Root
+      data-slot="navigation-menu"
+      data-viewport={viewport}
+      className={cn(
+        "group/navigation-menu relative flex max-w-max flex-1 items-center justify-center",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      {viewport && <NavigationMenuViewport />}
+    </NavigationMenuPrimitive.Root>
+  )
+}
+
+function NavigationMenuList({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.List>) {
+  return (
+    <NavigationMenuPrimitive.List
+      data-slot="navigation-menu-list"
+      className={cn(
+        "group flex flex-1 list-none items-center justify-center gap-1",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function NavigationMenuItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Item>) {
+  return (
+    <NavigationMenuPrimitive.Item
+      data-slot="navigation-menu-item"
+      className={cn("relative", className)}
+      {...props}
+    />
+  )
+}
+
+const navigationMenuTriggerStyle = cva(
+  "group inline-flex h-9 w-max items-center justify-center rounded-md bg-background px-4 py-2 text-sm font-medium hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground disabled:pointer-events-none disabled:opacity-50 data-[state=open]:hover:bg-accent data-[state=open]:text-accent-foreground data-[state=open]:focus:bg-accent data-[state=open]:bg-accent/50 focus-visible:ring-ring/50 outline-none transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1"
+)
+
+function NavigationMenuTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Trigger>) {
+  return (
+    <NavigationMenuPrimitive.Trigger
+      data-slot="navigation-menu-trigger"
+      className={cn(navigationMenuTriggerStyle(), "group", className)}
+      {...props}
+    >
+      {children}{" "}
+      <ChevronDownIcon
+        className="relative top-[1px] ml-1 size-3 transition duration-300 group-data-[state=open]:rotate-180"
+        aria-hidden="true"
+      />
+    </NavigationMenuPrimitive.Trigger>
+  )
+}
+
+function NavigationMenuContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Content>) {
+  return (
+    <NavigationMenuPrimitive.Content
+      data-slot="navigation-menu-content"
+      className={cn(
+        "data-[motion^=from-]:animate-in data-[motion^=to-]:animate-out data-[motion^=from-]:fade-in data-[motion^=to-]:fade-out data-[motion=from-end]:slide-in-from-right-52 data-[motion=from-start]:slide-in-from-left-52 data-[motion=to-end]:slide-out-to-right-52 data-[motion=to-start]:slide-out-to-left-52 top-0 left-0 w-full p-2 pr-2.5 md:absolute md:w-auto",
+        "group-data-[viewport=false]/navigation-menu:bg-popover group-data-[viewport=false]/navigation-menu:text-popover-foreground group-data-[viewport=false]/navigation-menu:data-[state=open]:animate-in group-data-[viewport=false]/navigation-menu:data-[state=closed]:animate-out group-data-[viewport=false]/navigation-menu:data-[state=closed]:zoom-out-95 group-data-[viewport=false]/navigation-menu:data-[state=open]:zoom-in-95 group-data-[viewport=false]/navigation-menu:data-[state=open]:fade-in-0 group-data-[viewport=false]/navigation-menu:data-[state=closed]:fade-out-0 group-data-[viewport=false]/navigation-menu:top-full group-data-[viewport=false]/navigation-menu:mt-1.5 group-data-[viewport=false]/navigation-menu:overflow-hidden group-data-[viewport=false]/navigation-menu:rounded-md group-data-[viewport=false]/navigation-menu:border group-data-[viewport=false]/navigation-menu:shadow group-data-[viewport=false]/navigation-menu:duration-200 **:data-[slot=navigation-menu-link]:focus:ring-0 **:data-[slot=navigation-menu-link]:focus:outline-none",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function NavigationMenuViewport({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Viewport>) {
+  return (
+    <div
+      className={cn(
+        "absolute top-full left-0 isolate z-50 flex justify-center"
+      )}
+    >
+      <NavigationMenuPrimitive.Viewport
+        data-slot="navigation-menu-viewport"
+        className={cn(
+          "origin-top-center bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-90 relative mt-1.5 h-[var(--radix-navigation-menu-viewport-height)] w-full overflow-hidden rounded-md border shadow md:w-[var(--radix-navigation-menu-viewport-width)]",
+          className
+        )}
+        {...props}
+      />
+    </div>
+  )
+}
+
+function NavigationMenuLink({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Link>) {
+  return (
+    <NavigationMenuPrimitive.Link
+      data-slot="navigation-menu-link"
+      className={cn(
+        "data-[active=true]:focus:bg-accent data-[active=true]:hover:bg-accent data-[active=true]:bg-accent/50 data-[active=true]:text-accent-foreground hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground focus-visible:ring-ring/50 [&_svg:not([class*='text-'])]:text-muted-foreground flex flex-col gap-1 rounded-sm p-2 text-sm transition-all outline-none focus-visible:ring-[3px] focus-visible:outline-1 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function NavigationMenuIndicator({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Indicator>) {
+  return (
+    <NavigationMenuPrimitive.Indicator
+      data-slot="navigation-menu-indicator"
+      className={cn(
+        "data-[state=visible]:animate-in data-[state=hidden]:animate-out data-[state=hidden]:fade-out data-[state=visible]:fade-in top-full z-[1] flex h-1.5 items-end justify-center overflow-hidden",
+        className
+      )}
+      {...props}
+    >
+      <div className="bg-border relative top-[60%] h-2 w-2 rotate-45 rounded-tl-sm shadow-md" />
+    </NavigationMenuPrimitive.Indicator>
+  )
+}
+
+export {
+  NavigationMenu,
+  NavigationMenuList,
+  NavigationMenuItem,
+  NavigationMenuContent,
+  NavigationMenuTrigger,
+  NavigationMenuLink,
+  NavigationMenuIndicator,
+  NavigationMenuViewport,
+  navigationMenuTriggerStyle,
+}

package/template/sources/web/src/context.ts

@@ -1,7 +1,23 @@
 import { makeContext as makeBasicContext, useContext as useBasicContext } from '@owlmeans/web-panel'
+import { appendStateResource } from '@owlmeans/state'
 import type { Config, Context } from './types.js'
 
+/** The alias the session items are stored under. Screens address the store by it, never by path. */
+export const SESSION_STATE = 'session-items'
+
 export const useContext = (): Context => useBasicContext<Config, Context>()
 
-export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T =>
-  makeBasicContext<C, T>(cfg)
+export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T => {
+  const context = makeBasicContext<C, T>(cfg)
+
+  // The framework's client store. A state resource lives ON the context, so a screen, a guard and
+  // a service all reach the same records — which is what separates it from a store held beside
+  // the app in a module of its own.
+  appendStateResource<C, T>(context, SESSION_STATE)
+
+  // A child context has to inherit THIS factory, not the layer's. Without the line, a derived
+  // context is built without the resource registered above and every lookup on it throws.
+  context.makeContext = makeContext as typeof context.makeContext
+
+  return context
+}

package/template/sources/web/src/index.css

@@ -1,5 +1,12 @@
 @import "tailwindcss";
 
+/*
+ * Tailwind scans this app's sources for class names, and node_modules is excluded from that
+ * scan by default — so the classes that exist ONLY inside @owlmeans/web-panel components
+ * (the navigation shell, the footer) would never reach the stylesheet. This line adds them.
+ */
+@source "../../../node_modules/@owlmeans/web-panel/build";
+
 /*
  * shadcn / Tailwind v4 design tokens (new-york, neutral). The app owns these — they
  * replace what @owlmeans/owl-theme would otherwise provide. The shadcn primitives in

package/template/sources/web/src/layout/main.tsx

@@ -1,21 +1,14 @@
 import type { FC, PropsWithChildren } from 'react'
-import { HOME, useNavigate } from '@owlmeans/web-panel'
-import { MainNavigation } from '@/components/nav/main'
+import { NavLayout } from '@owlmeans/web-panel'
+import { footerLinks, navConfig } from '@/nav'
 
-export const MainLayout: FC<PropsWithChildren> = ({ children }) => {
-  const nav = useNavigate()
-
-  return (
-    <div className="min-h-screen bg-background text-foreground">
-      <header className="border-b">
-        <div className="mx-auto flex h-16 max-w-4xl items-center justify-between px-4">
-          <a onClick={nav.press(HOME)} className="cursor-pointer text-lg font-semibold">
-            __APP_NAME__
-          </a>
-          <MainNavigation />
-        </div>
-      </header>
-      <main className="mx-auto max-w-4xl px-4 py-8">{children}</main>
-    </div>
-  )
-}
+/**
+ * The application shell. `NavLayout` renders the header with the section menu, the side menu
+ * of the active section (hidden when that section has a single screen), the content, and the
+ * footer — the screen arrives as `children`.
+ */
+export const MainLayout: FC<PropsWithChildren> = ({ children }) => (
+  <NavLayout nav={navConfig} title="__APP_NAME__" footer={footerLinks} contentClassName="mx-auto w-full max-w-4xl">
+    {children}
+  </NavLayout>
+)

package/template/sources/web/src/modules.ts

@@ -1,6 +1,7 @@
 import { BASE, elevate, entrypoint, frontend, handler, HOME, modules as baseModules, route } from '@owlmeans/web-panel'
 import { session, sessionModules, web } from '__APP_SLUG__-common'
 import { MainLayout } from './layout/main.js'
+import { AboutScreen } from './screens/about.js'
 import { HomeScreen } from './screens/home.js'
 import { SessionScreen } from './screens/session.js'
 
@@ -16,5 +17,6 @@ elevate(modules, session.remove)
 modules.push(entrypoint(route(BASE, '/', frontend()), handler(MainLayout)))
 modules.push(entrypoint(route(HOME, '/', frontend({ default: true, parent: BASE })), handler(HomeScreen)))
 modules.push(entrypoint(route(web.session, '/session', frontend({ parent: BASE })), handler(SessionScreen)))
+modules.push(entrypoint(route(web.about, '/about', frontend({ parent: BASE })), handler(AboutScreen)))
 
 export const appModules = modules

package/template/sources/web/src/nav.ts

@@ -0,0 +1,28 @@
+import { HOME } from '@owlmeans/web-panel'
+import type { PanelNavConfig, PanelNavLink } from '@owlmeans/web-panel'
+import { web } from '__APP_SLUG__-common'
+
+/**
+ * The application's navigation, as data.
+ *
+ * Sections are the top menu; their items are the side menu of whichever section is active.
+ * A section holding ONE item renders no side menu at all — `home` below shows that, `demo`
+ * shows the two-level case. Labels here are literal; drop them to fall back on the panel
+ * i18n keys (`nav.<section>` / `modules.<alias>`) instead.
+ */
+export const navConfig: PanelNavConfig = {
+  sections: [
+    { name: 'home', label: 'Home', items: [{ alias: HOME, label: 'Overview' }] },
+    {
+      name: 'demo', label: 'Demo', items: [
+        { alias: web.session, label: 'Session' },
+        { alias: web.about, label: 'About' },
+      ]
+    },
+  ],
+}
+
+export const footerLinks: PanelNavLink[] = [
+  { alias: HOME, label: '__APP_NAME__' },
+  { href: 'https://owlmeans.com', label: 'OwlMeans', open: true },
+]

package/template/sources/web/src/screens/about.tsx

@@ -0,0 +1,19 @@
+import type { FC } from 'react'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+
+export const AboutScreen: FC = () => (
+  <Card>
+    <CardHeader>
+      <CardTitle>About __APP_NAME__</CardTitle>
+      <CardDescription>
+        The second screen of the Demo section — which is why that section shows a side menu
+        and the single-screen Home section does not.
+      </CardDescription>
+    </CardHeader>
+    <CardContent>
+      <p className="text-sm text-muted-foreground">
+        Built with OwlMeans Common. Navigation lives in <code>src/nav.ts</code>.
+      </p>
+    </CardContent>
+  </Card>
+)

package/template/sources/web/src/screens/session.tsx

@@ -1,7 +1,8 @@
 import { useEffect, useState, type FC } from 'react'
 import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+import { useStoreList } from '@owlmeans/client'
 import { session, type SessionItem } from '__APP_SLUG__-common'
-import { useContext } from '../context.js'
+import { SESSION_STATE, useContext } from '../context.js'
 import { Button } from '@/components/ui/button'
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
 import { Input } from '@/components/ui/input'
@@ -20,15 +21,27 @@ const sessionId = (): string => {
 export const SessionScreen: FC = () => {
   const ctx = useContext()
   const sid = sessionId()
-  const [items, setItems] = useState<SessionItem[]>([])
   const [text, setText] = useState('')
   const [busy, setBusy] = useState(false)
 
+  const store = ctx.getStateResource<SessionItem>(SESSION_STATE)
+
+  /**
+   * The list is a live subscription to the state resource, not a piece of component state.
+   * Anything that writes a record — this screen or another one — re-renders it, so adding and
+   * removing never re-fetch to stay in step. `{}` matches every record; a real filter goes here.
+   */
+  const items = useStoreList<SessionItem>({ query: {}, resource: SESSION_STATE })
+
+  // The server is the source of truth; the store is what the screen reads. Fetch once, write
+  // what came back into the store, and let the subscription render it.
   const load = async () => {
     const [data] = await ctx
       .entrypoint<ClientEntrypoint<SessionItem[]>>(session.list)
       .call({ params: { sid } })
-    setItems(data ?? [])
+    for (const item of data ?? []) {
+      await store.save(item)
+    }
   }
 
   useEffect(() => { void load() }, [])
@@ -37,11 +50,13 @@ export const SessionScreen: FC = () => {
     if (text.trim() === '') return
     setBusy(true)
     try {
-      await ctx
+      const [item] = await ctx
         .entrypoint<ClientEntrypoint<SessionItem>>(session.add)
         .call({ params: { sid }, body: { text } })
       setText('')
-      await load()
+      if (item != null) {
+        await store.save(item)
+      }
     } finally {
       setBusy(false)
     }
@@ -51,7 +66,7 @@ export const SessionScreen: FC = () => {
     await ctx
       .entrypoint<ClientEntrypoint<{ removed: boolean }>>(session.remove)
       .call({ params: { sid, id } })
-    await load()
+    await store.delete(id)
   }
 
   return (
@@ -75,11 +90,11 @@ export const SessionScreen: FC = () => {
         <ul className="flex flex-col gap-2">
           {items.map(item => (
             <li
-              key={item.id}
+              key={item.record.id}
               className="flex items-center justify-between rounded-md border px-3 py-2"
             >
-              <span>{item.text}</span>
-              <Button variant="ghost" size="sm" onClick={() => void remove(item.id)}>
+              <span>{item.record.text}</span>
+              <Button variant="ghost" size="sm" onClick={() => void remove(item.record.id)}>
                 Remove
               </Button>
             </li>

package/template/sources/web/src/components/nav/main.tsx

@@ -1,15 +0,0 @@
-import type { FC } from 'react'
-import { HOME, useNavigate } from '@owlmeans/web-panel'
-import { web } from '__APP_SLUG__-common'
-import { Button } from '@/components/ui/button'
-
-export const MainNavigation: FC = () => {
-  const nav = useNavigate()
-
-  return (
-    <nav className="flex items-center gap-1">
-      <Button variant="ghost" size="sm" onClick={nav.press(HOME)}>Home</Button>
-      <Button variant="ghost" size="sm" onClick={nav.press(web.session)}>Session</Button>
-    </nav>
-  )
-}