universal-physics-tensor 0.47.1 → 1.0.2

package/dist/atlas/physjs-ref.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Reviewed `formalRef`s keyed by the vendored PhysJS bridge manifest.
+ *
+ * The manifest file is `formal/physjs/manifest.json` (PhysJS `manifest/bridges.json`
+ * at the commit below). This module is the copy the library ships: `src/` cannot
+ * import a file outside its root. `tests/atlas/physjs-manifest.test.ts` fails when
+ * the file and this copy disagree on the commit, a theorem, a key, or the
+ * coverage phrase.
+ *
+ * The commit is PhysJS `main` `c6958650f0be66b21f5cc3992d5474bf97ad5094`.
+ * Milestone 1's six top-level theorems are unchanged. Milestone 2 adds four
+ * atlas entries. Milestone 2b adds fifteen catalog entries. Bucket A adds
+ * twenty-one counted catalog entries, keyed `be-<n>`. BE-20 is the nested
+ * `corollary` on `be-13` and has no key. A counted covers line begins with
+ * `reduction`, `limit`, or `derivation-step`. A labeled covers line begins
+ * with `property` or `cross-check`. A nested object (`planeWave`, `oneLoop`,
+ * `inversion`, `vacuum`, `corollary`, `friedmann`, `lengthMonomial`,
+ * `torsionMonomial`, `coefficientNotFixed`, `unitCoefficient`, `scalingShape`,
+ * `everyPower`) is recorded and is not a `formalRef`.
+ *
+ * @module atlas/physjs-ref
+ */
+import type { FormalRef, FormalRefKind } from './types.js';
+/** PhysJS commit the vendored manifest records. @internal */
+export declare const PHYSJS_COMMIT = "c6958650f0be66b21f5cc3992d5474bf97ad5094";
+/** A second statement on the same entry. No key. Not a `formalRef`. */
+interface PhysjsNestedStatement {
+    readonly theorem: string;
+    readonly covers: string;
+    readonly coverage: string;
+    readonly leanProof: string;
+    readonly axioms: readonly string[];
+}
+/** One manifest entry, reduced to the fields a `formalRef` is built from. */
+interface PhysjsEntry {
+    readonly key: string;
+    readonly bridgeId: string;
+    readonly theorem: string;
+    /** What the top-level theorem certifies. The pendulum entry is not `bound.delta`. */
+    readonly covers: string;
+    readonly coverage: string;
+    readonly leanProof: string;
+    readonly axioms: readonly string[];
+    readonly imports?: string;
+    /** Present on the five rank-1 entries. Absent elsewhere. Not a `formalRef`. */
+    readonly planeWave?: PhysjsNestedStatement;
+    /** BE-53. The running solution. Not the reference. */
+    readonly oneLoop?: PhysjsNestedStatement;
+    /** BE-38. The μ inversion. Not the reference. */
+    readonly inversion?: PhysjsNestedStatement;
+    /** BE-13. The BE-20 vacuum density. Not a reference, and not a `be-20` key. */
+    readonly vacuum?: PhysjsNestedStatement;
+    /** BE-13. The Friedmann corollary of that density. Not a reference, and not a `be-20` key. */
+    readonly corollary?: PhysjsNestedStatement;
+    /** BE-54. The flat Friedmann identification. Not the reference. */
+    readonly friedmann?: PhysjsNestedStatement;
+    /**
+     * BE-15. L = C (Γ t)^{1/z} under dimensional homogeneity with [Γ] = L^z T⁻¹.
+     * C is not fixed, and z = 2 is not derived. Not the reference.
+     */
+    readonly lengthMonomial?: PhysjsNestedStatement;
+    /** BE-17. T = C κ S from dimensions. C is not fixed. Not the reference. */
+    readonly torsionMonomial?: PhysjsNestedStatement;
+    /** BE-17. A factor other than 1 is not the catalog coefficient. Not the reference. */
+    readonly coefficientNotFixed?: PhysjsNestedStatement;
+    /** BE-17. Inversion under the hypothesis C = 1. Not the reference. */
+    readonly unitCoefficient?: PhysjsNestedStatement;
+    /** BE-33. ξ = ξ₀ φ(T/T₀). φ is not fixed. Not the reference. */
+    readonly scalingShape?: PhysjsNestedStatement;
+    /** BE-33. Every real power of the temperature ratio is homogeneous. The exponent is not chosen. Not the reference. */
+    readonly everyPower?: PhysjsNestedStatement;
+}
+/** The vendored manifest, as this module compares it. @internal */
+export interface PhysjsManifestFile {
+    readonly schema: string;
+    readonly commit: string;
+    readonly toolchain: string;
+    readonly mathlib: string;
+    readonly physlib: string;
+    readonly entries: readonly PhysjsEntry[];
+}
+/**
+ * Theorem name on the compiled manifest copy for `key`.
+ *
+ * This reads the compiled table. It does not build a formal reference
+ * and it does not derive an evidence tag.
+ *
+ * @internal
+ */
+export declare function physjsTheorem(key: string): string | undefined;
+/**
+ * Manifest keys whose derived kind is `bridge`.
+ *
+ * An `ab-` key is a bridge. A catalog key is a bridge when `formalRefKind`
+ * says the theorem states the catalogued equation. A canonical id uses that
+ * same function: it is a seed when this table, or a caller-supplied overlay
+ * entry, has derived kind `bridge`. A textbook covers word is not a seed.
+ * One function, so a second list cannot drift.
+ *
+ * `kind`, when supplied, is that derived kind for an overlay reference the
+ * compiled table does not carry. The live call omits it. The return value
+ * is not stored on a bridge.
+ *
+ * @internal
+ */
+export declare function bridgeSeedKeys(entries?: readonly {
+    readonly key: string;
+    readonly covers: string;
+    readonly kind?: FormalRefKind;
+}[]): readonly string[];
+/**
+ * The reviewed reference for a manifest key. Throws when the key is not an
+ * entry, so a typo cannot ship a bridge with no reference.
+ *
+ * @internal
+ */
+export declare function physjsFormalRef(key: string): FormalRef;
+/**
+ * Problems in the vendored manifest against the bridges that claim to be keyed
+ * by it. Empty means every entry resolves to a `lean4-physjs` reference whose
+ * theorem, axioms, commit and coverage phrase are the entry's own.
+ *
+ * A wrong commit, theorem, key or coverage phrase is a problem. A manifest
+ * entry with no bridge is a problem. A `lean4-physjs` reference with no entry
+ * is a problem: the gate does not skip that system. A nested object is kept
+ * and compared; naming it as the `formalRef` is a problem. The top-level
+ * theorem stays the reference. A catalog entry whose covers line is a
+ * `property` or a `cross-check` is a labeled reference: it resolves to a
+ * `formalRef`, and it is not a counted kind.
+ *
+ * @internal
+ */
+export declare function physjsManifestProblems(input: {
+    readonly manifest: PhysjsManifestFile;
+    readonly bridges: readonly {
+        readonly id: string;
+        readonly formalRef?: FormalRef;
+    }[];
+}): string[];
+export {};
+//# sourceMappingURL=physjs-ref.d.ts.map

package/dist/atlas/physjs-ref.d.ts.map

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