hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-architecture
hyper-architecture
Verified[Hyper] Use this skill when the user asks for architecture, project setup, or performance work - building, auditing, restructuring, or reviewing project structure, routes, data or server boundaries, the lint/format/type tooling baseline (oxlint, Prettier, tsconfig, rustfmt, clippy), or build and runtime performance - in a Next.js App Router, TanStack Start, Vite with TanStack Router, Astro, Expo, Lynx (ReactLynx), Hono, Axum, Tauri v2, Electron, or Rust CLI, WASM, or MCP server project. It detects the stack from manifests and config files, routes each touched package of a monorepo separately, and applies the matching bundled stack guide, the shared setup baseline, and that stack's performance rules. Do not use it for stacks outside those eleven or for work that crosses no architecture, setup, or performance boundary, such as copy edits, a plain dependency bump, or one build failure.
references/official/lynx/lynx-2026-11-07.ko.md
View on GitHub# Lynx 공식 증거 Snapshot
설치된 version, config key, template file, engine 호환 규칙이 변경을 좌우할 때 읽습니다. 이 snapshot은 이 패키지가 의존하는 공식 주장과 각각의 확인 날짜를 기록합니다.
- last_verified_at: 2026-11-07
- `status`: Lynx 문서 site, `@lynx-js/create-lynx@0.2.1` template tarball, engine release feed, npm registry metadata에서 검토
- `baseline`: engine 4.2.0 (2026-10-27 release, PrimJS 4.2.1); `@lynx-js/react` 0.129.2; `@lynx-js/rspeedy` 0.18.5; `@lynx-js/types` 4.4.2; `@lynx-js/react-rsbuild-plugin` 0.22.2
- `refresh_when`: 설치 engine, `@lynx-js/react`, `@lynx-js/rspeedy`가 크게 다르거나 compatibility, threading, bundle 지침이 바뀔 때
- `authority`: 증거 전용. 사용자와 project 지시, 설치 project의 실제 동작이 계속 우선합니다
## Contents
- Versions와 release model
- Packages
- Scaffolder
- Tooling 현실
- Node와 platform 하한
- Rspeedy config key
- `pluginReactLynx` option
- Verbatim template config
- Compatibility 규칙
- 미확인 항목
- Sources
## Versions와 release model
| 항목 | 값 | 비고 |
|---|---|---|
| 문서상 stable engine | 4.2 | Site header가 "Lynx 4.2" |
| 4.2.0 release 날짜 | 2026-10-27 | Android, iOS, HarmonyOS에 PrimJS 4.2.1 고정 |
| 이전 engine 선 | 4.1, 4.0, 3.9, 3.8.1, 3.7.0, 3.6.0, 3.5.2, 3.4.2, 3.3.2, 3.2.0 | `versions.md` |
| Cadence | 3.8부터 월간 | 3.8 blog와 2026 roadmap에서 발표 |
| Cadence 신뢰도 | 계획이 한 번 밀림 | 4.2는 2026/09 계획이었고 2026-10-27에 출시 |
공개 roadmap은 3.8부터 4.5를 2026/05부터 2026/12에 대응시킵니다. 의도로 봅니다. 3.9.0은 2026/06 계획에 대해 2026-06-26에, 4.2.0은 2026/09 계획에 대해 2026-10-27에 나왔습니다.
## Packages
2026-11-07의 `latest` dist-tag:
| Package | Latest | 비고 |
|---|---|---|
| `@lynx-js/react` | 0.129.2 | Runtime. 마지막 publish 2026-11-06. 2025-03-02 이후 70개 version |
| `@lynx-js/rspeedy` | 0.18.5 | Build. `engines.node: "^20.19.0 \|\| >=22.12.0"` |
| `create-rspeedy` | 0.18.5 | Deprecated shim. `@lynx-js/create-lynx`에 의존 |
| `@lynx-js/create-lynx` | 0.2.1 | 현재 scaffolder |
| `@lynx-js/react-rsbuild-plugin` | 0.22.2 | `engines >=18`. peer는 `@lynx-js/react ^0.128.0 \|\| ^0.129.0`, `@lynx-js/rspeedy ^0.17.0 \|\| ^0.18.0` |
| `@lynx-js/qrcode-rsbuild-plugin` | 0.7.3 | `engines ^20.19.0 \|\| >=22.12.0` |
| `@lynx-js/types` | 4.4.2 | Engine major 선을 따름 |
| `@lynx-js/web-core` | 0.26.7 | Lynx for Web. production 준비 서술을 찾지 못함 |
| `@lynx-js/testing-environment` | 0.4.0 | Testing library용 dual thread emulation |
| `@lynx-js/lynx-ui` | 3.141.0 | Headless UI library. 호환성 서술을 찾지 못함 |
`@lynx-js/react` minor를 engine minor에 묶는 공개 matrix는 없습니다. `@lynx-js/react` 0.129.x와 engine 4.2의 관측된 짝은 관측일 뿐 계약이 아닙니다. 설치 version을 읽습니다.
## Scaffolder
`@lynx-js/create-lynx`가 `create-rspeedy`를 대체합니다. 0.2.0 changelog는 그것이 "`create-rspeedy`를 대체하며, 그 package는 이제 deprecation 안내를 달고 더 이상 update를 받지 않는다"고 적습니다.
```bash
# 현재 command
npm create @lynx-js/lynx@latest
# Quick-start page가 아직 안내하는 legacy alias. 오늘은 동작
npm create rspeedy@latest
```
새 project는 첫 번째를 씁니다. 두 번째로 이미 scaffold된 기존 repository는 그것만을 이유로 migration할 필요가 없습니다.
## Tooling 현실
- 공식 Lynx ESLint plugin은 없습니다. 2026-11-07 기준 `@lynx-js/eslint-plugin-react-lynx`와 `@lynx-js/eslint-config`가 npm에서 404입니다.
- `rslint` template variant는 `@rslint/core` `^0.9.0`과 `rslint.config.ts`를 제공합니다. `js.configs.recommended`, `ts.configs.recommended`, `reactHooksPlugin.configs.recommended`를 조합하고 `rslint`로 실행합니다. 관측된 최신 `@rslint/core`는 0.10.0이므로 hardcode하지 말고 설치 version을 읽습니다.
- ReactLynx template 자체는 linter도 Prettier config도 제공하지 않습니다. 문서 bundle 어디에도 Prettier가 나오지 않습니다.
- Oxlint에는 Lynx plugin이 없습니다. `react/no-unknown-property` rule은 DOM 지향이므로 `bindtap`, `catchtap`, `main-thread:bindtap`, `item-key`, `list-type`, `span-count`, `scroll-orientation`, `auto-size` 같은 Lynx attribute를 `ignore` 항목으로 넣어야 합니다. Config 탐색은 `.oxlintrc.json` 또는 `oxlint.config.ts`를 씁니다.
- Lynx용 oxlint 설정은 공식 Lynx 구성이 아니라 project 선택입니다.
## Node와 platform 하한
- Node.js: `^20.19.0 || >=22.12.0`. `@lynx-js/rspeedy`와 모든 scaffold된 `package.json`이 선언합니다. Quick-start page는 "Node.js 20.19 이상. Node.js 22.12 이상도 지원"이라고 적습니다.
- Rspeedy CLI는 `>=23.6`, `>=22.6`에 `--experimental-strip-types`, `>=22.7`에 `--experimental-transform-types`를 붙인 Node native TypeScript stripping을 문서화합니다. CLI 편의이지 지원 하한이 아닙니다.
- Target platform: iOS 10과 Android 5.0(API 21) 이상.
- 개발 OS: macOS 권장. Windows와 Linux는 engine project가 "아직 검증하거나 보장하지 않음"으로 적습니다.
- 현재 지원 runtime platform: Android, iOS, Web, OpenHarmony. macOS와 Windows용 Clay renderer 기반 desktop이 존재하고 Lynxtron은 "Coming soon"입니다.
- License: engine과 frontend stack 모두 Apache-2.0.
## Rspeedy config key
문서와 template에서 확인한 top-level key입니다.
```text
source.entry string | string[] | Record<string, string | string[] | EntryDescription>
source.tsconfigPath
source.alias
plugins array
tools.rspack.plugins
environments default { lynx: {} }
output.distPath
output.filename.bundle
output.cssModules.auto
output.sourceMap
output.legalComments
splitChunks default false. obsolete performance.chunkSplit을 대체
dev.hmr
dev.liveReload
dev.writeToDisk
dev.assetPrefix
dev.progressBar
dev.watchFiles
resolve.dedupe
```
CLI: `rspeedy dev | build | preview | inspect`. Global binary는 `./node_modules/.bin/rspeedy`를 우선하고 `--unmanaged`가 global binary를 강제합니다. `-c/--config`는 다른 config를, `--env-mode`는 `.env.[mode]` file을 고릅니다.
`rspeedy inspect`는 resolve된 Rsbuild와 Rspack config를 출력하며 config 주장을 확인하는 공인된 방법입니다.
## `pluginReactLynx` option
문서화된 option 23개입니다.
```text
compat
customCSSInheritanceList
debugInfoOutside
defaultDisplayLinear
defineDCE
enableAccessibilityElement
enableCSSInheritance default false
enableCSSInvalidation
enableCSSSelector
enableNewGesture
enableRemoveCSSScope
enableSSR default false
enableUISourceMap
engineVersion default '3.2'
experimental_isLazyBundle
experimental_useElementTemplate
extractStr default false
firstScreenSyncTiming default 'immediately'
globalPropsMode
optimizeBundleSize default false. mainThread/background sub-flag
removeDescendantSelectorScope
shake
targetSdkVersion engineVersion의 legacy alias
```
## Verbatim template config
공식 ReactLynx TypeScript template의 `lynx.config.ts`에 이 패키지가 권장하는 크기 및 검증 switch를 더한 것입니다.
```ts
import { pluginQRCode } from '@lynx-js/qrcode-rsbuild-plugin';
import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin';
import { defineConfig } from '@lynx-js/rspeedy';
import { pluginTypeCheck } from '@rsbuild/plugin-type-check';
export default defineConfig({
source: {
entry: './src/index.tsx',
},
plugins: [
pluginQRCode({
schema(url) {
// `?fullscreen=true` opens the page full screen in Lynx Explorer.
return `${url}?fullscreen=true`;
},
}),
pluginReactLynx({
engineVersion: '3.9', // raise only to the lowest host engine you actually ship on
optimizeBundleSize: { mainThread: true, background: true },
extractStr: true,
}),
pluginTypeCheck(),
],
// Web target is opt-in; without this Rspeedy builds `{ lynx: {} }`.
// environments: { lynx: {}, web: {} },
});
```
`tsconfig.json`. Template이 제공하는 그대로입니다.
```json
{
"compilerOptions": {
"strict": true,
"isolatedModules": true,
"verbatimModuleSyntax": true,
"esModuleInterop": true,
"skipLibCheck": true
},
"references": [{ "path": "./tsconfig.node.json" }, { "path": "./src" }],
"files": []
}
```
`tsconfig.node.json`:
```json
{
"extends": "./tsconfig.json",
"compilerOptions": {
"composite": true,
"module": "node16",
"moduleResolution": "node16",
"erasableSyntaxOnly": true,
"lib": ["es2023"],
"target": "es2022",
"noEmit": true
},
"include": ["./lynx.config.ts", "./rstest.config.ts"]
}
```
`src/tsconfig.json`:
```json
{
"extends": "../tsconfig.json",
"compilerOptions": {
"composite": true,
"jsx": "react-jsx",
"jsxImportSource": "@lynx-js/react",
"types": ["@lynx-js/rspeedy/client"],
"module": "ESNext",
"moduleResolution": "Bundler",
"noEmit": true
},
"include": ["./**/*.ts", "./**/*.tsx"]
}
```
`rstest.config.ts`:
```ts
import { withLynxConfig } from '@lynx-js/react/testing-library/rstest-config';
import { defineConfig } from '@rstest/core';
export default defineConfig({
extends: withLynxConfig(),
});
```
`package.json` script는 `build: rspeedy build`, `dev: rspeedy dev`, `preview: rspeedy preview`, `test: rstest run`이고 `engines.node: "^20.19.0 || >=22.12.0"`입니다.
`src/index.tsx`, entry:
```tsx
import '@lynx-js/preact-devtools';
import '@lynx-js/react/debug';
import { root } from '@lynx-js/react';
import { App } from './App.js';
root.render(<App />);
if (import.meta.webpackHot) {
import.meta.webpackHot.accept();
}
```
## Compatibility 규칙
| 규칙 | 세부 |
|---|---|
| `engineVersion` 의미 | N을 선언한 bundle은 N 이상 engine에서 실행. 구형 engine에서는 fatal error 10204로 실패 |
| `engineVersion` default | `'3.2'`. 하한이지 target이 아님 |
| `targetSdkVersion` | `engineVersion`의 legacy alias. 새 config에서 도입하지 않음 |
| Lazy bundle 하한 | 0.115.0 이전 Consumer는 0.115.0 이후로 build한 lazy bundle을 load할 수 없음 |
| `FetchBundle` loader | `engineVersion` 3.9 이상 필요 |
| CSS `!important` | `engineVersion` 3.9 이상 필요 |
| `flex` shorthand | 3.9부터 `flex-basis` 생략 시 `0`이 아니라 `0%`로 parse |
| `position: sticky`, `grid-row`/`grid-column` shorthand, HarmonyOS motion path | 3.9에서 추가 |
| Trace | engine 3.4부터 Android, iOS, HarmonyOS에서 지원 |
| WebAssembly | 3.8부터 Android 전용, background thread 전용 |
| Main-thread 문법 상한 | ES2019 |
| Background-thread 문법 상한 | ES2015 |
| Polyfill | iOS에만 주입 |
| `useLayoutEffect` | API index는 `useEffect` alias, lifecycle page는 미지원으로 서술 |
| React API 수준 | ReactLynx는 React v17 API surface를 노출. `@lynx-js/react/compat`가 `startTransition` 같은 React 18 API를 추가 |
## 미확인 항목
글을 쓰는 시점에 문서 page나 changelog 항목으로 확인하지 못한 것들입니다. 미확인으로 표시하거나 생략하며, 규칙으로 단정하지 않습니다.
- `@lynx-js/react` minor와 engine minor의 정확한 대응. Matrix가 없습니다.
- `useMainThreadRef` 외의 React hook을 `'main thread'` function 안에서 호출할 수 있는지.
- `'background only'`(공백)와 `background-only`(hyphen)가 동일하게 compile되는지. 문서 전체에 두 표기가 나타납니다.
- `Suspense`와 transition 의미가 React 17 동작인지 React 18 동작인지.
- `@lynx-js/lynx-ui`가 특정 engine이나 ReactLynx version과 호환되는지.
- Lynx for Web의 production 준비 상태. `@lynx-js/web-core`는 engine 4.2에 대해 0.26.7이고 준비 서술이 없습니다.
- Node 24와 npm 11의 구체 동작. `^20.19.0 || >=22.12.0`만 단정됩니다.
- Lynx attribute에 대한 Oxlint `react/no-unknown-property` ignore 목록. Attribute 이름은 문서화됐지만 rule 설정은 이 패키지의 것입니다.
- macOS와 Windows desktop host 구조. Lynxtron은 "Coming soon"입니다.
## Sources
> 확인 2026-11-07. 아래 모든 page와 registry 기록은 이 snapshot을 위해 2026-11-07에 읽었습니다.
- <https://lynxjs.org/>
- <https://lynxjs.org/llms.txt>
- <https://lynxjs.org/llms-full.txt>
- <https://lynxjs.org/versions.md>
- <https://lynxjs.org/guide/start/quick-start.md>
- <https://lynxjs.org/guide/compatibility.md>
- <https://lynxjs.org/guide/scripting-runtime/index.md>
- <https://lynxjs.org/guide/scripting-runtime/main-thread-runtime.md>
- <https://lynxjs.org/guide/start/integrate-with-existing-apps.md>
- <https://lynxjs.org/guide/use-native-modules.md>
- <https://lynxjs.org/guide/use-data-from-host-platform.md>
- <https://lynxjs.org/guide/devtool/trace.md>
- <https://lynxjs.org/guide/performance/analysis-performance/analysis-bundle-size.md>
- <https://lynxjs.org/react/thinking-in-reactlynx.md>
- <https://lynxjs.org/react/main-thread-script.md>
- <https://lynxjs.org/react/lifecycle.md>
- <https://lynxjs.org/react/code-splitting.md>
- <https://lynxjs.org/react/reactlynx-testing-library.md>
- <https://lynxjs.org/rspeedy/typescript.md>
- <https://lynxjs.org/rspeedy/output.md>
- <https://lynxjs.org/rspeedy/cli.md>
- <https://lynxjs.org/blog/lynx-3-8.md>
- <https://lynxjs.org/blog/lynx-3-9.md>
- <https://lynxjs.org/blog/lynx-open-source-roadmap-2026.md>
- <https://github.com/lynx-family/lynx/releases.atom>
- <https://github.com/lynx-family/lynx/develop/README.md>
- <https://registry.npmjs.org/@lynx-js%2Freact>
- <https://registry.npmjs.org/@lynx-js%2Frspeedy>
- <https://registry.npmjs.org/@lynx-js%2Freact-rsbuild-plugin>
- <https://registry.npmjs.org/@lynx-js%2Fqrcode-rsbuild-plugin>
- <https://registry.npmjs.org/@lynx-js%2Ftypes>
- <https://registry.npmjs.org/@lynx-js%2Fweb-core>
- <https://registry.npmjs.org/@lynx-js%2Ftesting-environment>
- <https://registry.npmjs.org/@lynx-js%2Fcreate-lynx>
- <https://registry.npmjs.org/create-rspeedy>
- <https://registry.npmjs.org/@lynx-js%2Fcreate-lynx/-/create-lynx-0.2.1.tgz>
- <https://registry.npmjs.org/@rslint%2Fcore>
- <https://registry.npmjs.org/@rstest%2Fcore>
- <https://oxc.rs/docs/guide/usage/linter/rules/react/no-unknown-property.html>
- <https://oxc.rs/docs/guide/usage/linter/config.html>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |