amc-web

The pakop C#/.NET WASM module (CUE4Parse-based) — what it does (pak-file inspection/hashing), how to build it (pnpm build:pakop), and how to consume it (lazy dynamic import). Read before touching wasm/pakop or the pak routes.

How to fetch data in the AMC web app — the apiClient helper, visibility-aware polling / EventSource / WebSocket wrappers in src/lib/api/_api.ts, per-domain API modules, and protobuf decoding. Read before adding any network call.

The AMC app shell — hooks.server.ts prerender-time head injection (SEO meta, theme-color, font preloads, icons), hooks.ts URL delocalization, and asset import suffixes (?no-inline, ?url). Read before changing global head tags, fonts, SEO metadata, or hooks.

High-level architecture of the AMC web app — SvelteKit static/SPA hybrid, Vite plugin pipeline, i18n strategy, WASM modules, dev-server proxies. Read before making structural or build-related changes.

Utility function conventions in the AMC web repo — es-toolkit for lodash-like helpers (lodash-es was removed), but check src/lib/utils first. Read before adding utility helpers.

Import path aliases ($lib, $messages) and workspace packages used in the AMC web repo. Read when writing imports or resolving where a module comes from.

Overlay/floating UI conventions in the AMC web repo — use the homegrown `portal` action from $lib/utils/portal (svelte-portal package is not used/dependency), as done in Tooltip and Modal. Read before building modals, tooltips, or popovers.

The lefthook pre-commit pipeline for the AMC web repo — which checks run on commit (dotnet format/WASM build, paraglide/proto codegen, format/lint/check/test) and what that implies for committing. Read before committing or debugging a failed commit.

Directory layout of the AMC web repo — where UI components, feature components, routes, data, schemas, WASM crates, and generated code live. Read before adding new files or searching for existing code.

CSS class-prop handling in the AMC web repo — the clsx + tailwind-merge pattern for merging component class props. Read before adding a class prop to a component.

Required coding patterns for the AMC web repo — code style (const enums only, no magic numbers, no useless comments), Svelte 5 runes, component prop conventions, class merging, context composition, i18n usage, icons, stories, and testing. Read before writing or modifying any code.

Date handling in the AMC web repo — date-fns v4 for manipulation/formatting, shared helpers in src/lib/date.ts, reactive current time via realtimeDate.svelte.ts. Read before writing date logic.

Environment variables in the AMC web app — PUBLIC_* vars consumed via $env/static/public vs VITE_* vars used only for dev proxies. Read when adding configuration or touching .env.

Animation guidance for the AMC web repo — when to use GSAP vs CSS/Svelte transitions. Read before adding animations.

The full i18n workflow in the AMC web repo — Paraglide message usage (m from $messages), adding messages to messages/*.json, locale strategy, URL delocalization, and locale-aware fonts. Read before adding or changing any user-facing text.

Lottie animation usage in the AMC web repo — render through the Lottie UI component, store animation JSONs in src/lib/assets/lottie. Read before adding vector animations.

The AMC in-game map system — OlMap/EditorOlMap wrappers, the custom game-world projection and reProjectPoint helpers, WebGL layers, styling from tw-var, static points, and realtime player streams. Read before touching anything under src/lib/ui/OlMap, src/lib/ui/EditorOlMap, or src/lib/components/Map.

Markdown/HTML rendering in the AMC web repo — always go through the MarkdownText component (marked + dompurify); never render unsanitized HTML. Read before displaying markdown or remote HTML.

OpenLayers (ol) usage in the AMC web repo — build on the OlMap/EditorOlMap wrappers, re-project coordinates, use WebGL layers for large point sets, style from tw-var. Read before writing any ol code.

Protobuf usage in the AMC web repo — .proto sources, buf codegen (pnpm proto:generate), decoding binary streams with @bufbuild/protobuf fromBinary. Read before touching realtime binary data or .proto files.

Rotation math in the AMC web repo — track waypoint rotations are {x,y,z,w} quaternions handled with the quaternion package in TrackEditor utils. Read before touching track rotation or 3D-orientation code.

Test setup in the AMC web repo — the two Vitest projects (browser component tests vs node unit tests), file-naming rules that decide which project runs a test, and how to run them. Read before writing or running tests.

Zod usage in the AMC web repo — always the zod/mini build, schemas in src/lib/schema with i18n-aware error factories. Read before writing or modifying validation schemas.