@niscorp/cli 0.8.2 → 0.9.1
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 +29 -0
- package/README.md +96 -10
- package/dist/cli.js +17 -3
- package/dist/cli.js.map +1 -1
- package/dist/shape.cjs +201 -0
- package/dist/shape.cjs.map +1 -0
- package/dist/shape.d.cts +22 -0
- package/dist/shape.d.ts +22 -0
- package/dist/shape.js +199 -0
- package/dist/shape.js.map +1 -0
- package/package.json +14 -4
package/dist/shape.cjs
ADDED
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var fs = require('fs');
|
|
4
|
+
var path = require('path');
|
|
5
|
+
var module$1 = require('module');
|
|
6
|
+
|
|
7
|
+
// src/shape/index.ts
|
|
8
|
+
var SOURCE = /\.(ts|tsx|mts|cts)$/;
|
|
9
|
+
var pathOf = (root, file) => path.relative(root, file).split(path.sep).join("/");
|
|
10
|
+
var sourceFilesOf = (root, dir = path.join(root, "src")) => {
|
|
11
|
+
let entries;
|
|
12
|
+
try {
|
|
13
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
14
|
+
} catch {
|
|
15
|
+
return [];
|
|
16
|
+
}
|
|
17
|
+
return entries.flatMap((entry) => {
|
|
18
|
+
if (entry.name === "node_modules") return [];
|
|
19
|
+
const path$1 = path.join(dir, entry.name);
|
|
20
|
+
if (entry.isDirectory()) return sourceFilesOf(root, path$1);
|
|
21
|
+
return SOURCE.test(entry.name) && !entry.name.endsWith(".d.ts") ? [path$1] : [];
|
|
22
|
+
});
|
|
23
|
+
};
|
|
24
|
+
var READ_FILE = /* @__PURE__ */ new Set(["readAsDataURL", "readAsText", "readAsArrayBuffer", "readAsBinaryString"]);
|
|
25
|
+
var FIND_ELEMENTS = /* @__PURE__ */ new Set(["querySelector", "querySelectorAll", "getElementById", "getElementsByClassName", "getElementsByTagName", "getElementsByName"]);
|
|
26
|
+
var ADDRESS_CHANGE = /* @__PURE__ */ new Set(["pushState", "replaceState"]);
|
|
27
|
+
var lastName = (ts, node) => {
|
|
28
|
+
if (ts.isIdentifier(node)) return node.text;
|
|
29
|
+
if (ts.isPropertyAccessExpression(node)) return node.name.text;
|
|
30
|
+
return void 0;
|
|
31
|
+
};
|
|
32
|
+
var hasModifier = (ts, node, kind) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);
|
|
33
|
+
var findingsIn = (ts, file, source) => {
|
|
34
|
+
const found = [];
|
|
35
|
+
const inSrc = (folder) => file.startsWith(`src/${folder}/`);
|
|
36
|
+
const at = (rule, node, what) => {
|
|
37
|
+
found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, what });
|
|
38
|
+
};
|
|
39
|
+
const visit = (node) => {
|
|
40
|
+
if (ts.isAsExpression(node) && !(ts.isTypeReferenceNode(node.type) && ts.isIdentifier(node.type.typeName) && node.type.typeName.text === "const")) at("style", node, `"as ${node.type.getText(source)}"`);
|
|
41
|
+
if (ts.isTypeAssertionExpression(node)) at("style", node, 'a "<T>" assertion');
|
|
42
|
+
if (ts.isNonNullExpression(node)) at("style", node, 'a non-null "!"');
|
|
43
|
+
if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at("style", node, "a function declaration");
|
|
44
|
+
if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at("style", node, "a class");
|
|
45
|
+
if (ts.isEnumDeclaration(node)) at("style", node, "an enum");
|
|
46
|
+
if (node.kind === ts.SyntaxKind.AnyKeyword) at("style", node, '"any"');
|
|
47
|
+
if (ts.isExportAssignment(node) && node.isExportEquals !== true || ts.isExportSpecifier(node) && node.name.text === "default" || hasModifier(ts, node, ts.SyntaxKind.DefaultKeyword)) at("style", node, "a default export");
|
|
48
|
+
if (!inSrc("dev")) {
|
|
49
|
+
if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "Intl") at("formatting", node, `Intl.${node.name.text}`);
|
|
50
|
+
if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith("toLocale")) at("formatting", node, `.${node.expression.name.text}()`);
|
|
51
|
+
}
|
|
52
|
+
if (inSrc("server") && ts.isPropertyAccessExpression(node) && node.name.text === "roles") {
|
|
53
|
+
const whose = lastName(ts, node.expression);
|
|
54
|
+
if (whose === "session" || whose === "principal") at("roles", node, `${whose}.roles`);
|
|
55
|
+
}
|
|
56
|
+
if (inSrc("ui")) {
|
|
57
|
+
if (ts.isIdentifier(node) && node.text === "FileReader" && !ts.isTypeReferenceNode(node.parent)) at("files", node, "FileReader");
|
|
58
|
+
if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at("files", node, node.name.text);
|
|
59
|
+
if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "location") at("address", node, `location.${node.name.text}`);
|
|
60
|
+
if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "history" && ADDRESS_CHANGE.has(node.name.text)) at("address", node, `history.${node.name.text}`);
|
|
61
|
+
if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === "document") {
|
|
62
|
+
at("dom", node, `document.${node.expression.name.text}`);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
ts.forEachChild(node, visit);
|
|
66
|
+
};
|
|
67
|
+
visit(source);
|
|
68
|
+
return found;
|
|
69
|
+
};
|
|
70
|
+
var sourceFindings = (ts, root) => sourceFilesOf(root).flatMap((path) => {
|
|
71
|
+
const file = pathOf(root, path);
|
|
72
|
+
const source = ts.createSourceFile(file, fs.readFileSync(path, "utf8"), ts.ScriptTarget.Latest, true, path.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
|
|
73
|
+
return findingsIn(ts, file, source);
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
// src/shape/app-data.ts
|
|
77
|
+
var MANIFEST = /^(Promise<)?NiscApp>?$/;
|
|
78
|
+
var programOf = (ts, root) => {
|
|
79
|
+
const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json");
|
|
80
|
+
if (config === void 0 || !path.resolve(config).startsWith(path.resolve(root))) throw new Error(`the shape check reads the app as its tsconfig.json says, and ${root} has none.`);
|
|
81
|
+
const parsed = ts.getParsedCommandLineOfConfigFile(config, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => void 0 });
|
|
82
|
+
if (parsed === void 0) throw new Error(`${config} could not be read.`);
|
|
83
|
+
return ts.createProgram({ rootNames: parsed.fileNames, options: parsed.options });
|
|
84
|
+
};
|
|
85
|
+
var importedNames = (ts, clause) => {
|
|
86
|
+
if (clause === void 0 || clause.isTypeOnly) return [];
|
|
87
|
+
const bindings = clause.namedBindings;
|
|
88
|
+
const named = bindings !== void 0 && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];
|
|
89
|
+
return [...clause.name === void 0 ? [] : [clause.name], ...named];
|
|
90
|
+
};
|
|
91
|
+
var appDataFindings = (ts, root) => {
|
|
92
|
+
const program = programOf(ts, root);
|
|
93
|
+
const checker = program.getTypeChecker();
|
|
94
|
+
const options = program.getCompilerOptions();
|
|
95
|
+
return program.getSourceFiles().flatMap((source) => {
|
|
96
|
+
const file = pathOf(root, path.resolve(source.fileName));
|
|
97
|
+
if (!file.startsWith("src/") || file.startsWith("src/app/") || file.startsWith("src/dev/") || source.isDeclarationFile) return [];
|
|
98
|
+
return source.statements.flatMap((statement) => {
|
|
99
|
+
if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) return [];
|
|
100
|
+
const target = ts.resolveModuleName(statement.moduleSpecifier.text, source.fileName, options, ts.sys).resolvedModule?.resolvedFileName;
|
|
101
|
+
if (target === void 0) return [];
|
|
102
|
+
const from = pathOf(root, path.resolve(target));
|
|
103
|
+
if (!from.startsWith("src/app/")) return [];
|
|
104
|
+
return importedNames(ts, statement.importClause).flatMap((name) => {
|
|
105
|
+
const calls = checker.getTypeAtLocation(name).getCallSignatures();
|
|
106
|
+
if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];
|
|
107
|
+
const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;
|
|
108
|
+
return [{ rule: "data", file, line, what: `${name.text}, a function of ${from}` }];
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
});
|
|
112
|
+
};
|
|
113
|
+
var isTypeScript = (value) => value !== null && typeof value === "object" && typeof Reflect.get(value, "createProgram") === "function" && typeof Reflect.get(value, "version") === "string";
|
|
114
|
+
var loadTypeScript = (root) => {
|
|
115
|
+
const require2 = module$1.createRequire(path.join(root, "package.json"));
|
|
116
|
+
let library;
|
|
117
|
+
try {
|
|
118
|
+
library = require2("typescript");
|
|
119
|
+
} catch {
|
|
120
|
+
throw new Error(`the shape check reads the source with TypeScript, and this app has none installed (looked from ${root}). pnpm add -D typescript`);
|
|
121
|
+
}
|
|
122
|
+
if (!isTypeScript(library)) throw new Error('the "typescript" this app has installed is not the TypeScript compiler.');
|
|
123
|
+
if (!library.version.startsWith("6.")) throw new Error(`the shape check is written against TypeScript 6, and this app has ${library.version}.`);
|
|
124
|
+
return library;
|
|
125
|
+
};
|
|
126
|
+
|
|
127
|
+
// src/shape/index.ts
|
|
128
|
+
var RULES = [
|
|
129
|
+
["style", 'rule 16: no assertion but "as const", no non-null "!", no function declaration, class, enum, "any" or default export in src/'],
|
|
130
|
+
["formatting", "rule 9: no Intl and no toLocale\u2026 outside Prism (src/, but src/dev/)"],
|
|
131
|
+
["roles", "rule 11: no server code reads the caller\u2019s roles (src/server/)"],
|
|
132
|
+
["files", "rule 9a: the kit reads no file into data (src/ui/)"],
|
|
133
|
+
["address", "rule 4: the kit neither reads nor changes the address (src/ui/)"],
|
|
134
|
+
["dom", "rule 2: no component finds elements in the document (src/ui/)"],
|
|
135
|
+
["data", "src/app is data: no code outside it calls a function of it, but the manifest\u2019s factory"]
|
|
136
|
+
];
|
|
137
|
+
var isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
|
|
138
|
+
var endpointsOf = (actions) => actions.flatMap((action) => Object.values(action.endpoints ?? {}).flatMap((endpoint) => isRecord(endpoint) ? [{ action: action.id, endpoint }] : []));
|
|
139
|
+
var replayOf = (endpoint) => {
|
|
140
|
+
const request = endpoint["request"];
|
|
141
|
+
if (!isRecord(request) || !("fingerprint" in request)) return void 0;
|
|
142
|
+
const fingerprint = request["fingerprint"];
|
|
143
|
+
return typeof fingerprint === "string" ? { fingerprint } : {};
|
|
144
|
+
};
|
|
145
|
+
var runShapeCheck = (config) => {
|
|
146
|
+
const log = config.log ?? ((line) => console.log(line));
|
|
147
|
+
let failures = 0;
|
|
148
|
+
const check = (what, passed, detail = []) => {
|
|
149
|
+
log(`${passed ? "[pass]" : "[fail]"} ${what}${passed || detail.length === 0 ? "" : ` \u2014 ${detail.join("; ")}`}`);
|
|
150
|
+
if (!passed) failures += 1;
|
|
151
|
+
};
|
|
152
|
+
const done = () => {
|
|
153
|
+
log(failures === 0 ? "[pass] shape: all checks passed" : `[fail] shape: ${failures} check(s) failed`);
|
|
154
|
+
return failures === 0 ? 0 : 1;
|
|
155
|
+
};
|
|
156
|
+
let findings;
|
|
157
|
+
try {
|
|
158
|
+
const ts = loadTypeScript(config.root);
|
|
159
|
+
findings = [...sourceFindings(ts, config.root), ...appDataFindings(ts, config.root)];
|
|
160
|
+
} catch (error) {
|
|
161
|
+
check("the source is read", false, [error instanceof Error ? error.message : String(error)]);
|
|
162
|
+
return done();
|
|
163
|
+
}
|
|
164
|
+
const allow = config.allow ?? {};
|
|
165
|
+
for (const [rule, what] of RULES) {
|
|
166
|
+
const allowed = allow[rule] ?? {};
|
|
167
|
+
const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === void 0);
|
|
168
|
+
check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));
|
|
169
|
+
}
|
|
170
|
+
const idle = RULES.flatMap(
|
|
171
|
+
([rule]) => Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {
|
|
172
|
+
if (reason.trim() === "") return [`${rule}: ${file} gives no reason`];
|
|
173
|
+
if (!fs.existsSync(path.join(config.root, file))) return [`${rule}: ${file} does not exist`];
|
|
174
|
+
return findings.some((finding) => finding.rule === rule && finding.file === file) ? [] : [`${rule}: ${file} has nothing to allow`];
|
|
175
|
+
})
|
|
176
|
+
);
|
|
177
|
+
check("every allowance names a file there is, why, and something it allows", idle.length === 0, idle);
|
|
178
|
+
const endpoints = endpointsOf(config.actions);
|
|
179
|
+
const ledger = config.functions ?? {};
|
|
180
|
+
const called = new Set(endpoints.flatMap(({ endpoint }) => typeof endpoint["fn"] === "string" ? [endpoint["fn"]] : []));
|
|
181
|
+
const unexplained = [...called].filter((id) => (ledger[id] ?? "").trim() === "").sort();
|
|
182
|
+
check("every server function an action calls is named in `functions`, with what it does that a vex read or write cannot", unexplained.length === 0, unexplained);
|
|
183
|
+
const uncalled = Object.keys(ledger).filter((id) => !called.has(id)).sort();
|
|
184
|
+
check("every function named in `functions` is called by an action", uncalled.length === 0, uncalled);
|
|
185
|
+
const replays = endpoints.flatMap(({ endpoint }) => {
|
|
186
|
+
const replay = replayOf(endpoint);
|
|
187
|
+
return replay === void 0 ? [] : [replay];
|
|
188
|
+
});
|
|
189
|
+
const named = new Set(replays.flatMap((replay) => replay.fingerprint === void 0 ? [] : [replay.fingerprint]));
|
|
190
|
+
const reads = (config.entries ?? []).filter((entry) => entry.dsl !== void 0);
|
|
191
|
+
const calls = endpoints.filter(({ endpoint }) => typeof endpoint["fn"] === "string").length;
|
|
192
|
+
log(`[info] actions call server functions ${calls} times and replay vex ${replays.length} times`);
|
|
193
|
+
log(`[info] ${reads.filter((entry) => entry.mapping !== void 0).length} of ${reads.length} reads word their rows with a Prism mapping`);
|
|
194
|
+
const unnamed = reads.filter((entry) => entry.refresh === "reactive" && !named.has(entry.fingerprint)).map((entry) => entry.fingerprint);
|
|
195
|
+
if (unnamed.length > 0) log(`[info] reactive reads no action replays by name: ${unnamed.join(", ")}`);
|
|
196
|
+
return done();
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
exports.runShapeCheck = runShapeCheck;
|
|
200
|
+
//# sourceMappingURL=shape.cjs.map
|
|
201
|
+
//# sourceMappingURL=shape.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/shape/source.ts","../src/shape/app-data.ts","../src/shape/typescript.ts","../src/shape/index.ts"],"names":["relative","sep","join","readdirSync","path","readFileSync","resolve","require","createRequire","existsSync"],"mappings":";;;;;;;AASA,IAAM,MAAA,GAAS,qBAAA;AAER,IAAM,MAAA,GAAS,CAAC,IAAA,EAAc,IAAA,KAAyBA,aAAA,CAAS,IAAA,EAAM,IAAI,CAAA,CAAE,KAAA,CAAMC,QAAG,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAE/F,IAAM,gBAAgB,CAAC,IAAA,EAAc,MAAMC,SAAA,CAAK,IAAA,EAAM,KAAK,CAAA,KAAgB;AAChF,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAUC,cAAA,CAAY,GAAA,EAAK,EAAE,aAAA,EAAe,MAAM,CAAA;AAAA,EACpD,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,KAAU;AAChC,IAAA,IAAI,KAAA,CAAM,IAAA,KAAS,cAAA,EAAgB,OAAO,EAAC;AAC3C,IAAA,MAAMC,MAAA,GAAOF,SAAA,CAAK,GAAA,EAAK,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,IAAI,MAAM,WAAA,EAAY,EAAG,OAAO,aAAA,CAAc,MAAME,MAAI,CAAA;AACxD,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,IAAI,KAAK,CAAC,KAAA,CAAM,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA,GAAI,CAACA,MAAI,IAAI,EAAC;AAAA,EAC9E,CAAC,CAAA;AACH,CAAA;AAEA,IAAM,SAAA,uBAAgB,GAAA,CAAI,CAAC,iBAAiB,YAAA,EAAc,mBAAA,EAAqB,oBAAoB,CAAC,CAAA;AACpG,IAAM,aAAA,mBAAgB,IAAI,GAAA,CAAI,CAAC,eAAA,EAAiB,oBAAoB,gBAAA,EAAkB,wBAAA,EAA0B,sBAAA,EAAwB,mBAAmB,CAAC,CAAA;AAC5J,IAAM,iCAAiB,IAAI,GAAA,CAAI,CAAC,WAAA,EAAa,cAAc,CAAC,CAAA;AAE5D,IAAM,QAAA,GAAW,CAAC,EAAA,EAAgB,IAAA,KAA4C;AAC5E,EAAA,IAAI,EAAA,CAAG,YAAA,CAAa,IAAI,CAAA,SAAU,IAAA,CAAK,IAAA;AACvC,EAAA,IAAI,GAAG,0BAAA,CAA2B,IAAI,CAAA,EAAG,OAAO,KAAK,IAAA,CAAK,IAAA;AAC1D,EAAA,OAAO,MAAA;AACT,CAAA;AAEA,IAAM,WAAA,GAAc,CAAC,EAAA,EAAgB,IAAA,EAAe,SAAiC,EAAA,CAAG,gBAAA,CAAiB,IAAI,CAAA,IAAA,CAAM,EAAA,CAAG,aAAa,IAAI,CAAA,IAAK,EAAC,EAAG,IAAA,CAAK,CAAC,QAAA,KAAa,QAAA,CAAS,SAAS,IAAI,CAAA;AAGzL,IAAM,UAAA,GAAa,CAAC,EAAA,EAAgB,IAAA,EAAc,MAAA,KAAqC;AACrF,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,QAAQ,CAAC,MAAA,KAA4B,KAAK,UAAA,CAAW,CAAA,IAAA,EAAO,MAAM,CAAA,CAAA,CAAG,CAAA;AAC3E,EAAA,MAAM,EAAA,GAAK,CAAC,IAAA,EAAkB,IAAA,EAAe,IAAA,KAAuB;AAClE,IAAA,KAAA,CAAM,IAAA,CAAK,EAAE,IAAA,EAAM,IAAA,EAAM,MAAM,MAAA,CAAO,6BAAA,CAA8B,IAAA,CAAK,QAAA,CAAS,MAAM,CAAC,CAAA,CAAE,IAAA,GAAO,CAAA,EAAG,MAAM,CAAA;AAAA,EAC7G,CAAA;AACA,EAAA,MAAM,KAAA,GAAQ,CAAC,IAAA,KAAwB;AACrC,IAAA,IAAI,EAAA,CAAG,cAAA,CAAe,IAAI,CAAA,IAAK,EAAE,EAAA,CAAG,mBAAA,CAAoB,IAAA,CAAK,IAAI,CAAA,IAAK,EAAA,CAAG,YAAA,CAAa,KAAK,IAAA,CAAK,QAAQ,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,IAAA,KAAS,OAAA,CAAA,EAAU,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,CAAA,IAAA,EAAO,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAC,CAAA,CAAA,CAAG,CAAA;AACxM,IAAA,IAAI,GAAG,yBAAA,CAA0B,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,mBAAmB,CAAA;AAC7E,IAAA,IAAI,GAAG,mBAAA,CAAoB,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,gBAAgB,CAAA;AACpE,IAAA,IAAI,EAAA,CAAG,qBAAA,CAAsB,IAAI,CAAA,IAAK,CAAC,WAAA,CAAY,EAAA,EAAI,IAAA,EAAM,EAAA,CAAG,WAAW,cAAc,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,MAAM,wBAAwB,CAAA;AACtI,IAAA,IAAI,EAAA,CAAG,kBAAA,CAAmB,IAAI,CAAA,IAAK,EAAA,CAAG,iBAAA,CAAkB,IAAI,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAC1F,IAAA,IAAI,GAAG,iBAAA,CAAkB,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,SAAS,CAAA;AAC3D,IAAA,IAAI,IAAA,CAAK,SAAS,EAAA,CAAG,UAAA,CAAW,YAAY,EAAA,CAAG,OAAA,EAAS,MAAM,OAAO,CAAA;AACrE,IAAA,IAAK,EAAA,CAAG,kBAAA,CAAmB,IAAI,CAAA,IAAK,IAAA,CAAK,mBAAmB,IAAA,IAAU,EAAA,CAAG,iBAAA,CAAkB,IAAI,CAAA,IAAK,IAAA,CAAK,KAAK,IAAA,KAAS,SAAA,IAAc,WAAA,CAAY,EAAA,EAAI,IAAA,EAAM,EAAA,CAAG,UAAA,CAAW,cAAc,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,kBAAkB,CAAA;AAE9N,IAAA,IAAI,CAAC,KAAA,CAAM,KAAK,CAAA,EAAG;AACjB,MAAA,IAAI,EAAA,CAAG,2BAA2B,IAAI,CAAA,IAAK,GAAG,YAAA,CAAa,IAAA,CAAK,UAAU,CAAA,IAAK,IAAA,CAAK,WAAW,IAAA,KAAS,MAAA,KAAW,YAAA,EAAc,IAAA,EAAM,QAAQ,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC/J,MAAA,IAAI,EAAA,CAAG,gBAAA,CAAiB,IAAI,CAAA,IAAK,EAAA,CAAG,2BAA2B,IAAA,CAAK,UAAU,CAAA,IAAK,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,KAAK,UAAA,CAAW,UAAU,CAAA,EAAG,EAAA,CAAG,YAAA,EAAc,IAAA,EAAM,IAAI,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,EAAA,CAAI,CAAA;AAAA,IAC/L;AACA,IAAA,IAAI,KAAA,CAAM,QAAQ,CAAA,IAAK,EAAA,CAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,IAAA,KAAS,OAAA,EAAS;AACxF,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,EAAI,IAAA,CAAK,UAAU,CAAA;AAC1C,MAAA,IAAI,KAAA,KAAU,aAAa,KAAA,KAAU,WAAA,KAAgB,OAAA,EAAS,IAAA,EAAM,CAAA,EAAG,KAAK,CAAA,MAAA,CAAQ,CAAA;AAAA,IACtF;AACA,IAAA,IAAI,KAAA,CAAM,IAAI,CAAA,EAAG;AACf,MAAA,IAAI,GAAG,YAAA,CAAa,IAAI,CAAA,IAAK,IAAA,CAAK,SAAS,YAAA,IAAgB,CAAC,EAAA,CAAG,mBAAA,CAAoB,KAAK,MAAM,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,MAAM,YAAY,CAAA;AAC/H,MAAA,IAAI,EAAA,CAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,UAAU,GAAA,CAAI,IAAA,CAAK,IAAA,CAAK,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,IAAA,CAAK,KAAK,IAAI,CAAA;AAC1G,MAAA,IAAI,GAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,QAAA,CAAS,IAAI,IAAA,CAAK,UAAU,CAAA,KAAM,UAAA,KAAe,SAAA,EAAW,IAAA,EAAM,YAAY,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AACzI,MAAA,IAAI,EAAA,CAAG,2BAA2B,IAAI,CAAA,IAAK,SAAS,EAAA,EAAI,IAAA,CAAK,UAAU,CAAA,KAAM,SAAA,IAAa,cAAA,CAAe,IAAI,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,EAAG,EAAA,CAAG,SAAA,EAAW,MAAM,CAAA,QAAA,EAAW,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC7K,MAAA,IAAI,EAAA,CAAG,iBAAiB,IAAI,CAAA,IAAK,GAAG,0BAAA,CAA2B,IAAA,CAAK,UAAU,CAAA,IAAK,aAAA,CAAc,GAAA,CAAI,KAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,IAAK,QAAA,CAAS,IAAI,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,KAAM,UAAA,EAAY;AAC1L,QAAA,EAAA,CAAG,OAAO,IAAA,EAAM,CAAA,SAAA,EAAY,KAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAAA,MACzD;AAAA,IACF;AACA,IAAA,EAAA,CAAG,YAAA,CAAa,MAAM,KAAK,CAAA;AAAA,EAC7B,CAAA;AACA,EAAA,KAAA,CAAM,MAAM,CAAA;AACZ,EAAA,OAAO,KAAA;AACT,CAAA;AAEO,IAAM,cAAA,GAAiB,CAAC,EAAA,EAAgB,IAAA,KAC7C,cAAc,IAAI,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,KAAS;AACpC,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,EAAM,IAAI,CAAA;AAC9B,EAAA,MAAM,MAAA,GAAS,GAAG,gBAAA,CAAiB,IAAA,EAAMC,gBAAa,IAAA,EAAM,MAAM,GAAG,EAAA,CAAG,YAAA,CAAa,QAAQ,IAAA,EAAM,IAAA,CAAK,SAAS,MAAM,CAAA,GAAI,GAAG,UAAA,CAAW,GAAA,GAAM,EAAA,CAAG,UAAA,CAAW,EAAE,CAAA;AAC/J,EAAA,OAAO,UAAA,CAAW,EAAA,EAAI,IAAA,EAAM,MAAM,CAAA;AACpC,CAAC,CAAA;;;AC9EH,IAAM,QAAA,GAAW,wBAAA;AAEjB,IAAM,SAAA,GAAY,CAAC,EAAA,EAAgB,IAAA,KAA6B;AAC9D,EAAA,MAAM,SAAS,EAAA,CAAG,cAAA,CAAe,MAAM,EAAA,CAAG,GAAA,CAAI,YAAY,eAAe,CAAA;AACzE,EAAA,IAAI,WAAW,MAAA,IAAa,CAACC,YAAA,CAAQ,MAAM,EAAE,UAAA,CAAWA,YAAA,CAAQ,IAAI,CAAC,GAAG,MAAM,IAAI,KAAA,CAAM,CAAA,6DAAA,EAAgE,IAAI,CAAA,UAAA,CAAY,CAAA;AACxK,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,gCAAA,CAAiC,MAAA,EAAQ,EAAC,EAAG,EAAE,GAAG,EAAA,CAAG,GAAA,EAAK,mCAAA,EAAqC,MAAM,QAAW,CAAA;AAClI,EAAA,IAAI,WAAW,MAAA,EAAW,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,mBAAA,CAAqB,CAAA;AACxE,EAAA,OAAO,EAAA,CAAG,cAAc,EAAE,SAAA,EAAW,OAAO,SAAA,EAAW,OAAA,EAAS,MAAA,CAAO,OAAA,EAAS,CAAA;AAClF,CAAA;AAEA,IAAM,aAAA,GAAgB,CAAC,EAAA,EAAgB,MAAA,KAAyD;AAC9F,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,CAAO,UAAA,SAAmB,EAAC;AACvD,EAAA,MAAM,WAAW,MAAA,CAAO,aAAA;AACxB,EAAA,MAAM,KAAA,GAAQ,aAAa,MAAA,IAAa,EAAA,CAAG,eAAe,QAAQ,CAAA,GAAI,QAAA,CAAS,QAAA,CAAS,MAAA,CAAO,CAAC,YAAY,CAAC,OAAA,CAAQ,UAAU,CAAA,CAAE,GAAA,CAAI,CAAC,OAAA,KAAY,OAAA,CAAQ,IAAI,CAAA,GAAI,EAAC;AACnK,EAAA,OAAO,CAAC,GAAI,MAAA,CAAO,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,CAAC,MAAA,CAAO,IAAI,CAAA,EAAI,GAAG,KAAK,CAAA;AACvE,CAAA;AAGO,IAAM,eAAA,GAAkB,CAAC,EAAA,EAAgB,IAAA,KAA4B;AAC1E,EAAA,MAAM,OAAA,GAAU,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAClC,EAAA,MAAM,OAAA,GAAU,QAAQ,cAAA,EAAe;AACvC,EAAA,MAAM,OAAA,GAAU,QAAQ,kBAAA,EAAmB;AAC3C,EAAA,OAAO,OAAA,CAAQ,cAAA,EAAe,CAAE,OAAA,CAAQ,CAAC,MAAA,KAAW;AAClD,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA,EAAMA,YAAA,CAAQ,MAAA,CAAO,QAAQ,CAAC,CAAA;AAClD,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,IAAK,KAAK,UAAA,CAAW,UAAU,CAAA,IAAK,IAAA,CAAK,WAAW,UAAU,CAAA,IAAK,MAAA,CAAO,iBAAA,SAA0B,EAAC;AAChI,IAAA,OAAO,MAAA,CAAO,UAAA,CAAW,OAAA,CAAQ,CAAC,SAAA,KAAc;AAC9C,MAAA,IAAI,CAAC,EAAA,CAAG,mBAAA,CAAoB,SAAS,CAAA,IAAK,CAAC,EAAA,CAAG,eAAA,CAAgB,SAAA,CAAU,eAAe,CAAA,EAAG,OAAO,EAAC;AAClG,MAAA,MAAM,MAAA,GAAS,EAAA,CAAG,iBAAA,CAAkB,SAAA,CAAU,eAAA,CAAgB,IAAA,EAAM,MAAA,CAAO,QAAA,EAAU,OAAA,EAAS,EAAA,CAAG,GAAG,CAAA,CAAE,cAAA,EAAgB,gBAAA;AACtH,MAAA,IAAI,MAAA,KAAW,MAAA,EAAW,OAAO,EAAC;AAClC,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,EAAMA,YAAA,CAAQ,MAAM,CAAC,CAAA;AACzC,MAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,SAAU,EAAC;AAC1C,MAAA,OAAO,cAAc,EAAA,EAAI,SAAA,CAAU,YAAY,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,KAAS;AACjE,QAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,iBAAA,CAAkB,IAAI,EAAE,iBAAA,EAAkB;AAChE,QAAA,IAAI,MAAM,MAAA,KAAW,CAAA,IAAK,MAAM,KAAA,CAAM,CAAC,SAAS,QAAA,CAAS,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,KAAK,aAAA,EAAe,CAAC,CAAC,CAAA,SAAU,EAAC;AACpH,QAAA,MAAM,IAAA,GAAO,OAAO,6BAAA,CAA8B,IAAA,CAAK,SAAS,MAAM,CAAC,EAAE,IAAA,GAAO,CAAA;AAChF,QAAA,OAAO,CAAC,EAAE,IAAA,EAAM,MAAA,EAAiB,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,CAAA,EAAG,IAAA,CAAK,IAAI,CAAA,gBAAA,EAAmB,IAAI,IAAI,CAAA;AAAA,MAC5F,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH,CAAA;ACxCA,IAAM,YAAA,GAAe,CAAC,KAAA,KACpB,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,OAAO,OAAA,CAAQ,IAAI,KAAA,EAAO,eAAe,MAAM,UAAA,IAAc,OAAO,QAAQ,GAAA,CAAI,KAAA,EAAO,SAAS,CAAA,KAAM,QAAA;AAGhJ,IAAM,cAAA,GAAiB,CAAC,IAAA,KAA6B;AAC1D,EAAA,MAAMC,QAAAA,GAAUC,sBAAA,CAAcN,SAAAA,CAAK,IAAA,EAAM,cAAc,CAAC,CAAA;AACxD,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAUK,SAAQ,YAAY,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+FAAA,EAAkG,IAAI,CAAA,yBAAA,CAA2B,CAAA;AAAA,EACnJ;AACA,EAAA,IAAI,CAAC,YAAA,CAAa,OAAO,GAAG,MAAM,IAAI,MAAM,yEAAyE,CAAA;AACrH,EAAA,IAAI,CAAC,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,IAAI,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,CAAA,kEAAA,EAAqE,OAAA,CAAQ,OAAO,CAAA,CAAA,CAAG,CAAA;AAC9I,EAAA,OAAO,OAAA;AACT,CAAA;;;ACCA,IAAM,KAAA,GAA+D;AAAA,EACnE,CAAC,SAAS,8HAA8H,CAAA;AAAA,EACxI,CAAC,cAAc,0EAAqE,CAAA;AAAA,EACpF,CAAC,SAAS,qEAAgE,CAAA;AAAA,EAC1E,CAAC,SAAS,oDAAoD,CAAA;AAAA,EAC9D,CAAC,WAAW,iEAAiE,CAAA;AAAA,EAC7E,CAAC,OAAO,+DAA+D,CAAA;AAAA,EACvE,CAAC,QAAQ,6FAAwF;AACnG,CAAA;AAEA,IAAM,QAAA,GAAW,CAAC,KAAA,KAAqD,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAE1I,IAAM,WAAA,GAAc,CAAC,OAAA,KACnB,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAW,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,SAAA,IAAa,EAAE,CAAA,CAAE,OAAA,CAAQ,CAAC,QAAA,KAAc,QAAA,CAAS,QAAQ,CAAA,GAAI,CAAC,EAAE,MAAA,EAAQ,MAAA,CAAO,EAAA,EAAI,QAAA,EAAU,CAAA,GAAI,EAAG,CAAC,CAAA;AAExJ,IAAM,QAAA,GAAW,CAAC,QAAA,KAA4E;AAC5F,EAAA,MAAM,OAAA,GAAU,SAAS,SAAS,CAAA;AAClC,EAAA,IAAI,CAAC,QAAA,CAAS,OAAO,KAAK,EAAE,aAAA,IAAiB,UAAU,OAAO,MAAA;AAC9D,EAAA,MAAM,WAAA,GAAc,QAAQ,aAAa,CAAA;AACzC,EAAA,OAAO,OAAO,WAAA,KAAgB,QAAA,GAAW,EAAE,WAAA,KAAgB,EAAC;AAC9D,CAAA;AAEO,IAAM,aAAA,GAAgB,CAAC,MAAA,KAAqC;AACjE,EAAA,MAAM,MAAM,MAAA,CAAO,GAAA,KAAQ,CAAC,IAAA,KAAiB,OAAA,CAAQ,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,IAAI,QAAA,GAAW,CAAA;AACf,EAAA,MAAM,QAAQ,CAAC,IAAA,EAAc,MAAA,EAAiB,MAAA,GAA4B,EAAC,KAAY;AACrF,IAAA,GAAA,CAAI,GAAG,MAAA,GAAS,QAAA,GAAW,QAAQ,CAAA,CAAA,EAAI,IAAI,GAAG,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,CAAA,GAAI,KAAK,CAAA,QAAA,EAAM,MAAA,CAAO,KAAK,IAAI,CAAC,EAAE,CAAA,CAAE,CAAA;AAC9G,IAAA,IAAI,CAAC,QAAQ,QAAA,IAAY,CAAA;AAAA,EAC3B,CAAA;AACA,EAAA,MAAM,OAAO,MAAc;AACzB,IAAA,GAAA,CAAI,QAAA,KAAa,CAAA,GAAI,iCAAA,GAAoC,CAAA,cAAA,EAAiB,QAAQ,CAAA,gBAAA,CAAkB,CAAA;AACpG,IAAA,OAAO,QAAA,KAAa,IAAI,CAAA,GAAI,CAAA;AAAA,EAC9B,CAAA;AAEA,EAAA,IAAI,QAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAM,EAAA,GAAK,cAAA,CAAe,MAAA,CAAO,IAAI,CAAA;AACrC,IAAA,QAAA,GAAW,CAAC,GAAG,cAAA,CAAe,EAAA,EAAI,MAAA,CAAO,IAAI,CAAA,EAAG,GAAG,eAAA,CAAgB,EAAA,EAAI,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,EACrF,SAAS,KAAA,EAAO;AACd,IAAA,KAAA,CAAM,oBAAA,EAAsB,KAAA,EAAO,CAAC,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA;AAC3F,IAAA,OAAO,IAAA,EAAK;AAAA,EACd;AAEA,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,IAAS,EAAC;AAC/B,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,IAAI,CAAA,IAAK,KAAA,EAAO;AAChC,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAI,CAAA,IAAK,EAAC;AAChC,IAAA,MAAM,IAAA,GAAO,QAAA,CAAS,MAAA,CAAO,CAAC,OAAA,KAAY,OAAA,CAAQ,IAAA,KAAS,IAAA,IAAQ,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,KAAM,MAAS,CAAA;AACtG,IAAA,KAAA,CAAM,MAAM,IAAA,CAAK,MAAA,KAAW,GAAG,IAAA,CAAK,GAAA,CAAI,CAAC,OAAA,KAAY,CAAA,EAAG,OAAA,CAAQ,IAAI,IAAI,OAAA,CAAQ,IAAI,IAAI,OAAA,CAAQ,IAAI,EAAE,CAAC,CAAA;AAAA,EACzG;AACA,EAAA,MAAM,OAAO,KAAA,CAAM,OAAA;AAAA,IAAQ,CAAC,CAAC,IAAI,CAAA,KAC/B,MAAA,CAAO,QAAQ,KAAA,CAAM,IAAI,CAAA,IAAK,EAAE,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC5D,MAAA,IAAI,MAAA,CAAO,IAAA,EAAK,KAAM,EAAA,EAAI,OAAO,CAAC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,gBAAA,CAAkB,CAAA;AACpE,MAAA,IAAI,CAACE,aAAA,CAAWP,SAAAA,CAAK,MAAA,CAAO,MAAM,IAAI,CAAC,CAAA,EAAG,OAAO,CAAC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,eAAA,CAAiB,CAAA;AACnF,MAAA,OAAO,SAAS,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,IAAA,KAAS,QAAQ,OAAA,CAAQ,IAAA,KAAS,IAAI,CAAA,GAAI,EAAC,GAAI,CAAC,GAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,qBAAA,CAAuB,CAAA;AAAA,IACnI,CAAC;AAAA,GACH;AACA,EAAA,KAAA,CAAM,qEAAA,EAAuE,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,IAAI,CAAA;AAEpG,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA;AAC5C,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,IAAa,EAAC;AACpC,EAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,SAAA,CAAU,QAAQ,CAAC,EAAE,UAAS,KAAO,OAAO,SAAS,IAAI,CAAA,KAAM,WAAW,CAAC,QAAA,CAAS,IAAI,CAAC,CAAA,GAAI,EAAG,CAAC,CAAA;AACxH,EAAA,MAAM,cAAc,CAAC,GAAG,MAAM,CAAA,CAAE,OAAO,CAAC,EAAA,KAAA,CAAQ,MAAA,CAAO,EAAE,KAAK,EAAA,EAAI,IAAA,EAAK,KAAM,EAAE,EAAE,IAAA,EAAK;AACtF,EAAA,KAAA,CAAM,kHAAA,EAAoH,WAAA,CAAY,MAAA,KAAW,CAAA,EAAG,WAAW,CAAA;AAC/J,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,IAAA,CAAK,MAAM,EAAE,MAAA,CAAO,CAAC,EAAA,KAAO,CAAC,MAAA,CAAO,GAAA,CAAI,EAAE,CAAC,EAAE,IAAA,EAAK;AAC1E,EAAA,KAAA,CAAM,4DAAA,EAA8D,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,QAAQ,CAAA;AAEnG,EAAA,MAAM,UAAU,SAAA,CAAU,OAAA,CAAQ,CAAC,EAAE,UAAS,KAAM;AAClD,IAAA,MAAM,MAAA,GAAS,SAAS,QAAQ,CAAA;AAChC,IAAA,OAAO,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,CAAC,MAAM,CAAA;AAAA,EAC5C,CAAC,CAAA;AACD,EAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAY,MAAA,CAAO,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,CAAC,MAAA,CAAO,WAAW,CAAE,CAAC,CAAA;AACjH,EAAA,MAAM,KAAA,GAAA,CAAS,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG,OAAO,CAAC,KAAA,KAAU,KAAA,CAAM,GAAA,KAAQ,MAAS,CAAA;AAC9E,EAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,MAAA,CAAO,CAAC,EAAE,QAAA,EAAS,KAAM,OAAO,QAAA,CAAS,IAAI,CAAA,KAAM,QAAQ,CAAA,CAAE,MAAA;AACrF,EAAA,GAAA,CAAI,CAAA,qCAAA,EAAwC,KAAK,CAAA,sBAAA,EAAyB,OAAA,CAAQ,MAAM,CAAA,MAAA,CAAQ,CAAA;AAChG,EAAA,GAAA,CAAI,CAAA,OAAA,EAAU,KAAA,CAAM,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,OAAA,KAAY,MAAS,CAAA,CAAE,MAAM,CAAA,IAAA,EAAO,KAAA,CAAM,MAAM,CAAA,2CAAA,CAA6C,CAAA;AACzI,EAAA,MAAM,UAAU,KAAA,CAAM,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,YAAY,UAAA,IAAc,CAAC,MAAM,GAAA,CAAI,KAAA,CAAM,WAAW,CAAC,CAAA,CAAE,IAAI,CAAC,KAAA,KAAU,MAAM,WAAW,CAAA;AACvI,EAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG,GAAA,CAAI,oDAAoD,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AACpG,EAAA,OAAO,IAAA,EAAK;AACd","file":"shape.cjs","sourcesContent":["import { readdirSync, readFileSync } from 'node:fs';\nimport { join, relative, sep } from 'node:path';\nimport type * as TS from 'typescript';\nimport type { TypeScript } from './typescript';\n\nexport type SourceRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom';\n\nexport type Finding = { rule: SourceRule | 'data'; file: string; line: number; what: string };\n\nconst SOURCE = /\\.(ts|tsx|mts|cts)$/;\n\nexport const pathOf = (root: string, file: string): string => relative(root, file).split(sep).join('/');\n\nexport const sourceFilesOf = (root: string, dir = join(root, 'src')): string[] => {\n let entries;\n try {\n entries = readdirSync(dir, { withFileTypes: true });\n } catch {\n return [];\n }\n return entries.flatMap((entry) => {\n if (entry.name === 'node_modules') return [];\n const path = join(dir, entry.name);\n if (entry.isDirectory()) return sourceFilesOf(root, path);\n return SOURCE.test(entry.name) && !entry.name.endsWith('.d.ts') ? [path] : [];\n });\n};\n\nconst READ_FILE = new Set(['readAsDataURL', 'readAsText', 'readAsArrayBuffer', 'readAsBinaryString']);\nconst FIND_ELEMENTS = new Set(['querySelector', 'querySelectorAll', 'getElementById', 'getElementsByClassName', 'getElementsByTagName', 'getElementsByName']);\nconst ADDRESS_CHANGE = new Set(['pushState', 'replaceState']);\n\nconst lastName = (ts: TypeScript, node: TS.Expression): string | undefined => {\n if (ts.isIdentifier(node)) return node.text;\n if (ts.isPropertyAccessExpression(node)) return node.name.text;\n return undefined;\n};\n\nconst hasModifier = (ts: TypeScript, node: TS.Node, kind: TS.SyntaxKind): boolean => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);\n\n// Each rule reads the syntax tree, so a word in a comment or a string is never a finding.\nconst findingsIn = (ts: TypeScript, file: string, source: TS.SourceFile): Finding[] => {\n const found: Finding[] = [];\n const inSrc = (folder: string): boolean => file.startsWith(`src/${folder}/`);\n const at = (rule: SourceRule, node: TS.Node, what: string): void => {\n found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, what });\n };\n const visit = (node: TS.Node): void => {\n if (ts.isAsExpression(node) && !(ts.isTypeReferenceNode(node.type) && ts.isIdentifier(node.type.typeName) && node.type.typeName.text === 'const')) at('style', node, `\"as ${node.type.getText(source)}\"`);\n if (ts.isTypeAssertionExpression(node)) at('style', node, 'a \"<T>\" assertion');\n if (ts.isNonNullExpression(node)) at('style', node, 'a non-null \"!\"');\n if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at('style', node, 'a function declaration');\n if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at('style', node, 'a class');\n if (ts.isEnumDeclaration(node)) at('style', node, 'an enum');\n if (node.kind === ts.SyntaxKind.AnyKeyword) at('style', node, '\"any\"');\n if ((ts.isExportAssignment(node) && node.isExportEquals !== true) || (ts.isExportSpecifier(node) && node.name.text === 'default') || hasModifier(ts, node, ts.SyntaxKind.DefaultKeyword)) at('style', node, 'a default export');\n\n if (!inSrc('dev')) {\n if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === 'Intl') at('formatting', node, `Intl.${node.name.text}`);\n if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith('toLocale')) at('formatting', node, `.${node.expression.name.text}()`);\n }\n if (inSrc('server') && ts.isPropertyAccessExpression(node) && node.name.text === 'roles') {\n const whose = lastName(ts, node.expression);\n if (whose === 'session' || whose === 'principal') at('roles', node, `${whose}.roles`);\n }\n if (inSrc('ui')) {\n if (ts.isIdentifier(node) && node.text === 'FileReader' && !ts.isTypeReferenceNode(node.parent)) at('files', node, 'FileReader');\n if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at('files', node, node.name.text);\n if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === 'location') at('address', node, `location.${node.name.text}`);\n if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === 'history' && ADDRESS_CHANGE.has(node.name.text)) at('address', node, `history.${node.name.text}`);\n if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === 'document') {\n at('dom', node, `document.${node.expression.name.text}`);\n }\n }\n ts.forEachChild(node, visit);\n };\n visit(source);\n return found;\n};\n\nexport const sourceFindings = (ts: TypeScript, root: string): Finding[] =>\n sourceFilesOf(root).flatMap((path) => {\n const file = pathOf(root, path);\n const source = ts.createSourceFile(file, readFileSync(path, 'utf8'), ts.ScriptTarget.Latest, true, path.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS);\n return findingsIn(ts, file, source);\n });\n","import { resolve } from 'node:path';\nimport type * as TS from 'typescript';\nimport { pathOf } from './source';\nimport type { Finding } from './source';\nimport type { TypeScript } from './typescript';\n\n// The manifest's factory takes the server's code seams and answers the manifest: setup, not code in the artifact tree.\nconst MANIFEST = /^(Promise<)?NiscApp>?$/;\n\nconst programOf = (ts: TypeScript, root: string): TS.Program => {\n const config = ts.findConfigFile(root, ts.sys.fileExists, 'tsconfig.json');\n if (config === undefined || !resolve(config).startsWith(resolve(root))) throw new Error(`the shape check reads the app as its tsconfig.json says, and ${root} has none.`);\n const parsed = ts.getParsedCommandLineOfConfigFile(config, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => undefined });\n if (parsed === undefined) throw new Error(`${config} could not be read.`);\n return ts.createProgram({ rootNames: parsed.fileNames, options: parsed.options });\n};\n\nconst importedNames = (ts: TypeScript, clause: TS.ImportClause | undefined): TS.Identifier[] => {\n if (clause === undefined || clause.isTypeOnly) return [];\n const bindings = clause.namedBindings;\n const named = bindings !== undefined && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];\n return [...(clause.name === undefined ? [] : [clause.name]), ...named];\n};\n\n// What code outside src/app calls of it, read by the compiler under the app's own tsconfig, so a path alias counts.\nexport const appDataFindings = (ts: TypeScript, root: string): Finding[] => {\n const program = programOf(ts, root);\n const checker = program.getTypeChecker();\n const options = program.getCompilerOptions();\n return program.getSourceFiles().flatMap((source) => {\n const file = pathOf(root, resolve(source.fileName));\n if (!file.startsWith('src/') || file.startsWith('src/app/') || file.startsWith('src/dev/') || source.isDeclarationFile) return [];\n return source.statements.flatMap((statement) => {\n if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) return [];\n const target = ts.resolveModuleName(statement.moduleSpecifier.text, source.fileName, options, ts.sys).resolvedModule?.resolvedFileName;\n if (target === undefined) return [];\n const from = pathOf(root, resolve(target));\n if (!from.startsWith('src/app/')) return [];\n return importedNames(ts, statement.importClause).flatMap((name) => {\n const calls = checker.getTypeAtLocation(name).getCallSignatures();\n if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];\n const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;\n return [{ rule: 'data' as const, file, line, what: `${name.text}, a function of ${from}` }];\n });\n });\n });\n};\n","import { createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport type * as TS from 'typescript';\n\nexport type TypeScript = typeof TS;\n\nconst isTypeScript = (value: unknown): value is TypeScript =>\n value !== null && typeof value === 'object' && typeof Reflect.get(value, 'createProgram') === 'function' && typeof Reflect.get(value, 'version') === 'string';\n\n// The app's own compiler, as `nisc build` uses the app's own jsdom: the gate adds no dependency to the cli.\nexport const loadTypeScript = (root: string): TypeScript => {\n const require = createRequire(join(root, 'package.json'));\n let library: unknown;\n try {\n library = require('typescript');\n } catch {\n throw new Error(`the shape check reads the source with TypeScript, and this app has none installed (looked from ${root}). pnpm add -D typescript`);\n }\n if (!isTypeScript(library)) throw new Error('the \"typescript\" this app has installed is not the TypeScript compiler.');\n if (!library.version.startsWith('6.')) throw new Error(`the shape check is written against TypeScript 6, and this app has ${library.version}.`);\n return library;\n};\n","import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { appDataFindings } from './app-data';\nimport { sourceFindings } from './source';\nimport type { Finding } from './source';\nimport { loadTypeScript } from './typescript';\n\nexport type ShapeRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom' | 'data';\n\nexport type ShapeAction = { id: string; endpoints?: Readonly<Record<string, unknown>> };\n\nexport type ShapeEntry = { fingerprint: string; refresh?: string; dsl?: unknown; mapping?: unknown };\n\nexport type ShapeCheckConfig = {\n root: string;\n actions: readonly ShapeAction[];\n entries?: readonly ShapeEntry[];\n functions?: Readonly<Record<string, string>>;\n allow?: Readonly<Partial<Record<ShapeRule, Readonly<Record<string, string>>>>>;\n log?: (line: string) => void;\n};\n\nconst RULES: readonly (readonly [rule: ShapeRule, what: string])[] = [\n ['style', 'rule 16: no assertion but \"as const\", no non-null \"!\", no function declaration, class, enum, \"any\" or default export in src/'],\n ['formatting', 'rule 9: no Intl and no toLocale… outside Prism (src/, but src/dev/)'],\n ['roles', 'rule 11: no server code reads the caller’s roles (src/server/)'],\n ['files', 'rule 9a: the kit reads no file into data (src/ui/)'],\n ['address', 'rule 4: the kit neither reads nor changes the address (src/ui/)'],\n ['dom', 'rule 2: no component finds elements in the document (src/ui/)'],\n ['data', 'src/app is data: no code outside it calls a function of it, but the manifest’s factory'],\n];\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst endpointsOf = (actions: readonly ShapeAction[]): { action: string; endpoint: Record<string, unknown> }[] =>\n actions.flatMap((action) => Object.values(action.endpoints ?? {}).flatMap((endpoint) => (isRecord(endpoint) ? [{ action: action.id, endpoint }] : [])));\n\nconst replayOf = (endpoint: Record<string, unknown>): { fingerprint?: string } | undefined => {\n const request = endpoint['request'];\n if (!isRecord(request) || !('fingerprint' in request)) return undefined;\n const fingerprint = request['fingerprint'];\n return typeof fingerprint === 'string' ? { fingerprint } : {};\n};\n\nexport const runShapeCheck = (config: ShapeCheckConfig): number => {\n const log = config.log ?? ((line: string) => console.log(line));\n let failures = 0;\n const check = (what: string, passed: boolean, detail: readonly string[] = []): void => {\n log(`${passed ? '[pass]' : '[fail]'} ${what}${passed || detail.length === 0 ? '' : ` — ${detail.join('; ')}`}`);\n if (!passed) failures += 1;\n };\n const done = (): number => {\n log(failures === 0 ? '[pass] shape: all checks passed' : `[fail] shape: ${failures} check(s) failed`);\n return failures === 0 ? 0 : 1;\n };\n\n let findings: Finding[];\n try {\n const ts = loadTypeScript(config.root);\n findings = [...sourceFindings(ts, config.root), ...appDataFindings(ts, config.root)];\n } catch (error) {\n check('the source is read', false, [error instanceof Error ? error.message : String(error)]);\n return done();\n }\n\n const allow = config.allow ?? {};\n for (const [rule, what] of RULES) {\n const allowed = allow[rule] ?? {};\n const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === undefined);\n check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));\n }\n const idle = RULES.flatMap(([rule]) =>\n Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {\n if (reason.trim() === '') return [`${rule}: ${file} gives no reason`];\n if (!existsSync(join(config.root, file))) return [`${rule}: ${file} does not exist`];\n return findings.some((finding) => finding.rule === rule && finding.file === file) ? [] : [`${rule}: ${file} has nothing to allow`];\n }),\n );\n check('every allowance names a file there is, why, and something it allows', idle.length === 0, idle);\n\n const endpoints = endpointsOf(config.actions);\n const ledger = config.functions ?? {};\n const called = new Set(endpoints.flatMap(({ endpoint }) => (typeof endpoint['fn'] === 'string' ? [endpoint['fn']] : [])));\n const unexplained = [...called].filter((id) => (ledger[id] ?? '').trim() === '').sort();\n check('every server function an action calls is named in `functions`, with what it does that a vex read or write cannot', unexplained.length === 0, unexplained);\n const uncalled = Object.keys(ledger).filter((id) => !called.has(id)).sort();\n check('every function named in `functions` is called by an action', uncalled.length === 0, uncalled);\n\n const replays = endpoints.flatMap(({ endpoint }) => {\n const replay = replayOf(endpoint);\n return replay === undefined ? [] : [replay];\n });\n const named = new Set(replays.flatMap((replay) => (replay.fingerprint === undefined ? [] : [replay.fingerprint])));\n const reads = (config.entries ?? []).filter((entry) => entry.dsl !== undefined);\n const calls = endpoints.filter(({ endpoint }) => typeof endpoint['fn'] === 'string').length;\n log(`[info] actions call server functions ${calls} times and replay vex ${replays.length} times`);\n log(`[info] ${reads.filter((entry) => entry.mapping !== undefined).length} of ${reads.length} reads word their rows with a Prism mapping`);\n const unnamed = reads.filter((entry) => entry.refresh === 'reactive' && !named.has(entry.fingerprint)).map((entry) => entry.fingerprint);\n if (unnamed.length > 0) log(`[info] reactive reads no action replays by name: ${unnamed.join(', ')}`);\n return done();\n};\n"]}
|
package/dist/shape.d.cts
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
type ShapeRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom' | 'data';
|
|
2
|
+
type ShapeAction = {
|
|
3
|
+
id: string;
|
|
4
|
+
endpoints?: Readonly<Record<string, unknown>>;
|
|
5
|
+
};
|
|
6
|
+
type ShapeEntry = {
|
|
7
|
+
fingerprint: string;
|
|
8
|
+
refresh?: string;
|
|
9
|
+
dsl?: unknown;
|
|
10
|
+
mapping?: unknown;
|
|
11
|
+
};
|
|
12
|
+
type ShapeCheckConfig = {
|
|
13
|
+
root: string;
|
|
14
|
+
actions: readonly ShapeAction[];
|
|
15
|
+
entries?: readonly ShapeEntry[];
|
|
16
|
+
functions?: Readonly<Record<string, string>>;
|
|
17
|
+
allow?: Readonly<Partial<Record<ShapeRule, Readonly<Record<string, string>>>>>;
|
|
18
|
+
log?: (line: string) => void;
|
|
19
|
+
};
|
|
20
|
+
declare const runShapeCheck: (config: ShapeCheckConfig) => number;
|
|
21
|
+
|
|
22
|
+
export { type ShapeAction, type ShapeCheckConfig, type ShapeEntry, type ShapeRule, runShapeCheck };
|
package/dist/shape.d.ts
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
type ShapeRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom' | 'data';
|
|
2
|
+
type ShapeAction = {
|
|
3
|
+
id: string;
|
|
4
|
+
endpoints?: Readonly<Record<string, unknown>>;
|
|
5
|
+
};
|
|
6
|
+
type ShapeEntry = {
|
|
7
|
+
fingerprint: string;
|
|
8
|
+
refresh?: string;
|
|
9
|
+
dsl?: unknown;
|
|
10
|
+
mapping?: unknown;
|
|
11
|
+
};
|
|
12
|
+
type ShapeCheckConfig = {
|
|
13
|
+
root: string;
|
|
14
|
+
actions: readonly ShapeAction[];
|
|
15
|
+
entries?: readonly ShapeEntry[];
|
|
16
|
+
functions?: Readonly<Record<string, string>>;
|
|
17
|
+
allow?: Readonly<Partial<Record<ShapeRule, Readonly<Record<string, string>>>>>;
|
|
18
|
+
log?: (line: string) => void;
|
|
19
|
+
};
|
|
20
|
+
declare const runShapeCheck: (config: ShapeCheckConfig) => number;
|
|
21
|
+
|
|
22
|
+
export { type ShapeAction, type ShapeCheckConfig, type ShapeEntry, type ShapeRule, runShapeCheck };
|
package/dist/shape.js
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { existsSync, readFileSync, readdirSync } from 'fs';
|
|
2
|
+
import { join, resolve, relative, sep } from 'path';
|
|
3
|
+
import { createRequire } from 'module';
|
|
4
|
+
|
|
5
|
+
// src/shape/index.ts
|
|
6
|
+
var SOURCE = /\.(ts|tsx|mts|cts)$/;
|
|
7
|
+
var pathOf = (root, file) => relative(root, file).split(sep).join("/");
|
|
8
|
+
var sourceFilesOf = (root, dir = join(root, "src")) => {
|
|
9
|
+
let entries;
|
|
10
|
+
try {
|
|
11
|
+
entries = readdirSync(dir, { withFileTypes: true });
|
|
12
|
+
} catch {
|
|
13
|
+
return [];
|
|
14
|
+
}
|
|
15
|
+
return entries.flatMap((entry) => {
|
|
16
|
+
if (entry.name === "node_modules") return [];
|
|
17
|
+
const path = join(dir, entry.name);
|
|
18
|
+
if (entry.isDirectory()) return sourceFilesOf(root, path);
|
|
19
|
+
return SOURCE.test(entry.name) && !entry.name.endsWith(".d.ts") ? [path] : [];
|
|
20
|
+
});
|
|
21
|
+
};
|
|
22
|
+
var READ_FILE = /* @__PURE__ */ new Set(["readAsDataURL", "readAsText", "readAsArrayBuffer", "readAsBinaryString"]);
|
|
23
|
+
var FIND_ELEMENTS = /* @__PURE__ */ new Set(["querySelector", "querySelectorAll", "getElementById", "getElementsByClassName", "getElementsByTagName", "getElementsByName"]);
|
|
24
|
+
var ADDRESS_CHANGE = /* @__PURE__ */ new Set(["pushState", "replaceState"]);
|
|
25
|
+
var lastName = (ts, node) => {
|
|
26
|
+
if (ts.isIdentifier(node)) return node.text;
|
|
27
|
+
if (ts.isPropertyAccessExpression(node)) return node.name.text;
|
|
28
|
+
return void 0;
|
|
29
|
+
};
|
|
30
|
+
var hasModifier = (ts, node, kind) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);
|
|
31
|
+
var findingsIn = (ts, file, source) => {
|
|
32
|
+
const found = [];
|
|
33
|
+
const inSrc = (folder) => file.startsWith(`src/${folder}/`);
|
|
34
|
+
const at = (rule, node, what) => {
|
|
35
|
+
found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, what });
|
|
36
|
+
};
|
|
37
|
+
const visit = (node) => {
|
|
38
|
+
if (ts.isAsExpression(node) && !(ts.isTypeReferenceNode(node.type) && ts.isIdentifier(node.type.typeName) && node.type.typeName.text === "const")) at("style", node, `"as ${node.type.getText(source)}"`);
|
|
39
|
+
if (ts.isTypeAssertionExpression(node)) at("style", node, 'a "<T>" assertion');
|
|
40
|
+
if (ts.isNonNullExpression(node)) at("style", node, 'a non-null "!"');
|
|
41
|
+
if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at("style", node, "a function declaration");
|
|
42
|
+
if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at("style", node, "a class");
|
|
43
|
+
if (ts.isEnumDeclaration(node)) at("style", node, "an enum");
|
|
44
|
+
if (node.kind === ts.SyntaxKind.AnyKeyword) at("style", node, '"any"');
|
|
45
|
+
if (ts.isExportAssignment(node) && node.isExportEquals !== true || ts.isExportSpecifier(node) && node.name.text === "default" || hasModifier(ts, node, ts.SyntaxKind.DefaultKeyword)) at("style", node, "a default export");
|
|
46
|
+
if (!inSrc("dev")) {
|
|
47
|
+
if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "Intl") at("formatting", node, `Intl.${node.name.text}`);
|
|
48
|
+
if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith("toLocale")) at("formatting", node, `.${node.expression.name.text}()`);
|
|
49
|
+
}
|
|
50
|
+
if (inSrc("server") && ts.isPropertyAccessExpression(node) && node.name.text === "roles") {
|
|
51
|
+
const whose = lastName(ts, node.expression);
|
|
52
|
+
if (whose === "session" || whose === "principal") at("roles", node, `${whose}.roles`);
|
|
53
|
+
}
|
|
54
|
+
if (inSrc("ui")) {
|
|
55
|
+
if (ts.isIdentifier(node) && node.text === "FileReader" && !ts.isTypeReferenceNode(node.parent)) at("files", node, "FileReader");
|
|
56
|
+
if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at("files", node, node.name.text);
|
|
57
|
+
if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "location") at("address", node, `location.${node.name.text}`);
|
|
58
|
+
if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "history" && ADDRESS_CHANGE.has(node.name.text)) at("address", node, `history.${node.name.text}`);
|
|
59
|
+
if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === "document") {
|
|
60
|
+
at("dom", node, `document.${node.expression.name.text}`);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
ts.forEachChild(node, visit);
|
|
64
|
+
};
|
|
65
|
+
visit(source);
|
|
66
|
+
return found;
|
|
67
|
+
};
|
|
68
|
+
var sourceFindings = (ts, root) => sourceFilesOf(root).flatMap((path) => {
|
|
69
|
+
const file = pathOf(root, path);
|
|
70
|
+
const source = ts.createSourceFile(file, readFileSync(path, "utf8"), ts.ScriptTarget.Latest, true, path.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
|
|
71
|
+
return findingsIn(ts, file, source);
|
|
72
|
+
});
|
|
73
|
+
|
|
74
|
+
// src/shape/app-data.ts
|
|
75
|
+
var MANIFEST = /^(Promise<)?NiscApp>?$/;
|
|
76
|
+
var programOf = (ts, root) => {
|
|
77
|
+
const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json");
|
|
78
|
+
if (config === void 0 || !resolve(config).startsWith(resolve(root))) throw new Error(`the shape check reads the app as its tsconfig.json says, and ${root} has none.`);
|
|
79
|
+
const parsed = ts.getParsedCommandLineOfConfigFile(config, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => void 0 });
|
|
80
|
+
if (parsed === void 0) throw new Error(`${config} could not be read.`);
|
|
81
|
+
return ts.createProgram({ rootNames: parsed.fileNames, options: parsed.options });
|
|
82
|
+
};
|
|
83
|
+
var importedNames = (ts, clause) => {
|
|
84
|
+
if (clause === void 0 || clause.isTypeOnly) return [];
|
|
85
|
+
const bindings = clause.namedBindings;
|
|
86
|
+
const named = bindings !== void 0 && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];
|
|
87
|
+
return [...clause.name === void 0 ? [] : [clause.name], ...named];
|
|
88
|
+
};
|
|
89
|
+
var appDataFindings = (ts, root) => {
|
|
90
|
+
const program = programOf(ts, root);
|
|
91
|
+
const checker = program.getTypeChecker();
|
|
92
|
+
const options = program.getCompilerOptions();
|
|
93
|
+
return program.getSourceFiles().flatMap((source) => {
|
|
94
|
+
const file = pathOf(root, resolve(source.fileName));
|
|
95
|
+
if (!file.startsWith("src/") || file.startsWith("src/app/") || file.startsWith("src/dev/") || source.isDeclarationFile) return [];
|
|
96
|
+
return source.statements.flatMap((statement) => {
|
|
97
|
+
if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) return [];
|
|
98
|
+
const target = ts.resolveModuleName(statement.moduleSpecifier.text, source.fileName, options, ts.sys).resolvedModule?.resolvedFileName;
|
|
99
|
+
if (target === void 0) return [];
|
|
100
|
+
const from = pathOf(root, resolve(target));
|
|
101
|
+
if (!from.startsWith("src/app/")) return [];
|
|
102
|
+
return importedNames(ts, statement.importClause).flatMap((name) => {
|
|
103
|
+
const calls = checker.getTypeAtLocation(name).getCallSignatures();
|
|
104
|
+
if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];
|
|
105
|
+
const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;
|
|
106
|
+
return [{ rule: "data", file, line, what: `${name.text}, a function of ${from}` }];
|
|
107
|
+
});
|
|
108
|
+
});
|
|
109
|
+
});
|
|
110
|
+
};
|
|
111
|
+
var isTypeScript = (value) => value !== null && typeof value === "object" && typeof Reflect.get(value, "createProgram") === "function" && typeof Reflect.get(value, "version") === "string";
|
|
112
|
+
var loadTypeScript = (root) => {
|
|
113
|
+
const require2 = createRequire(join(root, "package.json"));
|
|
114
|
+
let library;
|
|
115
|
+
try {
|
|
116
|
+
library = require2("typescript");
|
|
117
|
+
} catch {
|
|
118
|
+
throw new Error(`the shape check reads the source with TypeScript, and this app has none installed (looked from ${root}). pnpm add -D typescript`);
|
|
119
|
+
}
|
|
120
|
+
if (!isTypeScript(library)) throw new Error('the "typescript" this app has installed is not the TypeScript compiler.');
|
|
121
|
+
if (!library.version.startsWith("6.")) throw new Error(`the shape check is written against TypeScript 6, and this app has ${library.version}.`);
|
|
122
|
+
return library;
|
|
123
|
+
};
|
|
124
|
+
|
|
125
|
+
// src/shape/index.ts
|
|
126
|
+
var RULES = [
|
|
127
|
+
["style", 'rule 16: no assertion but "as const", no non-null "!", no function declaration, class, enum, "any" or default export in src/'],
|
|
128
|
+
["formatting", "rule 9: no Intl and no toLocale\u2026 outside Prism (src/, but src/dev/)"],
|
|
129
|
+
["roles", "rule 11: no server code reads the caller\u2019s roles (src/server/)"],
|
|
130
|
+
["files", "rule 9a: the kit reads no file into data (src/ui/)"],
|
|
131
|
+
["address", "rule 4: the kit neither reads nor changes the address (src/ui/)"],
|
|
132
|
+
["dom", "rule 2: no component finds elements in the document (src/ui/)"],
|
|
133
|
+
["data", "src/app is data: no code outside it calls a function of it, but the manifest\u2019s factory"]
|
|
134
|
+
];
|
|
135
|
+
var isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
|
|
136
|
+
var endpointsOf = (actions) => actions.flatMap((action) => Object.values(action.endpoints ?? {}).flatMap((endpoint) => isRecord(endpoint) ? [{ action: action.id, endpoint }] : []));
|
|
137
|
+
var replayOf = (endpoint) => {
|
|
138
|
+
const request = endpoint["request"];
|
|
139
|
+
if (!isRecord(request) || !("fingerprint" in request)) return void 0;
|
|
140
|
+
const fingerprint = request["fingerprint"];
|
|
141
|
+
return typeof fingerprint === "string" ? { fingerprint } : {};
|
|
142
|
+
};
|
|
143
|
+
var runShapeCheck = (config) => {
|
|
144
|
+
const log = config.log ?? ((line) => console.log(line));
|
|
145
|
+
let failures = 0;
|
|
146
|
+
const check = (what, passed, detail = []) => {
|
|
147
|
+
log(`${passed ? "[pass]" : "[fail]"} ${what}${passed || detail.length === 0 ? "" : ` \u2014 ${detail.join("; ")}`}`);
|
|
148
|
+
if (!passed) failures += 1;
|
|
149
|
+
};
|
|
150
|
+
const done = () => {
|
|
151
|
+
log(failures === 0 ? "[pass] shape: all checks passed" : `[fail] shape: ${failures} check(s) failed`);
|
|
152
|
+
return failures === 0 ? 0 : 1;
|
|
153
|
+
};
|
|
154
|
+
let findings;
|
|
155
|
+
try {
|
|
156
|
+
const ts = loadTypeScript(config.root);
|
|
157
|
+
findings = [...sourceFindings(ts, config.root), ...appDataFindings(ts, config.root)];
|
|
158
|
+
} catch (error) {
|
|
159
|
+
check("the source is read", false, [error instanceof Error ? error.message : String(error)]);
|
|
160
|
+
return done();
|
|
161
|
+
}
|
|
162
|
+
const allow = config.allow ?? {};
|
|
163
|
+
for (const [rule, what] of RULES) {
|
|
164
|
+
const allowed = allow[rule] ?? {};
|
|
165
|
+
const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === void 0);
|
|
166
|
+
check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));
|
|
167
|
+
}
|
|
168
|
+
const idle = RULES.flatMap(
|
|
169
|
+
([rule]) => Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {
|
|
170
|
+
if (reason.trim() === "") return [`${rule}: ${file} gives no reason`];
|
|
171
|
+
if (!existsSync(join(config.root, file))) return [`${rule}: ${file} does not exist`];
|
|
172
|
+
return findings.some((finding) => finding.rule === rule && finding.file === file) ? [] : [`${rule}: ${file} has nothing to allow`];
|
|
173
|
+
})
|
|
174
|
+
);
|
|
175
|
+
check("every allowance names a file there is, why, and something it allows", idle.length === 0, idle);
|
|
176
|
+
const endpoints = endpointsOf(config.actions);
|
|
177
|
+
const ledger = config.functions ?? {};
|
|
178
|
+
const called = new Set(endpoints.flatMap(({ endpoint }) => typeof endpoint["fn"] === "string" ? [endpoint["fn"]] : []));
|
|
179
|
+
const unexplained = [...called].filter((id) => (ledger[id] ?? "").trim() === "").sort();
|
|
180
|
+
check("every server function an action calls is named in `functions`, with what it does that a vex read or write cannot", unexplained.length === 0, unexplained);
|
|
181
|
+
const uncalled = Object.keys(ledger).filter((id) => !called.has(id)).sort();
|
|
182
|
+
check("every function named in `functions` is called by an action", uncalled.length === 0, uncalled);
|
|
183
|
+
const replays = endpoints.flatMap(({ endpoint }) => {
|
|
184
|
+
const replay = replayOf(endpoint);
|
|
185
|
+
return replay === void 0 ? [] : [replay];
|
|
186
|
+
});
|
|
187
|
+
const named = new Set(replays.flatMap((replay) => replay.fingerprint === void 0 ? [] : [replay.fingerprint]));
|
|
188
|
+
const reads = (config.entries ?? []).filter((entry) => entry.dsl !== void 0);
|
|
189
|
+
const calls = endpoints.filter(({ endpoint }) => typeof endpoint["fn"] === "string").length;
|
|
190
|
+
log(`[info] actions call server functions ${calls} times and replay vex ${replays.length} times`);
|
|
191
|
+
log(`[info] ${reads.filter((entry) => entry.mapping !== void 0).length} of ${reads.length} reads word their rows with a Prism mapping`);
|
|
192
|
+
const unnamed = reads.filter((entry) => entry.refresh === "reactive" && !named.has(entry.fingerprint)).map((entry) => entry.fingerprint);
|
|
193
|
+
if (unnamed.length > 0) log(`[info] reactive reads no action replays by name: ${unnamed.join(", ")}`);
|
|
194
|
+
return done();
|
|
195
|
+
};
|
|
196
|
+
|
|
197
|
+
export { runShapeCheck };
|
|
198
|
+
//# sourceMappingURL=shape.js.map
|
|
199
|
+
//# sourceMappingURL=shape.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/shape/source.ts","../src/shape/app-data.ts","../src/shape/typescript.ts","../src/shape/index.ts"],"names":["require","join"],"mappings":";;;;;AASA,IAAM,MAAA,GAAS,qBAAA;AAER,IAAM,MAAA,GAAS,CAAC,IAAA,EAAc,IAAA,KAAyB,QAAA,CAAS,IAAA,EAAM,IAAI,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAE/F,IAAM,gBAAgB,CAAC,IAAA,EAAc,MAAM,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA,KAAgB;AAChF,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,WAAA,CAAY,GAAA,EAAK,EAAE,aAAA,EAAe,MAAM,CAAA;AAAA,EACpD,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,KAAU;AAChC,IAAA,IAAI,KAAA,CAAM,IAAA,KAAS,cAAA,EAAgB,OAAO,EAAC;AAC3C,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,EAAK,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,IAAI,MAAM,WAAA,EAAY,EAAG,OAAO,aAAA,CAAc,MAAM,IAAI,CAAA;AACxD,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,IAAI,KAAK,CAAC,KAAA,CAAM,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA,GAAI,CAAC,IAAI,IAAI,EAAC;AAAA,EAC9E,CAAC,CAAA;AACH,CAAA;AAEA,IAAM,SAAA,uBAAgB,GAAA,CAAI,CAAC,iBAAiB,YAAA,EAAc,mBAAA,EAAqB,oBAAoB,CAAC,CAAA;AACpG,IAAM,aAAA,mBAAgB,IAAI,GAAA,CAAI,CAAC,eAAA,EAAiB,oBAAoB,gBAAA,EAAkB,wBAAA,EAA0B,sBAAA,EAAwB,mBAAmB,CAAC,CAAA;AAC5J,IAAM,iCAAiB,IAAI,GAAA,CAAI,CAAC,WAAA,EAAa,cAAc,CAAC,CAAA;AAE5D,IAAM,QAAA,GAAW,CAAC,EAAA,EAAgB,IAAA,KAA4C;AAC5E,EAAA,IAAI,EAAA,CAAG,YAAA,CAAa,IAAI,CAAA,SAAU,IAAA,CAAK,IAAA;AACvC,EAAA,IAAI,GAAG,0BAAA,CAA2B,IAAI,CAAA,EAAG,OAAO,KAAK,IAAA,CAAK,IAAA;AAC1D,EAAA,OAAO,MAAA;AACT,CAAA;AAEA,IAAM,WAAA,GAAc,CAAC,EAAA,EAAgB,IAAA,EAAe,SAAiC,EAAA,CAAG,gBAAA,CAAiB,IAAI,CAAA,IAAA,CAAM,EAAA,CAAG,aAAa,IAAI,CAAA,IAAK,EAAC,EAAG,IAAA,CAAK,CAAC,QAAA,KAAa,QAAA,CAAS,SAAS,IAAI,CAAA;AAGzL,IAAM,UAAA,GAAa,CAAC,EAAA,EAAgB,IAAA,EAAc,MAAA,KAAqC;AACrF,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,QAAQ,CAAC,MAAA,KAA4B,KAAK,UAAA,CAAW,CAAA,IAAA,EAAO,MAAM,CAAA,CAAA,CAAG,CAAA;AAC3E,EAAA,MAAM,EAAA,GAAK,CAAC,IAAA,EAAkB,IAAA,EAAe,IAAA,KAAuB;AAClE,IAAA,KAAA,CAAM,IAAA,CAAK,EAAE,IAAA,EAAM,IAAA,EAAM,MAAM,MAAA,CAAO,6BAAA,CAA8B,IAAA,CAAK,QAAA,CAAS,MAAM,CAAC,CAAA,CAAE,IAAA,GAAO,CAAA,EAAG,MAAM,CAAA;AAAA,EAC7G,CAAA;AACA,EAAA,MAAM,KAAA,GAAQ,CAAC,IAAA,KAAwB;AACrC,IAAA,IAAI,EAAA,CAAG,cAAA,CAAe,IAAI,CAAA,IAAK,EAAE,EAAA,CAAG,mBAAA,CAAoB,IAAA,CAAK,IAAI,CAAA,IAAK,EAAA,CAAG,YAAA,CAAa,KAAK,IAAA,CAAK,QAAQ,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,IAAA,KAAS,OAAA,CAAA,EAAU,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,CAAA,IAAA,EAAO,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAC,CAAA,CAAA,CAAG,CAAA;AACxM,IAAA,IAAI,GAAG,yBAAA,CAA0B,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,mBAAmB,CAAA;AAC7E,IAAA,IAAI,GAAG,mBAAA,CAAoB,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,gBAAgB,CAAA;AACpE,IAAA,IAAI,EAAA,CAAG,qBAAA,CAAsB,IAAI,CAAA,IAAK,CAAC,WAAA,CAAY,EAAA,EAAI,IAAA,EAAM,EAAA,CAAG,WAAW,cAAc,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,MAAM,wBAAwB,CAAA;AACtI,IAAA,IAAI,EAAA,CAAG,kBAAA,CAAmB,IAAI,CAAA,IAAK,EAAA,CAAG,iBAAA,CAAkB,IAAI,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAC1F,IAAA,IAAI,GAAG,iBAAA,CAAkB,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,MAAM,SAAS,CAAA;AAC3D,IAAA,IAAI,IAAA,CAAK,SAAS,EAAA,CAAG,UAAA,CAAW,YAAY,EAAA,CAAG,OAAA,EAAS,MAAM,OAAO,CAAA;AACrE,IAAA,IAAK,EAAA,CAAG,kBAAA,CAAmB,IAAI,CAAA,IAAK,IAAA,CAAK,mBAAmB,IAAA,IAAU,EAAA,CAAG,iBAAA,CAAkB,IAAI,CAAA,IAAK,IAAA,CAAK,KAAK,IAAA,KAAS,SAAA,IAAc,WAAA,CAAY,EAAA,EAAI,IAAA,EAAM,EAAA,CAAG,UAAA,CAAW,cAAc,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,kBAAkB,CAAA;AAE9N,IAAA,IAAI,CAAC,KAAA,CAAM,KAAK,CAAA,EAAG;AACjB,MAAA,IAAI,EAAA,CAAG,2BAA2B,IAAI,CAAA,IAAK,GAAG,YAAA,CAAa,IAAA,CAAK,UAAU,CAAA,IAAK,IAAA,CAAK,WAAW,IAAA,KAAS,MAAA,KAAW,YAAA,EAAc,IAAA,EAAM,QAAQ,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC/J,MAAA,IAAI,EAAA,CAAG,gBAAA,CAAiB,IAAI,CAAA,IAAK,EAAA,CAAG,2BAA2B,IAAA,CAAK,UAAU,CAAA,IAAK,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,KAAK,UAAA,CAAW,UAAU,CAAA,EAAG,EAAA,CAAG,YAAA,EAAc,IAAA,EAAM,IAAI,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,EAAA,CAAI,CAAA;AAAA,IAC/L;AACA,IAAA,IAAI,KAAA,CAAM,QAAQ,CAAA,IAAK,EAAA,CAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA,CAAK,IAAA,KAAS,OAAA,EAAS;AACxF,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,EAAI,IAAA,CAAK,UAAU,CAAA;AAC1C,MAAA,IAAI,KAAA,KAAU,aAAa,KAAA,KAAU,WAAA,KAAgB,OAAA,EAAS,IAAA,EAAM,CAAA,EAAG,KAAK,CAAA,MAAA,CAAQ,CAAA;AAAA,IACtF;AACA,IAAA,IAAI,KAAA,CAAM,IAAI,CAAA,EAAG;AACf,MAAA,IAAI,GAAG,YAAA,CAAa,IAAI,CAAA,IAAK,IAAA,CAAK,SAAS,YAAA,IAAgB,CAAC,EAAA,CAAG,mBAAA,CAAoB,KAAK,MAAM,CAAA,EAAG,EAAA,CAAG,OAAA,EAAS,MAAM,YAAY,CAAA;AAC/H,MAAA,IAAI,EAAA,CAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,UAAU,GAAA,CAAI,IAAA,CAAK,IAAA,CAAK,IAAI,GAAG,EAAA,CAAG,OAAA,EAAS,IAAA,EAAM,IAAA,CAAK,KAAK,IAAI,CAAA;AAC1G,MAAA,IAAI,GAAG,0BAAA,CAA2B,IAAI,CAAA,IAAK,QAAA,CAAS,IAAI,IAAA,CAAK,UAAU,CAAA,KAAM,UAAA,KAAe,SAAA,EAAW,IAAA,EAAM,YAAY,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AACzI,MAAA,IAAI,EAAA,CAAG,2BAA2B,IAAI,CAAA,IAAK,SAAS,EAAA,EAAI,IAAA,CAAK,UAAU,CAAA,KAAM,SAAA,IAAa,cAAA,CAAe,IAAI,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,EAAG,EAAA,CAAG,SAAA,EAAW,MAAM,CAAA,QAAA,EAAW,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC7K,MAAA,IAAI,EAAA,CAAG,iBAAiB,IAAI,CAAA,IAAK,GAAG,0BAAA,CAA2B,IAAA,CAAK,UAAU,CAAA,IAAK,aAAA,CAAc,GAAA,CAAI,KAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,IAAK,QAAA,CAAS,IAAI,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,KAAM,UAAA,EAAY;AAC1L,QAAA,EAAA,CAAG,OAAO,IAAA,EAAM,CAAA,SAAA,EAAY,KAAK,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAAA,MACzD;AAAA,IACF;AACA,IAAA,EAAA,CAAG,YAAA,CAAa,MAAM,KAAK,CAAA;AAAA,EAC7B,CAAA;AACA,EAAA,KAAA,CAAM,MAAM,CAAA;AACZ,EAAA,OAAO,KAAA;AACT,CAAA;AAEO,IAAM,cAAA,GAAiB,CAAC,EAAA,EAAgB,IAAA,KAC7C,cAAc,IAAI,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,KAAS;AACpC,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,EAAM,IAAI,CAAA;AAC9B,EAAA,MAAM,MAAA,GAAS,GAAG,gBAAA,CAAiB,IAAA,EAAM,aAAa,IAAA,EAAM,MAAM,GAAG,EAAA,CAAG,YAAA,CAAa,QAAQ,IAAA,EAAM,IAAA,CAAK,SAAS,MAAM,CAAA,GAAI,GAAG,UAAA,CAAW,GAAA,GAAM,EAAA,CAAG,UAAA,CAAW,EAAE,CAAA;AAC/J,EAAA,OAAO,UAAA,CAAW,EAAA,EAAI,IAAA,EAAM,MAAM,CAAA;AACpC,CAAC,CAAA;;;AC9EH,IAAM,QAAA,GAAW,wBAAA;AAEjB,IAAM,SAAA,GAAY,CAAC,EAAA,EAAgB,IAAA,KAA6B;AAC9D,EAAA,MAAM,SAAS,EAAA,CAAG,cAAA,CAAe,MAAM,EAAA,CAAG,GAAA,CAAI,YAAY,eAAe,CAAA;AACzE,EAAA,IAAI,WAAW,MAAA,IAAa,CAAC,OAAA,CAAQ,MAAM,EAAE,UAAA,CAAW,OAAA,CAAQ,IAAI,CAAC,GAAG,MAAM,IAAI,KAAA,CAAM,CAAA,6DAAA,EAAgE,IAAI,CAAA,UAAA,CAAY,CAAA;AACxK,EAAA,MAAM,MAAA,GAAS,EAAA,CAAG,gCAAA,CAAiC,MAAA,EAAQ,EAAC,EAAG,EAAE,GAAG,EAAA,CAAG,GAAA,EAAK,mCAAA,EAAqC,MAAM,QAAW,CAAA;AAClI,EAAA,IAAI,WAAW,MAAA,EAAW,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,mBAAA,CAAqB,CAAA;AACxE,EAAA,OAAO,EAAA,CAAG,cAAc,EAAE,SAAA,EAAW,OAAO,SAAA,EAAW,OAAA,EAAS,MAAA,CAAO,OAAA,EAAS,CAAA;AAClF,CAAA;AAEA,IAAM,aAAA,GAAgB,CAAC,EAAA,EAAgB,MAAA,KAAyD;AAC9F,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,CAAO,UAAA,SAAmB,EAAC;AACvD,EAAA,MAAM,WAAW,MAAA,CAAO,aAAA;AACxB,EAAA,MAAM,KAAA,GAAQ,aAAa,MAAA,IAAa,EAAA,CAAG,eAAe,QAAQ,CAAA,GAAI,QAAA,CAAS,QAAA,CAAS,MAAA,CAAO,CAAC,YAAY,CAAC,OAAA,CAAQ,UAAU,CAAA,CAAE,GAAA,CAAI,CAAC,OAAA,KAAY,OAAA,CAAQ,IAAI,CAAA,GAAI,EAAC;AACnK,EAAA,OAAO,CAAC,GAAI,MAAA,CAAO,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,CAAC,MAAA,CAAO,IAAI,CAAA,EAAI,GAAG,KAAK,CAAA;AACvE,CAAA;AAGO,IAAM,eAAA,GAAkB,CAAC,EAAA,EAAgB,IAAA,KAA4B;AAC1E,EAAA,MAAM,OAAA,GAAU,SAAA,CAAU,EAAA,EAAI,IAAI,CAAA;AAClC,EAAA,MAAM,OAAA,GAAU,QAAQ,cAAA,EAAe;AACvC,EAAA,MAAM,OAAA,GAAU,QAAQ,kBAAA,EAAmB;AAC3C,EAAA,OAAO,OAAA,CAAQ,cAAA,EAAe,CAAE,OAAA,CAAQ,CAAC,MAAA,KAAW;AAClD,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,MAAA,CAAO,QAAQ,CAAC,CAAA;AAClD,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,IAAK,KAAK,UAAA,CAAW,UAAU,CAAA,IAAK,IAAA,CAAK,WAAW,UAAU,CAAA,IAAK,MAAA,CAAO,iBAAA,SAA0B,EAAC;AAChI,IAAA,OAAO,MAAA,CAAO,UAAA,CAAW,OAAA,CAAQ,CAAC,SAAA,KAAc;AAC9C,MAAA,IAAI,CAAC,EAAA,CAAG,mBAAA,CAAoB,SAAS,CAAA,IAAK,CAAC,EAAA,CAAG,eAAA,CAAgB,SAAA,CAAU,eAAe,CAAA,EAAG,OAAO,EAAC;AAClG,MAAA,MAAM,MAAA,GAAS,EAAA,CAAG,iBAAA,CAAkB,SAAA,CAAU,eAAA,CAAgB,IAAA,EAAM,MAAA,CAAO,QAAA,EAAU,OAAA,EAAS,EAAA,CAAG,GAAG,CAAA,CAAE,cAAA,EAAgB,gBAAA;AACtH,MAAA,IAAI,MAAA,KAAW,MAAA,EAAW,OAAO,EAAC;AAClC,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,MAAM,CAAC,CAAA;AACzC,MAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,SAAU,EAAC;AAC1C,MAAA,OAAO,cAAc,EAAA,EAAI,SAAA,CAAU,YAAY,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,KAAS;AACjE,QAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,iBAAA,CAAkB,IAAI,EAAE,iBAAA,EAAkB;AAChE,QAAA,IAAI,MAAM,MAAA,KAAW,CAAA,IAAK,MAAM,KAAA,CAAM,CAAC,SAAS,QAAA,CAAS,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,KAAK,aAAA,EAAe,CAAC,CAAC,CAAA,SAAU,EAAC;AACpH,QAAA,MAAM,IAAA,GAAO,OAAO,6BAAA,CAA8B,IAAA,CAAK,SAAS,MAAM,CAAC,EAAE,IAAA,GAAO,CAAA;AAChF,QAAA,OAAO,CAAC,EAAE,IAAA,EAAM,MAAA,EAAiB,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,CAAA,EAAG,IAAA,CAAK,IAAI,CAAA,gBAAA,EAAmB,IAAI,IAAI,CAAA;AAAA,MAC5F,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH,CAAA;ACxCA,IAAM,YAAA,GAAe,CAAC,KAAA,KACpB,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,OAAO,OAAA,CAAQ,IAAI,KAAA,EAAO,eAAe,MAAM,UAAA,IAAc,OAAO,QAAQ,GAAA,CAAI,KAAA,EAAO,SAAS,CAAA,KAAM,QAAA;AAGhJ,IAAM,cAAA,GAAiB,CAAC,IAAA,KAA6B;AAC1D,EAAA,MAAMA,QAAAA,GAAU,aAAA,CAAcC,IAAAA,CAAK,IAAA,EAAM,cAAc,CAAC,CAAA;AACxD,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAUD,SAAQ,YAAY,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+FAAA,EAAkG,IAAI,CAAA,yBAAA,CAA2B,CAAA;AAAA,EACnJ;AACA,EAAA,IAAI,CAAC,YAAA,CAAa,OAAO,GAAG,MAAM,IAAI,MAAM,yEAAyE,CAAA;AACrH,EAAA,IAAI,CAAC,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,IAAI,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,CAAA,kEAAA,EAAqE,OAAA,CAAQ,OAAO,CAAA,CAAA,CAAG,CAAA;AAC9I,EAAA,OAAO,OAAA;AACT,CAAA;;;ACCA,IAAM,KAAA,GAA+D;AAAA,EACnE,CAAC,SAAS,8HAA8H,CAAA;AAAA,EACxI,CAAC,cAAc,0EAAqE,CAAA;AAAA,EACpF,CAAC,SAAS,qEAAgE,CAAA;AAAA,EAC1E,CAAC,SAAS,oDAAoD,CAAA;AAAA,EAC9D,CAAC,WAAW,iEAAiE,CAAA;AAAA,EAC7E,CAAC,OAAO,+DAA+D,CAAA;AAAA,EACvE,CAAC,QAAQ,6FAAwF;AACnG,CAAA;AAEA,IAAM,QAAA,GAAW,CAAC,KAAA,KAAqD,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAE1I,IAAM,WAAA,GAAc,CAAC,OAAA,KACnB,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAW,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,SAAA,IAAa,EAAE,CAAA,CAAE,OAAA,CAAQ,CAAC,QAAA,KAAc,QAAA,CAAS,QAAQ,CAAA,GAAI,CAAC,EAAE,MAAA,EAAQ,MAAA,CAAO,EAAA,EAAI,QAAA,EAAU,CAAA,GAAI,EAAG,CAAC,CAAA;AAExJ,IAAM,QAAA,GAAW,CAAC,QAAA,KAA4E;AAC5F,EAAA,MAAM,OAAA,GAAU,SAAS,SAAS,CAAA;AAClC,EAAA,IAAI,CAAC,QAAA,CAAS,OAAO,KAAK,EAAE,aAAA,IAAiB,UAAU,OAAO,MAAA;AAC9D,EAAA,MAAM,WAAA,GAAc,QAAQ,aAAa,CAAA;AACzC,EAAA,OAAO,OAAO,WAAA,KAAgB,QAAA,GAAW,EAAE,WAAA,KAAgB,EAAC;AAC9D,CAAA;AAEO,IAAM,aAAA,GAAgB,CAAC,MAAA,KAAqC;AACjE,EAAA,MAAM,MAAM,MAAA,CAAO,GAAA,KAAQ,CAAC,IAAA,KAAiB,OAAA,CAAQ,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,IAAI,QAAA,GAAW,CAAA;AACf,EAAA,MAAM,QAAQ,CAAC,IAAA,EAAc,MAAA,EAAiB,MAAA,GAA4B,EAAC,KAAY;AACrF,IAAA,GAAA,CAAI,GAAG,MAAA,GAAS,QAAA,GAAW,QAAQ,CAAA,CAAA,EAAI,IAAI,GAAG,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,CAAA,GAAI,KAAK,CAAA,QAAA,EAAM,MAAA,CAAO,KAAK,IAAI,CAAC,EAAE,CAAA,CAAE,CAAA;AAC9G,IAAA,IAAI,CAAC,QAAQ,QAAA,IAAY,CAAA;AAAA,EAC3B,CAAA;AACA,EAAA,MAAM,OAAO,MAAc;AACzB,IAAA,GAAA,CAAI,QAAA,KAAa,CAAA,GAAI,iCAAA,GAAoC,CAAA,cAAA,EAAiB,QAAQ,CAAA,gBAAA,CAAkB,CAAA;AACpG,IAAA,OAAO,QAAA,KAAa,IAAI,CAAA,GAAI,CAAA;AAAA,EAC9B,CAAA;AAEA,EAAA,IAAI,QAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAM,EAAA,GAAK,cAAA,CAAe,MAAA,CAAO,IAAI,CAAA;AACrC,IAAA,QAAA,GAAW,CAAC,GAAG,cAAA,CAAe,EAAA,EAAI,MAAA,CAAO,IAAI,CAAA,EAAG,GAAG,eAAA,CAAgB,EAAA,EAAI,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,EACrF,SAAS,KAAA,EAAO;AACd,IAAA,KAAA,CAAM,oBAAA,EAAsB,KAAA,EAAO,CAAC,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA;AAC3F,IAAA,OAAO,IAAA,EAAK;AAAA,EACd;AAEA,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,IAAS,EAAC;AAC/B,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,IAAI,CAAA,IAAK,KAAA,EAAO;AAChC,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAI,CAAA,IAAK,EAAC;AAChC,IAAA,MAAM,IAAA,GAAO,QAAA,CAAS,MAAA,CAAO,CAAC,OAAA,KAAY,OAAA,CAAQ,IAAA,KAAS,IAAA,IAAQ,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,KAAM,MAAS,CAAA;AACtG,IAAA,KAAA,CAAM,MAAM,IAAA,CAAK,MAAA,KAAW,GAAG,IAAA,CAAK,GAAA,CAAI,CAAC,OAAA,KAAY,CAAA,EAAG,OAAA,CAAQ,IAAI,IAAI,OAAA,CAAQ,IAAI,IAAI,OAAA,CAAQ,IAAI,EAAE,CAAC,CAAA;AAAA,EACzG;AACA,EAAA,MAAM,OAAO,KAAA,CAAM,OAAA;AAAA,IAAQ,CAAC,CAAC,IAAI,CAAA,KAC/B,MAAA,CAAO,QAAQ,KAAA,CAAM,IAAI,CAAA,IAAK,EAAE,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AAC5D,MAAA,IAAI,MAAA,CAAO,IAAA,EAAK,KAAM,EAAA,EAAI,OAAO,CAAC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,gBAAA,CAAkB,CAAA;AACpE,MAAA,IAAI,CAAC,UAAA,CAAWC,IAAAA,CAAK,MAAA,CAAO,MAAM,IAAI,CAAC,CAAA,EAAG,OAAO,CAAC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,eAAA,CAAiB,CAAA;AACnF,MAAA,OAAO,SAAS,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,IAAA,KAAS,QAAQ,OAAA,CAAQ,IAAA,KAAS,IAAI,CAAA,GAAI,EAAC,GAAI,CAAC,GAAG,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,qBAAA,CAAuB,CAAA;AAAA,IACnI,CAAC;AAAA,GACH;AACA,EAAA,KAAA,CAAM,qEAAA,EAAuE,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,IAAI,CAAA;AAEpG,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA;AAC5C,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,IAAa,EAAC;AACpC,EAAA,MAAM,MAAA,GAAS,IAAI,GAAA,CAAI,SAAA,CAAU,QAAQ,CAAC,EAAE,UAAS,KAAO,OAAO,SAAS,IAAI,CAAA,KAAM,WAAW,CAAC,QAAA,CAAS,IAAI,CAAC,CAAA,GAAI,EAAG,CAAC,CAAA;AACxH,EAAA,MAAM,cAAc,CAAC,GAAG,MAAM,CAAA,CAAE,OAAO,CAAC,EAAA,KAAA,CAAQ,MAAA,CAAO,EAAE,KAAK,EAAA,EAAI,IAAA,EAAK,KAAM,EAAE,EAAE,IAAA,EAAK;AACtF,EAAA,KAAA,CAAM,kHAAA,EAAoH,WAAA,CAAY,MAAA,KAAW,CAAA,EAAG,WAAW,CAAA;AAC/J,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,IAAA,CAAK,MAAM,EAAE,MAAA,CAAO,CAAC,EAAA,KAAO,CAAC,MAAA,CAAO,GAAA,CAAI,EAAE,CAAC,EAAE,IAAA,EAAK;AAC1E,EAAA,KAAA,CAAM,4DAAA,EAA8D,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,QAAQ,CAAA;AAEnG,EAAA,MAAM,UAAU,SAAA,CAAU,OAAA,CAAQ,CAAC,EAAE,UAAS,KAAM;AAClD,IAAA,MAAM,MAAA,GAAS,SAAS,QAAQ,CAAA;AAChC,IAAA,OAAO,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,CAAC,MAAM,CAAA;AAAA,EAC5C,CAAC,CAAA;AACD,EAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAY,MAAA,CAAO,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,CAAC,MAAA,CAAO,WAAW,CAAE,CAAC,CAAA;AACjH,EAAA,MAAM,KAAA,GAAA,CAAS,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG,OAAO,CAAC,KAAA,KAAU,KAAA,CAAM,GAAA,KAAQ,MAAS,CAAA;AAC9E,EAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,MAAA,CAAO,CAAC,EAAE,QAAA,EAAS,KAAM,OAAO,QAAA,CAAS,IAAI,CAAA,KAAM,QAAQ,CAAA,CAAE,MAAA;AACrF,EAAA,GAAA,CAAI,CAAA,qCAAA,EAAwC,KAAK,CAAA,sBAAA,EAAyB,OAAA,CAAQ,MAAM,CAAA,MAAA,CAAQ,CAAA;AAChG,EAAA,GAAA,CAAI,CAAA,OAAA,EAAU,KAAA,CAAM,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,OAAA,KAAY,MAAS,CAAA,CAAE,MAAM,CAAA,IAAA,EAAO,KAAA,CAAM,MAAM,CAAA,2CAAA,CAA6C,CAAA;AACzI,EAAA,MAAM,UAAU,KAAA,CAAM,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,YAAY,UAAA,IAAc,CAAC,MAAM,GAAA,CAAI,KAAA,CAAM,WAAW,CAAC,CAAA,CAAE,IAAI,CAAC,KAAA,KAAU,MAAM,WAAW,CAAA;AACvI,EAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG,GAAA,CAAI,oDAAoD,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AACpG,EAAA,OAAO,IAAA,EAAK;AACd","file":"shape.js","sourcesContent":["import { readdirSync, readFileSync } from 'node:fs';\nimport { join, relative, sep } from 'node:path';\nimport type * as TS from 'typescript';\nimport type { TypeScript } from './typescript';\n\nexport type SourceRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom';\n\nexport type Finding = { rule: SourceRule | 'data'; file: string; line: number; what: string };\n\nconst SOURCE = /\\.(ts|tsx|mts|cts)$/;\n\nexport const pathOf = (root: string, file: string): string => relative(root, file).split(sep).join('/');\n\nexport const sourceFilesOf = (root: string, dir = join(root, 'src')): string[] => {\n let entries;\n try {\n entries = readdirSync(dir, { withFileTypes: true });\n } catch {\n return [];\n }\n return entries.flatMap((entry) => {\n if (entry.name === 'node_modules') return [];\n const path = join(dir, entry.name);\n if (entry.isDirectory()) return sourceFilesOf(root, path);\n return SOURCE.test(entry.name) && !entry.name.endsWith('.d.ts') ? [path] : [];\n });\n};\n\nconst READ_FILE = new Set(['readAsDataURL', 'readAsText', 'readAsArrayBuffer', 'readAsBinaryString']);\nconst FIND_ELEMENTS = new Set(['querySelector', 'querySelectorAll', 'getElementById', 'getElementsByClassName', 'getElementsByTagName', 'getElementsByName']);\nconst ADDRESS_CHANGE = new Set(['pushState', 'replaceState']);\n\nconst lastName = (ts: TypeScript, node: TS.Expression): string | undefined => {\n if (ts.isIdentifier(node)) return node.text;\n if (ts.isPropertyAccessExpression(node)) return node.name.text;\n return undefined;\n};\n\nconst hasModifier = (ts: TypeScript, node: TS.Node, kind: TS.SyntaxKind): boolean => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);\n\n// Each rule reads the syntax tree, so a word in a comment or a string is never a finding.\nconst findingsIn = (ts: TypeScript, file: string, source: TS.SourceFile): Finding[] => {\n const found: Finding[] = [];\n const inSrc = (folder: string): boolean => file.startsWith(`src/${folder}/`);\n const at = (rule: SourceRule, node: TS.Node, what: string): void => {\n found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, what });\n };\n const visit = (node: TS.Node): void => {\n if (ts.isAsExpression(node) && !(ts.isTypeReferenceNode(node.type) && ts.isIdentifier(node.type.typeName) && node.type.typeName.text === 'const')) at('style', node, `\"as ${node.type.getText(source)}\"`);\n if (ts.isTypeAssertionExpression(node)) at('style', node, 'a \"<T>\" assertion');\n if (ts.isNonNullExpression(node)) at('style', node, 'a non-null \"!\"');\n if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at('style', node, 'a function declaration');\n if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at('style', node, 'a class');\n if (ts.isEnumDeclaration(node)) at('style', node, 'an enum');\n if (node.kind === ts.SyntaxKind.AnyKeyword) at('style', node, '\"any\"');\n if ((ts.isExportAssignment(node) && node.isExportEquals !== true) || (ts.isExportSpecifier(node) && node.name.text === 'default') || hasModifier(ts, node, ts.SyntaxKind.DefaultKeyword)) at('style', node, 'a default export');\n\n if (!inSrc('dev')) {\n if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === 'Intl') at('formatting', node, `Intl.${node.name.text}`);\n if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith('toLocale')) at('formatting', node, `.${node.expression.name.text}()`);\n }\n if (inSrc('server') && ts.isPropertyAccessExpression(node) && node.name.text === 'roles') {\n const whose = lastName(ts, node.expression);\n if (whose === 'session' || whose === 'principal') at('roles', node, `${whose}.roles`);\n }\n if (inSrc('ui')) {\n if (ts.isIdentifier(node) && node.text === 'FileReader' && !ts.isTypeReferenceNode(node.parent)) at('files', node, 'FileReader');\n if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at('files', node, node.name.text);\n if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === 'location') at('address', node, `location.${node.name.text}`);\n if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === 'history' && ADDRESS_CHANGE.has(node.name.text)) at('address', node, `history.${node.name.text}`);\n if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === 'document') {\n at('dom', node, `document.${node.expression.name.text}`);\n }\n }\n ts.forEachChild(node, visit);\n };\n visit(source);\n return found;\n};\n\nexport const sourceFindings = (ts: TypeScript, root: string): Finding[] =>\n sourceFilesOf(root).flatMap((path) => {\n const file = pathOf(root, path);\n const source = ts.createSourceFile(file, readFileSync(path, 'utf8'), ts.ScriptTarget.Latest, true, path.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS);\n return findingsIn(ts, file, source);\n });\n","import { resolve } from 'node:path';\nimport type * as TS from 'typescript';\nimport { pathOf } from './source';\nimport type { Finding } from './source';\nimport type { TypeScript } from './typescript';\n\n// The manifest's factory takes the server's code seams and answers the manifest: setup, not code in the artifact tree.\nconst MANIFEST = /^(Promise<)?NiscApp>?$/;\n\nconst programOf = (ts: TypeScript, root: string): TS.Program => {\n const config = ts.findConfigFile(root, ts.sys.fileExists, 'tsconfig.json');\n if (config === undefined || !resolve(config).startsWith(resolve(root))) throw new Error(`the shape check reads the app as its tsconfig.json says, and ${root} has none.`);\n const parsed = ts.getParsedCommandLineOfConfigFile(config, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => undefined });\n if (parsed === undefined) throw new Error(`${config} could not be read.`);\n return ts.createProgram({ rootNames: parsed.fileNames, options: parsed.options });\n};\n\nconst importedNames = (ts: TypeScript, clause: TS.ImportClause | undefined): TS.Identifier[] => {\n if (clause === undefined || clause.isTypeOnly) return [];\n const bindings = clause.namedBindings;\n const named = bindings !== undefined && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];\n return [...(clause.name === undefined ? [] : [clause.name]), ...named];\n};\n\n// What code outside src/app calls of it, read by the compiler under the app's own tsconfig, so a path alias counts.\nexport const appDataFindings = (ts: TypeScript, root: string): Finding[] => {\n const program = programOf(ts, root);\n const checker = program.getTypeChecker();\n const options = program.getCompilerOptions();\n return program.getSourceFiles().flatMap((source) => {\n const file = pathOf(root, resolve(source.fileName));\n if (!file.startsWith('src/') || file.startsWith('src/app/') || file.startsWith('src/dev/') || source.isDeclarationFile) return [];\n return source.statements.flatMap((statement) => {\n if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) return [];\n const target = ts.resolveModuleName(statement.moduleSpecifier.text, source.fileName, options, ts.sys).resolvedModule?.resolvedFileName;\n if (target === undefined) return [];\n const from = pathOf(root, resolve(target));\n if (!from.startsWith('src/app/')) return [];\n return importedNames(ts, statement.importClause).flatMap((name) => {\n const calls = checker.getTypeAtLocation(name).getCallSignatures();\n if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];\n const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;\n return [{ rule: 'data' as const, file, line, what: `${name.text}, a function of ${from}` }];\n });\n });\n });\n};\n","import { createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport type * as TS from 'typescript';\n\nexport type TypeScript = typeof TS;\n\nconst isTypeScript = (value: unknown): value is TypeScript =>\n value !== null && typeof value === 'object' && typeof Reflect.get(value, 'createProgram') === 'function' && typeof Reflect.get(value, 'version') === 'string';\n\n// The app's own compiler, as `nisc build` uses the app's own jsdom: the gate adds no dependency to the cli.\nexport const loadTypeScript = (root: string): TypeScript => {\n const require = createRequire(join(root, 'package.json'));\n let library: unknown;\n try {\n library = require('typescript');\n } catch {\n throw new Error(`the shape check reads the source with TypeScript, and this app has none installed (looked from ${root}). pnpm add -D typescript`);\n }\n if (!isTypeScript(library)) throw new Error('the \"typescript\" this app has installed is not the TypeScript compiler.');\n if (!library.version.startsWith('6.')) throw new Error(`the shape check is written against TypeScript 6, and this app has ${library.version}.`);\n return library;\n};\n","import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { appDataFindings } from './app-data';\nimport { sourceFindings } from './source';\nimport type { Finding } from './source';\nimport { loadTypeScript } from './typescript';\n\nexport type ShapeRule = 'style' | 'formatting' | 'roles' | 'files' | 'address' | 'dom' | 'data';\n\nexport type ShapeAction = { id: string; endpoints?: Readonly<Record<string, unknown>> };\n\nexport type ShapeEntry = { fingerprint: string; refresh?: string; dsl?: unknown; mapping?: unknown };\n\nexport type ShapeCheckConfig = {\n root: string;\n actions: readonly ShapeAction[];\n entries?: readonly ShapeEntry[];\n functions?: Readonly<Record<string, string>>;\n allow?: Readonly<Partial<Record<ShapeRule, Readonly<Record<string, string>>>>>;\n log?: (line: string) => void;\n};\n\nconst RULES: readonly (readonly [rule: ShapeRule, what: string])[] = [\n ['style', 'rule 16: no assertion but \"as const\", no non-null \"!\", no function declaration, class, enum, \"any\" or default export in src/'],\n ['formatting', 'rule 9: no Intl and no toLocale… outside Prism (src/, but src/dev/)'],\n ['roles', 'rule 11: no server code reads the caller’s roles (src/server/)'],\n ['files', 'rule 9a: the kit reads no file into data (src/ui/)'],\n ['address', 'rule 4: the kit neither reads nor changes the address (src/ui/)'],\n ['dom', 'rule 2: no component finds elements in the document (src/ui/)'],\n ['data', 'src/app is data: no code outside it calls a function of it, but the manifest’s factory'],\n];\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst endpointsOf = (actions: readonly ShapeAction[]): { action: string; endpoint: Record<string, unknown> }[] =>\n actions.flatMap((action) => Object.values(action.endpoints ?? {}).flatMap((endpoint) => (isRecord(endpoint) ? [{ action: action.id, endpoint }] : [])));\n\nconst replayOf = (endpoint: Record<string, unknown>): { fingerprint?: string } | undefined => {\n const request = endpoint['request'];\n if (!isRecord(request) || !('fingerprint' in request)) return undefined;\n const fingerprint = request['fingerprint'];\n return typeof fingerprint === 'string' ? { fingerprint } : {};\n};\n\nexport const runShapeCheck = (config: ShapeCheckConfig): number => {\n const log = config.log ?? ((line: string) => console.log(line));\n let failures = 0;\n const check = (what: string, passed: boolean, detail: readonly string[] = []): void => {\n log(`${passed ? '[pass]' : '[fail]'} ${what}${passed || detail.length === 0 ? '' : ` — ${detail.join('; ')}`}`);\n if (!passed) failures += 1;\n };\n const done = (): number => {\n log(failures === 0 ? '[pass] shape: all checks passed' : `[fail] shape: ${failures} check(s) failed`);\n return failures === 0 ? 0 : 1;\n };\n\n let findings: Finding[];\n try {\n const ts = loadTypeScript(config.root);\n findings = [...sourceFindings(ts, config.root), ...appDataFindings(ts, config.root)];\n } catch (error) {\n check('the source is read', false, [error instanceof Error ? error.message : String(error)]);\n return done();\n }\n\n const allow = config.allow ?? {};\n for (const [rule, what] of RULES) {\n const allowed = allow[rule] ?? {};\n const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === undefined);\n check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));\n }\n const idle = RULES.flatMap(([rule]) =>\n Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {\n if (reason.trim() === '') return [`${rule}: ${file} gives no reason`];\n if (!existsSync(join(config.root, file))) return [`${rule}: ${file} does not exist`];\n return findings.some((finding) => finding.rule === rule && finding.file === file) ? [] : [`${rule}: ${file} has nothing to allow`];\n }),\n );\n check('every allowance names a file there is, why, and something it allows', idle.length === 0, idle);\n\n const endpoints = endpointsOf(config.actions);\n const ledger = config.functions ?? {};\n const called = new Set(endpoints.flatMap(({ endpoint }) => (typeof endpoint['fn'] === 'string' ? [endpoint['fn']] : [])));\n const unexplained = [...called].filter((id) => (ledger[id] ?? '').trim() === '').sort();\n check('every server function an action calls is named in `functions`, with what it does that a vex read or write cannot', unexplained.length === 0, unexplained);\n const uncalled = Object.keys(ledger).filter((id) => !called.has(id)).sort();\n check('every function named in `functions` is called by an action', uncalled.length === 0, uncalled);\n\n const replays = endpoints.flatMap(({ endpoint }) => {\n const replay = replayOf(endpoint);\n return replay === undefined ? [] : [replay];\n });\n const named = new Set(replays.flatMap((replay) => (replay.fingerprint === undefined ? [] : [replay.fingerprint])));\n const reads = (config.entries ?? []).filter((entry) => entry.dsl !== undefined);\n const calls = endpoints.filter(({ endpoint }) => typeof endpoint['fn'] === 'string').length;\n log(`[info] actions call server functions ${calls} times and replay vex ${replays.length} times`);\n log(`[info] ${reads.filter((entry) => entry.mapping !== undefined).length} of ${reads.length} reads word their rows with a Prism mapping`);\n const unnamed = reads.filter((entry) => entry.refresh === 'reactive' && !named.has(entry.fingerprint)).map((entry) => entry.fingerprint);\n if (unnamed.length > 0) log(`[info] reactive reads no action replays by name: ${unnamed.join(', ')}`);\n return done();\n};\n"]}
|