@octanejs/tanstack-pacer 0.0.31 → 0.0.32
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/{LICENSE → LICENSE.upstream} +1 -1
- package/UPSTREAM.md +56 -0
- package/package.json +8 -6
package/UPSTREAM.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# TanStack React Pacer upstream ledger
|
|
2
|
+
|
|
3
|
+
`@octanejs/tanstack-pacer` targets `@tanstack/react-pacer@0.22.1` from
|
|
4
|
+
`https://github.com/TanStack/pacer.git`.
|
|
5
|
+
|
|
6
|
+
## Immutable pin
|
|
7
|
+
|
|
8
|
+
- Tag: `@tanstack/react-pacer@0.22.1`
|
|
9
|
+
- Resolved commit: `a894009100aeb373965d4121eb92a1af634af012`
|
|
10
|
+
- npm archive SHA-256: `d4055dcec785b5eac078a2c2acde90b80e84e70c0262a174a5065ed92a9be2f0`
|
|
11
|
+
- npm lock integrity: `sha512-CenQqK0GluSPIrnsG1yuD7w5uMSQ/4lI9AcGEFxBrRd66r260boWcYRIsS5+eHtXb238FoZYhKmJPGlhRzmHRw==`
|
|
12
|
+
- Supported range: exactly `0.22.1`
|
|
13
|
+
- License: MIT
|
|
14
|
+
- React oracle: exact `react@19.2.7`, `react-dom@19.2.7`, `@types/react@19.2.17`, and `@types/react-dom@19.2.3` via the `tanstack-pacer-react-oracle` catalog
|
|
15
|
+
- Framework-neutral core: exact `@tanstack/pacer@0.21.1`, reused by both adapters
|
|
16
|
+
|
|
17
|
+
## Source, exports, and suites
|
|
18
|
+
|
|
19
|
+
The byte-exact tagged adapter directory is vendored under `upstream/`; all 51 files verify
|
|
20
|
+
offline against the upstream git blob shas recorded in `audit/upstream.lock.json`, and the
|
|
21
|
+
pinned root license is republished at the package root as `LICENSE.upstream`, hash-matched
|
|
22
|
+
to the lock's license evidence. The tagged package contains no
|
|
23
|
+
runtime test, fixture, or snapshot artifacts. Upstream's `test:types` script compiles package source
|
|
24
|
+
with `tsc` and has no dedicated type-assertion files, so suite presence is `insufficient` while
|
|
25
|
+
compile lanes still run.
|
|
26
|
+
|
|
27
|
+
`audit/upstream-crosswalk.json` accounts for all 16 published entrypoints and every adapter
|
|
28
|
+
value/type export plus each core `export *` re-export, with a disposition and evidence pointer per
|
|
29
|
+
row. The binding reuses the exact framework-neutral core. With absent upstream runtime tests,
|
|
30
|
+
provenance is `recorded-unverified`: a repo-authored adapted-octane suite plus a React/Octane differential cover a representative scheduler lifecycle, while nearly every export remains `surface-present-unverified`.
|
|
31
|
+
|
|
32
|
+
## Type lanes
|
|
33
|
+
|
|
34
|
+
- Pristine: `typetests/pristine` runs `tsc` over the vendored React adapter source (upstream
|
|
35
|
+
`test:types`) with pinned React types. Inventory: `audit/upstream-types.json`.
|
|
36
|
+
- Adapted: `typetests/adapted` compiles the complete Octane adapter source through
|
|
37
|
+
`tsrx-tsc` (one-for-one with upstream `test:types`). Inventory:
|
|
38
|
+
`audit/adapted-types.json`. Permitted transforms (structurally enforced):
|
|
39
|
+
`typetests/assertions.md`.
|
|
40
|
+
- Ordinary Octane-only: `typetests/octane-only/setter-types.test-d.ts` holds
|
|
41
|
+
accept/reject evidence for local `Dispatch` / `SetStateAction` aliases outside
|
|
42
|
+
required React-parity ownership (no pristine React assertion counterpart). Root
|
|
43
|
+
`bindings:typecheck` runs `typetests/octane-only/tsconfig.json` so this evidence
|
|
44
|
+
executes in the always-on ordinary typecheck control plane.
|
|
45
|
+
|
|
46
|
+
## Executable evidence
|
|
47
|
+
|
|
48
|
+
A repo-authored adapted-octane Vitest suite covers the Octane scheduler lifecycle (debounce,
|
|
49
|
+
throttle, batching, and teardown cancellation). A paired differential runs the same compiled
|
|
50
|
+
fixture against the Octane and React adapters under Vitest fake timers, advancing the exact waits
|
|
51
|
+
and asserting intermediate observable DOM. `tests/pacer.test.ts` and
|
|
52
|
+
`tests/parity/contracts.test.ts` remain Octane-only contracts and are not counted as React parity.
|
|
53
|
+
|
|
54
|
+
This representative scheduler lifecycle does not exhaustively prove every sync/async hook family,
|
|
55
|
+
provider, render-prop subscription, state/value helper, or option combination; those remain
|
|
56
|
+
surface-present via the crosswalk without additional runtime cases.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@octanejs/tanstack-pacer",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.32",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|
|
@@ -24,7 +24,9 @@
|
|
|
24
24
|
"types": "src/index.ts",
|
|
25
25
|
"files": [
|
|
26
26
|
"src",
|
|
27
|
-
"
|
|
27
|
+
"LICENSE.upstream",
|
|
28
|
+
"README.md",
|
|
29
|
+
"UPSTREAM.md"
|
|
28
30
|
],
|
|
29
31
|
"exports": {
|
|
30
32
|
".": "./src/index.ts",
|
|
@@ -47,8 +49,8 @@
|
|
|
47
49
|
"@tanstack/pacer": "0.21.1"
|
|
48
50
|
},
|
|
49
51
|
"peerDependencies": {
|
|
50
|
-
"@octanejs/tanstack-store": "0.0.
|
|
51
|
-
"octane": "0.1.
|
|
52
|
+
"@octanejs/tanstack-store": "0.0.37",
|
|
53
|
+
"octane": "0.1.43"
|
|
52
54
|
},
|
|
53
55
|
"devDependencies": {
|
|
54
56
|
"@tanstack/react-pacer": "0.22.1",
|
|
@@ -60,8 +62,8 @@
|
|
|
60
62
|
"react": "19.2.7",
|
|
61
63
|
"react-dom": "19.2.7",
|
|
62
64
|
"vitest": "^4.1.10",
|
|
63
|
-
"@octanejs/tanstack-store": "0.0.
|
|
64
|
-
"octane": "0.1.
|
|
65
|
+
"@octanejs/tanstack-store": "0.0.37",
|
|
66
|
+
"octane": "0.1.43"
|
|
65
67
|
},
|
|
66
68
|
"scripts": {
|
|
67
69
|
"test": "vitest run --project tanstack-pacer",
|