@cadence-app/compiler 0.4.0 → 0.6.0
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/dist/build.js +28 -16
- package/dist/cli.js +128 -12
- package/dist/dev-channel-client.d.ts +61 -0
- package/dist/dev-channel-client.js +168 -0
- package/dist/dev-channel-session.d.ts +46 -0
- package/dist/dev-channel-session.js +113 -0
- package/dist/dev-deep-link.d.ts +22 -0
- package/dist/dev-deep-link.js +45 -0
- package/dist/dev-scaffold.d.ts +12 -0
- package/dist/dev-scaffold.js +16 -0
- package/dist/dev-server.d.ts +17 -0
- package/dist/dev-server.js +113 -7
- package/dist/host/browser-mock-host.js +3 -0
- package/dist/host/dev-client.js +3 -1
- package/dist/host/engine-entry.js +84 -13
- package/dist/index.d.ts +5 -1
- package/dist/index.js +3 -1
- package/dist/local-addresses.d.ts +10 -0
- package/dist/local-addresses.js +23 -0
- package/dist/pairing-token.d.ts +40 -0
- package/dist/pairing-token.js +76 -0
- package/dist/qr/galois.d.ts +9 -0
- package/dist/qr/galois.js +48 -0
- package/dist/qr/matrix.d.ts +9 -0
- package/dist/qr/matrix.js +316 -0
- package/dist/qr/qr-code.d.ts +19 -0
- package/dist/qr/qr-code.js +131 -0
- package/dist/qr/qr-error.d.ts +4 -0
- package/dist/qr/qr-error.js +7 -0
- package/dist/qr/terminal-render.d.ts +8 -0
- package/dist/qr/terminal-render.js +59 -0
- package/package.json +5 -5
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Le lien que porte le QR : l'adresse du serveur, telle que le conteneur la
|
|
3
|
+
* composera ensuite.
|
|
4
|
+
*
|
|
5
|
+
* L'adresse n'est pas encodée. `:` et `/` sont permis dans une query, et un
|
|
6
|
+
* `%3A` de plus par caractère ferait grossir le QR pour rien — une adresse de
|
|
7
|
+
* serveur de développement ne porte ni `&` ni `=`.
|
|
8
|
+
*
|
|
9
|
+
* La barre oblique avant la query n'est pas décorative : un lien au chemin vide
|
|
10
|
+
* se lit différemment d'un cadre d'hôte à l'autre, et plusieurs n'en tirent
|
|
11
|
+
* alors aucune route.
|
|
12
|
+
*/
|
|
13
|
+
export declare function pairingDeepLink(baseUrl: string): string;
|
|
14
|
+
/**
|
|
15
|
+
* Le lien que porte le QR d'un canal de développement : l'adresse que
|
|
16
|
+
* l'appareil interrogera (ADR-038).
|
|
17
|
+
*
|
|
18
|
+
* Même forme et mêmes raisons que celle d'un serveur local, au paramètre près.
|
|
19
|
+
* Le code court reste la voie sans appareil photo ; ce lien est celle qui
|
|
20
|
+
* épargne de le recopier.
|
|
21
|
+
*/
|
|
22
|
+
export declare function channelDeepLink(pollUrl: string): string;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Le schéma que les hôtes de démonstration enregistrent pour recevoir une
|
|
3
|
+
* adresse de serveur de développement.
|
|
4
|
+
*
|
|
5
|
+
* Un seul schéma pour les deux hôtes : installer les deux sur le même
|
|
6
|
+
* téléphone fait demander lequel ouvrir, ce qui est la bonne réponse. Une
|
|
7
|
+
* super-app réelle choisit le sien.
|
|
8
|
+
*/
|
|
9
|
+
const PAIRING_SCHEME = 'cadence-dev';
|
|
10
|
+
const PAIRING_ACTION = 'pair';
|
|
11
|
+
const PAIRING_URL_PARAMETER = 'url';
|
|
12
|
+
/**
|
|
13
|
+
* Un canal se nomme par un paramètre à lui, et non par la même adresse.
|
|
14
|
+
*
|
|
15
|
+
* Les deux portent une adresse `http(s)`, donc rien dans sa forme ne les
|
|
16
|
+
* distingue. Laisser l'hôte deviner le ferait ouvrir sa WebView sur ce qu'on
|
|
17
|
+
* lui montre, ce qu'ADR-036 refuse déjà pour la saisie. Le lien le dit.
|
|
18
|
+
*/
|
|
19
|
+
const PAIRING_CHANNEL_PARAMETER = 'channel';
|
|
20
|
+
/**
|
|
21
|
+
* Le lien que porte le QR : l'adresse du serveur, telle que le conteneur la
|
|
22
|
+
* composera ensuite.
|
|
23
|
+
*
|
|
24
|
+
* L'adresse n'est pas encodée. `:` et `/` sont permis dans une query, et un
|
|
25
|
+
* `%3A` de plus par caractère ferait grossir le QR pour rien — une adresse de
|
|
26
|
+
* serveur de développement ne porte ni `&` ni `=`.
|
|
27
|
+
*
|
|
28
|
+
* La barre oblique avant la query n'est pas décorative : un lien au chemin vide
|
|
29
|
+
* se lit différemment d'un cadre d'hôte à l'autre, et plusieurs n'en tirent
|
|
30
|
+
* alors aucune route.
|
|
31
|
+
*/
|
|
32
|
+
export function pairingDeepLink(baseUrl) {
|
|
33
|
+
return `${PAIRING_SCHEME}://${PAIRING_ACTION}/?${PAIRING_URL_PARAMETER}=${baseUrl}`;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Le lien que porte le QR d'un canal de développement : l'adresse que
|
|
37
|
+
* l'appareil interrogera (ADR-038).
|
|
38
|
+
*
|
|
39
|
+
* Même forme et mêmes raisons que celle d'un serveur local, au paramètre près.
|
|
40
|
+
* Le code court reste la voie sans appareil photo ; ce lien est celle qui
|
|
41
|
+
* épargne de le recopier.
|
|
42
|
+
*/
|
|
43
|
+
export function channelDeepLink(pollUrl) {
|
|
44
|
+
return `${PAIRING_SCHEME}://${PAIRING_ACTION}/?${PAIRING_CHANNEL_PARAMETER}=${pollUrl}`;
|
|
45
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Le document que le conteneur demande, et le seul que l'archive embarque. */
|
|
2
|
+
export declare const ENTRY_DOCUMENT = "index.html";
|
|
3
|
+
/** Le document que `mini dev` sert au navigateur, avec son mock natif. */
|
|
4
|
+
export declare const DEV_SHELL_FILE = "dev.html";
|
|
5
|
+
export declare const DEV_HOST_ENTRY = "dev-host";
|
|
6
|
+
export declare const DEV_CLIENT_ENTRY = "dev-client";
|
|
7
|
+
/**
|
|
8
|
+
* L'échafaudage que `mini dev` sert dans le navigateur. Il reste dans `outDir`,
|
|
9
|
+
* mais l'archive part sur le serveur de distribution et jusque sur les
|
|
10
|
+
* appareils : elle n'embarque que ce que le conteneur exécute.
|
|
11
|
+
*/
|
|
12
|
+
export declare const DEV_SCAFFOLD_FILES: ReadonlySet<string>;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Le document que le conteneur demande, et le seul que l'archive embarque. */
|
|
2
|
+
export const ENTRY_DOCUMENT = 'index.html';
|
|
3
|
+
/** Le document que `mini dev` sert au navigateur, avec son mock natif. */
|
|
4
|
+
export const DEV_SHELL_FILE = 'dev.html';
|
|
5
|
+
export const DEV_HOST_ENTRY = 'dev-host';
|
|
6
|
+
export const DEV_CLIENT_ENTRY = 'dev-client';
|
|
7
|
+
/**
|
|
8
|
+
* L'échafaudage que `mini dev` sert dans le navigateur. Il reste dans `outDir`,
|
|
9
|
+
* mais l'archive part sur le serveur de distribution et jusque sur les
|
|
10
|
+
* appareils : elle n'embarque que ce que le conteneur exécute.
|
|
11
|
+
*/
|
|
12
|
+
export const DEV_SCAFFOLD_FILES = new Set([
|
|
13
|
+
DEV_SHELL_FILE,
|
|
14
|
+
`${DEV_HOST_ENTRY}.js`,
|
|
15
|
+
`${DEV_CLIENT_ENTRY}.js`,
|
|
16
|
+
]);
|
package/dist/dev-server.d.ts
CHANGED
|
@@ -6,8 +6,25 @@ export interface DevServerOptions {
|
|
|
6
6
|
}
|
|
7
7
|
export interface DevServer {
|
|
8
8
|
readonly url: string;
|
|
9
|
+
/**
|
|
10
|
+
* Les mêmes pages, atteintes depuis le réseau local : `listen` sans hôte
|
|
11
|
+
* écoute déjà toutes les interfaces, un appareil du même Wi-Fi y répond donc
|
|
12
|
+
* sans rien de plus. Vide sur une machine sans interface externe.
|
|
13
|
+
*
|
|
14
|
+
* Elles portent le jeton, parce qu'elles en ont besoin pour répondre.
|
|
15
|
+
*/
|
|
16
|
+
readonly networkUrls: readonly string[];
|
|
17
|
+
/** Le jeton que ce serveur exige de tout appareil qui n'est pas la machine. */
|
|
18
|
+
readonly pairingToken: string;
|
|
9
19
|
close(): void;
|
|
10
20
|
}
|
|
21
|
+
/**
|
|
22
|
+
* Le type MIME d'un fichier servi, `application/octet-stream` à défaut.
|
|
23
|
+
*
|
|
24
|
+
* Exporté parce que le canal de développement doit étiqueter les mêmes
|
|
25
|
+
* fichiers (ADR-038) : deux tables divergeraient.
|
|
26
|
+
*/
|
|
27
|
+
export declare function contentTypeFor(filePath: string): string;
|
|
11
28
|
/**
|
|
12
29
|
* Serveur `mini dev` : sert le bundle compilé, surveille les sources du
|
|
13
30
|
* mini-programme et pousse un événement SSE de rechargement après chaque
|
package/dist/dev-server.js
CHANGED
|
@@ -1,7 +1,17 @@
|
|
|
1
1
|
import { existsSync, watch } from 'node:fs';
|
|
2
2
|
import { readFile } from 'node:fs/promises';
|
|
3
3
|
import http from 'node:http';
|
|
4
|
+
import os from 'node:os';
|
|
4
5
|
import path from 'node:path';
|
|
6
|
+
import { DEV_CLIENT_ENTRY, DEV_SHELL_FILE, ENTRY_DOCUMENT } from "./dev-scaffold.js";
|
|
7
|
+
import { dialableAddresses } from "./local-addresses.js";
|
|
8
|
+
import { mintPairingToken, pairingPathPrefix, pairingRefusal, splitPairingToken, } from "./pairing-token.js";
|
|
9
|
+
class DevServerError extends Error {
|
|
10
|
+
constructor(message) {
|
|
11
|
+
super(message);
|
|
12
|
+
this.name = 'DevServerError';
|
|
13
|
+
}
|
|
14
|
+
}
|
|
5
15
|
const CONTENT_TYPES = {
|
|
6
16
|
'.html': 'text/html; charset=utf-8',
|
|
7
17
|
'.js': 'text/javascript; charset=utf-8',
|
|
@@ -17,7 +27,52 @@ const CONTENT_TYPES = {
|
|
|
17
27
|
'.woff': 'font/woff',
|
|
18
28
|
'.zip': 'application/zip',
|
|
19
29
|
};
|
|
30
|
+
/**
|
|
31
|
+
* Le type MIME d'un fichier servi, `application/octet-stream` à défaut.
|
|
32
|
+
*
|
|
33
|
+
* Exporté parce que le canal de développement doit étiqueter les mêmes
|
|
34
|
+
* fichiers (ADR-038) : deux tables divergeraient.
|
|
35
|
+
*/
|
|
36
|
+
export function contentTypeFor(filePath) {
|
|
37
|
+
return CONTENT_TYPES[path.extname(filePath)] ?? 'application/octet-stream';
|
|
38
|
+
}
|
|
20
39
|
const REBUILD_DEBOUNCE_MS = 150;
|
|
40
|
+
const RELOAD_ENDPOINT = '/__cadence_dev';
|
|
41
|
+
/**
|
|
42
|
+
* Combien de fois le mini-programme a été recompilé depuis le démarrage.
|
|
43
|
+
*
|
|
44
|
+
* Un conteneur qui sert ses octets lui-même n'a pas de page où brancher le
|
|
45
|
+
* canal poussé : la WebView ne parle qu'à lui, et il ne sait pas tenir un flux
|
|
46
|
+
* ouvert à travers son interception de requêtes. Il demande donc ce compteur, et
|
|
47
|
+
* recharge quand il change (ADR-035).
|
|
48
|
+
*/
|
|
49
|
+
const BUILD_COUNT_ENDPOINT = `${RELOAD_ENDPOINT}/builds`;
|
|
50
|
+
/**
|
|
51
|
+
* Ce que la page raconte sur l'appareil, rapporté ici.
|
|
52
|
+
*
|
|
53
|
+
* Un GET, et non un envoi : le seul HTTP dont un conteneur dispose est celui
|
|
54
|
+
* que le SDK lui injecte, et ce point d'injection rapporte des octets. Lui
|
|
55
|
+
* adjoindre un verbe demanderait un client par plateforme, pour une ligne de
|
|
56
|
+
* journal sur une machine locale (ADR-037).
|
|
57
|
+
*/
|
|
58
|
+
const CONSOLE_ENDPOINT = `${RELOAD_ENDPOINT}/console`;
|
|
59
|
+
const CONSOLE_PARAMETER = 'line';
|
|
60
|
+
const DEVICE_PREFIX = '[appareil]';
|
|
61
|
+
const LONGEST_CONSOLE_LINE = 2000;
|
|
62
|
+
const BODY_END = '</body>';
|
|
63
|
+
const LIVE_RELOAD_TAG = `<script src="./${DEV_CLIENT_ENTRY}.js"></script>`;
|
|
64
|
+
/**
|
|
65
|
+
* Le conteneur demande le document de production, celui que l'archive embarque
|
|
66
|
+
* et qui ne porte aucun échafaudage. Le rechargement lui vient donc du serveur,
|
|
67
|
+
* à la seconde où il sert la page, et non du bundle : ce qui tourne sur
|
|
68
|
+
* l'appareil reste octet pour octet ce qui sera publié.
|
|
69
|
+
*/
|
|
70
|
+
function withLiveReloadClient(document) {
|
|
71
|
+
if (!document.includes(BODY_END)) {
|
|
72
|
+
throw new DevServerError(`${ENTRY_DOCUMENT} ne contient pas ${BODY_END} : impossible d'y brancher le rechargement`);
|
|
73
|
+
}
|
|
74
|
+
return document.replace(BODY_END, ` ${LIVE_RELOAD_TAG}\n ${BODY_END}`);
|
|
75
|
+
}
|
|
21
76
|
/**
|
|
22
77
|
* Serveur `mini dev` : sert le bundle compilé, surveille les sources du
|
|
23
78
|
* mini-programme et pousse un événement SSE de rechargement après chaque
|
|
@@ -25,12 +80,55 @@ const REBUILD_DEBOUNCE_MS = 150;
|
|
|
25
80
|
*/
|
|
26
81
|
export function startDevServer(options) {
|
|
27
82
|
const sseClients = new Set();
|
|
83
|
+
const pairingToken = mintPairingToken();
|
|
84
|
+
let completedBuilds = 0;
|
|
85
|
+
const servedRoot = options.distDir.endsWith(path.sep)
|
|
86
|
+
? options.distDir
|
|
87
|
+
: `${options.distDir}${path.sep}`;
|
|
28
88
|
const server = http.createServer((request, response) => {
|
|
29
|
-
|
|
89
|
+
handleRequest(request, response).catch((error) => {
|
|
90
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
91
|
+
console.error('[cadence dev]', message);
|
|
92
|
+
if (!response.headersSent) {
|
|
93
|
+
response.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
|
|
94
|
+
}
|
|
95
|
+
response.end(`500 — ${message}`);
|
|
96
|
+
});
|
|
30
97
|
});
|
|
31
98
|
async function handleRequest(request, response) {
|
|
32
|
-
const
|
|
33
|
-
|
|
99
|
+
const [requestPath = '/', query = ''] = (request.url ?? '/').split('?');
|
|
100
|
+
const requested = splitPairingToken(requestPath);
|
|
101
|
+
const refusal = pairingRefusal({
|
|
102
|
+
expected: pairingToken,
|
|
103
|
+
presented: requested.token,
|
|
104
|
+
peer: request.socket.remoteAddress,
|
|
105
|
+
});
|
|
106
|
+
if (refusal !== null) {
|
|
107
|
+
response.writeHead(403, { 'Content-Type': 'text/plain; charset=utf-8' });
|
|
108
|
+
response.end(`403 — ${refusal}`);
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
111
|
+
if (requested.path === CONSOLE_ENDPOINT) {
|
|
112
|
+
const line = new URLSearchParams(query).get(CONSOLE_PARAMETER) ?? '';
|
|
113
|
+
console.warn(`${DEVICE_PREFIX} ${line.slice(0, LONGEST_CONSOLE_LINE)}`);
|
|
114
|
+
/* 200 et non 204 : le conteneur lit par le téléchargeur du SDK, qui
|
|
115
|
+
refuse tout ce qui n'est pas un corps complet. */
|
|
116
|
+
response.writeHead(200, {
|
|
117
|
+
'Content-Type': 'text/plain; charset=utf-8',
|
|
118
|
+
'Cache-Control': 'no-store',
|
|
119
|
+
});
|
|
120
|
+
response.end('ok');
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
123
|
+
if (requested.path === BUILD_COUNT_ENDPOINT) {
|
|
124
|
+
response.writeHead(200, {
|
|
125
|
+
'Content-Type': 'text/plain; charset=utf-8',
|
|
126
|
+
'Cache-Control': 'no-store',
|
|
127
|
+
});
|
|
128
|
+
response.end(String(completedBuilds));
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
if (requested.path === RELOAD_ENDPOINT) {
|
|
34
132
|
response.writeHead(200, {
|
|
35
133
|
'Content-Type': 'text/event-stream',
|
|
36
134
|
'Cache-Control': 'no-cache',
|
|
@@ -41,16 +139,21 @@ export function startDevServer(options) {
|
|
|
41
139
|
request.on('close', () => sseClients.delete(response));
|
|
42
140
|
return;
|
|
43
141
|
}
|
|
44
|
-
const relativePath =
|
|
142
|
+
const relativePath = requested.path === '/' ? DEV_SHELL_FILE : requested.path.slice(1);
|
|
45
143
|
const filePath = path.join(options.distDir, relativePath);
|
|
46
|
-
if (!filePath.startsWith(
|
|
144
|
+
if (!filePath.startsWith(servedRoot) || !existsSync(filePath)) {
|
|
47
145
|
response.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
|
|
48
146
|
response.end(`404 — ${relativePath}`);
|
|
49
147
|
return;
|
|
50
148
|
}
|
|
51
|
-
|
|
149
|
+
/* Le corps est prêt avant l'en-tête : un document d'entrée où brancher le
|
|
150
|
+
rechargement échoue répond 500, et non 200 suivi d'un silence. */
|
|
151
|
+
const body = relativePath === ENTRY_DOCUMENT
|
|
152
|
+
? withLiveReloadClient(await readFile(filePath, 'utf8'))
|
|
153
|
+
: await readFile(filePath);
|
|
154
|
+
const contentType = contentTypeFor(filePath);
|
|
52
155
|
response.writeHead(200, { 'Content-Type': contentType, 'Cache-Control': 'no-store' });
|
|
53
|
-
response.end(
|
|
156
|
+
response.end(body);
|
|
54
157
|
}
|
|
55
158
|
let rebuildTimer = null;
|
|
56
159
|
const watcher = watch(options.watchDir, { recursive: true }, (_event, fileName) => {
|
|
@@ -64,6 +167,7 @@ export function startDevServer(options) {
|
|
|
64
167
|
options
|
|
65
168
|
.rebuild()
|
|
66
169
|
.then(() => {
|
|
170
|
+
completedBuilds += 1;
|
|
67
171
|
console.warn(`[cadence dev] rebuild ok (${fileName ?? 'watch'})`);
|
|
68
172
|
for (const client of sseClients) {
|
|
69
173
|
client.write('event: reload\ndata: {}\n\n');
|
|
@@ -75,6 +179,8 @@ export function startDevServer(options) {
|
|
|
75
179
|
server.listen(options.port);
|
|
76
180
|
return {
|
|
77
181
|
url: `http://localhost:${options.port}/`,
|
|
182
|
+
networkUrls: dialableAddresses(os.networkInterfaces()).map((host) => `http://${host}:${options.port}${pairingPathPrefix(pairingToken)}`),
|
|
183
|
+
pairingToken,
|
|
78
184
|
close() {
|
|
79
185
|
watcher.close();
|
|
80
186
|
for (const client of sseClients) {
|
|
@@ -144,6 +144,9 @@ host.handle(BridgeMethods.appReportError, (payload) => {
|
|
|
144
144
|
console.error(`[cadence miniapp] ${source} — ${message}`, stack ?? '');
|
|
145
145
|
return null;
|
|
146
146
|
});
|
|
147
|
+
/* Un navigateur n'a pas d'écran d'ouverture à lever. L'appel est tout de même
|
|
148
|
+
accepté : un refus ferait écrire au moteur une erreur qui n'en est pas une. */
|
|
149
|
+
host.handle(BridgeMethods.appPageRendered, () => null);
|
|
147
150
|
host.handle(BridgeMethods.navSetChrome, (payload) => {
|
|
148
151
|
document.title = payload.title;
|
|
149
152
|
return null;
|
package/dist/host/dev-client.js
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
|
|
2
|
+
/* Relative, et non absolue : l'adresse d'un appareil apparié porte un
|
|
3
|
+
préfixe de jeton, que le calcul du navigateur reconduit tout seul. */
|
|
4
|
+
const events = new EventSource('./__cadence_dev');
|
|
3
5
|
events.addEventListener('reload', () => location.reload());
|
|
4
6
|
events.addEventListener('error', () => {
|
|
5
7
|
/* le serveur dev est parti ; EventSource retentera tout seul */
|
|
@@ -5,7 +5,7 @@ import * as router from '@cadence-app/router';
|
|
|
5
5
|
import { JavaScriptChannelTransport, containerBridgeObject, NativeBridge, TransportUnavailableError, createNativeApi, setActiveNativeApi, } from '@cadence-app/bridge';
|
|
6
6
|
import { APP_ICON_STYLE_ID, BASE_STYLESHEET, BASE_STYLE_ID, BUILTIN_COMPONENTS, BUILTIN_COMPONENT_STYLESHEET, BUILTIN_COMPONENT_STYLE_ID, BUILTIN_ICONS, ComponentRegistry, ICON_BASE_STYLESHEET, ICON_STYLE_ID, appendStyle, iconRulesFor, applyTextScale, applyViewportGeometry, injectStyleOnce, installErrorBoundary, instructions, textScaleOf, toEngineError, } from '@cadence-app/runtime';
|
|
7
7
|
import { BridgeEvents } from '@cadence-app/bridge';
|
|
8
|
-
import { PageRegistry, ROUTER_STYLESHEET, ROUTER_STYLE_ID, Router, resolvePageChrome, setActiveRouter, } from '@cadence-app/router';
|
|
8
|
+
import { PageRegistry, ROUTER_COMPONENTS, ROUTER_COMPONENT_STYLESHEET, ROUTER_COMPONENT_STYLE_ID, ROUTER_STYLESHEET, ROUTER_STYLE_ID, Router, resolvePageChrome, setActiveRouter, } from '@cadence-app/router';
|
|
9
9
|
import { COLOR_SCHEME_ATTRIBUTE, PLATFORM_ATTRIBUTE, THEME_STYLE_ID } from '@cadence-app/theme';
|
|
10
10
|
import { allManifestPages } from "../manifest.js";
|
|
11
11
|
const ENGINE_VERSION = '0.1.0';
|
|
@@ -27,7 +27,7 @@ const errorBoundary = installErrorBoundary({
|
|
|
27
27
|
});
|
|
28
28
|
const componentRegistry = new ComponentRegistry();
|
|
29
29
|
const pageRegistry = new PageRegistry();
|
|
30
|
-
for (const definition of BUILTIN_COMPONENTS) {
|
|
30
|
+
for (const definition of [...BUILTIN_COMPONENTS, ...ROUTER_COMPONENTS]) {
|
|
31
31
|
componentRegistry.register(definition);
|
|
32
32
|
}
|
|
33
33
|
function registerPage(route, definition) {
|
|
@@ -79,10 +79,10 @@ function loadSubPackageChunk(chunkRoot) {
|
|
|
79
79
|
* La WebView occupe tout l'écran, barre de statut comprise : sans ces valeurs
|
|
80
80
|
* le mini-programme dessinerait son en-tête sous l'heure et la batterie.
|
|
81
81
|
*/
|
|
82
|
-
async function applyInitialEnvironment(nativeApi) {
|
|
82
|
+
async function applyInitialEnvironment(nativeApi, tone) {
|
|
83
83
|
const info = await nativeApi.system.getSystemInfo();
|
|
84
84
|
applyViewportGeometry(document, { safeAreaInsets: info.safeAreaInsets, capsule: info.capsule });
|
|
85
|
-
applyColorScheme(
|
|
85
|
+
applyColorScheme(tone, info.colorScheme);
|
|
86
86
|
applyTextScale(document, textScaleOf(info));
|
|
87
87
|
/* La plateforme ne change pas en cours de route : elle se pose une fois, et
|
|
88
88
|
un nom que le preset ignore ne matche simplement aucun bloc. */
|
|
@@ -91,14 +91,48 @@ async function applyInitialEnvironment(nativeApi) {
|
|
|
91
91
|
/**
|
|
92
92
|
* Le schéma va sur la racine, comme le style de navigation (ADR-006) : les
|
|
93
93
|
* feuilles réagissent, rien n'est reconstruit. Les icônes de la barre de statut
|
|
94
|
-
* suivent par défaut — un en-tête sombre demande des icônes claires
|
|
95
|
-
*
|
|
94
|
+
* suivent par défaut — un en-tête sombre demande des icônes claires.
|
|
95
|
+
*
|
|
96
|
+
* **Ce défaut cède dès qu'une page a choisi.** Il était inconditionnel, et
|
|
97
|
+
* effaçait à la bascule suivante la teinte qu'un mini-programme avait posée —
|
|
98
|
+
* y compris par la recette que ce commentaire recommandait. Un en-tête de
|
|
99
|
+
* marque garde donc la sienne (ADR-040).
|
|
96
100
|
*/
|
|
97
|
-
function applyColorScheme(
|
|
101
|
+
function applyColorScheme(tone, colorScheme) {
|
|
98
102
|
document.documentElement.setAttribute(COLOR_SCHEME_ATTRIBUTE, colorScheme);
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
103
|
+
tone.applyFor(colorScheme);
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Le défaut de teinte, et la façade qui lui dit de se taire.
|
|
107
|
+
*
|
|
108
|
+
* Le moteur et la page passent par la même méthode du pont : sans ce détour, le
|
|
109
|
+
* moteur ne pourrait pas distinguer son propre défaut d'un choix explicite, et
|
|
110
|
+
* il continuerait à l'écraser à chaque bascule de thème. Le prototype de `ui`
|
|
111
|
+
* est conservé — seule cette méthode est reposée dessus.
|
|
112
|
+
*
|
|
113
|
+
* L'état vit dans cet amorçage, pas dans le module : un moteur par chargement
|
|
114
|
+
* de page, et deux amorçages ne se transmettent rien.
|
|
115
|
+
*/
|
|
116
|
+
function statusBarIconsDefault(nativeApi) {
|
|
117
|
+
let pageChose = false;
|
|
118
|
+
const ui = Object.create(nativeApi.ui);
|
|
119
|
+
ui.setStatusBarIcons = (icons) => {
|
|
120
|
+
pageChose = true;
|
|
121
|
+
return nativeApi.ui.setStatusBarIcons(icons);
|
|
122
|
+
};
|
|
123
|
+
return {
|
|
124
|
+
api: { ...nativeApi, ui },
|
|
125
|
+
applyFor: (colorScheme) => {
|
|
126
|
+
if (pageChose) {
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
void nativeApi.ui
|
|
130
|
+
.setStatusBarIcons(colorScheme === 'dark' ? 'light' : 'dark')
|
|
131
|
+
.catch((error) => {
|
|
132
|
+
console.error('[cadence/engine] status bar icons refused', error);
|
|
133
|
+
});
|
|
134
|
+
},
|
|
135
|
+
};
|
|
102
136
|
}
|
|
103
137
|
/**
|
|
104
138
|
* Le conteneur répond sous le dernier chrome qu'on lui a annoncé : sans cette
|
|
@@ -110,6 +144,40 @@ function announceEntryChrome(nativeApi, manifest) {
|
|
|
110
144
|
console.error('[cadence] the container did not take the entry chrome', error);
|
|
111
145
|
});
|
|
112
146
|
}
|
|
147
|
+
/**
|
|
148
|
+
* Dit au conteneur que la page d'entrée est peinte, et une seule fois.
|
|
149
|
+
*
|
|
150
|
+
* C'est le signal qui lève un écran d'ouverture. `nav.setChrome` part **avant**
|
|
151
|
+
* le rendu — un conteneur qui s'en sert découvre une WebView encore vide.
|
|
152
|
+
*/
|
|
153
|
+
function announcePageRendered(nativeApi) {
|
|
154
|
+
afterTheNextPaint(() => {
|
|
155
|
+
/* Un conteneur qui ne connaît pas la méthode rejette l'appel, et c'est son
|
|
156
|
+
droit : le moteur n'a rien à faire de la réponse. */
|
|
157
|
+
void nativeApi.app.pageRendered().catch(() => undefined);
|
|
158
|
+
});
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Appelle `onPainted` une fois la frame suivante passée à l'écran.
|
|
162
|
+
*
|
|
163
|
+
* Le rappel de `requestAnimationFrame` s'exécute **avant** la peinture de sa
|
|
164
|
+
* frame ; la tâche qu'il programme s'exécute après. C'est la seule façon
|
|
165
|
+
* d'attendre le pixel sans le mesurer.
|
|
166
|
+
*
|
|
167
|
+
* Un document déjà caché n'ordonnance aucune frame, et le repli part alors sur
|
|
168
|
+
* une tâche : le conteneur garderait sinon son écran d'ouverture pour toujours.
|
|
169
|
+
* Rien ne clignote pour autant — une vue qu'on ne regarde pas peint sa page
|
|
170
|
+
* avant qu'on la regarde.
|
|
171
|
+
*/
|
|
172
|
+
function afterTheNextPaint(onPainted) {
|
|
173
|
+
if (typeof requestAnimationFrame !== 'function' || document.hidden) {
|
|
174
|
+
setTimeout(onPainted, 0);
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
requestAnimationFrame(() => {
|
|
178
|
+
setTimeout(onPainted, 0);
|
|
179
|
+
});
|
|
180
|
+
}
|
|
113
181
|
function resolveAppRoot() {
|
|
114
182
|
const existing = document.getElementById('app');
|
|
115
183
|
if (existing !== null) {
|
|
@@ -133,7 +201,8 @@ async function startEngine(manifest, app) {
|
|
|
133
201
|
const transport = selectTransport();
|
|
134
202
|
const nativeBridge = new NativeBridge(transport);
|
|
135
203
|
const nativeApi = createNativeApi(nativeBridge);
|
|
136
|
-
|
|
204
|
+
const tone = statusBarIconsDefault(nativeApi);
|
|
205
|
+
setActiveNativeApi(tone.api);
|
|
137
206
|
reportToContainer = (error) => {
|
|
138
207
|
// Un rejet ici relancerait le gestionnaire de rejets non interceptés.
|
|
139
208
|
void nativeApi.app.reportError(error).catch(() => undefined);
|
|
@@ -142,6 +211,7 @@ async function startEngine(manifest, app) {
|
|
|
142
211
|
injectStyleOnce(document, ICON_STYLE_ID, ICON_BASE_STYLESHEET + iconRulesFor(BUILTIN_ICONS));
|
|
143
212
|
injectStyleOnce(document, BUILTIN_COMPONENT_STYLE_ID, BUILTIN_COMPONENT_STYLESHEET);
|
|
144
213
|
injectStyleOnce(document, ROUTER_STYLE_ID, ROUTER_STYLESHEET);
|
|
214
|
+
injectStyleOnce(document, ROUTER_COMPONENT_STYLE_ID, ROUTER_COMPONENT_STYLESHEET);
|
|
145
215
|
const routerManifest = {
|
|
146
216
|
entry: manifest.entry,
|
|
147
217
|
pages: allManifestPages(manifest),
|
|
@@ -152,9 +222,9 @@ async function startEngine(manifest, app) {
|
|
|
152
222
|
: { navigationStyle: manifest.navigationStyle }),
|
|
153
223
|
};
|
|
154
224
|
announceEntryChrome(nativeApi, routerManifest);
|
|
155
|
-
await applyInitialEnvironment(nativeApi);
|
|
225
|
+
await applyInitialEnvironment(nativeApi, tone);
|
|
156
226
|
nativeBridge.on(BridgeEvents.colorSchemeChanged, (payload) => {
|
|
157
|
-
applyColorScheme(
|
|
227
|
+
applyColorScheme(tone, payload.colorScheme);
|
|
158
228
|
});
|
|
159
229
|
nativeBridge.on(BridgeEvents.textScaleChanged, (payload) => {
|
|
160
230
|
applyTextScale(document, textScaleOf(payload));
|
|
@@ -185,6 +255,7 @@ async function startEngine(manifest, app) {
|
|
|
185
255
|
setActiveRouter(appRouter);
|
|
186
256
|
await appRouter.launch();
|
|
187
257
|
metrics.timeToInteractiveMs = performance.now();
|
|
258
|
+
announcePageRendered(nativeApi);
|
|
188
259
|
}
|
|
189
260
|
const cadenceGlobal = {
|
|
190
261
|
version: ENGINE_VERSION,
|
package/dist/index.d.ts
CHANGED
|
@@ -17,8 +17,12 @@ export { projectToolingFiles } from './project-tooling.js';
|
|
|
17
17
|
export type { InitOptions, InitReport } from './init-project.js';
|
|
18
18
|
export { PROJECT_TEMPLATES, PROJECT_TEMPLATE_NAMES, isProjectTemplateName, } from './project-templates.js';
|
|
19
19
|
export type { ProjectTemplate, ProjectTemplateName } from './project-templates.js';
|
|
20
|
-
export { startDevServer } from './dev-server.js';
|
|
20
|
+
export { startDevServer, contentTypeFor } from './dev-server.js';
|
|
21
21
|
export type { DevServer, DevServerOptions } from './dev-server.js';
|
|
22
|
+
export { DevChannelClient, DevChannelRejectedError } from './dev-channel-client.js';
|
|
23
|
+
export type { DevChannelClientOptions, OpenedDevChannel, PushedBundle, } from './dev-channel-client.js';
|
|
24
|
+
export { openDevChannel } from './dev-channel-session.js';
|
|
25
|
+
export type { DevChannelPush, DevChannelSession, OpenDevChannelOptions, } from './dev-channel-session.js';
|
|
22
26
|
export { credentialsPath, readCredentials, writeCredentials, clearCredentials, normalizeRemoteUrl, } from './publish/credentials.js';
|
|
23
27
|
export type { Credentials } from './publish/credentials.js';
|
|
24
28
|
export { DistributionClient } from './publish/distribution-client.js';
|
package/dist/index.js
CHANGED
|
@@ -10,7 +10,9 @@ export { buildMiniApp, BuildError } from "./build.js";
|
|
|
10
10
|
export { initProject, InitError } from "./init-project.js";
|
|
11
11
|
export { projectToolingFiles } from "./project-tooling.js";
|
|
12
12
|
export { PROJECT_TEMPLATES, PROJECT_TEMPLATE_NAMES, isProjectTemplateName, } from "./project-templates.js";
|
|
13
|
-
export { startDevServer } from "./dev-server.js";
|
|
13
|
+
export { startDevServer, contentTypeFor } from "./dev-server.js";
|
|
14
|
+
export { DevChannelClient, DevChannelRejectedError } from "./dev-channel-client.js";
|
|
15
|
+
export { openDevChannel } from "./dev-channel-session.js";
|
|
14
16
|
export { credentialsPath, readCredentials, writeCredentials, clearCredentials, normalizeRemoteUrl, } from "./publish/credentials.js";
|
|
15
17
|
export { DistributionClient } from "./publish/distribution-client.js";
|
|
16
18
|
export { publishMiniApp } from "./publish/publish-bundle.js";
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { NetworkInterfaceInfo } from 'node:os';
|
|
2
|
+
/**
|
|
3
|
+
* Les adresses IPv4 de cette machine qu'un autre appareil peut composer.
|
|
4
|
+
*
|
|
5
|
+
* Deux refus. Une interface interne ne sort pas de la machine. Et une adresse
|
|
6
|
+
* dont les bits d'hôte sont tous nuls désigne le réseau, pas une machine :
|
|
7
|
+
* macOS en expose une par pont de partage, et elles noieraient la seule
|
|
8
|
+
* adresse utile.
|
|
9
|
+
*/
|
|
10
|
+
export declare function dialableAddresses(interfaces: Readonly<Record<string, NetworkInterfaceInfo[] | undefined>>): readonly string[];
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Les adresses IPv4 de cette machine qu'un autre appareil peut composer.
|
|
3
|
+
*
|
|
4
|
+
* Deux refus. Une interface interne ne sort pas de la machine. Et une adresse
|
|
5
|
+
* dont les bits d'hôte sont tous nuls désigne le réseau, pas une machine :
|
|
6
|
+
* macOS en expose une par pont de partage, et elles noieraient la seule
|
|
7
|
+
* adresse utile.
|
|
8
|
+
*/
|
|
9
|
+
export function dialableAddresses(interfaces) {
|
|
10
|
+
return Object.values(interfaces)
|
|
11
|
+
.flatMap((addresses) => addresses ?? [])
|
|
12
|
+
.filter((address) => address.family === 'IPv4' && !address.internal)
|
|
13
|
+
.filter((address) => !isNetworkAddress(address.address, address.netmask))
|
|
14
|
+
.map((address) => address.address);
|
|
15
|
+
}
|
|
16
|
+
function isNetworkAddress(address, netmask) {
|
|
17
|
+
const host = toUnsignedInteger(address);
|
|
18
|
+
const network = (host & toUnsignedInteger(netmask)) >>> 0;
|
|
19
|
+
return network === host;
|
|
20
|
+
}
|
|
21
|
+
function toUnsignedInteger(dotted) {
|
|
22
|
+
return dotted.split('.').reduce((value, byte) => value * 256 + Number(byte), 0);
|
|
23
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/** Ce qu'un chemin demandait, une fois son jeton mis de côté. */
|
|
2
|
+
export interface PairedRequest {
|
|
3
|
+
/** Le jeton que le chemin portait, ou `null` s'il n'en portait pas. */
|
|
4
|
+
readonly token: string | null;
|
|
5
|
+
/** Le chemin sans son préfixe, celui que le serveur résout. */
|
|
6
|
+
readonly path: string;
|
|
7
|
+
}
|
|
8
|
+
/** Une requête à juger : le jeton attendu, celui présenté, et d'où elle vient. */
|
|
9
|
+
export interface PairingCheck {
|
|
10
|
+
readonly expected: string;
|
|
11
|
+
readonly presented: string | null;
|
|
12
|
+
readonly peer: string | undefined;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Un jeton d'appariement, neuf à chaque `mini dev`.
|
|
16
|
+
*
|
|
17
|
+
* Il ne protège rien d'autre que des sources en cours d'écriture, et il meurt
|
|
18
|
+
* avec le serveur : le tirage vaut pour un réseau partagé, pas pour un secret
|
|
19
|
+
* qu'on garde.
|
|
20
|
+
*/
|
|
21
|
+
export declare function mintPairingToken(): string;
|
|
22
|
+
/** Le préfixe de chemin qui porte ce jeton, barre oblique finale comprise. */
|
|
23
|
+
export declare function pairingPathPrefix(token: string): string;
|
|
24
|
+
/**
|
|
25
|
+
* Sépare le jeton du chemin qu'il préfixe.
|
|
26
|
+
*
|
|
27
|
+
* Le jeton vit dans le chemin, et non dans un en-tête ni une query : le
|
|
28
|
+
* conteneur compose l'adresse d'un sous-fichier en ajoutant son nom à celle du
|
|
29
|
+
* document, et un préfixe suit ce calcul sans que personne n'ait à le savoir.
|
|
30
|
+
*/
|
|
31
|
+
export declare function splitPairingToken(requestPath: string): PairedRequest;
|
|
32
|
+
/**
|
|
33
|
+
* Pourquoi cette requête est refusée, `null` quand elle passe.
|
|
34
|
+
*
|
|
35
|
+
* La machine elle-même n'a rien à présenter : le navigateur et l'USB gardent
|
|
36
|
+
* l'adresse courte qu'annonce la documentation. Le jeton n'est exigé que de ce
|
|
37
|
+
* que la boucle locale n'explique pas — un appareil du Wi-Fi, donc aussi la
|
|
38
|
+
* machine du voisin.
|
|
39
|
+
*/
|
|
40
|
+
export declare function pairingRefusal(check: PairingCheck): string | null;
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { randomBytes } from 'node:crypto';
|
|
2
|
+
/** Le segment qui annonce un jeton dans un chemin : `/t/<jeton>/index.html`. */
|
|
3
|
+
const TOKEN_SEGMENT = 't';
|
|
4
|
+
const TOKEN_LENGTH = 12;
|
|
5
|
+
/*
|
|
6
|
+
* Trente-deux caractères, sans les jumeaux qu'on recopie de travers (0 et O,
|
|
7
|
+
* 1 et l) : le jeton se tape à la main quand lire un QR n'est pas une option.
|
|
8
|
+
* Trente-deux divise 256, donc tirer un octet modulo l'alphabet ne favorise
|
|
9
|
+
* aucun caractère.
|
|
10
|
+
*/
|
|
11
|
+
const TOKEN_ALPHABET = '0123456789abcdefghjkmnpqrstvwxyz';
|
|
12
|
+
const IPV4_IN_IPV6_PREFIX = '::ffff:';
|
|
13
|
+
/**
|
|
14
|
+
* Un jeton d'appariement, neuf à chaque `mini dev`.
|
|
15
|
+
*
|
|
16
|
+
* Il ne protège rien d'autre que des sources en cours d'écriture, et il meurt
|
|
17
|
+
* avec le serveur : le tirage vaut pour un réseau partagé, pas pour un secret
|
|
18
|
+
* qu'on garde.
|
|
19
|
+
*/
|
|
20
|
+
export function mintPairingToken() {
|
|
21
|
+
return Array.from(randomBytes(TOKEN_LENGTH), (byte) => TOKEN_ALPHABET.charAt(byte % TOKEN_ALPHABET.length)).join('');
|
|
22
|
+
}
|
|
23
|
+
/** Le préfixe de chemin qui porte ce jeton, barre oblique finale comprise. */
|
|
24
|
+
export function pairingPathPrefix(token) {
|
|
25
|
+
return `/${TOKEN_SEGMENT}/${token}/`;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Sépare le jeton du chemin qu'il préfixe.
|
|
29
|
+
*
|
|
30
|
+
* Le jeton vit dans le chemin, et non dans un en-tête ni une query : le
|
|
31
|
+
* conteneur compose l'adresse d'un sous-fichier en ajoutant son nom à celle du
|
|
32
|
+
* document, et un préfixe suit ce calcul sans que personne n'ait à le savoir.
|
|
33
|
+
*/
|
|
34
|
+
export function splitPairingToken(requestPath) {
|
|
35
|
+
const segments = requestPath.split('/');
|
|
36
|
+
const token = segments[2];
|
|
37
|
+
if (segments[1] !== TOKEN_SEGMENT || token === undefined || token === '') {
|
|
38
|
+
return { token: null, path: requestPath };
|
|
39
|
+
}
|
|
40
|
+
return { token, path: `/${segments.slice(3).join('/')}` };
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Pourquoi cette requête est refusée, `null` quand elle passe.
|
|
44
|
+
*
|
|
45
|
+
* La machine elle-même n'a rien à présenter : le navigateur et l'USB gardent
|
|
46
|
+
* l'adresse courte qu'annonce la documentation. Le jeton n'est exigé que de ce
|
|
47
|
+
* que la boucle locale n'explique pas — un appareil du Wi-Fi, donc aussi la
|
|
48
|
+
* machine du voisin.
|
|
49
|
+
*/
|
|
50
|
+
export function pairingRefusal(check) {
|
|
51
|
+
if (check.presented === check.expected) {
|
|
52
|
+
return null;
|
|
53
|
+
}
|
|
54
|
+
if (check.presented !== null) {
|
|
55
|
+
return "jeton d'appariement inconnu — relire celui qu'affiche « mini dev »";
|
|
56
|
+
}
|
|
57
|
+
if (isLoopbackPeer(check.peer)) {
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
return "un appareil du réseau doit porter le jeton d'appariement de « mini dev »";
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Vrai quand la requête vient de cette machine.
|
|
64
|
+
*
|
|
65
|
+
* L'USB en fait partie : `adb reverse` fait composer 127.0.0.1 au téléphone, et
|
|
66
|
+
* c'est le tunnel qui livre.
|
|
67
|
+
*/
|
|
68
|
+
function isLoopbackPeer(address) {
|
|
69
|
+
if (address === undefined) {
|
|
70
|
+
return false;
|
|
71
|
+
}
|
|
72
|
+
const bare = address.startsWith(IPV4_IN_IPV6_PREFIX)
|
|
73
|
+
? address.slice(IPV4_IN_IPV6_PREFIX.length)
|
|
74
|
+
: address;
|
|
75
|
+
return bare === '::1' || bare.startsWith('127.');
|
|
76
|
+
}
|