@glissade/core 0.14.0-pre.0 → 0.14.0-pre.1

package/dist/i18n.d.ts

@@ -26,6 +26,14 @@ type MessageTable = Record<string, string>;
 interface LocalizeOptions {
   /** the locale being resolved (carried for error context only; no behavior depends on it). */
   locale: string;
+  /**
+   * Message ids ALREADY consumed outside the doc — the free-standing `t()` ids
+   * resolved at module-eval / createScene() time (`getConsumedMessageIds()`).
+   * `localize` folds these into the "matched keys" set so the orphaned-key check
+   * (FIX 5) doesn't flag a legitimate `t()` key as unmatched. Omit when there is
+   * no ambient `t()` usage (then only node-id keys count as matched).
+   */
+  consumedIds?: ReadonlySet<string> | undefined;
 }
 declare class LocalizationError extends Error {
   constructor(message: string);
@@ -40,16 +48,30 @@ declare class LocalizationError extends Error {
  *
  * Pure: no playhead, no time, no filesystem. The base-locale table (or an empty
  * table) leaves the doc structurally identical to the input.
+ *
+ * FIX 5 (0.14 canary): a table key matching NO consumed id (neither a string-track
+ * node-id NOR a `t()` id passed via `opts.consumedIds`) is a stale/typo'd key that
+ * would silently never localize anything — so `localize` throws a `LocalizationError`
+ * naming every orphaned key (the inverse of `t()`'s hard-fail). A fully-matched
+ * table is silent.
  */
-declare function localize(doc: Timeline, table: MessageTable, _opts: LocalizeOptions): Timeline;
+declare function localize(doc: Timeline, table: MessageTable, opts: LocalizeOptions): Timeline;
 /**
  * Install the ambient message table consulted by `t()`. Called ONCE before
  * scene construction (the render entry injects it from `--locale`). Pass
  * `undefined` to clear it (the base-locale / no-flag path leaves it unset).
+ * Resets the consumed-id set (a fresh table = a fresh resolution pass).
  */
 declare function setMessageTable(table: MessageTable | undefined): void;
 /** The currently installed ambient message table (undefined when none is set). */
 declare function getMessageTable(): MessageTable | undefined;
+/**
+ * The set of ids `t()` has resolved against the ambient table since the last
+ * `setMessageTable`. The render entry passes this to `localize` so a key consumed
+ * by a free-standing `t()` (which `localize` can't see — it isn't a doc track)
+ * isn't reported as an orphaned table key (FIX 5).
+ */
+declare function getConsumedMessageIds(): ReadonlySet<string>;
 /**
  * Resolve a free-standing message `id` against the ambient table — build-time
  * sugar for static Text-node text (text that is NOT animated by a doc track,
@@ -62,4 +84,4 @@ declare function getMessageTable(): MessageTable | undefined;
  */
 declare function t(id: string): string;
 //#endregion
-export { LocaleManifest, LocalizationError, LocalizeOptions, MessageTable, ParityError, getMessageTable, localize, requireParity, setMessageTable, t };
+export { LocaleManifest, LocalizationError, LocalizeOptions, MessageTable, ParityError, getConsumedMessageIds, getMessageTable, localize, requireParity, setMessageTable, t };

package/dist/i18n.js

@@ -55,13 +55,21 @@ function nodeIdOf(target) {
 *
 * Pure: no playhead, no time, no filesystem. The base-locale table (or an empty
 * table) leaves the doc structurally identical to the input.
+*
+* FIX 5 (0.14 canary): a table key matching NO consumed id (neither a string-track
+* node-id NOR a `t()` id passed via `opts.consumedIds`) is a stale/typo'd key that
+* would silently never localize anything — so `localize` throws a `LocalizationError`
+* naming every orphaned key (the inverse of `t()`'s hard-fail). A fully-matched
+* table is silent.
 */
-function localize(doc, table, _opts) {
+function localize(doc, table, opts) {
 	let changed = false;
+	const consumed = /* @__PURE__ */ new Set();
 	const tracks = doc.tracks.map((tr) => {
 		if (tr.type !== "string") return tr;
 		const id = nodeIdOf(tr.target);
 		if (!(id in table)) return tr;
+		consumed.add(id);
 		const localized = table[id];
 		changed = true;
 		return {
@@ -72,6 +80,8 @@ function localize(doc, table, _opts) {
 			})
 		};
 	});
+	const orphans = Object.keys(table).filter((key) => !consumed.has(key) && !(opts.consumedIds?.has(key) ?? false)).sort();
+	if (orphans.length > 0) throw new LocalizationError(`message table for locale '${opts.locale}' has ${orphans.length} key(s) that match no node-id and no t() id: ${orphans.map((k) => `'${k}'`).join(", ")} — a stale/typo'd key would silently ship base text. Remove the key, or fix it to match a target id.`);
 	if (!changed) return { ...doc };
 	return {
 		...doc,
@@ -79,19 +89,31 @@ function localize(doc, table, _opts) {
 	};
 }
 let ambientTable;
+let consumedIds = /* @__PURE__ */ new Set();
 /**
 * Install the ambient message table consulted by `t()`. Called ONCE before
 * scene construction (the render entry injects it from `--locale`). Pass
 * `undefined` to clear it (the base-locale / no-flag path leaves it unset).
+* Resets the consumed-id set (a fresh table = a fresh resolution pass).
 */
 function setMessageTable(table) {
 	ambientTable = table;
+	consumedIds = /* @__PURE__ */ new Set();
 }
 /** The currently installed ambient message table (undefined when none is set). */
 function getMessageTable() {
 	return ambientTable;
 }
 /**
+* The set of ids `t()` has resolved against the ambient table since the last
+* `setMessageTable`. The render entry passes this to `localize` so a key consumed
+* by a free-standing `t()` (which `localize` can't see — it isn't a doc track)
+* isn't reported as an orphaned table key (FIX 5).
+*/
+function getConsumedMessageIds() {
+	return consumedIds;
+}
+/**
 * Resolve a free-standing message `id` against the ambient table — build-time
 * sugar for static Text-node text (text that is NOT animated by a doc track,
 * so `localize()` can't reach it): `new Text({ text: t('hero.title') })`.
@@ -104,8 +126,9 @@ function getMessageTable() {
 function t(id) {
 	if (ambientTable === void 0) return id;
 	const value = ambientTable[id];
+	if (value !== void 0) consumedIds.add(id);
 	if (value === void 0) throw new LocalizationError(`t('${id}'): no message for id '${id}' in the active message table (have: ${Object.keys(ambientTable).map((k) => `'${k}'`).join(", ") || "<empty>"})`);
 	return value;
 }
 //#endregion
-export { LocalizationError, ParityError, getMessageTable, localize, requireParity, setMessageTable, t };
+export { LocalizationError, ParityError, getConsumedMessageIds, getMessageTable, localize, requireParity, setMessageTable, t };

package/dist/index.d.ts

@@ -312,9 +312,12 @@ interface BindTarget {
   /**
    * The value type this target accepts; a track of any other type is a bind
    * error. An ARRAY for a polymorphic prop that admits more than one type
-   * (e.g. a Shape `fill` accepts both `color` and `paint`).
+   * (e.g. a Shape `fill` accepts both `color` and `paint`, or a vec2 prop that
+   * accepts both `vec2` and `vec2-arc`). UNDEFINED means the target opted OUT
+   * of the guard (an untagged custom-node prop — back-compat with 0.13, which
+   * had no guard): any track binds without a type check.
    */
-  readonly expects: ValueTypeId | readonly ValueTypeId[];
+  readonly expects: ValueTypeId | readonly ValueTypeId[] | undefined;
 }
 /** Analytic value/velocity access to one bound target (v2 addendum §B.6). */
 interface CurveSampler {

package/dist/index.js

@@ -854,7 +854,9 @@ function bindTimeline(compiled, resolve, playhead = createPlayhead()) {
 		if (!sig) throw new UnboundTargetError(target);
 		const got = tr.type;
 		const expects = sig.expects;
-		if (!(Array.isArray(expects) ? expects.includes(got) : got === expects)) throw new BindTypeMismatchError(target, got, expects);
+		if (expects !== void 0) {
+			if (!(Array.isArray(expects) ? expects.includes(got) : got === expects)) throw new BindTypeMismatchError(target, got, expects);
+		}
 		sig.bindSource(() => sampleTrack(tr, playhead()));
 		bound.push(sig);
 		samplers.set(target, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.14.0-pre.0",
+  "version": "0.14.0-pre.1",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {