AlgoScan

Contains auto-generated code from specification file

Co-authored-by: Algorand Generation Bot <codegen@algorand.com>

Update api/README.md to describe fetching OAS3 specs from the pinned
algokit-oas-generator commit (and how to bump it), fix the convert-* command
descriptions in the contributing guide, and mark the legacy openapi_generators
research note as historical.

The OAS3 specs are now fetched from the pinned algokit-oas-generator commit
via 'cargo api convert-*', so the in-tree TypeScript converter and its npm
scaffolding are no longer needed. Drops the setup-node/npm ci steps from the
weekly api-openapi-sync workflow (its cargo api convert-* drift check stays).

Regenerated from the pinned upstream specs on top of the wasm32 http client.
Notable changes:
- Address fields now use algokit_transact::Address (indexer/kmd gain the
  algokit_transact dependency)
- 31 [u8; 32] and 11 [u8; 64] fixed-length byte arrays replace Vec<u8>
- box/holding/locals reference structs carry documenting markers
- upstream operationId/field renames and required-field changes

Specs now sourced from algokit-oas-generator @60ac9cc. Adds the upstream
vendor extensions our generator now honors (x-algokit-byte-length on 5 algod
+ 27 indexer fields; box/holding/locals-reference on 3 algod schemas) plus
upstream's operationId renames, field renames, and required-field strategies.

Bring the Rust OAS generator to extension parity with the utils-ts/-py
generators by honoring three vendor extensions it previously dropped:

- x-algorand-format: "Address" -> algokit_transact::Address
- x-algokit-byte-length: N -> fixed [u8; N] arrays (serde via Bytes)
- x-algokit-box/holding/locals-reference -> documenting struct markers

Pulls algokit_transact into generated clients that use Address even when
they have no msgpack operations (new has_address_fields spec flag).

Self-contained parser tests (via parse_dict) for the three newly honored
vendor extensions, independent of the regenerated specs.

Replace the in-tree npm convert-openapi calls in the convert-* commands with
a fetch of the published specs from a pinned algokit-oas-generator commit,
matching how algokit-utils-ts/-py consume the canonical converter. The pinned
SHA is recorded in api/specs/.oas-generator-sha and OAS_GENERATOR_SHA.

Port two remaining version-independent pieces from main:

- eslint.config.mjs: add eslint-plugin-unused-imports and switch to
  typescript-eslint projectService; unused vars/args are now warnings
  and unused imports are auto-removable (drops the examples-only ignore)
- add publish-devportal-docs.yml to publish docs to the AlgoKit devportal
  on push to main and version tags (complements GitHub Pages publishing)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Replace the typedoc-markdown docs (docs/code, docs/capabilities) with the
Astro/Starlight site from main, adapted to v9:

- starlight-typedoc entry points point at v9 src (index.ts, testing);
  API reference is auto-generated and accurate to the v9 API
- skipErrorChecking on typedoc so the docs toolchain's newer @types/node
  doesn't flag v9's Buffer/Uint8Array usage (v9 builds clean on its own)
- migrate v9's 17 capability guides into src/content/docs/concepts (flat),
  with Starlight frontmatter; convert sibling links and de-link the old
  ../code API references (the API reference is browsable via the sidebar)
- remove the v10-only examples generation (loader, script, sidebar section)
  and the v9-to-v10 migration guide
- rewrite sidebar.config.json and the landing/quick-start examples for v9

Wire-up:
- root package.json: add docs:dev/build/preview, drop generate:code-docs
  and root typedoc deps; remove typedoc.json
- CI check_docs now uses the shared check-docs.yml (builds the Astro site);
  add publish_docs to GitHub Pages on main
- ignore docs/ in root prettier and add .claude/ to .gitignore

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Make main the single stable semantic-release branch instead of a beta
prerelease channel, so the v9 line publishes stable releases from main.
Removes the main(beta)/release(stable) two-stage promotion flow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Migrate CI to algorandfoundation/algokit-shared-config reusable
workflows (adapted to v9: node 20, install-algokit, no polytest),
replace @makerx/ts-toolkit copy-package-json with a local
scripts/copy-package-json.ts (+ tsx), and replace @makerx/prettier-config
with an inline .prettierrc (identical settings). Add tslib explicitly
since it was only resolved transitively via the makerx tree.

Also brings over version-independent infra from main: dependabot
cooldown, root .npmrc min-release-age, and .vscode launch config.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>