Brian Cardarella bcardarella

Complete Specification: Zap — Typed Functional Elixir-Syntax Language Lowering to Zig

1. Purpose

This language is a new statically typed, functional, macro-capable language with Elixir-like syntax and a native backend strategy built around lowering through a Zig-oriented compiler pipeline.

It is:

Elixir-shaped at the surface
statically typed

Cog Memory

You have persistent associative memory via Cog. Checking it before work and recording to it after work is how you avoid repeating mistakes, surface known gotchas, and build institutional knowledge. This is not optional overhead — it is how you operate effectively.

Truth hierarchy: Current code > User statements > Cog knowledge

The Memory Lifecycle

Every task follows four steps. This is your operating procedure, not a guideline.

Codebase Exploration for Knowledge Capture

You are building a knowledge asset for the team—capturing insights that save time for new developers ramping up AND experienced developers debugging at 2am.

Your goal is NOT to document every file. It's to capture the understanding that takes significant time to acquire and would otherwise be lost.

What to Capture

Capture two types of knowledge equally:

description
Load Cog memory system instructions for persistent AI knowledge

Cog Memory System Instructions

⛔ MANDATORY: Query Cog for EVERY Task

There are NO exceptions. Even if:

The problem seems trivial ("just a file not found")

HTML element (tag / state)	SwiftUI closest equivalent(s)	Default action(s)	Trigger	Event name(s) to bind on the element

name	description	license
zig	Ensures highest quality, well-tested, performant, and properly documented Zig code	MIT

Zig Programming Skill

Purpose

WHATWG WebIDL Complete Dependency Analysis Summary

Generated: November 7, 2025
Analysis Type: Comprehensive type dependency analysis including WebIDL primitives, strings, generics, and spec types
Total Specifications Analyzed: 333 WebIDL files (20 WHATWG, 313 W3C/other)

Executive Summary

✅ COMPLETE AND VERIFIED - ALL 23 WHATWG SPECS INCLUDED

Analysis Date: November 7, 2025
Status: 100% Complete - All WHATWG specs verified and included
Total Specifications Analyzed: 333 WebIDL files


	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>DOM Benchmark Results</title>
	<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>
	<style>
	* {

	INFO 2025-09-30T18:03:44 +42ms service=default version=0.13.5 args=["run","hello","--print-logs","--model","opencode/claude-sonnet-4-5"] opencode
	INFO 2025-09-30T18:03:44 +0ms service=project directory=/Users/bcardarella/projects/zig/zigdom fromDirectory
	INFO 2025-09-30T18:03:44 +4ms service=config path=/Users/bcardarella/.config/opencode/config.json loading
	INFO 2025-09-30T18:03:44 +0ms service=config path=/Users/bcardarella/.config/opencode/opencode.json loading
	INFO 2025-09-30T18:03:44 +2ms service=config path=/Users/bcardarella/.config/opencode/opencode.jsonc loading
	INFO 2025-09-30T18:03:44 +1ms service=plugin path=opencode-copilot-auth@0.0.3 loading plugin
	INFO 2025-09-30T18:03:44 +1ms service=plugin path=opencode-anthropic-auth@0.0.2 loading plugin
	INFO 2025-09-30T18:03:44 +8ms service=bus type=* subscribing
	INFO 2025-09-30T18:03:44 +0ms service=bus type=session.updated subscribing
	INFO 2025-09-30T18:03:44 +0ms service=bus type=message.updated subscribing