Diagnostics

Error and lint codes reported by kinemo check, the preview and the build.

Every problem kinemo reports has a stable code: K codes are errors, W codes are lints (warnings; kinemo check --strict treats them as errors). Codes never change meaning and are never reused. kinemo explain <code> prints the same explanation in the terminal and kinemo check --fix applies the safe fixes. A lint can be allowed on one line with # kinemo: allow W1002 or for the whole project in kinemo.toml ([lints] allow).

K00xx: General#

K0001: Python exception during build#

Error. The scene code raised an ordinary Python exception.

K01xx: Object lifecycle#

K0101: object not in the scene#

Error. Creating an object does not put it in the scene. .to() only animates objects that have entered, via s.add(obj) or an entrance verb (k.draw, k.write, k.fade_in, k.grow).

Example that triggers it:

c = k.Circle()
s.play(c.to(x=2))

Fix:

s.play(k.draw(c))
s.play(c.to(x=2))

K0102: object already removed#

Error. The object left the scene (s.remove, k.fade_out, k.shrink) before the animation's time. Bring it back with an entrance verb or animate it before it exits.

K0103: object with two parents#

Error. An object belongs to exactly one group. To show the same visual in two places, copy it (obj.copy()); to change groups while keeping its position, use k.reparent(obj, new_parent).

K0104: outside scene construction#

Error. Objects, signals and animations belong to a scene. Create them inside the function decorated with @k.scene (or inside a clip, a handler or a component's build()).

K0105: invalid argument#

Error. An argument has a type or value the API does not accept.

K0106: unknown prop#

Error. The object has no such prop. See kinemo docs <Type>.

W0110: play with at=#

Warning (lint). play(..., at=) does not move the cursor; use s.start(..., at=) to make that explicit.

K02xx / W02xx: Animations, conflicts, interpolation#

K0201: two animations on the same prop#

Error. Two animations write the same prop of the same object over overlapping intervals. Chain them (k.seq) or, if summing them is intended, use blend="add" on the second one.

K0202: invalid duration#

Error. Durations and waits must be finite, non-negative numbers.

K0203: not an animation#

Error. s.play/s.start take k.Animation values (verbs, .to(), clips).

K0204: non-reversible animation in during#

Error. s.during reverts what it applied when the block ends; it only accepts state changes (.to) and k.indicate. Entrance/exit verbs have no reverse.

K0205: type without interpolation#

Error. Lists and custom types must declare how to interpolate: k.signal([...], lerp=k.lerp.pointwise) or lerp=None to switch in a single step.

K03xx / W03xx: Reactive system#

K0301: tracked read outside a reactive context#

Error. x() only works inside prop lambdas, k.computed and .map functions. In the scene body, read the value at the cursor with x.now.

K0302: x.now inside a lambda#

Error. x.now inside a lambda would freeze the value at build time. Use x() so the lambda follows the signal.

K0303: derived values are read-only#

Error. Derived values are recomputed from their sources; animate the source.

K0304: signal used as a boolean#

Error. if signal: has no single value: the signal changes over time. Use x.now > 2 to decide at the cursor, or k.when(x > 2, ...) to react during playback.

K0305: signal converted to a number#

Error. Functions like math.sin need a number; a signal is a value over time. Use k.sin(x) (native) or x.map(k.python(math.sin)).

K0306: write inside a derived value#

Error. Derived values are pure: they do not write to signals.

K0310: untraceable function#

Error. The function uses something that cannot be compiled to the IR (math.*, if on a symbolic value, external libraries). Replace it with the native k building blocks or accept the cost with k.python(fn).

W0310: lambda in a loop#

Warning (lint). The lambda captures the loop variable by reference; use lambda i=i: or .map.

W0311: captured Python list#

Warning (lint). Plain lists are not tracked; use k.list([...]).

W0312: eased clock#

Warning (lint). A signal used as a clock must advance linearly; use k.time.map(...).

K04xx: Layout and constraints#

K0401: axis held by a constraint#

Error. The object's position comes from a constraint (place, a container or a binding). Change the constraint with an animation via .to_place(...), release it with .to(..., unpin=True) (or .unpin() at the cursor), or drop a binding with .unbind().

K0402: constraint cycle#

Error. The constraints depend on each other in a cycle; break one of them.

K0403: conflicting constraints#

Error. Two constraints compete for the same axis. Remove one or mark the weaker one with weak=True.

K0404: unknown anchor#

Error. Valid anchors: center, top, bottom, left, right and combinations such as top-left.

K05xx: Resolution (loops, convergence)#

K0501: event loop#

Error. Events and handlers did not converge within 8 passes.

K06xx / W06xx: Components#

K0601: signal in a static field#

Error. Declare the field as k.Prop[T] to accept reactive values.

K0602: unassigned out#

Error. Every k.Out must be assigned in build().

K07xx / W07xx: Events#

W0701: handler object never removed#

Warning (lint). Objects created in handlers should leave the scene.

K0702: event did not happen before the timeout#

Error. No trigger before the timeout.

K0703: event already happened#

Error. The event happened before the cursor; use s.start instead of the earlier play.

K08xx / W08xx: Text and math#

K0801: unsupported LaTeX command#

Error. Use engine="tex" for packages the built-in engine does not cover.

W0801: morph without matches#

Warning (lint). The shapes have nothing in common; the morph does a warp + crossfade.

W09xx: Performance#

W0901: too many individual objects#

Warning (lint). Use vectorized types (k.Points, k.VectorField).

W10xx: Visual legibility#

W1001: outside the safe area#

Warning (lint). The object extends beyond the frame's safe area.

W1002: text over text#

Warning (lint). Two texts overlap by more than 10% of their area.

W1003: low contrast#

Warning (lint). Contrast between text and background is below 4.5:1.

W1004: small text#

Warning (lint). Text smaller than 18 px at the final resolution.

W1005: invisible object#

Warning (lint). Object invisible for more than 3 s and never removed.

W1006: visual noise#

Warning (lint). More than 12 short simultaneous animations.

W1007: static scene#

Warning (lint). More than 8 s without visual change.

K11xx: Names from other libraries (Manim)#

K1101: Manim name#

Error. Manim verbs have a direct equivalent in k. (see the Manim → kinemo table).

K1102: Manim .animate#

Error. In kinemo, an animated state change is s.play(obj.to(...)).

K1103: Manim self.play#

Error. The scene receives s: k.Scene; use s.play(...).

K1104: Manim ValueTracker#

Error. Use k.signal(value).

K1105: Manim updater#

Error. Pass a signal or a lambda to the prop: obj.set(x=other.x).

K1106: Manim direction constant#

Error. Position comes from constraints (place) or from x=/y=.

K12xx: Data and interoperability (Arrow, arrays)#

K1201: data without Arrow#

Error. The object does not implement the Arrow PyCapsule Interface.

K1202: missing column#

Error. The table has no column with that name; check x=, y= and key=.

K1203: column with the wrong type#

Error. Chart values need a numeric column (int, float or decimal).

K1204: duplicate key#

Error. Each row of a chart needs a unique key (key=); aggregate the data or pick another column.

W13xx: Parameters and export#

W1301: parameter read with .now#

Warning (lint). It is fixed at build time and does not become an interactive control.

W1302: k.python depending on a parameter#

Warning (lint). It cannot be precomputed for the interactive web player.

W14xx: Audio and voice#

W1401: voice without a TTS provider#

Warning (lint). No provider configured: silence with an estimated duration.