@melite/models-h3 0.1.5-pre-alpha → 0.2.0-alpha

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/README.md CHANGED
@@ -15,7 +15,7 @@ Beyond the package entry, the manifest exports `./mods/loras` (the flavor rows),
15
15
 
16
16
  ## Declaration
17
17
 
18
- `src/index.ts` declares the DECL and the `family-h3` plugin; the subpath modules above are the family's published seams for the card, the flow, and the agents that read them.
18
+ `src/index.ts` declares the DECL and the `family-h3` plugin; the subpath modules above are the family's published seams for the card, the flow, and the agents that read them. The timeline lane serves a three-member quant offer (the 2026-10-26 quant cure: "the system needs ALL THREE"): `int8` (the smhfacct hybrid default), `int8_convrot_pruned` (the Comfy-Org pruned ConvRot dit, already provisioned), and `int8_convrot` (the 34 GB non-pruned tier, a per-cell artifact) — beside the community Singularity fine-tune at `int8_pruned` (pruned int8, convrot unstated upstream; a per-variant `lane_inputs.unet` override, pick-only, with the first+last-frame audition and the VRAM peaks owed to the bench experiments).
19
19
 
20
20
  ## Model Experience
21
21
 
package/lib/actions.d.ts CHANGED
@@ -1,5 +1,64 @@
1
1
  import type { OutputHandle } from '@melite/comfyui-card-kit/graph';
2
+ import { GraphBuilder } from '@melite/comfyui-card-kit/graph';
2
3
  import type { ComfyActionSpec } from '@melite/comfyui-card-kit';
4
+
5
+ export declare const H3_DEFAULT_LORA_ID = "h3_lightx2v_turbo";
6
+ /** The absent-bag default as a RESOLVED ROW — the same catalog row the
7
+ * compose default builds, exposed so the card can serve it as the
8
+ * ghost chip: the face then shows the adapter the film will actually
9
+ * run instead of an empty bag. One owner: the catalog. */
10
+ export declare const h3DefaultLoraEntry: () => {
11
+ id: string;
12
+ strength: number;
13
+ steps: number;
14
+ };
15
+
16
+
17
+
18
+
19
+
20
+
21
+
22
+ export declare function h3LoraStackOf(p: Record<string, unknown>): string;
23
+ /** THE MARRIED SHIFT'S ONE OWNER (same law as the lora plane): the
24
+ * sigma-shift grid the doc's lora plane owns — a pinned shift is the
25
+ * user's word, an unstated one marries the bag's highest-count row
26
+ * (marriedBagKnob), else the doc's own row. Both renderers read this.
27
+ * @param p the walked doc params */
28
+ export declare function h3ShiftVideoOf(p: Record<string, unknown>): number;
29
+
30
+
31
+
32
+
33
+
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+ export declare const LANE_FILES: {
42
+ readonly clip: "qwen3vl_32b_minimax_h3_int8_convrot.safetensors";
43
+ readonly vae_video: "minimax_h3_video_vae_int8_convrot.safetensors";
44
+ readonly vae_audio: "minimax_h3_audio_vae_fp32.safetensors";
45
+ readonly sr_vae: "ema_vae_fp16.safetensors";
46
+ };
47
+
48
+
49
+
50
+
51
+
52
+
53
+ export declare const FILM_AUDIO_RATE = 48000;
54
+ /** THE JOIN-RATE DOOR: one spelling for every audio leg that feeds a
55
+ * join's CreateVideo — the leg passes MeliteAudioResample at
56
+ * FILM_AUDIO_RATE (engine-core bandlimited sinc; equal-rate input
57
+ * passes the SAME dict through, so a leg already at the film rate
58
+ * pays nothing but the stated law).
59
+ * @param g the run's graph builder
60
+ * @param audio the leg's AUDIO output handle */
61
+ export declare function filmJoinAudio(g: GraphBuilder, audio: OutputHandle): OutputHandle;
3
62
  /** The h3 facts door: the resolved lane_inputs parsed into the
4
63
  * loader names the renderers read (the unet from the row; the
5
64
  * three invariants from the package's own LANE_FILES).
@@ -17,23 +76,38 @@ export declare function parseH3Facts(raw: unknown): H3Facts;
17
76
  * Exported so the card's single-call lift judges through the same
18
77
  * re-check (the h3-b duplicate is gone: one owner). */
19
78
  export declare const assertOverlayGated: (doc: Record<string, unknown>, where: string) => void;
20
- export interface WindowHandles {
21
- latOut: OutputHandle;
22
- vdec: OutputHandle;
23
- vadec: OutputHandle;
24
- /** the DELIVERED clip — post-trim, post-sharpen: exactly the
25
- * streams that window's own SaveVideo plays; the film concat's
26
- * currency (the film must not differ from its windows). */
27
- filmImages: OutputHandle;
28
- filmAudio: OutputHandle;
29
- /** the window's SaveVideo VIDEO passthrough — the film tail's
30
- * ordering wire: the MeliteUnload boundary consumes it, so the
31
- * file loaders provably wait for the saves (and the passthrough
32
- * tensor dies at the boundary — the §20 law). Assigned by BOTH
33
- * family arms (every family path saves); the film tail refuses
34
- * loud if a future arm forgets. */
35
- savePassthrough?: OutputHandle;
36
- }
79
+
80
+
81
+
82
+
83
+
84
+
85
+
86
+
87
+
88
+
89
+
90
+ export declare function chainSaveBoundaries(g: GraphBuilder, saves: readonly OutputHandle[]): OutputHandle;
91
+ /** THE FILE-JOIN PRIMITIVE, half 2 — the concat + container (the
92
+ * film tail's own law, ONE spelling for every join-by-file seat):
93
+ * MeliteConcatVideos decodes the saved FILES back CPU-side strictly
94
+ * after the boundary token; CreateVideo → SaveVideo delivers the
95
+ * joined film.
96
+ * @param g the run's graph builder
97
+ * @param prefixes the members' SaveVideo prefixes, film order
98
+ * @param after the boundary chain's final token (the ordering proof)
99
+ * @param out the joined film's filename_prefix
100
+ * @param opts.audio an audio override for the container mux (the
101
+ * film's mixed stem); absent = the concat's own decoded audio
102
+ * @param opts.append an exact saved-file path wired as the LAST
103
+ * member after the prefix list (the multi-window extend's assembled
104
+ * extension — ChainAssemble's video_path output; DAG-proven by its
105
+ * own data dependency, no boundary needed)
106
+ * @returns the joined film's SaveVideo passthrough */
107
+ export declare function concatSavedFilms(g: GraphBuilder, prefixes: readonly string[], after: OutputHandle, out: string, opts?: {
108
+ audio?: OutputHandle;
109
+ append?: OutputHandle;
110
+ }): OutputHandle;
37
111
  /** The seam's cross-window wires: the RAW decode + sampler handles
38
112
  * of one rendered window (pre-trim, pre-sharpen — the true tail). */
39
113
  export interface WindowHandles {