@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/vehicle/inspectionSheets.js

@@ -0,0 +1,173 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOOK = exports.SHEET_WIDTH = exports.INSPECTION_SCHEMA = void 0;
+exports.writeInspectionSheets = writeInspectionSheets;
+// The gauntlet INSPECTION sheets of `helix vehicle preview`: every frame of the fixed inspection set, laid out as small
+// contact sheets an agent (or a fresh critic) can actually read, one question per sheet, plus `inspection/index.json`.
+//
+//   exterior-day      8 angles round the car, daylight                 (visualQa/vehicleInspection.ts)
+//   exterior-night    the same 8 angles at night, low beam on
+//   lamps-night       each lamp function lit at night
+//   wheels            each wheel close-up, low and square-on            (vehicle route, exterior phase)
+//   panels-open       every door and lid at full open                   (vehicle route, articulation phase)
+//   seat-<key>        every seat occupied: first person, through the side glass, over the shoulder, through the windscreen
+//   seat-<key>-detail the same occupant: cutaway, head to roof, hips, feet, door open, 3/4 front
+//   driver-steering   the driver's hands and the wheel at left lock, centred and right lock (hands view + first person)
+//   stillness         three frames 0.3 s apart of every occupant's hands: fingers that change between them are a FAIL
+//
+// A frame the set requires and the run did not make keeps its tile (grey, "NOT RENDERED") and fails
+// `preview.inspection.complete`: an inspection with a hole in it is not an inspection.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const sharp_1 = __importDefault(require("sharp"));
+const vehicleInspection_1 = require("../visualQa/vehicleInspection");
+exports.INSPECTION_SCHEMA = 'helix.vehicle-inspection/1';
+/** Sheet width in px. Tiles are downscaled to fit; a sheet is a JPEG of a few hundred KB, readable in one image turn. */
+exports.SHEET_WIDTH = 1280;
+exports.LOOK = {
+    'exterior-day': 'Compare each angle with the reference photo at the same angle: silhouette, proportions, stance, wheel fitment, paint colour, lamp shapes, trim. Anything missing, floating, clipped, see-through or the wrong colour is a FAIL.',
+    'exterior-night': 'Low beam on, at night: the headlamps glow and throw light, the tail lamps glow red, no panel glows that should not, nothing turns black or see-through.',
+    'lamps-night': 'Each function lights its own lenses: high beam brighter than low; fog lamps; brake lamps red and brighter than the tails; reverse lamp white at the rear; each indicator amber at BOTH the front and the rear of its side in its LIT frame (the brightest of a full blink period; its DARK frame shows it off, so it blinks); hazards both sides.',
+    wheels: 'Each wheel centred in its arch with tyre-to-arch clearance, tyre on the ground, the right design and size for its axle; no tyre through the body, no rim floating off the hub.',
+    'panels-open': 'Every door and lid at full open on its real hinge: nothing detaches or flies off, glass and door card move with the door, the opening shows a finished interior, not a hole or a back face.',
+    seat: 'Is this a person sitting in THIS car? Torso at a normal driving recline (not lying back), thighs about level (knees not up at the chest), head clear of the roof and not wedged between the seat wings, feet on the floor or pedals, the driver\'s hands on the rim and a passenger\'s resting naturally, nothing through the seat, door, dash or roof. Compare with the interior reference photos. Any posture defect is a FAIL, never "minor".',
+    'seat-detail': 'The same occupant up close: hips on the cushion (not hovering, not sunk through), head-to-roof gap, feet on the floor or pedals, nothing through the bodywork. Frames captioned "door panel hidden" are a deliberate cutaway.',
+    'driver-steering': 'Left lock, centred, right lock: BOTH hands stay ON the rim at every position and travel round WITH the wheel; centred they sit at about 9 and 3. A hand that floats off the rim, drops to the lap, stays put while the wheel turns, or goes through the wheel or dash is a FAIL.',
+    stillness: 'Three frames 0.3 s apart per occupant, nothing pressed between them: the fingers and hands must look IDENTICAL across each row. Any twitch, curl/uncurl or "grasping" between frames is a FAIL.',
+};
+const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const clip = (s, n) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
+function wrap(s, n) {
+    const out = [];
+    let line = '';
+    for (const w of s.split(/\s+/)) {
+        if ((line + ' ' + w).trim().length > n) {
+            if (line)
+                out.push(line);
+            line = w;
+        }
+        else
+            line = (line + ' ' + w).trim();
+    }
+    if (line)
+        out.push(line);
+    return out;
+}
+async function renderSheet(title, look, tiles, cols, outFile) {
+    const W = exports.SHEET_WIDTH;
+    const pad = 10;
+    const tileW = Math.floor((W - pad * (cols + 1)) / cols);
+    const tileH = Math.round(tileW * 0.625);
+    const capH = 34;
+    const lookLines = wrap(look, 150).slice(0, 4);
+    const headerH = 44 + lookLines.length * 20 + 8;
+    const rows = Math.max(1, Math.ceil(tiles.length / cols));
+    const H = headerH + rows * (tileH + capH + pad) + pad;
+    const at = (i) => ({ left: pad + (i % cols) * (tileW + pad), top: headerH + pad + Math.floor(i / cols) * (tileH + capH + pad) });
+    const composites = [];
+    for (const [i, t] of tiles.entries()) {
+        const buf = t.file && node_fs_1.default.existsSync(t.file)
+            ? await (0, sharp_1.default)(t.file).resize(tileW, tileH, { fit: 'cover' }).jpeg({ quality: 80 }).toBuffer()
+            : await (0, sharp_1.default)({ create: { width: tileW, height: tileH, channels: 3, background: '#4a2a2a' } }).jpeg().toBuffer();
+        composites.push({ input: buf, ...at(i) });
+    }
+    const svg = [
+        `<svg width="${W}" height="${H}" xmlns="http://www.w3.org/2000/svg" font-family="Helvetica, Arial, DejaVu Sans, sans-serif">`,
+        `<rect x="0" y="0" width="${W}" height="${headerH}" fill="#111"/>`,
+        `<text x="14" y="30" font-size="22" font-weight="700" fill="#fff">${esc(clip(title, 100))}</text>`,
+        ...lookLines.map((l, k) => `<text x="14" y="${56 + k * 20}" font-size="15" fill="#f0c674">${esc(k === 0 ? `LOOK: ${l}` : l)}</text>`),
+        ...tiles.map((t, i) => {
+            const { left, top } = at(i);
+            const miss = t.file && node_fs_1.default.existsSync(t.file) ? '' : `<text x="${left + tileW / 2}" y="${top + tileH / 2}" font-size="20" font-weight="700" fill="#fff" text-anchor="middle">NOT RENDERED</text>`;
+            return `${miss}<text x="${left + 3}" y="${top + tileH + 22}" font-size="14" fill="#ddd">${esc(clip(t.label, Math.floor(tileW / 7.6)))}</text>`;
+        }),
+        '</svg>',
+    ].join('');
+    const img = await (0, sharp_1.default)({ create: { width: W, height: H, channels: 3, background: '#1b1b1b' } })
+        .composite([...composites, { input: Buffer.from(svg), left: 0, top: 0 }])
+        .jpeg({ quality: 78 })
+        .toBuffer();
+    node_fs_1.default.writeFileSync(outFile, img);
+}
+/** Lay out the sheets and the index; returns the index and the `preview.inspection.complete` assert. */
+async function writeInspectionSheets(input) {
+    const dir = node_path_1.default.join(input.out, 'inspection');
+    node_fs_1.default.mkdirSync(dir, { recursive: true });
+    for (const f of node_fs_1.default.readdirSync(dir))
+        if (/\.jpg$/.test(f))
+            node_fs_1.default.rmSync(node_path_1.default.join(dir, f), { force: true });
+    const insp = input.facts.inspection ?? { frames: [], errors: [], night: null };
+    const byId = new Map();
+    for (const f of input.frames)
+        byId.set(f.id, { label: f.label, file: node_path_1.default.join(input.out, f.file) });
+    for (const f of insp.frames)
+        byId.set(f.id, { label: f.label, file: node_path_1.default.join(input.out, f.file) });
+    const tile = (id, fallback) => { const f = byId.get(id); return { id, label: f?.label ?? `${fallback} (not rendered)`, file: f?.file ?? null }; };
+    const missingAll = [];
+    const sheets = [];
+    const add = async (id, title, look, tiles, cols, required) => {
+        if (!tiles.length) {
+            if (required)
+                missingAll.push(`${id}: no frames at all`);
+            return;
+        }
+        const missing = tiles.filter((t) => !t.file).map((t) => t.id);
+        if (required)
+            missingAll.push(...missing);
+        const n = String(sheets.length + 1).padStart(2, '0');
+        const file = `${n}-${id}.jpg`;
+        await renderSheet(`${n} ${title} — ${input.carName}`, look, tiles, cols, node_path_1.default.join(dir, file));
+        sheets.push({ id, file, title, look: [look], tiles: tiles.length, missing });
+    };
+    await add('exterior-day', 'Exterior, 8 angles, day', exports.LOOK['exterior-day'], vehicleInspection_1.INSPECTION_ANGLES.map(([a, l]) => tile(`inspect.day.${a}`, `Day: ${l}`)), 4, true);
+    await add('exterior-night', 'Exterior, 8 angles, night, low beam', exports.LOOK['exterior-night'], vehicleInspection_1.INSPECTION_ANGLES.map(([a, l]) => tile(`inspect.night.${a}`, `Night: ${l}`)), 4, true);
+    await add('lamps-night', 'Each lamp function lit, night', exports.LOOK['lamps-night'], insp.frames.filter((f) => f.group === 'inspect.lamp').map((f) => tile(f.id, f.label)), 4, false);
+    await add('wheels', 'Each wheel close-up', exports.LOOK.wheels, input.frames.filter((f) => /^wheel\./.test(f.id) && !/evidence/.test(f.id)).map((f) => tile(f.id, f.label)), 4, true);
+    await add('panels-open', 'Every door and lid open', exports.LOOK['panels-open'], input.frames.filter((f) => /\.open$/.test(f.id) && f.group === 'articulation').map((f) => tile(f.id, f.label)), 3, false);
+    // occupants: every seat that the route tried (facts.occupants.seats), in its order
+    const occ = input.facts.occupants?.seats ?? [];
+    if (!occ.length)
+        missingAll.push('occupants: no seat was occupied (the occupants phase did not run or could not board)');
+    const driverKeys = occ.filter((s) => s.role === 'driver').map((s) => s.key);
+    for (const s of occ) {
+        const p = `occupant.${s.key}`;
+        const who = `${s.key}${s.role === 'driver' ? ' (driver)' : ''}`;
+        await add(`seat-${s.key}`, `Seat ${who}: first person, side glass, over the shoulder, windscreen`, exports.LOOK.seat, [tile(`${p}.first_person`, 'First person'), tile(`${p}.side`, 'Through the side glass'), tile(`${p}.over_shoulder`, 'Over the shoulder'), tile(`${p}.windscreen`, 'Through the windscreen')], 2, true);
+        const detail = ['cutaway', 'head_roof', 'hips', 'feet', 'door_open', 'front34'].map((v) => byId.has(`${p}.${v}`) ? tile(`${p}.${v}`, v) : null).filter((t) => t !== null);
+        await add(`seat-${s.key}-detail`, `Seat ${who}: up close`, exports.LOOK['seat-detail'], detail, 3, false);
+    }
+    for (const k of driverKeys) {
+        const p = `occupant.${k}`;
+        await add('driver-steering', `Driver ${k}: steering left, centre, right`, exports.LOOK['driver-steering'], ['left', 'centre', 'right'].flatMap((st) => [tile(`${p}.steer_${st}.hands`, `${st}: hands on the rim`)]).concat(['left', 'centre', 'right'].map((st) => tile(`${p}.steer_${st}.fp`, `${st}: first person`))), 3, true);
+    }
+    if (occ.length) {
+        const rows = [];
+        for (const s of occ) {
+            const tag = s.role === 'driver' ? 'centre' : 'rest';
+            for (let i = 0; i < 3; i++)
+                rows.push(tile(`occupant.${s.key}.still.${tag}.${i}`, `${s.key}${s.role === 'driver' ? ' (driver)' : ''}: frame ${i + 1}/3`));
+        }
+        await add('stillness', 'Hands and fingers, 3 frames 0.3 s apart per occupant', exports.LOOK.stillness, rows, 3, true);
+    }
+    const complete = {
+        id: 'preview.inspection.complete', severity: 'block', pass: missingAll.length === 0,
+        detail: missingAll.length ? `the inspection set has holes, so it is not an inspection: ${missingAll.slice(0, 12).join(', ')}${missingAll.length > 12 ? ` and ${missingAll.length - 12} more` : ''}${insp.errors.length ? ` (render errors: ${insp.errors.slice(0, 3).join('; ')})` : ''}`
+            : `every required inspection frame rendered (${sheets.reduce((n, s) => n + s.tiles, 0)} frames on ${sheets.length} sheets)`,
+        measured: { missing: missingAll, sheets: sheets.map((s) => ({ id: s.id, tiles: s.tiles, missing: s.missing })) },
+    };
+    const relevant = [...input.asserts.filter((a) => a.id.startsWith('vehicle.occupants.') || a.id === 'preview.occupants.cabin_fit'), complete];
+    const index = {
+        schema: exports.INSPECTION_SCHEMA,
+        verdict: relevant.some((a) => !a.pass && (a.severity ?? 'block') === 'block') ? 'fail' : 'pass',
+        car: input.carName,
+        engineVersion: input.engineVersion,
+        sheets,
+        asserts: relevant.map((a) => ({ id: a.id, pass: a.pass, severity: (a.severity ?? 'block'), detail: a.detail })),
+    };
+    node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'index.json'), JSON.stringify(index, null, 2));
+    return { index, complete, dir };
+}
+//# sourceMappingURL=inspectionSheets.js.map

package/dist/vehicle/inspectionSheets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectionSheets.js","sourceRoot":"","sources":["../../src/vehicle/inspectionSheets.ts"],"names":[],"mappings":"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"}

package/dist/vehicle/keyboardLaunch.d.ts

@@ -0,0 +1,189 @@
+/**
+ * THE KEYBOARD LAUNCH — what a player on W/A/D actually gets, in the same runtime solver the instrument uses.
+ *
+ * WHY. `measureVehicle` launches with `throttle: 1, steer: 0` on a perfectly symmetric pad. That IS a digital launch,
+ * but nothing ever disturbs the car's heading, so a car that is directionally UNSTABLE under power — the rear spinning,
+ * its lateral grip gone — still runs dead straight and posts its best figure. A keyboard player cannot modulate the
+ * throttle (W is 0 or 1; the platform does not ramp it, `VehicleDriveAbility` passes it straight to `setInput`), so on
+ * such a car every heading correction meets a rear that has no grip to give, and the car snaps. A round-8 car posted
+ * 4.38 s 0-100 in the instrument and hit the arena wall 3 runs out of 3 on a live keyboard launch.
+ *
+ * Two measurements, both in the served runtime (Rapier, land solver v2, 60 Hz):
+ *
+ *   1. THE RUN. A full-throttle launch from rest exactly as the live drive ability sends it: auto-hold brake released,
+ *      throttle 0 → 1 in one tick, automatic shifts. Steering is a keyboard PLAYER: every 100 ms it looks at what it saw
+ *      100 ms ago (reaction time), decides a correction from the heading error to the lane (with a 30 m look-ahead on
+ *      the lateral offset) plus the yaw rate, and taps A or D for a fraction of the next 100 ms. While a steer key is
+ *      down the platform's keyboard `move` vector is normalised (`InputService`: |(x, y)| ≤ 1), so W+A sends throttle
+ *      0.707 and steer −0.707 — modelled here exactly. The car starts 2° off its lane, so the player has to steer.
+ *      Reported: keyboard 0-100 against the instrument's, wheelspin (driven slip ratio > 0.2) time and peak slip per
+ *      gear, and for 1.5 s after each upshift re-engages the peak yaw rate, heading error and sideslip; the worst
+ *      heading error, sideslip and lane offset of the whole run.
+ *   2. THE PROBE. The same launch HANDS OFF (steer 0), with a 0.2 rad/s yaw-rate nudge — less than one short keyboard
+ *      tap — at 20, 40, 60 and 100 km/h and at the moment each of the first two upshifts re-engages, each in a fresh
+ *      run, both directions. A drivable car damps it: the yaw rate decays and the sideslip stays small. A car that is
+ *      unstable under power amplifies it into a spin; the player then has to catch every disturbance within a few
+ *      tenths of a second, which a keyboard cannot do reliably.
+ *
+ * VERDICT.
+ *   FAIL (not drivable on a keyboard): any probe spins (sideslip ≥ 20°, or the yaw rate grows to ≥ 3× the nudge), or the
+ *        run spins (sideslip or heading error ≥ 20°) or leaves its 3.5 m lane (centre more than 1.75 m off).
+ *   WARN: the run needs big corrections (heading error or sideslip > 0.1 rad ≈ 5.7°); a probe does not settle (yaw rate
+ *        still > half the nudge after 1 s, or sideslip > 0.1 rad); or the keyboard 0-100 is > 15 % slower than the
+ *        instrument's (or never reached).
+ */
+type Json = Record<string, unknown>;
+type Engine = Record<string, any>;
+export declare const KEYBOARD_LAUNCH: {
+    /** Player: decisions every this many ticks (100 ms), each on what it saw this many ticks earlier (100 ms reaction). */
+    readonly decisionTicks: 6;
+    readonly reactionTicks: 6;
+    /** The car starts this far off its lane heading, so the player has to steer from the first moment. */
+    readonly misalignDeg: 2;
+    /** Lateral offset → heading demand: aim at the lane centre this far ahead. */
+    readonly lookAheadM: 30;
+    /** Correction u = kp·heading + kd·yawRate, as a fraction of a 100 ms tap; |u| below the deadband is "leave it". */
+    readonly kp: 3;
+    readonly kd: 0.6;
+    readonly deadband: 0.08;
+    /** Half a 3.5 m lane. */
+    readonly laneHalfM: 1.75;
+    /** Probe nudge, rad/s of yaw rate — about a third of what one short keyboard tap commands at 80 km/h. */
+    readonly nudgeRadS: 0.2;
+    readonly probeKph: readonly number[];
+    readonly probeUpshifts: 2;
+    readonly probeWatchS: 2.5;
+    readonly spinSideslipRad: 0.35;
+    readonly spinYawGain: 3;
+    readonly marginalRad: 0.1;
+    readonly unsettledFraction: 0.5;
+    readonly wheelspinSlip: 0.2;
+    readonly gapWarn: 0.15;
+    readonly postShiftS: 1.5;
+    readonly endKph: 160;
+    readonly maxS: 20;
+};
+export type Verdict = 'PASS' | 'WARN' | 'FAIL';
+export interface GearSpin {
+    gear: number;
+    seconds: number;
+    wheelspinS: number;
+    peakSlip: number;
+}
+export interface PostShift {
+    from: number;
+    to: number;
+    kph: number;
+    atS: number;
+    peakYawRateRadS: number;
+    peakHeadingRad: number;
+    peakSideslipRad: number;
+    peakSlip: number;
+}
+export interface ProbeResult {
+    at: string;
+    kph: number;
+    gear: number;
+    slipAtNudge: number;
+    direction: 1 | -1;
+    peakYawRateRadS: number;
+    peakSideslipRad: number;
+    yawRateAfter1sRadS: number;
+    outcome: 'settles' | 'unsettled' | 'spins';
+}
+export interface KeyboardLaunchReport {
+    verdict: Verdict;
+    /** One line per reason, FAIL reasons first. */
+    reasons: string[];
+    run: {
+        zeroToHundredKphS: number | null;
+        instrumentZeroToHundredKphS: number | null;
+        /** keyboard − instrument, s and fraction of the instrument figure. */
+        gapS: number | null;
+        gapFraction: number | null;
+        maxHeadingRad: number;
+        maxSideslipRad: number;
+        maxLaneOffsetM: number;
+        maxYawRateRadS: number;
+        spun: boolean;
+        endKph: number;
+        endS: number;
+        /** Seconds the car's traction control was cutting torque; null when the car has none (or the runtime predates it). */
+        tractionControlS?: number | null;
+        gears: GearSpin[];
+        upshifts: PostShift[];
+    };
+    probe: ProbeResult[];
+    player: typeof KEYBOARD_LAUNCH;
+}
+/** The keyboard composite: W held, A/D as a tap; normalised like `InputService` normalises `move`. */
+export declare function keyboardInput(steerKey: -1 | 0 | 1): {
+    throttle: number;
+    steer: number;
+};
+/** The player's tap for the next decision window: [ticks held, direction]. */
+export declare function playerTap(headingRad: number, lateralM: number, yawRateRadS: number, p?: {
+    /** Player: decisions every this many ticks (100 ms), each on what it saw this many ticks earlier (100 ms reaction). */
+    readonly decisionTicks: 6;
+    readonly reactionTicks: 6;
+    /** The car starts this far off its lane heading, so the player has to steer from the first moment. */
+    readonly misalignDeg: 2;
+    /** Lateral offset → heading demand: aim at the lane centre this far ahead. */
+    readonly lookAheadM: 30;
+    /** Correction u = kp·heading + kd·yawRate, as a fraction of a 100 ms tap; |u| below the deadband is "leave it". */
+    readonly kp: 3;
+    readonly kd: 0.6;
+    readonly deadband: 0.08;
+    /** Half a 3.5 m lane. */
+    readonly laneHalfM: 1.75;
+    /** Probe nudge, rad/s of yaw rate — about a third of what one short keyboard tap commands at 80 km/h. */
+    readonly nudgeRadS: 0.2;
+    readonly probeKph: readonly number[];
+    readonly probeUpshifts: 2;
+    readonly probeWatchS: 2.5;
+    readonly spinSideslipRad: 0.35;
+    readonly spinYawGain: 3;
+    readonly marginalRad: 0.1;
+    readonly unsettledFraction: 0.5;
+    readonly wheelspinSlip: 0.2;
+    readonly gapWarn: 0.15;
+    readonly postShiftS: 1.5;
+    readonly endKph: 160;
+    readonly maxS: 20;
+}): {
+    ticks: number;
+    dir: -1 | 0 | 1;
+};
+/** Run the keyboard launch and the hands-off probe and judge them. Needs the real runtime (Rapier). */
+export declare function measureKeyboardLaunch(hc: Engine, tuning: Json, instrumentZeroToHundredKphS: number | null, p?: {
+    /** Player: decisions every this many ticks (100 ms), each on what it saw this many ticks earlier (100 ms reaction). */
+    readonly decisionTicks: 6;
+    readonly reactionTicks: 6;
+    /** The car starts this far off its lane heading, so the player has to steer from the first moment. */
+    readonly misalignDeg: 2;
+    /** Lateral offset → heading demand: aim at the lane centre this far ahead. */
+    readonly lookAheadM: 30;
+    /** Correction u = kp·heading + kd·yawRate, as a fraction of a 100 ms tap; |u| below the deadband is "leave it". */
+    readonly kp: 3;
+    readonly kd: 0.6;
+    readonly deadband: 0.08;
+    /** Half a 3.5 m lane. */
+    readonly laneHalfM: 1.75;
+    /** Probe nudge, rad/s of yaw rate — about a third of what one short keyboard tap commands at 80 km/h. */
+    readonly nudgeRadS: 0.2;
+    readonly probeKph: readonly number[];
+    readonly probeUpshifts: 2;
+    readonly probeWatchS: 2.5;
+    readonly spinSideslipRad: 0.35;
+    readonly spinYawGain: 3;
+    readonly marginalRad: 0.1;
+    readonly unsettledFraction: 0.5;
+    readonly wheelspinSlip: 0.2;
+    readonly gapWarn: 0.15;
+    readonly postShiftS: 1.5;
+    readonly endKph: 160;
+    readonly maxS: 20;
+}): Promise<KeyboardLaunchReport>;
+/** Human-readable block for `formatSimulationReport`. */
+export declare function formatKeyboardLaunch(k: KeyboardLaunchReport): string[];
+export {};