scripting

const (
	// Animation commands - object manipulation
	OP_MOVE       = 0x10001000 // Move object (speed & distance from stack, then piece#, axis#)
	OP_TURN       = 0x10002000 // Turn object (speed & direction from stack, then piece#, axis#)
	OP_SPIN       = 0x10003000 // Spin object (speed from stack, then piece#, axis#)
	OP_STOP_SPIN  = 0x10004000 // Stop spin (piece#, axis# after)
	OP_SHOW       = 0x10005000 // Show object (piece# after)
	OP_HIDE       = 0x10006000 // Hide object (piece# after)
	OP_CACHE      = 0x10007000 // Cache object (piece# after)
	OP_DONT_CACHE = 0x10008000 // Don't cache (piece# after)
	OP_TURN_NOW   = 0x1000C000 // Turn immediately (piece#, axis#, angle after)
	OP_MOVE_NOW   = 0x1000B000 // Move immediately (piece#, axis#, position after)
	OP_SHADE      = 0x1000D000 // Shade object (piece# after)
	OP_DONT_SHADE = 0x1000E000 // Don't shade (piece# after)
	OP_EMIT_SFX   = 0x1000F000 // Emit SFX (type from stack, then piece#)

	// Wait operations
	OP_WAIT_FOR_TURN = 0x10011000 // Wait for turn (piece#, axis# after)
	OP_WAIT_FOR_MOVE = 0x10012000 // Wait for move (piece#, axis# after)
	OP_SLEEP         = 0x10013000 // Sleep (time from stack)

	// Stack operations
	OP_PUSH_CONSTANT  = 0x10021001 // Push constant <value>
	OP_PUSH_LOCAL_VAR = 0x10021002 // Push local var <var#>
	OP_PUSH_STATIC    = 0x10021004 // Push static var <var#>
	OP_CREATE_LOCAL   = 0x10021008 // Create local variable
	OP_PUSH_IMMEDIATE = 0x10021000 // Push immediate (value after)
	OP_STACK_ALLOC    = 0x10022000 // Allocate local variable (no param)
	OP_POP_LOCAL_VAR  = 0x10023002 // Pop to local var <var#>
	OP_POP_STATIC     = 0x10023004 // Pop to static var <var#>
	OP_POP_STACK      = 0x10024000 // Pop and discard top of stack

	// Arithmetic operations
	OP_ADD = 0x10031000 // Add (both from stack)
	OP_SUB = 0x10032000 // Subtract (both from stack)
	OP_MUL = 0x10033000 // Multiply (both from stack)
	OP_DIV = 0x10034000 // Divide (both from stack)
	OP_MOD = 0x10037000 // Modulo (both from stack)

	// Bitwise operations
	OP_BITWISE_AND = 0x10035000 // Bitwise AND
	OP_BITWISE_OR  = 0x10036000 // Bitwise OR
	OP_BITWISE_XOR = 0x10038000 // Bitwise XOR
	OP_BITWISE_NOT = 0x1003A000 // Bitwise NOT

	// Special functions
	OP_RAND           = 0x10041000 // Random (low & high from stack)
	OP_GET_UNIT_VALUE = 0x10042000 // Get unit value (port# from stack)
	OP_GET            = 0x10043000 // Get value

	// Comparison operations
	OP_LESS_THAN     = 0x10051000 // <  (both from stack)
	OP_LESS_OR_EQUAL = 0x10052000 // <= (both from stack)
	OP_GREATER_THAN  = 0x10053000 // >  (both from stack)
	OP_GREATER_EQUAL = 0x10054000 // >= (both from stack)
	OP_EQUAL         = 0x10055000 // == (both from stack)
	OP_NOT_EQUAL     = 0x10056000 // != (both from stack)

	// Logical operations
	OP_LOGICAL_AND = 0x10057000 // && (both from stack)
	OP_LOGICAL_OR  = 0x10058000 // || (both from stack)
	OP_LOGICAL_XOR = 0x10059000 // ^^ (both from stack)
	OP_LOGICAL_NOT = 0x1005A000 // !  (from stack)

	// Control flow
	OP_START_SCRIPT    = 0x10061000 // Start script (params from stack, then script#, param_count)
	OP_CALL_SCRIPT     = 0x10062000 // Call script — actual value found in TA COB files (0x10062000, not 0x10063000 as documented)
	OP_JUMP            = 0x10064000 // Jump <offset>
	OP_RETURN          = 0x10065000 // Return (value from stack)
	OP_JUMP_IF_FALSE   = 0x10066000 // Jump if false (test from stack, <offset>)
	OP_SIGNAL          = 0x10067000 // Signal (signal# from stack)
	OP_SET_SIGNAL_MASK = 0x10068000 // Set signal mask (mask from stack)

	// Special effects
	OP_EXPLODE    = 0x10071000 // Explode (type from stack, then piece#)
	OP_PLAY_SOUND = 0x10072000 // Play sound (sound# from stack, volume after)

	// Set operations
	OP_SET_VALUE   = 0x10082000 // Set unit value (port# from stack, value from stack)
	OP_ATTACH_UNIT = 0x10083000 // Attach unit (piece# after)
	OP_DROP_UNIT   = 0x10084000 // Drop unit

	// DONT_SHADOW disables shadow casting for a single piece. It shares the
	// shape of the other animation opcodes (one inline piece# DWORD) and
	// only appears in retail TA: Kingdoms .cob files (Scriptor's keyword
	// `dont-shadow` lives in the same animation category as `dont-shade`).
	OP_DONT_SHADOW = 0x1000A000

	// MISSION_COMMAND invokes a named TAK engine command. Two inline DWORDs
	// encode (soundNameIndex, stackArgCount); the engine pops `stackArgCount`
	// values off the stack, executes the command stored at index
	// `soundNameIndex` of the per-COB sound-name table, and pushes a result
	// back. The result is consumed by whichever POP_* opcode follows
	// (POP_STATIC/POP_LOCAL for assignment, POP_STACK to discard). Maps to
	// Scriptor's `Mission-Command(STRING, args...)` keyword.
	OP_MISSION_COMMAND = 0x10073000

	// OP_TAK_MATH_09 / OP_TAK_MATH_0B are TAK-only math opcodes whose exact
	// semantics have not been documented. Scriptor labels them `??` / `????`,
	// so even the canonical TAK-aware tool treats them as opaque operators.
	// Empirically every retail .cob site uses them as stack-neutral
	// pseudo-ops wrapping a producing expression — that's how we round-trip
	// them through decompile/compile.
	OP_TAK_MATH_09 = 0x10039000
	OP_TAK_MATH_0B = 0x1003B000
)