@owlmeans/create-app 0.1.18-rc.4 → 0.1.18-rc.41

package/template/sources/api/src/app/session/remove.ts

@@ -1,13 +1,14 @@
-import { handleParams } from '@owlmeans/server-app'
-import type { ItemParams, SessionItem } from '__APP_SLUG__-common'
+import { handlers } from '@owlmeans/server-app'
+import { session, type SessionItem } from '__APP_SLUG__-common'
 import { SESSION_ITEMS } from '../../consts.js'
 import type { Context } from '../../types.js'
 
-export const remove = handleParams<ItemParams>(async (params, context) => {
-  const ctx = context as Context
-  const resource = ctx.getStaticResource<SessionItem>(SESSION_ITEMS)
+const handle = handlers<Context>()
 
-  const existing = await resource.load<SessionItem>(params.id)
+export const remove = handle.params(session.remove, async (params, context) => {
+  const resource = context.getStaticResource<SessionItem>(SESSION_ITEMS)
+
+  const existing = await resource.load(params.id)
   // Only remove the item if it belongs to the requesting session.
   if (existing == null || existing.sessionId !== params.sid) {
     return { removed: false }

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

@@ -0,0 +1,11 @@
+import { makeContext as makeBasicContext } from '@owlmeans/server-app'
+import type { Config, Context } from './types.js'
+
+/**
+ * Where the app's resources are registered. `@owlmeans/static-resource` is already a dependency,
+ * so `appendStaticResource<C, T>(context, ALIAS)` gives you an in-memory store with no database
+ * behind it; a mongo/postgres resource takes its place once the data has to outlive the process.
+ * Whatever you append here must also widen `Context` in `types.ts`, or the getter will not exist.
+ */
+export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T =>
+  makeBasicContext<C, T>(cfg, true)

package/template/sources/api/src/entrypoints.bare.ts

@@ -0,0 +1,4 @@
+import { entrypoints } from '@owlmeans/server-app'
+
+// The bare shell has no API declarations yet. Bind new protocols here as they are added.
+export const appBindings = [...entrypoints]

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

@@ -0,0 +1,13 @@
+import { entrypoints } from '@owlmeans/server-app'
+import { bind } from '@owlmeans/server-entrypoint'
+import { appProtocols } from '__APP_SLUG__-common'
+import * as handlers from './app/session/index.js'
+
+/** Local server bindings for the shared session protocol tree. */
+export const appBindings = [
+  ...entrypoints,
+  bind(appProtocols.api.session.base),
+  bind(appProtocols.api.session.list, handlers.list),
+  bind(appProtocols.api.session.add, handlers.add),
+  bind(appProtocols.api.session.remove, handlers.remove),
+]

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

@@ -1,9 +1,9 @@
 import { main } from '@owlmeans/server-app'
 import config from './config.js'
 import { makeContext } from './context.js'
-import { appModules } from './modules.js'
+import { appBindings } from './entrypoints.js'
 import type { Config, Context } from './types.js'
 
 const context = makeContext<Config, Context>(config)
 
-main<{}, Config, Context>(context, appModules)
+main<{}, Config, Context>(context, appBindings)

package/template/sources/api/src/types.bare.ts

@@ -0,0 +1,5 @@
+import type { AppConfig, AppContext } from '@owlmeans/server-app'
+
+export interface Config extends AppConfig {}
+
+export interface Context<C extends Config = Config> extends AppContext<C> {}

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.33",
+    "@owlmeans/entrypoint": "^0.1.18-rc.32",
+    "@owlmeans/error": "^0.1.18-rc.31",
+    "@owlmeans/resource": "^0.1.18-rc.31",
+    "@owlmeans/route": "^0.1.18-rc.30",
     "ajv": "^8.17.1"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "^0.1.16",
+    "@owlmeans/dep-config": "^0.1.18-rc.6",
     "@types/node": "^24.10.1",
     "typescript": "^7.0.2"
   }

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

@@ -0,0 +1,8 @@
+/** Service aliases shared between web and api. */
+export const APP = '__APP_SLUG__'
+export const APP_WEB = '__APP_SLUG__-web'
+export const APP_API = '__APP_SLUG__-api'
+
+/** Local development ports. */
+export const WEB_PORT = 3001
+export const API_PORT = 3000

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

@@ -6,16 +6,3 @@ export const APP_API = '__APP_SLUG__-api'
 /** Local development ports. */
 export const WEB_PORT = 3001
 export const API_PORT = 3000
-
-/** Backend (API) entrypoint identifiers. */
-export const session = {
-  base: '__APP_SLUG__:api:session',
-  list: '__APP_SLUG__:api:session:list',
-  add: '__APP_SLUG__:api:session:add',
-  remove: '__APP_SLUG__:api:session:remove',
-}
-
-/** Frontend (web) entrypoint identifiers. */
-export const web = {
-  session: '__APP_SLUG__:web:session',
-}

package/template/sources/common/src/entrypoints.bare.ts

@@ -0,0 +1,14 @@
+import { openProtocol } from '@owlmeans/entrypoint'
+import { BASE, HOME } from '@owlmeans/context'
+import { frontend, route } from '@owlmeans/route'
+
+const webBase = openProtocol(route(BASE, '/', frontend()))
+
+/** The shared immutable protocol tree. Add API declarations below `api` as the shell grows. */
+export const appProtocols = {
+  api: {},
+  web: {
+    base: webBase,
+    home: openProtocol(route(HOME, '/', frontend({ default: true, parent: webBase }))),
+  },
+}

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

@@ -0,0 +1,60 @@
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
+import { route, RouteMethod, frontend } from '@owlmeans/route'
+import { AddItemSchema, ItemParamsSchema, SessionParamsSchema } from './schemas.js'
+import type { SessionItem } from './types.js'
+
+const aliases = {
+  session: {
+    base: '__APP_SLUG__:api:session',
+    list: '__APP_SLUG__:api:session:list',
+    add: '__APP_SLUG__:api:session:add',
+    remove: '__APP_SLUG__:api:session:remove',
+  },
+  web: {
+    base: '__APP_SLUG__:web:base',
+    home: '__APP_SLUG__:web:home',
+    session: '__APP_SLUG__:web:session',
+    about: '__APP_SLUG__:web:about',
+  },
+}
+
+const sessionBase = protocol(route(aliases.session.base, '/session'), contract())
+const webBase = openProtocol(route(aliases.web.base, '/', frontend()))
+
+/**
+ * Shared entrypoint declarations. The api materializes these with handlers; the web
+ * materializes them with screen components and calls them. Routes resolve under the
+ * api service `base` (`/api`), so e.g. `session.list` → `GET /api/session/:sid/items`.
+ */
+export const session = {
+  base: sessionBase,
+  list: protocol(
+    route(aliases.session.list, '/:sid/items', { parent: sessionBase, method: RouteMethod.GET }),
+    contract.request({ params: SessionParamsSchema }, typed<SessionItem[]>()),
+  ),
+  add: protocol(
+    route(aliases.session.add, '/:sid/items', { parent: sessionBase, method: RouteMethod.POST }),
+    contract.request({
+      params: SessionParamsSchema,
+      body: AddItemSchema,
+    }, typed<SessionItem>()),
+  ),
+  remove: protocol(
+    route(aliases.session.remove, '/:sid/items/:id', { parent: sessionBase, method: RouteMethod.DELETE }),
+    contract.request({ params: ItemParamsSchema }, typed<{ removed: boolean }>()),
+  ),
+}
+
+/** Frontend routes are protocol declarations too; their renderer is bound by the web project. */
+export const web = {
+  base: webBase,
+  home: openProtocol(route(aliases.web.home, '/', frontend({ default: true, parent: webBase }))),
+  session: openProtocol(route(aliases.web.session, '/session', frontend({ parent: webBase }))),
+  about: openProtocol(route(aliases.web.about, '/about', frontend({ parent: webBase }))),
+}
+
+/** The shared immutable protocol tree. Runtime packages bind their own local handlers and screens. */
+export const appProtocols = Object.freeze({
+  api: Object.freeze({ session }),
+  web: Object.freeze(web),
+})

package/template/sources/common/src/index.bare.ts

@@ -0,0 +1,3 @@
+export * from './consts.js'
+export * from './config.js'
+export * from './entrypoints.js'

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

@@ -2,4 +2,4 @@ export * from './consts.js'
 export * from './types.js'
 export * from './schemas.js'
 export * from './config.js'
-export * from './modules.js'
+export * from './entrypoints.js'

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

@@ -1,25 +1,25 @@
-import type { JSONSchemaType } from 'ajv'
+import { schema } from '@owlmeans/entrypoint'
 import type { AddItemPayload, ItemParams, SessionParams } from './types.js'
 
-export const AddItemSchema: JSONSchemaType<AddItemPayload> = {
+export const AddItemSchema = schema<AddItemPayload>({
   type: 'object',
   properties: {
     text: { type: 'string', minLength: 1, maxLength: 280 },
   },
   required: ['text'],
   additionalProperties: false,
-}
+})
 
-export const SessionParamsSchema: JSONSchemaType<SessionParams> = {
+export const SessionParamsSchema = schema<SessionParams>({
   type: 'object',
   properties: {
     sid: { type: 'string', minLength: 1 },
   },
   required: ['sid'],
   additionalProperties: false,
-}
+})
 
-export const ItemParamsSchema: JSONSchemaType<ItemParams> = {
+export const ItemParamsSchema = schema<ItemParams>({
   type: 'object',
   properties: {
     sid: { type: 'string', minLength: 1 },
@@ -27,4 +27,4 @@ export const ItemParamsSchema: JSONSchemaType<ItemParams> = {
   },
   required: ['sid', 'id'],
   additionalProperties: false,
-}
+})

package/template/sources/web/index.html

@@ -1,9 +1,11 @@
 <!doctype html>
-<html lang="en">
+<html lang="__APP_LANG__">
 
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta name="application-name" content="__APP_NAME__" />
+  <meta name="description" content="__APP_DESCRIPTION__" />
   <title>__APP_NAME__</title>
 </head>
 

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.36",
+    "@owlmeans/client-config": "^0.1.18-rc.33",
+    "@owlmeans/client-context": "^0.1.18-rc.34",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.33",
+    "@owlmeans/client-i18n": "^0.1.18-rc.35",
+    "@owlmeans/entrypoint": "^0.1.18-rc.32",
+    "@owlmeans/route": "^0.1.18-rc.30",
+    "@owlmeans/state": "^0.1.18-rc.30",
+    "@owlmeans/web-client": "^0.1.18-rc.45",
+    "@owlmeans/web-panel": "^0.1.18-rc.55",
     "@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.6",
     "@tailwindcss/vite": "^4.1.13",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",

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

@@ -0,0 +1,257 @@
+"use client"
+
+import * as React from "react"
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu"
+import { CheckIcon, ChevronRightIcon, CircleIcon } from "lucide-react"
+
+import { cn } from "@/lib/utils"
+
+function DropdownMenu({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Root>) {
+  return <DropdownMenuPrimitive.Root data-slot="dropdown-menu" {...props} />
+}
+
+function DropdownMenuPortal({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>) {
+  return (
+    <DropdownMenuPrimitive.Portal data-slot="dropdown-menu-portal" {...props} />
+  )
+}
+
+function DropdownMenuTrigger({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>) {
+  return (
+    <DropdownMenuPrimitive.Trigger
+      data-slot="dropdown-menu-trigger"
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuContent({
+  className,
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Content>) {
+  return (
+    <DropdownMenuPrimitive.Portal>
+      <DropdownMenuPrimitive.Content
+        data-slot="dropdown-menu-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
+          className
+        )}
+        {...props}
+      />
+    </DropdownMenuPrimitive.Portal>
+  )
+}
+
+function DropdownMenuGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Group>) {
+  return (
+    <DropdownMenuPrimitive.Group data-slot="dropdown-menu-group" {...props} />
+  )
+}
+
+function DropdownMenuItem({
+  className,
+  inset,
+  variant = "default",
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+  inset?: boolean
+  variant?: "default" | "destructive"
+}) {
+  return (
+    <DropdownMenuPrimitive.Item
+      data-slot="dropdown-menu-item"
+      data-inset={inset}
+      data-variant={variant}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuCheckboxItem({
+  className,
+  children,
+  checked,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>) {
+  return (
+    <DropdownMenuPrimitive.CheckboxItem
+      data-slot="dropdown-menu-checkbox-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      checked={checked}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.CheckboxItem>
+  )
+}
+
+function DropdownMenuRadioGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>) {
+  return (
+    <DropdownMenuPrimitive.RadioGroup
+      data-slot="dropdown-menu-radio-group"
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuRadioItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>) {
+  return (
+    <DropdownMenuPrimitive.RadioItem
+      data-slot="dropdown-menu-radio-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CircleIcon className="size-2 fill-current" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.RadioItem>
+  )
+}
+
+function DropdownMenuLabel({
+  className,
+  inset,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+  inset?: boolean
+}) {
+  return (
+    <DropdownMenuPrimitive.Label
+      data-slot="dropdown-menu-label"
+      data-inset={inset}
+      className={cn(
+        "px-2 py-1.5 text-sm font-medium data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>) {
+  return (
+    <DropdownMenuPrimitive.Separator
+      data-slot="dropdown-menu-separator"
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuShortcut({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="dropdown-menu-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function DropdownMenuSub({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>) {
+  return <DropdownMenuPrimitive.Sub data-slot="dropdown-menu-sub" {...props} />
+}
+
+function DropdownMenuSubTrigger({
+  className,
+  inset,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+  inset?: boolean
+}) {
+  return (
+    <DropdownMenuPrimitive.SubTrigger
+      data-slot="dropdown-menu-sub-trigger"
+      data-inset={inset}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronRightIcon className="ml-auto size-4" />
+    </DropdownMenuPrimitive.SubTrigger>
+  )
+}
+
+function DropdownMenuSubContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>) {
+  return (
+    <DropdownMenuPrimitive.SubContent
+      data-slot="dropdown-menu-sub-content"
+      className={cn(
+        "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export {
+  DropdownMenu,
+  DropdownMenuPortal,
+  DropdownMenuTrigger,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuLabel,
+  DropdownMenuItem,
+  DropdownMenuCheckboxItem,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuSeparator,
+  DropdownMenuShortcut,
+  DropdownMenuSub,
+  DropdownMenuSubTrigger,
+  DropdownMenuSubContent,
+}