docs(docs): R4.6 J2 recette (procedure, results grid, kit script), export harness phases and dist override, export series script, ledger targets of the app PDF suites, CLAUDE.md export flow; export driver publishes its User Timing split

This commit is contained in:
bchanot committed 2026-10-19 01:41:57 +02:00
1 parent 9cb3cb75d4
commit cdcdda8e1c
12 files changed
+679 -39

No files matched your search

+1 -1
View File
@@ -48,7 +48,7 @@ export function checkBuild() {
throw new Error(`the build carries no sheet: run ${BUILD_COMMAND}`)
}
return {
distDir: 'apps/app/dist',
distDir: DIST_DIR,
builtAt: statSync(index).mtime.toISOString(),
sheetChunk: sheet,
entryChunk: assetSize(/^index-.*\.js$/),
+22 -3
View File
@@ -21,6 +21,8 @@ export function installProbes() {
dataUrls: 0,
clickAt: null,
pdfBlobAt: null,
/** R4.6: the `faunosteo:export` User Timing entry's detail (the Rust driver's split). */
exportTiming: null,
changeAt: null,
navAt: null,
alertAt: null,
@@ -37,8 +39,14 @@ export function installProbes() {
const toBlob = proto.toBlob
proto.toBlob = function (callback, ...rest) {
const size = { width: this.width, height: this.height }
const startedAt = now()
const record = (blob) => {
probe.png.push({ ...size, bytes: blob ? blob.size : null })
probe.png.push({
...size,
bytes: blob ? blob.size : null,
startedAt,
at: now(),
})
callback(blob)
}
return toBlob.call(this, record, ...rest)
@@ -132,8 +140,19 @@ export function countErrorLines() {
}).observe(document.body, { childList: true, subtree: true })
}
/** Reads the probe back (a structured-clone copy). */
export const readProbe = () => window.__harness
/** Reads the probe back (a structured-clone copy), with the export timing entry if any. */
export const readProbe = () => {
const probe = window.__harness
const entry = performance.getEntriesByName('faunosteo:export').at(-1)
if (entry) {
probe.exportTiming = {
startTime: entry.startTime,
duration: entry.duration,
...(entry.detail ?? {}),
}
}
return probe
}
/**
* A page of a fresh context with the probes and the tab seed, dialogs
+4 -1
View File
@@ -2,7 +2,10 @@ import { resolve } from 'node:path'
export const HARNESS_DIR = resolve(import.meta.dirname, '..')
export const REPO_ROOT = resolve(HARNESS_DIR, '../..')
export const DIST_DIR = resolve(REPO_ROOT, 'apps/app/dist')
/** The build measured; `FAUNOSTEO_DIST` points a run at another build (R4.6: TS vs Rust). */
export const DIST_DIR = process.env.FAUNOSTEO_DIST
? resolve(process.env.FAUNOSTEO_DIST)
: resolve(REPO_ROOT, 'apps/app/dist')
export const FIXTURES_DIR = resolve(REPO_ROOT, 'apps/app/tests/fixtures')
export const ORACLES_R4_DIR = resolve(REPO_ROOT, 'crates/core/tests/oracles/r4')
export const RESULTS_DIR = resolve(HARNESS_DIR, 'results')