deskforge 1.0.0

package/packages/router/dist/router.js

@@ -0,0 +1,112 @@
+"use strict";
+// router.ts
+// The DeskForge navigation system.
+// Maps route names to screen components.
+// Manages navigation history for back/forward.
+// Handles screen transitions automatically.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = Router;
+exports.go = go;
+exports.back = back;
+exports.forward = forward;
+exports.params = params;
+exports.render = render;
+// Global router state
+const routerState = {
+    routes: new Map(),
+    history: [],
+    currentIndex: -1,
+    listeners: new Set(),
+};
+// Notifies all listeners that route changed
+function notifyRouteChange() {
+    routerState.listeners.forEach(listener => listener());
+}
+// Registers all routes at once
+// Called once in app.dtx to set up navigation
+function Router(routes) {
+    Object.keys(routes).forEach(name => {
+        const route = routes[name];
+        if (!route)
+            return;
+        // If it is a plain function wrap it in ScreenConfig
+        if (typeof route === 'function') {
+            routerState.routes.set(name, { component: route });
+        }
+        else {
+            routerState.routes.set(name, route);
+        }
+    });
+}
+// Navigates to a named route with optional params
+// Adds entry to history stack
+function go(name, params = {}) {
+    const route = routerState.routes.get(name);
+    if (!route) {
+        console.error(`DeskForge Router: unknown route "${name}"`);
+        return;
+    }
+    // Remove any forward history when navigating new route
+    routerState.history = routerState.history.slice(0, routerState.currentIndex + 1);
+    // Add new entry to history
+    routerState.history.push({ name, params });
+    routerState.currentIndex = routerState.history.length - 1;
+    notifyRouteChange();
+}
+// Goes back one step in navigation history
+function back() {
+    if (routerState.currentIndex <= 0)
+        return;
+    routerState.currentIndex--;
+    notifyRouteChange();
+}
+// Goes forward one step in navigation history
+function forward() {
+    if (routerState.currentIndex >= routerState.history.length - 1) {
+        return;
+    }
+    routerState.currentIndex++;
+    notifyRouteChange();
+}
+// Returns the params of the current screen
+function params() {
+    const current = routerState.history[routerState.currentIndex];
+    return current?.params ?? {};
+}
+// Returns the name of the current route
+function currentRoute() {
+    const current = routerState.history[routerState.currentIndex];
+    return current?.name ?? null;
+}
+// Renders the current screen as a DFNode tree
+// Call this in Window body or Screen body
+function render() {
+    const current = routerState.history[routerState.currentIndex];
+    if (!current)
+        return null;
+    const route = routerState.routes.get(current.name);
+    if (!route)
+        return null;
+    // Call the screen component with its params
+    return route.component(current.params);
+}
+// Registers a listener for route changes
+// Returns unsubscribe function
+function onRouteChange(listener) {
+    routerState.listeners.add(listener);
+    return () => routerState.listeners.delete(listener);
+}
+// Returns all registered route names
+function getRoutes() {
+    return Array.from(routerState.routes.keys());
+}
+// Attaches go, back, forward etc to Router function
+Router.go = go;
+Router.back = back;
+Router.forward = forward;
+Router.params = params;
+Router.currentRoute = currentRoute;
+Router.render = render;
+Router.onRouteChange = onRouteChange;
+Router.getRoutes = getRoutes;
+//# sourceMappingURL=router.js.map

package/packages/router/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/packages/router/dist/screen.d.ts

@@ -0,0 +1,31 @@
+export type ScreenParams = Record<string, unknown>;
+export interface DFNode<P = Record<string, unknown>> {
+    id: string;
+    type: string;
+    props: P;
+    children: DFNode[];
+    key: string | number | null;
+}
+export type ScreenComponent = (params: ScreenParams) => DFNode;
+export interface ScreenConfig {
+    component: ScreenComponent;
+    transition?: string;
+    protected?: boolean;
+    layout?: string;
+    title?: string;
+}
+export interface DFScreen {
+    name: string;
+    config: ScreenConfig;
+}
+export interface ScreenOptions {
+    transition?: string;
+    protected?: boolean;
+    layout?: string;
+    title?: string;
+}
+export declare function Screen(component: ScreenComponent, options?: ScreenOptions): ScreenConfig;
+export declare function createScreen(component: ScreenComponent, options?: ScreenOptions): DFScreen;
+export declare function withLayout(layoutName: string, screen: ScreenConfig): ScreenConfig;
+export declare function withTitle(title: string, screen: ScreenConfig): ScreenConfig;
+//# sourceMappingURL=screen.d.ts.map

package/packages/router/dist/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,eAAe,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,MAAM,CACpB,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAQd;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,aAAkB,GAC1B,QAAQ,CAKV;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAKjF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAK3E"}

package/packages/router/dist/screen.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Screen = Screen;
+exports.createScreen = createScreen;
+exports.withLayout = withLayout;
+exports.withTitle = withTitle;
+function Screen(component, options = {}) {
+    return {
+        component,
+        ...(options.transition !== undefined ? { transition: options.transition } : {}),
+        ...(options.protected !== undefined ? { protected: options.protected } : {}),
+        ...(options.layout !== undefined ? { layout: options.layout } : {}),
+        ...(options.title !== undefined ? { title: options.title } : {}),
+    };
+}
+function createScreen(component, options = {}) {
+    return {
+        name: options.title ?? 'screen',
+        config: Screen(component, options),
+    };
+}
+function withLayout(layoutName, screen) {
+    return {
+        ...screen,
+        layout: layoutName,
+    };
+}
+function withTitle(title, screen) {
+    return {
+        ...screen,
+        title,
+    };
+}
+//# sourceMappingURL=screen.js.map

package/packages/router/dist/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":";;AAgCA,wBAWC;AAED,oCAQC;AAED,gCAKC;AAED,8BAKC;AAnCD,SAAgB,MAAM,CACpB,SAA0B,EAC1B,UAAyB,EAAE;IAE3B,OAAO;QACL,SAAS;QACT,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAA;AACH,CAAC;AAED,SAAgB,YAAY,CAC1B,SAA0B,EAC1B,UAAyB,EAAE;IAE3B,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;QAC/B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC;KACnC,CAAA;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,UAAkB,EAAE,MAAoB;IACjE,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,UAAU;KACnB,CAAA;AACH,CAAC;AAED,SAAgB,SAAS,CAAC,KAAa,EAAE,MAAoB;IAC3D,OAAO;QACL,GAAG,MAAM;QACT,KAAK;KACN,CAAA;AACH,CAAC"}

package/packages/router/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@deskforge/router",
+  "version": "1.0.0",
+  "description": "DeskForge router — screen navigation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deskforge/deskforge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/deskforge/deskforge/issues"
+  },
+  "homepage": "https://github.com/deskforge/deskforge#readme"
+}

package/packages/router/src/app.ts

@@ -0,0 +1,16 @@
+import type { RouteManifest } from './manifest'
+import { FileRouter } from './file-router'
+
+export interface AppContext {
+  router: InstanceType<typeof FileRouter>
+}
+
+export function createApp(opts: { manifest: RouteManifest }): AppContext {
+  const router = new FileRouter(opts.manifest)
+
+  return {
+    router,
+  }
+}
+
+export default createApp

package/packages/router/src/file-router.ts

@@ -0,0 +1,181 @@
+import type { DFNode, ScreenParams, ScreenComponent } from './screen'
+
+export interface FileRouteEntry {
+  path: string
+  pattern: string
+  component: ScreenComponent
+  params: ScreenParams
+}
+
+export function filePathToRoute(filePath: string): {
+  path: string
+  pattern: string
+  dynamicSegments: string[]
+} {
+  let path = filePath.replace(/\.ts$/, '')
+
+  if (path === 'index') {
+    return { path: '/', pattern: '^/$', dynamicSegments: [] }
+  }
+
+  const segments = path.split('/').filter(Boolean)
+  const dynamicSegments: string[] = []
+  const patternSegments = segments.map(segment => {
+    if (segment.startsWith('[') && segment.endsWith(']')) {
+      const param = segment.slice(1, -1)
+      dynamicSegments.push(param)
+      return `:${param}`
+    }
+    return segment
+  })
+
+  const route = '/' + patternSegments.join('/')
+  let pattern = '^' + route.replace(/:[^/]+/g, '[^/]+').replace(/\//g, '\\/')
+  pattern += '$'
+
+  return { path: route, pattern, dynamicSegments }
+}
+
+export function extractParams(path: string, pattern: { dynamicSegments: string[]; segments: string[] }): ScreenParams {
+  const params: ScreenParams = {}
+  const pathSegments = path.split('/').filter(Boolean)
+
+  for (let index = 0; index < pattern.dynamicSegments.length; index += 1) {
+    const paramName = pattern.dynamicSegments[index]
+    if (paramName !== undefined) {
+      params[paramName] = pathSegments[index] ?? ''
+    }
+  }
+
+  return params
+}
+
+export class FileRouter {
+  private routes: Map<string, FileRouteEntry> = new Map()
+  private history: string[] = []
+  private listeners: Set<() => void> = new Set()
+  private currentPath = '/'
+  private routeManifest: Record<string, ScreenComponent>
+
+  constructor(manifest: Record<string, ScreenComponent>) {
+    this.routeManifest = manifest
+    this.initializeRoutes()
+  }
+
+  private initializeRoutes(): void {
+    for (const [filePath, component] of Object.entries(this.routeManifest)) {
+      const { path, pattern } = filePathToRoute(filePath)
+      this.routes.set(path, {
+        path,
+        pattern,
+        component,
+        params: {},
+      })
+    }
+  }
+
+  navigate(path: string, params: ScreenParams = {}): void {
+    this.currentPath = path
+    this.history.push(path)
+    this.notifyListeners()
+
+    const route = this.findRoute(path)
+    if (route) {
+      route.params = {
+        ...route.params,
+        ...params,
+      }
+    }
+  }
+
+  back(): void {
+    if (this.history.length <= 1) return
+
+    this.history.pop()
+    this.currentPath = this.history[this.history.length - 1] ?? '/'
+    this.notifyListeners()
+  }
+
+  private findRoute(path: string): FileRouteEntry | null {
+    if (this.routes.has(path)) {
+      return this.routes.get(path) ?? null
+    }
+
+    for (const [routePath, route] of this.routes.entries()) {
+      if (this.matchesPattern(path, routePath)) {
+        const params = this.extractDynamicParams(path, routePath)
+        return {
+          ...route,
+          params,
+        }
+      }
+    }
+
+    return null
+  }
+
+  private matchesPattern(path: string, routePath: string): boolean {
+    const routeSegments = routePath.split('/').filter(Boolean)
+    const pathSegments = path.split('/').filter(Boolean)
+
+    if (routeSegments.length !== pathSegments.length) {
+      return false
+    }
+
+    return routeSegments.every((segment, index) => {
+      if (segment.startsWith('[') && segment.endsWith(']')) {
+        return true
+      }
+      if (segment.startsWith(':')) {
+        return true
+      }
+      return segment === pathSegments[index]
+    })
+  }
+
+  private extractDynamicParams(path: string, routePath: string): ScreenParams {
+    const params: ScreenParams = {}
+    const routeSegments = routePath.split('/').filter(Boolean)
+    const pathSegments = path.split('/').filter(Boolean)
+
+    routeSegments.forEach((segment, index) => {
+      if (segment.startsWith('[') && segment.endsWith(']')) {
+        const paramName = segment.slice(1, -1)
+        params[paramName] = pathSegments[index] ?? ''
+      }
+      if (segment.startsWith(':')) {
+        const paramName = segment.slice(1)
+        params[paramName] = pathSegments[index] ?? ''
+      }
+    })
+
+    return params
+  }
+
+  render(): DFNode | null {
+    const route = this.findRoute(this.currentPath)
+
+    if (!route) {
+      return null
+    }
+
+    return route.component(route.params)
+  }
+
+  getCurrentPath(): string {
+    return this.currentPath
+  }
+
+  onRouteChange(listener: () => void): () => void {
+    this.listeners.add(listener)
+    return () => this.listeners.delete(listener)
+  }
+
+  private notifyListeners(): void {
+    this.listeners.forEach(listener => listener())
+  }
+
+  getRoutes(): string[] {
+    return Array.from(this.routes.keys())
+  }
+}

package/packages/router/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './screen';
+export * from './router';

package/packages/router/src/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// index.ts
+// Public door into the router package.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Screen component and config types
+__exportStar(require("./screen"), exports);
+// Router navigation system
+__exportStar(require("./router"), exports);
+//# sourceMappingURL=index.js.map

package/packages/router/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA,WAAW;AACX,uCAAuC;;;;;;;;;;;;;;;;AAEvC,oCAAoC;AACpC,2CAAwB;AAExB,2BAA2B;AAC3B,2CAAwB"}

package/packages/router/src/index.ts

@@ -0,0 +1,7 @@
+// index.ts
+// Public entrypoint for the router package.
+export * from './screen'
+export * from './router'
+export * from './file-router'
+export * from './manifest'
+export * from './app'

package/packages/router/src/manifest.ts

@@ -0,0 +1,27 @@
+import type { ScreenComponent } from './screen'
+
+export type RouteManifest = Record<string, ScreenComponent>
+
+export function buildManifest(routes: Record<string, ScreenComponent>): RouteManifest {
+  return { ...routes }
+}
+
+export class ManifestBuilder {
+  private routes: Record<string, ScreenComponent> = {}
+
+  add(filePath: string, component: ScreenComponent): this {
+    this.routes[filePath] = component
+    return this
+  }
+
+  build(): RouteManifest {
+    return { ...this.routes }
+  }
+}
+
+export async function loadManifest(
+  importFn: () => Promise<Record<string, ScreenComponent>>
+): Promise<RouteManifest> {
+  const routes = await importFn()
+  return buildManifest(routes)
+}

package/packages/router/src/router.d.ts

@@ -0,0 +1,30 @@
+import type { DFNode } from './screen';
+import type { ScreenParams, ScreenComponent, ScreenConfig } from './screen';
+interface HistoryEntry {
+    name: string;
+    params: ScreenParams;
+}
+interface RouterState {
+    routes: Map<string, ScreenConfig>;
+    history: HistoryEntry[];
+    currentIndex: number;
+    listeners: Set<() => void>;
+}
+declare function Router(routes: Record<string, ScreenComponent | ScreenConfig>): void;
+declare namespace Router {
+    var go: typeof import("./router").go;
+    var back: typeof import("./router").back;
+    var forward: typeof import("./router").forward;
+    var params: typeof import("./router").params;
+    var currentRoute: () => string | null;
+    var render: typeof import("./router").render;
+    var onRouteChange: (listener: () => void) => () => void;
+    var getRoutes: () => string[];
+}
+declare function go(name: string, params?: ScreenParams): void;
+declare function back(): void;
+declare function forward(): void;
+declare function params(): ScreenParams;
+declare function render(): DFNode | null;
+export type { HistoryEntry, RouterState };
+export { Router, go, back, forward, params, render };

package/packages/router/src/router.js

@@ -0,0 +1,112 @@
+"use strict";
+// router.ts
+// The DeskForge navigation system.
+// Maps route names to screen components.
+// Manages navigation history for back/forward.
+// Handles screen transitions automatically.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = Router;
+exports.go = go;
+exports.back = back;
+exports.forward = forward;
+exports.params = params;
+exports.render = render;
+// Global router state
+const routerState = {
+    routes: new Map(),
+    history: [],
+    currentIndex: -1,
+    listeners: new Set(),
+};
+// Notifies all listeners that route changed
+function notifyRouteChange() {
+    routerState.listeners.forEach(listener => listener());
+}
+// Registers all routes at once
+// Called once in app.dtx to set up navigation
+function Router(routes) {
+    Object.keys(routes).forEach(name => {
+        const route = routes[name];
+        if (!route)
+            return;
+        // If it is a plain function wrap it in ScreenConfig
+        if (typeof route === 'function') {
+            routerState.routes.set(name, { component: route });
+        }
+        else {
+            routerState.routes.set(name, route);
+        }
+    });
+}
+// Navigates to a named route with optional params
+// Adds entry to history stack
+function go(name, params = {}) {
+    const route = routerState.routes.get(name);
+    if (!route) {
+        console.error(`DeskForge Router: unknown route "${name}"`);
+        return;
+    }
+    // Remove any forward history when navigating new route
+    routerState.history = routerState.history.slice(0, routerState.currentIndex + 1);
+    // Add new entry to history
+    routerState.history.push({ name, params });
+    routerState.currentIndex = routerState.history.length - 1;
+    notifyRouteChange();
+}
+// Goes back one step in navigation history
+function back() {
+    if (routerState.currentIndex <= 0)
+        return;
+    routerState.currentIndex--;
+    notifyRouteChange();
+}
+// Goes forward one step in navigation history
+function forward() {
+    if (routerState.currentIndex >= routerState.history.length - 1) {
+        return;
+    }
+    routerState.currentIndex++;
+    notifyRouteChange();
+}
+// Returns the params of the current screen
+function params() {
+    const current = routerState.history[routerState.currentIndex];
+    return current?.params ?? {};
+}
+// Returns the name of the current route
+function currentRoute() {
+    const current = routerState.history[routerState.currentIndex];
+    return current?.name ?? null;
+}
+// Renders the current screen as a DFNode tree
+// Call this in Window body or Screen body
+function render() {
+    const current = routerState.history[routerState.currentIndex];
+    if (!current)
+        return null;
+    const route = routerState.routes.get(current.name);
+    if (!route)
+        return null;
+    // Call the screen component with its params
+    return route.component(current.params);
+}
+// Registers a listener for route changes
+// Returns unsubscribe function
+function onRouteChange(listener) {
+    routerState.listeners.add(listener);
+    return () => routerState.listeners.delete(listener);
+}
+// Returns all registered route names
+function getRoutes() {
+    return Array.from(routerState.routes.keys());
+}
+// Attaches go, back, forward etc to Router function
+Router.go = go;
+Router.back = back;
+Router.forward = forward;
+Router.params = params;
+Router.currentRoute = currentRoute;
+Router.render = render;
+Router.onRouteChange = onRouteChange;
+Router.getRoutes = getRoutes;
+//# sourceMappingURL=router.js.map

package/packages/router/src/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["router.ts"],"names":[],"mappings":"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"}