Add TypeScript format and check selectors

.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "useTabs": true,
+  "tabWidth": 2,
+  "singleQuote": false,
+  "semi": true,
+  "trailingComma": "all",
+  "printWidth": 100
+}

AGENTS.md

@@ -86,6 +86,8 @@ effigy rust:clippy       # denies warnings
 effigy rust:test         # filter {args} to the touched crate/package
 effigy fmt:rust:check    # cargo fmt --all --check; read-only
 effigy fmt:rust          # cargo fmt --all; mutates the workspace
+effigy fmt:ts -- ts/src/client/format.ts        # format the named TypeScript files
+effigy fmt:ts:check -- ts/src/client/format.ts  # read-only formatting check
 effigy test:unit         # vitest, filter {args} to the touched code
 effigy test:components   # vitest component config
 effigy test --plan       # when the test shape is what you need to know
@@ -97,6 +99,10 @@ Run full `effigy qa` (`validate` + `qa:docs`) on `main` at Queue milestones,
 not as a per-task default. Format selectors stay out of health, validate, and
 qa; run `fmt:rust:check` when formatted Rust source changed.
 
+TypeScript formatting uses the pinned local Prettier and `.prettierrc.json`.
+Pass the changed TypeScript paths explicitly to `fmt:ts` and `fmt:ts:check`.
+These selectors do not include Svelte formatting or run automatically in QA.
+
 `underlay-db` Postgres integration tests need a running Docker runtime and are
 `#[ignore]`d by default; see `README.md` for the bring-up.
 

README.md

@@ -73,8 +73,14 @@ effigy rust:build
 effigy rust:check
 effigy rust:test
 effigy test:components
+effigy fmt:ts -- ts/src/client/format.ts
+effigy fmt:ts:check -- ts/src/client/format.ts
 ```
 
+TypeScript formatting uses the local pinned Prettier with `.prettierrc.json`.
+Pass explicit changed-file paths; formatting is separate from health, validate
+and QA. Svelte formatting is outside these selectors' documented scope.
+
 For shared UI discovery, use the ACME reference apps in `underlay-reference`
 for retained Underlay workflow shells and helpers. Use Poodle's own
 preview/docs for primitives and generic composites that no longer belong to

docs/knowledge/contracts/022-testing-posture-and-shared-harnesses.md

@@ -98,6 +98,18 @@ Rules:
 - `validate` should represent the normal local merge gate
 - `qa` may layer docs, lint, audits, or other broader checks
 
+### Underlay repository TypeScript formatting
+
+Underlay's `fmt:ts` and `fmt:ts:check` selectors invoke the root development
+dependency's pinned Prettier with the committed `.prettierrc.json` options.
+The first writes formatting; the second checks without writing and returns
+nonzero for formatting differences or formatter errors.
+
+Pass explicit changed TypeScript file paths after `--`. These selectors are
+separate from `health`, `validate` and `qa`; adding them does not require a
+repository-wide formatting migration. They do not establish Svelte formatting
+support or prescribe a consumer application's formatter configuration.
+
 ### API minimum posture
 
 Every normal API package should prove at least:

effigy.toml

@@ -53,6 +53,8 @@ check = "cd {repo} && bun x svelte-check --tsconfig ./ts/tsconfig.json"
 "rust:test" = "cd {repo} && cargo test --workspace --all-features"
 "fmt:rust" = "cd {repo} && cargo fmt --all"
 "fmt:rust:check" = "cd {repo} && cargo fmt --all --check"
+"fmt:ts" = "cd {repo} && ./node_modules/.bin/prettier --write {args}"
+"fmt:ts:check" = "cd {repo} && ./node_modules/.bin/prettier --check {args}"
 "test:unit" = "cd {repo} && bun x vitest run {args}"
 "test:ui" = "cd {repo} && bun x vitest --ui {args}"
 "test:components" = "cd {repo} && bun x vitest run -c vitest.component.config.ts {args}"

package.json

@@ -344,6 +344,7 @@
     "bits-ui": "^2.19.3",
     "lucide-static": "^1.48.0",
     "lucide-svelte": "^1.0.1",
+    "prettier": "3.9.9",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
     "tsx": "^4.23.15",