rea/src/domain/javascript/javascriptSemanticAnalysis....

406 lines
14 KiB
TypeScript

import { describe, expect, it } from "vitest";
import { analyzeJavaScriptSemantics } from "./javascriptSemanticAnalysis.js";
import { onlyCallable } from "./javascriptSemanticAnalysis.fixture.js";
const resultValue = (body: string) =>
onlyCallable(
analyzeJavaScriptSemantics(`export function result() { ${body} }`),
"result",
).returnSites[0]?.value;
describe("reference lifetimes across calls and shallow copies", () => {
it("bounds dynamic destructuring across shared alias branches", () => {
const declarations = Array.from(
{ length: 9 },
(_, index) =>
`const alias${index + 1} = { left: alias${index}, right: alias${index} };`,
).join("\n");
const pattern = "{ [key]: ".repeat(9) + "[copy]" + " }".repeat(9);
const start = performance.now();
resultValue(
`const alias0 = [1]; ${declarations} const ${pattern} = alias9; return alias0[0];`,
);
expect(performance.now() - start).toBeLessThan(2000);
}, 30000);
it("bounds conditional shallow-copy traversal while retaining shared children", () => {
const declarations = Array.from(
{ length: 20 },
(_, i) =>
`const alias${i + 1} = flag ? {...alias${i}, a${i}:{}} : {...alias${i}, b${i}:{}};`,
).join("\n");
const start = performance.now();
expect(
resultValue(
`const alias0 = { value: { token: 1 } }; ${declarations} consume(alias20); return alias0.value.token;`,
)?.status,
).toBe("unknown");
expect(performance.now() - start).toBeLessThan(2000);
}, 30000);
it.each([
["child: {}", "child: {}", "literal"],
["child: {}", "other: {}", "unknown"],
])(
"retains exclusions common to both branches: %s / %s",
(left, right, status) => {
expect(
resultValue(
`const source = {child:{value:1}}; const copy = flag ? {...source, ${left}} : {...source, ${right}}; consume(copy); return source.child.value;`,
)?.status,
).toBe(status);
},
);
it.each([
"mutate(alias)",
"alias.method()",
"new Factory(alias)",
"tag`${alias}`",
"alias.tag``",
"mutate((0, alias))",
])("drops replaced call origins for %s", (call) => {
expect(
resultValue(
`const source={value:1}; let alias=source; alias={}; ${call}; return source.value;`,
),
).toEqual({ status: "literal", value: 1 });
});
it.each([
"mutate(alias); alias={};",
"if(flag) alias={}; mutate(alias);",
"alias={}; if(flag) mutate(alias);",
"function invoke(){mutate(alias);} alias={}; invoke();",
"alias={}; mutate(alias); alias=source;",
])("retains uncertain call ordering: %s", (body) => {
expect(
resultValue(
`const source={value:1}; let alias=source; ${body} return source.value;`,
)?.status,
).toBe("unknown");
});
it.each([
["let {...copy}={child};", "copy={child:{}};", "copy.child.value=2;"],
["let [...copy]=[child];", "copy=[{}];", "copy[0].value=2;"],
["let {copy=child}={};", "copy={};", "copy.value=2;"],
["let [copy=child]=[];", "copy={};", "mutate(copy);"],
])(
"drops replaced rest/default origins: %s",
(declaration, rebind, mutation) => {
expect(
resultValue(
`const child={value:1}; ${declaration} ${rebind} ${mutation} return child.value;`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const child={value:1}; ${declaration} if(flag) ${rebind} ${mutation} return child.value;`,
)?.status,
).toBe("unknown");
},
);
});
describe("capture ordering within declarations and expressions", () => {
it.each([
"const ignored = mutate(source);",
"void mutate(source);",
"consume(mutate(source));",
])("preserves a primitive before a later nested call: %s", (escape) => {
expect(
resultValue(
`const source={value:1}; const snapshot=source.value; ${escape} return snapshot;`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const source={value:1}; ${escape} const snapshot=source.value; return snapshot;`,
)?.status,
).toBe("unknown");
});
it("preserves a primitive before an awaited escape", () => {
const value = onlyCallable(
analyzeJavaScriptSemantics(`export async function result() {
const source={value:1}; const snapshot=source.value;
await mutate(source); return snapshot;
}`),
"result",
).returnSites[0]?.value;
expect(value).toEqual({ status: "literal", value: 1 });
});
it.each([
"({value:1} as {value:number})",
"({value:1} satisfies {value:number})",
"({value:1})!",
])("classifies transparent initializer wrappers: %s", (source) => {
expect(
resultValue(
`const source=${source}; const snapshot=source.value; mutate(source); return snapshot;`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const source=${source}; mutate(source); const snapshot=source.value; return snapshot;`,
)?.status,
).toBe("unknown");
});
it.each(["(source as {value:number})", "(source satisfies {value:number})"])(
"captures through a wrapped alias: %s",
(alias) => {
expect(
resultValue(
`const source={value:1}; const alias=${alias}; const snapshot=alias.value; mutate(alias); return snapshot;`,
),
).toEqual({ status: "literal", value: 1 });
},
);
it.each([
["{child:{}}", "{child:copy=fallback}"],
["[{}]", "[copy=fallback]"],
])("guards fallback selection before escape: %s", (source, pattern) => {
expect(
resultValue(
`const fallback={value:1}; const source=${source}; const ${pattern}=source; mutate(copy); return fallback.value;`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const fallback={value:1}; const source=${source}; mutate(source); const ${pattern}=source; mutate(copy); return fallback.value;`,
)?.status,
).toBe("unknown");
});
it.each([
"const source={value:1}, snapshot=source.value; mutate(source);",
"const source={value:1}, snapshot=source.value, ignored=mutate(source);",
])("preserves sequential declarator captures: %s", (body) => {
expect(resultValue(`${body} return snapshot;`)).toEqual({
status: "literal",
value: 1,
});
});
it("retains an escape in an earlier declarator", () => {
expect(
resultValue(
"const source={value:1}, ignored=mutate(source), snapshot=source.value; return snapshot;",
)?.status,
).toBe("unknown");
});
});
describe("primitive snapshots across calls", () => {
it.each([
"const [copy] = source;",
"const copy = [...source];",
"for (const copy of source) {}",
])("preserves snapshots taken before custom iteration: %s", (iteration) => {
expect(
resultValue(`
const source = { *[Symbol.iterator]() { yield this; }, value: 1 };
const snapshot = source.value;
${iteration}
return snapshot;
`),
).toEqual({ status: "literal", value: 1 });
});
it.each([
"const [copy] = alias;",
"const copy = [...alias];",
"for (const copy of alias) {}",
])("ignores iterable aliases replaced before %s", (iteration) => {
expect(
resultValue(`
const source = { *[Symbol.iterator]() { yield this; }, value: 1 };
let alias = source;
alias = [];
${iteration}
return source.value;
`),
).toEqual({ status: "literal", value: 1 });
});
it.each([
["const snapshot=source.value;", "snapshot"],
["const {value:snapshot}=source;", "snapshot"],
["const copy={value:source.value};", "copy.value"],
['const copy={["snapshot"]:source.value};', "copy.snapshot"],
['const copy={[""]:source.value};', 'copy[""]'],
["const copy={[0]:source.value};", "copy[0]"],
['const copy={[("snapshot" as string)]:source.value};', "copy.snapshot"],
["const copy=[source.value];", "copy[0]"],
])("preserves primitive capture before escape: %s", (capture, result) => {
expect(
resultValue(
`const source={value:1}; ${capture} mutate(source); return ${result};`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const source={value:1}; mutate(source); ${capture} return ${result};`,
)?.status,
).toBe("unknown");
});
it.each([
["const copy={value:source.value};", "copy.value"],
["const copy=[source.value];", "copy[0]"],
])(
"retains a literal field's earlier primitive capture: %s",
(copy, read) => {
expect(
resultValue(
`const source={value:1}; ${copy} mutate(source); const snapshot=${read}; mutate(copy); return snapshot;`,
),
).toEqual({ status: "literal", value: 1 });
expect(
resultValue(
`const source={value:1}; mutate(source); ${copy} const snapshot=${read}; mutate(copy); return snapshot;`,
)?.status,
).toBe("unknown");
},
);
it.each([
["const copy={child:source.child};", "copy.child"],
["const copy=[source.child];", "copy[0]"],
])(
"keeps a shared child uncertain across both capture points: %s",
(copy, read) => {
expect(
resultValue(
`const source={child:{value:1}}; ${copy} mutate(source); const snapshot=${read}; mutate(copy); return snapshot.value;`,
)?.status,
).toBe("unknown");
},
);
it.each([
"const alias=source; const snapshot=alias.value; mutate(alias); return snapshot;",
"const alias=source.child; const snapshot=alias.value; mutate(alias); return snapshot;",
])("captures through an earlier intermediate reference: %s", (body) => {
expect(
resultValue(`const source={value:1,child:{value:1}}; ${body}`),
).toEqual({ status: "literal", value: 1 });
});
it("does not read a later alias initializer at an earlier capture point", () => {
expect(
resultValue(
"const source={value:1}; var alias; const snapshot=alias?.value; mutate(source); alias=source; return snapshot;",
)?.status,
).toBe("unknown");
});
it("does not treat a persistent child as freshly allocated with its wrapper", () => {
const ir = analyzeJavaScriptSemantics(
"const child={value:1}; export function result(){const source={child}; const alias=source.child; const snapshot=alias.value; mutate(alias); return snapshot;}",
);
expect(onlyCallable(ir, "result").returnSites[0]?.value.status).toBe(
"unknown",
);
});
it("keeps persistent sources uncertain across function activations", () => {
const ir = analyzeJavaScriptSemantics(
"const source={value:1}; export function result(){const snapshot=source.value; mutate(source); return snapshot;}",
);
expect(onlyCallable(ir, "result").returnSites[0]?.value.status).toBe(
"unknown",
);
});
it("keeps reads from earlier loop iterations uncertain", () => {
expect(
resultValue(
"const source={value:1}; for(let i=0;i<2;i++){const snapshot=source.value; mutate(source); if(i===1)return snapshot;}",
)?.status,
).toBe("unknown");
});
it.each([
"const copy={child:source.child}; return copy.child.value;",
"const copy=source.child; return copy.value;",
"const copy=[source.child]; return copy[0].value;",
])("keeps shared children live: %s", (body) => {
expect(
resultValue(
`const source={child:{value:1}}; ${body.replace("return", "mutate(source); return")}`,
)?.status,
).toBe("unknown");
});
});
describe("references captured before an intermediate rebind", () => {
it.each([
["const saved=alias;", "alias=saved;", "mutate(alias);"],
["const saved=alias;", "alias=saved;", "alias.value=9;"],
["const saved={child:alias};", "alias=saved.child;", "mutate(alias);"],
["const {...saved}={child:alias};", "alias=saved.child;", "mutate(alias);"],
["const [...saved]=[alias];", "alias=saved[0];", "mutate(alias);"],
["const {saved=alias}={};", "alias=saved;", "mutate(alias);"],
])("follows an alias restored from %s", (capture, restore, effect) => {
expect(
resultValue(
`const source={value:1}; let alias=source; ${capture} ${restore} ${effect} return source.value;`,
)?.status,
).toBe("unknown");
});
it.each([
["const saved=alias;", "mutate(saved);"],
["const saved={child:alias};", "mutate(saved.child);"],
["const {...saved}={child:alias};", "mutate(saved.child);"],
["const [...saved]=[alias];", "mutate(saved[0]);"],
["const {saved=alias}={};", "mutate(saved);"],
["const [saved=alias]=[];", "mutate(saved);"],
["const saved=alias;", "saved.method();"],
["const saved=alias;", "mutate(alias,saved);"],
["const saved=alias;", "mutate(saved,alias);"],
])("preserves the original reference captured by %s", (capture, effect) => {
expect(
resultValue(
`const source={value:1}; let alias=source; ${capture} alias={}; ${effect} return source.value;`,
)?.status,
).toBe("unknown");
expect(
resultValue(
`const source={value:1}; let alias=source; alias={}; ${capture} ${effect} return source.value;`,
),
).toEqual({ status: "literal", value: 1 });
});
it.each([
[
"let {...alias}={child:source};",
"alias={child:{}};",
"saved.child.value=9;",
],
["let [...alias]=[source];", "alias=[{}];", "saved[0].value=9;"],
["let {alias=source}={};", "alias={};", "saved.value=9;"],
["let [alias=source]=[];", "alias={};", "saved.value=9;"],
])(
"preserves a saved rest/default reference from %s",
(declaration, rebind, effect) => {
expect(
resultValue(
`const source={value:1}; ${declaration} const saved=alias; ${rebind} ${effect} return source.value;`,
)?.status,
).toBe("unknown");
expect(
resultValue(
`const source={value:1}; ${declaration} ${rebind} const saved=alias; ${effect} return source.value;`,
),
).toEqual({ status: "literal", value: 1 });
},
);
});