create-mithaq 0.1.1 → 0.2.0

package/template/apps/{asas-platform → asas-backoffice}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "asas-platform",
+  "name": "asas-backoffice",
   "version": "0.0.0",
   "private": true,
   "type": "module",
@@ -13,7 +13,7 @@
     "@fontsource-variable/figtree": "^5.3.0",
     "@fontsource-variable/noto-sans": "^5.3.0",
     "@fontsource/ibm-plex-sans-arabic": "^5.2.8",
-    "@hugeicons/core-free-icons": "^4.1.4",
+    "@hugeicons/core-free-icons": "4.3.5",
     "@hugeicons/react": "^1.1.6",
     "@lexical/extension": "0.52.0",
     "@lexical/link": "0.52.0",
@@ -34,9 +34,11 @@
     "lexical": "0.52.0",
     "lucide-react": "^1.16.0",
     "mithaq": "*",
+    "mithaq-admin": "*",
     "react": "^19.3.0",
     "react-day-picker": "^10.0.1",
     "react-dom": "^19.3.0",
+    "react-is": "^19.3.0",
     "react-resizable-panels": "^4.14.1",
     "recharts": "3.8.0",
     "tw-animate-css": "^1.4.0"
@@ -47,9 +49,9 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@vitejs/plugin-react": "^6.0.2",
-    "mithaq-admin": "*",
     "shadcn": "4.18.0",
     "tailwindcss": "^4.3.0",
+    "typescript": "^7.0.2",
     "vite": "^8.0.13"
   }
 }

package/template/apps/{asas-platform → asas-backoffice}/src/api.ts

@@ -144,4 +144,4 @@ export const authArm = async (path: string, body: unknown = {}) => {
   // The status too, because a rate limit's refusal carries no code to read.
   return { ok: response.ok, status: response.status, message: answered?.message, body: answered }
 }
-// mithaq-admin b06d8d335d306c07556f8f2b81fba20ba7ded198 94db2fc49ad4391c0d1c2183cb41001dd08d62017c76af86cc5f611488c22c68
+// mithaq-admin 2d3ab739c92c6c2b397041b76bf4b23b2902b7a2 94db2fc49ad4391c0d1c2183cb41001dd08d62017c76af86cc5f611488c22c68

package/template/apps/{asas-platform → asas-backoffice}/src/auth-frame.tsx

@@ -7,10 +7,10 @@ import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/com
 import { Input } from '@/components/ui/input'
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from '@/components/ui/input-group'
 import { authArm } from './api.ts'
-import { FieldShell, describedBy } from './components/mithaq/field-shell.tsx'
+import { FieldShell, describedBy } from 'mithaq-admin/field-shell.tsx'
 import { refusalKey } from './copy.ts'
 import { LocaleSwitch } from './locale-switch.tsx'
-import { wanted } from './redirect.ts'
+import { landing } from './redirect.ts'
 import { useCopy } from './routes/__root.tsx'
 
 /** The one search key the auth pages read, off the raw search. */
@@ -21,8 +21,8 @@ export const redirectSearch = (search: Record<string, unknown>): { redirect?: st
 export const signedInAs = async (actor: Promise<unknown>) => Boolean(((await actor.catch(() => null)) as { email?: unknown } | null)?.email)
 
 /**
- * Whether this request carries a session, where signing in lands for it, and the provider's password bounds.
- * No auth page sends a referrer, since the reset page's address carries its token.
+ * Whether this request carries a session, the screens it opens, the first of them as `home`, which a link back names,
+ * and the provider's password bounds. No auth page sends a referrer, since the reset page's address carries its token.
  */
 export const authGate = createServerFn({ method: 'GET' }).handler(async () => {
   // Imported inside the server half so no auth page ships the screen host to the browser.
@@ -31,9 +31,9 @@ export const authGate = createServerFn({ method: 'GET' }).handler(async () => {
   type Provider = { name: string; server: { $context: Promise<{ password: { config: { minPasswordLength: number; maxPasswordLength: number } } }> } }
   const provider = (asas.auth.strategies as unknown as Provider[]).find((one) => one.name === 'user')!
   const [signedIn, { password }] = await Promise.all([signedInAs(asas.auth.actor(getRequest().headers)), provider.server.$context])
-  const first = signedIn ? (await loadEnterable())?.screens[0] : undefined
-  const home: { path: string; name?: string } = first ?? { path: '/unauthorized' }
-  return { signedIn, home, password: { min: password.config.minPasswordLength, max: password.config.maxPasswordLength } }
+  const entered = signedIn ? ((await loadEnterable())?.screens ?? []) : []
+  const home: { path: string; name?: string } = entered[0] ?? { path: '/unauthorized' }
+  return { signedIn, home, screens: entered, password: { min: password.config.minPasswordLength, max: password.config.maxPasswordLength } }
 })
 
 /**
@@ -42,8 +42,8 @@ export const authGate = createServerFn({ method: 'GET' }).handler(async () => {
  * route context.
  */
 export const gate = async ({ search }: { search: { redirect?: string } }) => {
-  const { signedIn, home, password } = await authGate()
-  if (signedIn) throw redirect({ href: wanted({ asked: search.redirect, home: home.path }) })
+  const { signedIn, screens, password } = await authGate()
+  if (signedIn) throw redirect({ href: landing({ asked: search.redirect, screens }) })
   return { password }
 }
 
@@ -57,10 +57,10 @@ export const useHomeLabel = () => {
 }
 
 /** What the forgot and reset pages draw for someone already signed in: the way on, and a sign-out. */
-export function AlreadySignedIn({ redirect: asked, home }: { redirect?: string; home: { path: string; name?: string } }) {
+export function AlreadySignedIn({ redirect: asked, home, screens }: { redirect?: string; home: { path: string; name?: string }; screens: readonly { name: string; path: string }[] }) {
   const { t } = useCopy()
   const label = useHomeLabel()
-  const to = wanted({ asked, home: home.path })
+  const to = landing({ asked, screens })
   return (
     <AuthFrame title={t('auth.alreadySignedIn', 'You are already signed in')}>
       <div className="grid gap-4">
@@ -147,4 +147,4 @@ export function AuthBox({
     </FieldShell>
   )
 }
-// mithaq-admin b06d8d335d306c07556f8f2b81fba20ba7ded198 ab822afe361dfc5f82c504570fd5d0ea13ec4572e60adb679a3f9532ccf67803
+// mithaq-admin 0.0.0 e498423cf4a61adb8cf6358d043d31ae92d853de4c6939a9c0fe138c848b7211

package/template/apps/asas-backoffice/src/components.ts

@@ -0,0 +1,35 @@
+import type { Language } from 'asas'
+import type { ComponentsOf } from 'mithaq-admin/components.tsx'
+import { defaultComponents } from 'mithaq-admin/default-components.tsx'
+// add-on: rich-text
+import { richTextComponents } from 'mithaq-admin/rich-text.tsx'
+// end add-on: rich-text
+// add-on: uploads
+import { uploadComponents } from 'mithaq-admin/upload.tsx'
+// end add-on: uploads
+
+// Typed against the language, so a kind of the project's own with no control or cell here is a type error, and so
+// is leaving out the rich text or files add-on while the language holds its kind.
+// Spread defaultComponents.controls or defaultComponents.cells to add or replace one.
+// A file of its own, so the server entry reads the map without evaluating the router and its route tree.
+export const components: ComponentsOf<Language> = {
+  ...defaultComponents,
+  controls: {
+    ...defaultComponents.controls,
+    // add-on: rich-text
+    ...richTextComponents.controls,
+    // end add-on: rich-text
+    // add-on: uploads
+    ...uploadComponents.controls,
+    // end add-on: uploads
+  },
+  cells: {
+    ...defaultComponents.cells,
+    // add-on: rich-text
+    ...richTextComponents.cells,
+    // end add-on: rich-text
+    // add-on: uploads
+    ...uploadComponents.cells,
+    // end add-on: uploads
+  },
+}

package/template/apps/asas-backoffice/src/first-user.ts

@@ -0,0 +1,14 @@
+import { createServerFn } from '@tanstack/react-start'
+
+type FirstUser = { initialized: true } | { initialized: false; code: 'none' | 'required' | 'unset' }
+
+/**
+ * Whether the backoffice has an administrator yet, and while it has none whether making one asks for
+ * the setup code: the provider's own `init`, read in process.
+ */
+export const firstUser = createServerFn({ method: 'GET' }).handler(async () => {
+  // Imported inside the server half so no page ships the provider to the browser.
+  const { asas } = await import('asas')
+  type Provider = { name: string; server: { api: { init(): Promise<FirstUser> } } }
+  return (asas.auth.strategies as unknown as Provider[]).find((one) => one.name === 'user')!.server.api.init()
+})

package/template/apps/{asas-platform → asas-backoffice}/src/links.ts

@@ -35,4 +35,4 @@ export const clampedHref = ({ href, page, totalPages }: { href: string; page: nu
   else url.searchParams.delete('page')
   return `${url.pathname}${url.search}${url.hash}`
 }
-// mithaq-admin b06d8d335d306c07556f8f2b81fba20ba7ded198 4754cbac64eeac528e7e037173ad56ffa8d07df3e526e1191bbe3be400db97a5
+// mithaq-admin 2d3ab739c92c6c2b397041b76bf4b23b2902b7a2 4754cbac64eeac528e7e037173ad56ffa8d07df3e526e1191bbe3be400db97a5

package/template/apps/{asas-platform → asas-backoffice}/src/locale-switch.tsx

@@ -1,9 +1,11 @@
+import { useRouter } from '@tanstack/react-router'
 import { Button } from '@/components/ui/button'
-import { localeEntries } from './components/mithaq/nav.tsx'
-import { locales, switchLocale, type Locale } from './copy.ts'
+import { localeEntries } from 'mithaq-admin/locale-menu.ts'
+import { locales, showLocale, type Locale } from './copy.ts'
 
-/** The language switch for pages without a form: `switchLocale` reloads without asking, so a page with a form must use the user menu, which asks first. */
+/** The language switch of the auth and landing pages, which redraws the page in place, so a form keeps what was typed. */
 export function LocaleSwitch({ locale }: { locale: Locale }) {
+  const router = useRouter()
   return (
     <div className="flex items-center gap-1">
       {localeEntries(locales, locale).map((entry) => (
@@ -14,7 +16,7 @@ export function LocaleSwitch({ locale }: { locale: Locale }) {
           size="xs"
           aria-current={entry.active}
           aria-label={entry.label}
-          onClick={() => switchLocale({ to: entry.locale })}
+          onClick={() => void showLocale({ to: entry.locale, router })}
         >
           <span className="hidden sm:inline">{entry.label}</span>
           <span className="sm:hidden">{entry.locale.toUpperCase()}</span>
@@ -23,4 +25,4 @@ export function LocaleSwitch({ locale }: { locale: Locale }) {
     </div>
   )
 }
-// mithaq-admin b06d8d335d306c07556f8f2b81fba20ba7ded198 43c6d309a5bae4f6af3cdcf4c741106b3a16129ac77d142f1e4254594f5b8a54
+// mithaq-admin 0.0.0 37e32a32766452cd88389e2e4cc6c246ccc3ccb40bf941f8c1e3835b4e377f98

package/template/apps/asas-backoffice/src/no-organization.tsx

@@ -0,0 +1,5 @@
+// What `/unauthorized` draws below its sentence for someone in no organization. The backoffice is staff's, who join an
+// organization in the tenant app, so it offers nothing here.
+export function NoOrganization(_: { email: string | undefined }) {
+  return null
+}

package/template/apps/asas-backoffice/src/redirect.ts

@@ -0,0 +1 @@
+export { landing } from '../../asas-tanstack/src/redirect.ts'

package/template/apps/{asas-platform → asas-backoffice}/src/request-headers.ts

@@ -8,4 +8,4 @@ export const mergedHeaders = (session: Headers, own?: HeadersInit): Headers => {
   if (own) for (const [key, value] of new Headers(own)) if (key !== 'cookie') headers.set(key, value)
   return headers
 }
-// mithaq-admin b06d8d335d306c07556f8f2b81fba20ba7ded198 2969a3dafbf201d6eb6074ecda0e8f17e341cbd1ca176100350844e74ec23623
+// mithaq-admin 2d3ab739c92c6c2b397041b76bf4b23b2902b7a2 2969a3dafbf201d6eb6074ecda0e8f17e341cbd1ca176100350844e74ec23623

package/template/apps/asas-backoffice/src/routeTree.gen.ts

@@ -0,0 +1,206 @@
+/* eslint-disable */
+
+// @ts-nocheck
+
+// noinspection JSUnusedGlobalSymbols
+
+// This file was automatically generated by TanStack Router.
+// You should NOT make any changes in this file as it will be overwritten.
+// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
+
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as UnauthorizedRouteImport } from './routes/unauthorized'
+import { Route as screensBackofficeRouteImport } from './routes/(screens)/backoffice'
+import { Route as ApiSplatRouteImport } from './routes/api/$'
+import { Route as AuthCreateFirstUserRouteImport } from './routes/auth.create-first-user'
+import { Route as AuthSignInRouteImport } from './routes/auth.sign-in'
+import { Route as screensBackofficeIndexRouteImport } from './routes/(screens)/backoffice.index'
+import { Route as screensBackofficeSplatRouteImport } from './routes/(screens)/backoffice.$'
+
+const UnauthorizedRoute = UnauthorizedRouteImport.update({
+  id: '/unauthorized',
+  path: '/unauthorized',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const screensBackofficeRoute = screensBackofficeRouteImport.update({
+  id: '/(screens)/backoffice',
+  path: '/backoffice',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiSplatRoute = ApiSplatRouteImport.update({
+  id: '/api/$',
+  path: '/api/$',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const AuthCreateFirstUserRoute = AuthCreateFirstUserRouteImport.update({
+  id: '/auth/create-first-user',
+  path: '/auth/create-first-user',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const AuthSignInRoute = AuthSignInRouteImport.update({
+  id: '/auth/sign-in',
+  path: '/auth/sign-in',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const screensBackofficeIndexRoute = screensBackofficeIndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => screensBackofficeRoute,
+} as any)
+const screensBackofficeSplatRoute = screensBackofficeSplatRouteImport.update({
+  id: '/$',
+  path: '/$',
+  getParentRoute: () => screensBackofficeRoute,
+} as any)
+
+export interface FileRoutesByFullPath {
+  '/unauthorized': typeof UnauthorizedRoute
+  '/backoffice': typeof screensBackofficeRouteWithChildren
+  '/api/$': typeof ApiSplatRoute
+  '/auth/create-first-user': typeof AuthCreateFirstUserRoute
+  '/auth/sign-in': typeof AuthSignInRoute
+  '/backoffice/$': typeof screensBackofficeSplatRoute
+  '/backoffice/': typeof screensBackofficeIndexRoute
+}
+export interface FileRoutesByTo {
+  '/unauthorized': typeof UnauthorizedRoute
+  '/api/$': typeof ApiSplatRoute
+  '/auth/create-first-user': typeof AuthCreateFirstUserRoute
+  '/auth/sign-in': typeof AuthSignInRoute
+  '/backoffice/$': typeof screensBackofficeSplatRoute
+  '/backoffice': typeof screensBackofficeIndexRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/unauthorized': typeof UnauthorizedRoute
+  '/(screens)/backoffice': typeof screensBackofficeRouteWithChildren
+  '/api/$': typeof ApiSplatRoute
+  '/auth/create-first-user': typeof AuthCreateFirstUserRoute
+  '/auth/sign-in': typeof AuthSignInRoute
+  '/(screens)/backoffice/$': typeof screensBackofficeSplatRoute
+  '/(screens)/backoffice/': typeof screensBackofficeIndexRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths:
+    | '/unauthorized'
+    | '/backoffice'
+    | '/api/$'
+    | '/auth/create-first-user'
+    | '/auth/sign-in'
+    | '/backoffice/$'
+    | '/backoffice/'
+  fileRoutesByTo: FileRoutesByTo
+  to:
+    | '/unauthorized'
+    | '/api/$'
+    | '/auth/create-first-user'
+    | '/auth/sign-in'
+    | '/backoffice/$'
+    | '/backoffice'
+  id:
+    | '__root__'
+    | '/unauthorized'
+    | '/(screens)/backoffice'
+    | '/api/$'
+    | '/auth/create-first-user'
+    | '/auth/sign-in'
+    | '/(screens)/backoffice/$'
+    | '/(screens)/backoffice/'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  UnauthorizedRoute: typeof UnauthorizedRoute
+  screensBackofficeRoute: typeof screensBackofficeRouteWithChildren
+  ApiSplatRoute: typeof ApiSplatRoute
+  AuthCreateFirstUserRoute: typeof AuthCreateFirstUserRoute
+  AuthSignInRoute: typeof AuthSignInRoute
+}
+
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/unauthorized': {
+      id: '/unauthorized'
+      path: '/unauthorized'
+      fullPath: '/unauthorized'
+      preLoaderRoute: typeof UnauthorizedRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/(screens)/backoffice': {
+      id: '/(screens)/backoffice'
+      path: '/backoffice'
+      fullPath: '/backoffice'
+      preLoaderRoute: typeof screensBackofficeRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api/$': {
+      id: '/api/$'
+      path: '/api/$'
+      fullPath: '/api/$'
+      preLoaderRoute: typeof ApiSplatRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/auth/create-first-user': {
+      id: '/auth/create-first-user'
+      path: '/auth/create-first-user'
+      fullPath: '/auth/create-first-user'
+      preLoaderRoute: typeof AuthCreateFirstUserRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/auth/sign-in': {
+      id: '/auth/sign-in'
+      path: '/auth/sign-in'
+      fullPath: '/auth/sign-in'
+      preLoaderRoute: typeof AuthSignInRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/(screens)/backoffice/': {
+      id: '/(screens)/backoffice/'
+      path: '/'
+      fullPath: '/backoffice/'
+      preLoaderRoute: typeof screensBackofficeIndexRouteImport
+      parentRoute: typeof screensBackofficeRoute
+    }
+    '/(screens)/backoffice/$': {
+      id: '/(screens)/backoffice/$'
+      path: '/$'
+      fullPath: '/backoffice/$'
+      preLoaderRoute: typeof screensBackofficeSplatRouteImport
+      parentRoute: typeof screensBackofficeRoute
+    }
+  }
+}
+
+interface screensBackofficeRouteChildren {
+  screensBackofficeSplatRoute: typeof screensBackofficeSplatRoute
+  screensBackofficeIndexRoute: typeof screensBackofficeIndexRoute
+}
+
+const screensBackofficeRouteChildren: screensBackofficeRouteChildren = {
+  screensBackofficeSplatRoute: screensBackofficeSplatRoute,
+  screensBackofficeIndexRoute: screensBackofficeIndexRoute,
+}
+
+const screensBackofficeRouteWithChildren =
+  screensBackofficeRoute._addFileChildren(screensBackofficeRouteChildren)
+
+const rootRouteChildren: RootRouteChildren = {
+  UnauthorizedRoute: UnauthorizedRoute,
+  screensBackofficeRoute: screensBackofficeRouteWithChildren,
+  ApiSplatRoute: ApiSplatRoute,
+  AuthCreateFirstUserRoute: AuthCreateFirstUserRoute,
+  AuthSignInRoute: AuthSignInRoute,
+}
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()
+
+import type { getRouter } from './router.tsx'
+import type { startInstance } from './start.ts'
+declare module '@tanstack/react-start' {
+  interface Register {
+    ssr: true
+    router: Awaited<ReturnType<typeof getRouter>>
+    config: Awaited<ReturnType<typeof startInstance.getOptions>>
+  }
+}

package/template/apps/asas-backoffice/src/router.tsx

@@ -0,0 +1,18 @@
+import { createRouter } from '@tanstack/react-router'
+import { routeTree } from './routeTree.gen'
+import { flatSearch } from './screen-list.tsx'
+import { ComponentsProvider, RouteError } from 'mithaq-admin/components.tsx'
+import { components } from './components.ts'
+
+// routeTree.gen.ts is committed: a clean checkout has to typecheck before any build.
+// The search stays the URL's own pairs, one string each; a screen's list keeps its `qs` URL there.
+export const getRouter = () =>
+  createRouter({
+    routeTree,
+    scrollRestoration: true,
+    ...flatSearch,
+    // Around every route, so each screen draws its controls from this map.
+    Wrap: ({ children }) => <ComponentsProvider components={components}>{children}</ComponentsProvider>,
+    // Drawn in place of the route that threw, so the shell around it stays.
+    defaultErrorComponent: RouteError,
+  })

package/template/apps/asas-backoffice/src/routes/(screens)/backoffice/files.ts

@@ -0,0 +1,10 @@
+// Written by `mithaq generate screens`. Do not edit.
+/// <reference types="vite/client" />
+// Every file the `backoffice` screen's references name, each loaded when a page draws it, keyed as the reference prints it.
+const named = (name: string, files: Record<string, () => Promise<unknown>>) => Object.fromEntries(Object.entries(files).map(([file, load]) => [`${name}:${file}`, load]))
+export const files = {
+  ...import.meta.glob(['./src/ui-backoffice/home.tsx', './src/ui-backoffice/organization-actions.tsx', './src/ui-backoffice/record-page.tsx', './src/ui-backoffice/role-cells.tsx', './src/ui-backoffice/user-actions.tsx', './src/ui-dashboard/theme-provider.tsx'], { base: '../../../../../../templates/asas/', exhaustive: true }),
+  ...named('@asas/courses', import.meta.glob(['./courses/ui/fee-cell.tsx', './enrollments/ui/session-cell.tsx', './enrollments/ui/session-labels.tsx'], { base: '../../../../../../templates/features/courses/', exhaustive: true })),
+  ...named('@asas/mithaq', import.meta.glob(['./src/ui/app-shell.tsx', './src/ui/rich-text-nodes.tsx', './src/ui/table-page.tsx'], { base: '../../../../../../templates/mithaq/', exhaustive: true })),
+  ...named('@asas/roles', import.meta.glob(['./roles/ui/roles.tsx'], { base: '../../../../../../templates/features/roles/', exhaustive: true })),
+}