@glissade/cli 0.47.0-pre.0 → 0.47.0-pre.1

package/dist/describeLint.js

@@ -8,6 +8,174 @@ import { usageArity } from "@glissade/scene/describe";
 */
 const RUNTIME_TYPE_ALLOWLIST = /* @__PURE__ */ new Set([]);
 /**
+* PUBLIC runtime exports that are intentionally NOT authoring surface, so they need
+* not appear in describe().surface — the curated exempt-list that makes the
+* BIDIRECTIONAL "no-MISSING" gate precise. Grouped by rationale. A NEW public export
+* that fits none of these (nor a pattern below) must be added to describe()'s surface
+* (authoring) OR here (internal), or `check:describe` fails — which is exactly how an
+* omission (a real authoring export absent from surface, red-lining valid no-build
+* code under the ambient .d.ts) is now caught instead of staying silently green.
+*/
+const EXEMPT_INTERNALS = new Set([
+	"Canvas2DBackend",
+	"Custom",
+	"Echo",
+	"FollowPath",
+	"GsPlayerElement",
+	"Highlight",
+	"ImageNode",
+	"LookAt",
+	"MotionBlur",
+	"Node",
+	"OrientToPath",
+	"Raster2D",
+	"ShaderEffect",
+	"TextCursor",
+	"TrackMatte",
+	"ALL_FILTER_KINDS",
+	"DEFAULT_EASE",
+	"EXPR_CONSTANTS",
+	"EXPR_FUNCTIONS",
+	"IDENTITY",
+	"MEASURE_QUANTUM_PX",
+	"MESH_DOWNSCALE",
+	"MESH_SHEPARD_POWER",
+	"MESH_SIGMA",
+	"NODE_TAXONOMY",
+	"TARGET_PATH",
+	"easingDerivatives",
+	"estimatingMeasurer",
+	"springPresets",
+	"clockDriver",
+	"scrollDriver",
+	"createPlayhead",
+	"createDisplayListBuilder",
+	"getLayoutEngine",
+	"setLayoutEngine",
+	"requireLayoutEngine",
+	"loadYogaLayoutEngine",
+	"swapOnHmr",
+	"setScheduler",
+	"synchronousScheduler",
+	"setDefaultMeasurer",
+	"setDevWarning",
+	"defineGsPlayer",
+	"buildFontRegistry",
+	"setShaderRunner",
+	"bake",
+	"bakeCheckpointed",
+	"batch",
+	"beginReadPhase",
+	"endReadPhase",
+	"inReadPhase",
+	"bindScene",
+	"bindTimeline",
+	"buildTimeline",
+	"compileExpr",
+	"compileTimeline",
+	"computed",
+	"collapseReplacer",
+	"evaluateAt",
+	"getTimelineCallbacks",
+	"sampleTrack",
+	"validateTrack",
+	"withDeterminismGuards",
+	"untracked",
+	"revealSchedule",
+	"registerExamples",
+	"listComponents",
+	"isDurationEditable",
+	"isEditableNodeId",
+	"targetNodeId",
+	"resolveTweenTarget",
+	"drawOn",
+	"drawOnEach",
+	"__resetEstimateWarnings",
+	"applyToPoint",
+	"arcLength",
+	"assertFiniteFontSize",
+	"audioOffsetSamples",
+	"breakLines",
+	"childId",
+	"coercePathData",
+	"collectLocalizedTextUsages",
+	"collectTextUsages",
+	"cubicBezierDerivative",
+	"driftLoop",
+	"each",
+	"emitDevWarning",
+	"filtersToCanvasFilter",
+	"flatten",
+	"fontString",
+	"formatColor",
+	"fromTRS",
+	"hachureLines",
+	"invert",
+	"isEstimatingMeasurer",
+	"isExemptFamily",
+	"lerpColor",
+	"listValueTypes",
+	"matEquals",
+	"mediaPrefersReducedMotion",
+	"meshRasterSize",
+	"multiply",
+	"oklabToRgba",
+	"parseCmap",
+	"parseColor",
+	"parseSvgPathData",
+	"pathFromSegs",
+	"pathLength",
+	"planReducedMotion",
+	"pointAtLength",
+	"quantize",
+	"random",
+	"rasterizeMesh",
+	"reprOf",
+	"resolveAnchor",
+	"resolveEase",
+	"resolveEaseDerivative",
+	"resolveSketch",
+	"rgbaToOklab",
+	"roughen",
+	"roundedRectSegs",
+	"segmentGraphemes",
+	"segmentWords",
+	"sketchStrokes",
+	"springEasing",
+	"springEasingDerivative",
+	"textCursor",
+	"transitionToClip",
+	"usageArity",
+	"validateFilters",
+	"validateFonts",
+	"validateHachure",
+	"validateSceneFonts",
+	"validateSketch",
+	"vec2Equals",
+	"vec2Signal",
+	"velocityAt"
+]);
+/**
+* PATTERN-exempt runtime exports (no per-name entry needed): error classes
+* (`…Error`), the value-type registry + its accessors (`…Type`), and the ESM
+* `default` binding. Everything else must be surfaced or in {@link EXEMPT_INTERNALS}.
+*/
+function isExemptPattern(name) {
+	return name === "default" || /Error$/.test(name) || /Type$/.test(name);
+}
+/** Whether a public runtime export is intentionally NOT part of describe().surface. */
+function isExemptFromSurface(name) {
+	return isExemptPattern(name) || EXEMPT_INTERNALS.has(name);
+}
+/** Every name the manifest presents as authoring surface (surface entries + node/helper names). */
+function surfacedNames(manifest) {
+	const surfaced = /* @__PURE__ */ new Set();
+	for (const e of manifest.surface ?? []) surfaced.add(e.name);
+	for (const n of Object.keys(manifest.nodes)) surfaced.add(n);
+	for (const h of manifest.helpers) surfaced.add(h.name);
+	return surfaced;
+}
+/**
 * Reconcile a describe() manifest against a runtime surface record. Returns every
 * violation (empty = clean); the CLI prints them and exits non-zero.
 *
@@ -19,7 +187,12 @@ const RUNTIME_TYPE_ALLOWLIST = /* @__PURE__ */ new Set([]);
 *  (c) arity: a documented callable must not REQUIRE materially more positional
 *      args than its usage advertises (`Function.length > documented total + 1`;
 *      tolerant by one — a trailing optional like `measurer` legitimately lifts
-*      `Function.length`).
+*      `Function.length`);
+*  (d) NO-MISSING (the BIDIRECTIONAL half): every PUBLIC runtime export on the
+*      bundle must be SURFACED or explicitly exempt ({@link isExemptFromSurface}) —
+*      an omission (a real authoring export absent from surface, which red-lines
+*      valid no-build code under the ambient .d.ts) fails here. Without (d) the gate
+*      could only catch PHANTOMS, never OMISSIONS — the class it was scoped to gate.
 */
 function describeLint(manifest, surface, opts = {}) {
 	const exempt = opts.exempt ?? /* @__PURE__ */ new Set();
@@ -63,6 +236,15 @@ function describeLint(manifest, surface, opts = {}) {
 			detail: `window.glissade.${h.name} takes ${fn.length} params but its usage documents ${total} — update describe()'s usage or the signature`
 		});
 	}
+	const surfaced = surfacedNames(manifest);
+	for (const name of Object.keys(surface).sort()) {
+		if (surfaced.has(name) || exempt.has(name) || isExemptFromSurface(name)) continue;
+		out.push({
+			kind: "unsurfaced",
+			name,
+			detail: `on window.glissade but absent from describe().surface — add it to buildSurface() (an authoring export) or the exempt-list in describeLint.ts (an internal)`
+		});
+	}
 	return out;
 }
 /**
@@ -78,9 +260,11 @@ function describeLint(manifest, surface, opts = {}) {
 async function collectRuntimeSurface(manifest) {
 	const modules = new Set([
 		"@glissade/core",
+		"@glissade/core/clips",
 		"@glissade/scene",
 		"@glissade/scene/describe",
-		"@glissade/scene/layout-ctors"
+		"@glissade/scene/layout-ctors",
+		"@glissade/scene/path"
 	]);
 	for (const h of manifest.helpers) modules.add(h.import);
 	const surface = {};

package/dist/typedSdk.js

@@ -250,6 +250,7 @@ function generateAmbientDts(manifest) {
 		L.push(`/** Construction props for \`new glissade.${node}({ … })\` (best-effort; opaque prop types → \`unknown\`). */`);
 		L.push(`interface ${propsInterfaceName(node)} {`);
 		for (const prop of Object.keys(props).sort()) L.push(`  ${JSON.stringify(prop)}?: ${ambientPropType(props[prop].type)};`);
+		L.push("  [prop: string]: unknown;");
 		L.push("}");
 		L.push("");
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/cli",
-  "version": "0.47.0-pre.0",
+  "version": "0.47.0-pre.1",
   "description": "glissade CLI: headless rendering via backend-skia (+ FFmpeg mux).",
   "license": "Apache-2.0",
   "engines": {
@@ -28,15 +28,15 @@
     "@napi-rs/canvas": "^0.1.65",
     "esbuild": "0.28.0",
     "jiti": "^2.4.2",
-    "@glissade/backend-skia": "0.47.0-pre.0",
-    "@glissade/core": "0.47.0-pre.0",
-    "@glissade/interact": "0.47.0-pre.0",
-    "@glissade/lottie": "0.47.0-pre.0",
-    "@glissade/narrate": "0.47.0-pre.0",
-    "@glissade/player": "0.47.0-pre.0",
-    "@glissade/scene": "0.47.0-pre.0",
-    "@glissade/sfx": "0.47.0-pre.0",
-    "@glissade/svg": "0.47.0-pre.0"
+    "@glissade/backend-skia": "0.47.0-pre.1",
+    "@glissade/core": "0.47.0-pre.1",
+    "@glissade/interact": "0.47.0-pre.1",
+    "@glissade/lottie": "0.47.0-pre.1",
+    "@glissade/narrate": "0.47.0-pre.1",
+    "@glissade/player": "0.47.0-pre.1",
+    "@glissade/scene": "0.47.0-pre.1",
+    "@glissade/sfx": "0.47.0-pre.1",
+    "@glissade/svg": "0.47.0-pre.1"
   },
   "repository": {
     "type": "git",