@niscorp/moss 0.2.3 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/DESIGN.md +10 -0
- package/DOCS.md +17 -3
- package/README.md +6 -0
- package/dist/{chunk-JBRD2TDQ.js → chunk-CDNJ2CBA.js} +3 -3
- package/dist/{chunk-JBRD2TDQ.js.map → chunk-CDNJ2CBA.js.map} +1 -1
- package/dist/{chunk-2AHJ6VDR.js → chunk-D6E4SV6F.js} +8 -5
- package/dist/chunk-D6E4SV6F.js.map +1 -0
- package/dist/{document-Dg1BZxCz.d.cts → document-Jhfii6kd.d.cts} +4 -0
- package/dist/{document-Dg1BZxCz.d.ts → document-Jhfii6kd.d.ts} +4 -0
- package/dist/index.cjs +6 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -2
- package/dist/index.d.ts +3 -2
- package/dist/index.js +1 -1
- package/dist/node.cjs +5 -3
- package/dist/node.cjs.map +1 -1
- package/dist/node.d.cts +3 -2
- package/dist/node.d.ts +3 -2
- package/dist/node.js +2 -2
- package/dist/terminal/index.cjs +10 -0
- package/dist/terminal/index.cjs.map +1 -1
- package/dist/terminal/index.js +10 -0
- package/dist/terminal/index.js.map +1 -1
- package/dist/vite.cjs +6 -3
- package/dist/vite.cjs.map +1 -1
- package/dist/vite.d.cts +3 -1
- package/dist/vite.d.ts +3 -1
- package/dist/vite.js +3 -2
- package/dist/vite.js.map +1 -1
- package/package.json +6 -6
- package/dist/chunk-2AHJ6VDR.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @niscorp/moss
|
|
2
2
|
|
|
3
|
+
## 0.2.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- af903c6: A page's head is its screen's own. `nisc export` wrote every path with the built `index.html`'s `<head>`, so a site with more than one page shipped each of them under the front page's title, description, preview card and canonical address.
|
|
8
|
+
|
|
9
|
+
What a screen says about itself is now a node in a layout: nova's `nova:head`, with `title`, `description`, `image`, `kind` and `structured` bound to the action's data like any other node's props. It draws nothing — no adapter builds an element for it, no registry has to hold it, and a component is never handed one as a child — and it rides in the render tree, so it reaches a shell in the page, a snapshot a server drew and the trees on a wire alike. `headOf(api)` reads it off any of them; with more than one on the screen the last one speaks.
|
|
10
|
+
- **nova** — `HEAD_NAME`, `HeadPropsSchema`, `HEAD_META`, `headOf`, `isHeadNode`; and `@niscorp/nova/document`: `placeHead` writes a head into an HTML document (the tag that said the same thing is replaced, a missing one is added before `</head>`, everything else is left as it was; values are escaped) and `createTitleKeeper` keeps a tab's title on it. The DOM, React and Vue adapters keep the title on the head as the screen moves, and give the page's own back when the screen has none.
|
|
11
|
+
- **cli** — `build`, `export` and `start` write each path's document with its screen's head. "Same twice" also fails a boot that says a different head the second time, and the route table says whose head each path goes out with once an app has one. New config field `site`: the address the site is served at. With it every path says its own canonical address (`<link rel="canonical">`, `og:url`) and a head's picture gets a whole address; a build with several paths, a canonical tag in `index.html` and no `site` says so.
|
|
12
|
+
- **moss** — `renderDocument` and `exportDocuments` do the same from the snapshot (`site` on the config, `head` on the result), and the terminal keeps the tab's title off the wire for every render target.
|
|
13
|
+
- **create-nisc** — the two own-shell templates say their welcome screen's head.
|
|
14
|
+
|
|
15
|
+
**What to change:** nothing. An app with no `nova:head` node and no `site` is built, served and drawn exactly as before. An app that rewrote its exported files to give each page a head can delete that step: put the node in the layout and set `site`.
|
|
16
|
+
|
|
3
17
|
## 0.2.3
|
|
4
18
|
|
|
5
19
|
### Patch Changes
|
package/DESIGN.md
CHANGED
|
@@ -361,6 +361,16 @@ drawing a signed-in screen to a string is 0.4–0.7 ms; a whole anonymous docume
|
|
|
361
361
|
— build a shell, read it, draw it — about 0.65 ms, some 1,500 a second. The
|
|
362
362
|
page carries its screen twice (markup and snapshot), 3–5 KB compressed.
|
|
363
363
|
|
|
364
|
+
**The head of the page is part of the screen.** A title, a description and a
|
|
365
|
+
preview card are facts about what the screen shows, so they are a node in a
|
|
366
|
+
layout (nova's `nova:head`) and ride in the same trees as everything else:
|
|
367
|
+
`renderDocument` reads the node off the snapshot and writes it into the
|
|
368
|
+
template's `<head>`, and the terminal reads it off the wire to keep the tab's
|
|
369
|
+
title. Nothing was added to the snapshot, the wire or the manifest for it. The
|
|
370
|
+
one thing a head cannot say is where the page lives — a layout never holds its
|
|
371
|
+
own address — so the canonical address is the `site` plus the path the
|
|
372
|
+
document was drawn at, both of which the writer already holds.
|
|
373
|
+
|
|
364
374
|
Six things had to be true, and each is a small, separate decision:
|
|
365
375
|
|
|
366
376
|
- **The read does not disturb anybody.** A snapshot renders, and rendering can
|
package/DOCS.md
CHANGED
|
@@ -453,8 +453,9 @@ const page = await renderDocument({
|
|
|
453
453
|
request: { path, cookie }, // what the request named and carried
|
|
454
454
|
draw: (snapshot) => renderSnapshot({ snapshot, registry, slotWrapper }),
|
|
455
455
|
htmlAttributes: (snapshot) => ({ 'data-accent': … }), // optional
|
|
456
|
+
site: 'https://example.com', // optional
|
|
456
457
|
});
|
|
457
|
-
// → { html, headers, drawn, principal, page?, live?, why?, drawnWith?, settled? }
|
|
458
|
+
// → { html, headers, drawn, principal, page?, head?, live?, why?, drawnWith?, settled? }
|
|
458
459
|
```
|
|
459
460
|
|
|
460
461
|
- **Which shell**: the page `server.page(path)` names, else the app's.
|
|
@@ -469,6 +470,19 @@ const page = await renderDocument({
|
|
|
469
470
|
- **`htmlAttributes`** is for what a kit would otherwise set on `<html>` from an
|
|
470
471
|
effect, which never runs on a server: a palette, a colour scheme. Read it off
|
|
471
472
|
the same node the effect reads it from. Values are escaped.
|
|
473
|
+
- **The page's head is its screen's own.** What a screen says about itself is
|
|
474
|
+
a node in a layout — nova's `nova:head`, with `title`, `description`,
|
|
475
|
+
`image`, `kind` and `structured` bound to the action's data. It is in the
|
|
476
|
+
snapshot's trees like everything else on the screen, so it is read off them
|
|
477
|
+
and written into the template's `<head>`: what it says takes the place of
|
|
478
|
+
the tag that said the same thing, and the rest of the head is left as the
|
|
479
|
+
template has it. `head` in the result is what was read (`{ head, action? }`);
|
|
480
|
+
absent, the page went out with the template's. In the browser the terminal
|
|
481
|
+
keeps the tab's title on the same node as the screen moves.
|
|
482
|
+
- **`site`** is the address the site is served at. A layout never holds its
|
|
483
|
+
own page's address: with `site`, every path's document says its own
|
|
484
|
+
canonical address (`<link rel="canonical">`, `og:url`) and a picture a head
|
|
485
|
+
names is given a whole one. Without it the template's is left as it is.
|
|
472
486
|
- **`template`** must hold the empty root (`root`, default
|
|
473
487
|
`<div id="root"></div>`). The screen goes inside it, the snapshot element
|
|
474
488
|
straight after.
|
|
@@ -880,7 +894,7 @@ Correctness, which matters more than the saving:
|
|
|
880
894
|
the runtime's through for you, so only a host running its own listener (a
|
|
881
895
|
vite plugin, a dev check) ever needs it.
|
|
882
896
|
|
|
883
|
-
- `mountSite(server, { dist, draw, htmlAttributes?, tokenKey?, waitMs?, owned? })`
|
|
897
|
+
- `mountSite(server, { dist, draw, htmlAttributes?, site?, tokenKey?, waitMs?, owned? })`
|
|
884
898
|
— the built terminal, served by the same process as the app. Every GET that
|
|
885
899
|
nothing registered earlier answers is a file from `dist`, or a page:
|
|
886
900
|
`index.html` with the caller's screen drawn into it (`renderDocument`) — the
|
|
@@ -914,7 +928,7 @@ Requires the optional `vite` peer.
|
|
|
914
928
|
keeps it.
|
|
915
929
|
- `options.app(load): Promise<DevApp>` — stand the app up. `load` is vite's
|
|
916
930
|
`ssrLoadModule`. `DevApp = { server, close?, draw?, htmlAttributes?,
|
|
917
|
-
tokenKey?, signIn? }`; absent `draw`, pages go out undrawn.
|
|
931
|
+
site?, tokenKey?, signIn? }`; absent `draw`, pages go out undrawn.
|
|
918
932
|
- `signIn(who)` enables `/dev/as/<who>`: it stores the returned token (and
|
|
919
933
|
its cookie copy) and goes to `/`. `null` is nobody of that name.
|
|
920
934
|
- `watch?: RegExp` (default: `src/app`, `src/server`, `src/db`, `src/ui` and
|
package/README.md
CHANGED
|
@@ -85,6 +85,12 @@ Who may keep the page follows from who asked: drawn for nobody it is the same
|
|
|
85
85
|
for everybody; drawn for somebody it is `private, no-store`. A page that cannot
|
|
86
86
|
be drawn goes out undrawn.
|
|
87
87
|
|
|
88
|
+
The page's `<head>` is its screen's own: a `nova:head` node in a layout — a
|
|
89
|
+
title, a description, a preview picture, bound to the action's data — is read
|
|
90
|
+
off the snapshot and written into the template, and the terminal keeps the
|
|
91
|
+
tab's title on it as the screen moves. With `site`, every path says its own
|
|
92
|
+
canonical address.
|
|
93
|
+
|
|
88
94
|
`pages` are the other thing a path can lead to: a shell manifest drawn for
|
|
89
95
|
whoever asks and then let go — a welcome, the docs. A page with nothing left to
|
|
90
96
|
happen opens no socket, and `exportDocuments` writes pages as files. See
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { renderDocument, createServer } from './chunk-
|
|
1
|
+
import { renderDocument, createServer } from './chunk-D6E4SV6F.js';
|
|
2
2
|
import { readFile } from 'fs/promises';
|
|
3
3
|
import { relative, extname, join } from 'path';
|
|
4
4
|
import { serve as serve$1 } from '@hono/node-server';
|
|
@@ -60,5 +60,5 @@ var serve = async (app, runtime) => {
|
|
|
60
60
|
};
|
|
61
61
|
|
|
62
62
|
export { MOSS_PATHS, attachSocket, mountSite, serve };
|
|
63
|
-
//# sourceMappingURL=chunk-
|
|
64
|
-
//# sourceMappingURL=chunk-
|
|
63
|
+
//# sourceMappingURL=chunk-CDNJ2CBA.js.map
|
|
64
|
+
//# sourceMappingURL=chunk-CDNJ2CBA.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/node.ts"],"names":["listen"],"mappings":"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","file":"chunk-
|
|
1
|
+
{"version":3,"sources":["../src/node.ts"],"names":["listen"],"mappings":"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","file":"chunk-CDNJ2CBA.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { extname, join, relative } from 'node:path';\nimport { serve as listen } from '@hono/node-server';\nimport { serveStatic } from '@hono/node-server/serve-static';\nimport { WebSocketServer } from 'ws';\nimport type { IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\nimport { createServer } from './server';\nimport type { MossServer } from './server';\nimport type { NiscApp } from './app';\nimport type { NiscRuntime } from './runtime';\nimport type { SocketAccept } from './socket';\nimport { renderDocument } from './document';\nimport type { DocumentConfig } from './document';\n\n// ═══════════════════════════════════════════════════════════════\n// The Node entry — runtime-specific by design: the transport is a seam, so\n// the Bun flip swaps this file, never the app. Two exports: the\n// websocket transport for hosts that run their own listener (the dev\n// checks, vite), and the batteries-included `serve`.\n// ═══════════════════════════════════════════════════════════════\n\n// Anything that emits Node upgrade events — http.Server structurally, so\n// the @hono/node-server return type needs no narrowing.\ntype Upgradeable = {\n on: (event: 'upgrade', handler: (req: IncomingMessage, socket: Duplex, head: Buffer) => void) => unknown;\n};\n\n// The `ws` half of the transport seam: RFC 6455 stays library-handled\n// (permessage-deflate on by default — see `runtime.socketCompression`); the\n// protocol above the seam is nisc's own (../socket.ts) and identical on every\n// runtime.\nexport const attachSocket = (\n httpServer: Upgradeable,\n accept: SocketAccept,\n path = '/socket',\n options?: { compression?: boolean | Record<string, unknown> },\n): void => {\n const wss = new WebSocketServer({ noServer: true, perMessageDeflate: options?.compression ?? true });\n httpServer.on('upgrade', (req, socket, head) => {\n const url = req.url ?? '/';\n // Not ours: leave it for whichever other listener owns it (vite's HMR\n // upgrade rides the same server in dev).\n if (new URL(url, 'http://nisc.local').pathname !== path) return;\n wss.handleUpgrade(req, socket, head, (ws) => {\n // accept promises to handle its own failures (see socket.ts). This is\n // the floor under that promise: an await added there without a guard\n // degrades to one logged close here instead of an unhandled rejection\n // taking every session on the box down with it.\n accept(url, {\n send: (text) => ws.send(text),\n close: (code, reason) => ws.close(code, reason),\n onMessage: (fn) => ws.on('message', (data) => fn(String(data))),\n onClose: (fn) => ws.on('close', () => fn()),\n }).catch((error: unknown) => {\n console.error('[moss/node] a connection escaped accept:', error);\n try {\n ws.close(1011, 'accept failed');\n } catch {\n // already gone\n }\n });\n });\n });\n};\n\n// THE BUILT TERMINAL, served by the same process as the app — one origin, so the\n// socket is `/socket` wherever the page came from.\n//\n// `dist` is what the app's bundler wrote: index.html and its assets. Every GET\n// that nothing registered earlier answers is a file from it, or a PAGE:\n// index.html with the caller's screen drawn into it (./document) — the app's own\n// for `/`, one of the manifest's pages for a path that leads to one. index.html\n// itself is never served as a file: it is the template, and goes out drawn.\n//\n// A name with an extension that is neither a file in `dist` nor a page of the\n// manifest is a MISSING FILE, and is answered 404 — not with a screen. A browser\n// holding a page from before a deploy asks for that page's script by its old\n// name; what it needs back is \"gone\", not a document that is not a script.\n//\n// Register the app's own routes FIRST; this is the catch-all. `owned` names the\n// prefixes that are never a page (default: moss's own surfaces) — an unknown\n// path under one is a 404, not a screen.\nexport type SiteConfig = Pick<DocumentConfig, 'draw' | 'htmlAttributes' | 'site' | 'tokenKey' | 'waitMs'> & {\n dist: string;\n owned?: RegExp;\n};\n\n// The paths the app server answers itself; everything else is the site's.\nexport const MOSS_PATHS = /^\\/(api|catalog|socket|operator|integrations)(\\/|$)/;\n\nexport const mountSite = (server: MossServer, config: SiteConfig): void => {\n const { dist, owned = MOSS_PATHS, ...drawing } = config;\n // serveStatic resolves `root` against the working directory.\n const root = relative(process.cwd(), dist) || '.';\n const files = serveStatic({ root });\n server.use('/*', async (c, next) => {\n const path = c.req.path;\n if (owned.test(path) || path === '/' || path === '/index.html' || server.page(path) !== undefined) return next();\n return files(c, next);\n });\n server.get('*', async (c) => {\n if (owned.test(c.req.path)) return c.notFound();\n // the static server above found no such file, and no page is at this path\n if (extname(c.req.path) !== '' && c.req.path !== '/index.html' && server.page(c.req.path) === undefined) return c.notFound();\n const template = await readFile(join(dist, 'index.html'), 'utf8');\n const page = await renderDocument({\n ...drawing,\n server,\n template,\n request: { path: c.req.path === '/index.html' ? '/' : c.req.path, cookie: c.req.header('cookie') ?? null },\n });\n return c.html(page.html, 200, page.headers);\n });\n};\n\nexport const serve = async (app: NiscApp, runtime: NiscRuntime & { port?: number }): Promise<MossServer> => {\n const server = await createServer(app, runtime);\n const port = runtime.port ?? 8787;\n const httpServer = listen({ fetch: server.fetch, port });\n attachSocket(httpServer, server.socket, '/socket', { ...(runtime.socketCompression !== undefined ? { compression: runtime.socketCompression } : {}) });\n console.log(`moss serving http://localhost:${port}`);\n console.log(`surfaces: GET /catalog · GET|POST /api/vex · GET|POST /api/<resource>/vex · ws://localhost:${port}/socket`);\n return server;\n};\n"]}
|
|
@@ -15,6 +15,7 @@ import { Hono } from 'hono';
|
|
|
15
15
|
import { vex, VEX_LIVE_ENV } from '@niscorp/vex/hono';
|
|
16
16
|
import { NOVA_SEQUENCE } from '@niscorp/nova/migrations';
|
|
17
17
|
import { prismTransform, PRISM_SEQUENCE } from '@niscorp/prism/migrations';
|
|
18
|
+
import { headOf, placeHead } from '@niscorp/nova/document';
|
|
18
19
|
|
|
19
20
|
// src/runtime.ts
|
|
20
21
|
var mintDevToken = (sub, claims = {}) => btoa(JSON.stringify({ sub, ...claims, iat: Date.now() })).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
@@ -3224,8 +3225,6 @@ ${nextVariantErrors.map((e) => ` ${e}`).join("\n")}`);
|
|
|
3224
3225
|
...identities !== void 0 ? { identities: { list: identities.list, meter: identities.meter } } : {}
|
|
3225
3226
|
});
|
|
3226
3227
|
};
|
|
3227
|
-
|
|
3228
|
-
// src/document.ts
|
|
3229
3228
|
var SNAPSHOT_ELEMENT_ID = "nisc-snapshot";
|
|
3230
3229
|
var DEFAULT_TOKEN_KEY = "nisc.token";
|
|
3231
3230
|
var DEFAULT_ROOT = '<div id="root"></div>';
|
|
@@ -3269,9 +3268,12 @@ var renderDocument = async (config) => {
|
|
|
3269
3268
|
});
|
|
3270
3269
|
const screen = await draw(snapshot);
|
|
3271
3270
|
const attributes = Object.entries(config.htmlAttributes?.(snapshot) ?? {}).map(([name, value]) => ` ${name}="${escapeAttribute(value)}"`).join("");
|
|
3272
|
-
const
|
|
3271
|
+
const placed = template.replace(root, () => `${root.replace("></div>", () => `>${screen}</div>`)}${embedSnapshot(snapshot, principal, request.path)}`).replace(/<html([^>]*)>/, (whole, existing) => attributes === "" ? whole : `<html${existing}${attributes}>`);
|
|
3272
|
+
const head = headOf({ frame: () => snapshot.frame, canvasTree: (id) => snapshot.trees[id] ?? [] });
|
|
3273
|
+
const html = placeHead(placed, head?.head, { ...config.site !== void 0 ? { site: config.site } : {}, path: request.path });
|
|
3273
3274
|
return {
|
|
3274
3275
|
html,
|
|
3276
|
+
...head !== void 0 ? { head } : {},
|
|
3275
3277
|
headers: {
|
|
3276
3278
|
...documentHeaders(principal),
|
|
3277
3279
|
...token !== null && principal === null ? { "set-cookie": `${encodeURIComponent(tokenKey)}=; Path=/; Max-Age=0; SameSite=Lax` } : {}
|
|
@@ -3298,6 +3300,7 @@ var exportDocuments = async (config) => {
|
|
|
3298
3300
|
path,
|
|
3299
3301
|
html: page.html,
|
|
3300
3302
|
...page.page !== void 0 ? { page: page.page } : {},
|
|
3303
|
+
...page.head !== void 0 ? { head: page.head } : {},
|
|
3301
3304
|
drawn: page.drawn,
|
|
3302
3305
|
// undrawn is not concluded finished
|
|
3303
3306
|
live: page.live ?? true,
|
|
@@ -3310,5 +3313,5 @@ var exportDocuments = async (config) => {
|
|
|
3310
3313
|
};
|
|
3311
3314
|
|
|
3312
3315
|
export { DEFAULT_GENERATION_POLL_MS, DEFAULT_IDENTITY_IDLE_MS, DEFAULT_IDENTITY_MAX, DEFAULT_IDLE_MS, GENERATION_DDL, MOSS_SEQUENCE, SESSIONS_SEQUENCE, SNAPSHOT_ELEMENT_ID, TIDE_DDL, TIDE_SEQUENCE, TIDE_TABLES, auditClosure, buildContract, callIntegrationWith, contractAsMarkdown, copyPress, createAssertionSigner, createDataLayer, createGeneration, createIdentityCache, createPageRouter, createServer, createShellHost, createTideStore, describePlacements, devSession, documentHeaders, embedSnapshot, exportDocuments, filterInstalled, hashIntegrationKey, initIntegrations, initSessions, integrationByKey, integrationOfAction, listAttachments, listIntegrations, listPlacements, loadIntegrationActions, memoKeyOf, mintDevToken, mintIntegrationKey, mintSession, mintWrites, renderDocument, resolveCatalog, resolveCatalogForRoles, resolvePolicy, resolvePolicyAtReach, resolvePolicyForRoles, resolveRoles, resolveVariants, resolveVariantsForRoles, revokeAllFor, revokeSession, runIntake, sessionOf, sessionVerifierOf, shellNeedOf, tokenFromCookie, verifyAssertion, verifyVariants, wearableOf, wireFabric };
|
|
3313
|
-
//# sourceMappingURL=chunk-
|
|
3314
|
-
//# sourceMappingURL=chunk-
|
|
3316
|
+
//# sourceMappingURL=chunk-D6E4SV6F.js.map
|
|
3317
|
+
//# sourceMappingURL=chunk-D6E4SV6F.js.map
|