create-gesso-app 0.6.3 → 0.6.17

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # create-gesso-app
 
+## 0.6.17
+
+## 0.6.16
+
+### Patch Changes
+
+- 1f60081: A channel's view may hold a `SharedArrayBuffer`. It is a handle on memory, so reference equality is the right comparison for it, and posted to another thread it is shared rather than copied: the app worker and the render worker can read one large document without sending it, and what changes is a small plain value saying which version to read. It needs a cross-origin isolated page. A desktop window's channels refuse it by name rather than sending `{}`, an agent is shown its size, and `gesso-vite-plugin` describes it in a view's schema instead of warning. A command still may not take one from an agent.
+
+## 0.6.15
+
+### Patch Changes
+
+- 2cc396a: `standardMenu(appName)` in `gesso-electrobun/desktop`: the application, Edit and Window menus every Mac application has, for `ApplicationMenu.setApplicationMenu`. Without an Edit menu macOS sends ⌘V and ⌘C nowhere, so text fields in a desktop window could not be pasted into or copied from. The Electrobun template installs it.
+
+## 0.6.14
+
+## 0.6.13
+
+## 0.6.12
+
+## 0.6.11
+
+## 0.6.10
+
+## 0.6.9
+
+## 0.6.8
+
+## 0.6.7
+
+## 0.6.6
+
+## 0.6.5
+
+### Patch Changes
+
+- e93e0ee: A `Link` can now name an in-app destination with `to`, and a Cmd-click opens it somewhere new, the way a browser treats an anchor. `to` takes one of the application's own urls (`/epic/BUD-12?story=BUD-13`) or a `RouteTarget` from `to(route, params)`. A plain click, Enter or Space runs `onPress` and then navigates the router in place. A click with Command or Control held (either one, on any platform), a middle click, or Cmd-Enter / Ctrl-Enter runs `onPress` and then asks the shell to open the app at that url somewhere new, leaving the current screen where it is. An `href` link is unchanged: it opens through `openUrl` however it is clicked. When a link has both, `to` wins. `Breadcrumb` items take the same `to`.
+
+  The request is the new `ShellService.openRoute(url)`, and what "somewhere new" means is the shell's decision. `createApp` and `GessoApp` take an `onOpenRoute(url)` for a host with its own idea of a new tab, such as an app inside Jira opening one through Forge's `router.open`. Without one, a browser shell opens a tab at the app's own address for that url: the path on the same origin in `path` mode, the same page with the fragment set in `hash` mode. In `memory` mode there is no address, so the link is followed in place. A handed-in `ShellHistory` can answer the new optional `href(url)` to give the address itself; without it, such a link is also followed in place.
+
+  In `gesso-electrobun`, the view bridge has `openRoute(url)` to pass as `onOpenRoute`, and `createDesktopApp` answers it by opening a new window of the application at that route: `openWindow({ route })`, and an `onOpenRoute(url, window)` option to do something else. A window learns its route from the page it loads: `open` reads `window.route`, `withWindowRoute` puts it in the view url's fragment, and `windowRoute()` reads it back as the window's starting url. An `open` that ignores it keeps working. The Electrobun template does all three.
+
+## 0.6.4
+
 ## 0.6.3
 
 ## 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gesso-app",
-  "version": "0.6.3",
+  "version": "0.6.17",
   "description": "Scaffolds a Gesso app: a native-grade web application built from declarative components, with its interface in a render worker.",
   "license": "MIT",
   "author": "Kevin Baker",

package/templates/_shared/AGENTS.md

@@ -110,7 +110,8 @@ export const Notes = defineChannel('notes', {
 
 - Only **plain data** crosses: primitives, arrays and plain objects.
   No `Date`, `Map`, `Set` or class instances. Flatten them where they
-  are made.
+  are made. The one exception is a `SharedArrayBuffer`, which both
+  threads read without copying (the page must be cross-origin isolated).
 - Commands return `void`. The effect comes back as a change to the view,
   never as a return value.
 - A component reads `ctx.channel(Notes).view.rows` like any other cell

package/templates/electrobun/package.json

@@ -5,16 +5,16 @@
   "type": "module",
   "description": "A Gesso application in a native Electrobun window.",
   "dependencies": {
-    "gesso-components": "^0.6.3",
-    "gesso-core": "^0.6.3",
-    "gesso-electrobun": "^0.6.3",
-    "gesso-framework": "^0.6.3",
+    "gesso-components": "^0.6.17",
+    "gesso-core": "^0.6.17",
+    "gesso-electrobun": "^0.6.17",
+    "gesso-framework": "^0.6.17",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "concurrently": "^9.1.0",
-    "gesso-vite-plugin": "^0.6.3",
+    "gesso-vite-plugin": "^0.6.17",
     "typescript": "~7.0.2",
     "vite": "^8.2.0"
   }

package/templates/electrobun/src/main/index.ts

@@ -11,11 +11,18 @@
  * what that window has already seen, so two windows agree by
  * construction rather than by synchronising.
  */
-import { BrowserView, BrowserWindow, Utils } from 'electrobun/main';
+import { ApplicationMenu, BrowserView, BrowserWindow, Utils } from 'electrobun/main';
 import { BehaviorSubject, map } from 'rxjs';
 
 import type { GessoFrame } from 'gesso-electrobun';
-import { createDesktopApp, messageBoxConfirm, serveDesktopAgent, windowsChannel } from 'gesso-electrobun/desktop';
+import {
+  createDesktopApp,
+  messageBoxConfirm,
+  serveDesktopAgent,
+  standardMenu,
+  windowsChannel,
+  withWindowRoute
+} from 'gesso-electrobun/desktop';
 import { serve } from 'gesso-framework';
 
 import { Counter } from '../shared/Counter';
@@ -23,6 +30,9 @@ import { Counter } from '../shared/Counter';
 import '../shared/channels.described';
 import type { GessoWindowRPC } from '../shared/rpc';
 
+// Without an Edit menu, macOS sends ⌘V and ⌘C nowhere, and text fields cannot be pasted into.
+ApplicationMenu.setApplicationMenu(standardMenu('Gesso app'));
+
 /** The application's whole state, in the process that owns it. */
 const count = new BehaviorSubject(0);
 
@@ -65,7 +75,9 @@ const app = createDesktopApp({
     });
     const window = new BrowserWindow({
       title: '{{name}}',
-      url: 'views://mainview/index.html',
+      // The route a Cmd-click asked for, if any, for the window to
+      // start at; see `windowRoute` in the view.
+      url: withWindowRoute('views://mainview/index.html', handle.route),
       frame: { width: 460, height: 360, x: 100 + handle.id * 60, y: 120 + handle.id * 40 },
       rpc
     });

package/templates/electrobun/src/view/main.ts

@@ -8,7 +8,7 @@
  * a transport rather than a router.
  */
 import type { GessoFrame } from 'gesso-electrobun';
-import { createElectrobunBridge } from 'gesso-electrobun/view';
+import { createElectrobunBridge, windowRoute } from 'gesso-electrobun/view';
 import { createApp } from 'gesso-framework';
 import { Electroview } from 'electrobun/view';
 
@@ -43,11 +43,15 @@ const shell = createApp({
   // The application layer is in another process, so this is the bridge
   // rather than a data worker. The render worker cannot tell.
   appLogicWorker: bridge.endpoint,
-  // A window has no address bar, so its routes are its own.
-  history: { mode: 'memory' },
+  // A window has no address bar, so its routes are its own. It starts
+  // at the route the main process opened it at, if it was given one.
+  history: { mode: 'memory', initialUrl: windowRoute() },
   // A link in a desktop application belongs in the person's browser,
   // which only the process outside this window can reach.
   onOpenUrl: url => bridge.openUrl(url),
+  // A Cmd-click on an in-app link opens another window of this
+  // application, at that route.
+  onOpenRoute: url => bridge.openRoute(url),
   // The window is all app: a key pressed before anything is clicked is its.
   pageKeys: true,
   onError: (message, stack, source) => console.error(`[gesso ${source}] ${message}`, stack)

package/templates/web/package.json

@@ -10,14 +10,14 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "gesso-components": "^0.6.3",
-    "gesso-core": "^0.6.3",
-    "gesso-framework": "^0.6.3",
+    "gesso-components": "^0.6.17",
+    "gesso-core": "^0.6.17",
+    "gesso-framework": "^0.6.17",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "gesso-devtools": "^0.6.3",
-    "gesso-vite-plugin": "^0.6.3",
+    "gesso-devtools": "^0.6.17",
+    "gesso-vite-plugin": "^0.6.17",
     "typescript": "~7.0.2",
     "vite": "^8.2.0"
   }