@litfamily/litcodex 1.0.34 → 1.0.36
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README-Ko-KR.md +9 -9
- package/README.md +9 -9
- package/dist/install/generated-skill-payload-hashes.d.ts +6 -6
- package/dist/install/generated-skill-payload-hashes.js +6 -6
- package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
- package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
- package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
- package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
- package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
- package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
- package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
- package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover.mjs +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-gate.mjs +1 -0
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-kit.js +43 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-render.mjs +1 -0
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage.mjs +133 -5
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +27 -3
- package/marketplace/plugins/litcodex/skills/lsp-setup/references/typescript/README.md +5 -5
- package/marketplace/plugins/litcodex/skills/lsp-setup/scripts/lsp-server-table.ts +2 -1
- package/node_modules/@litcodex/lit-loop/package.json +1 -1
- package/package.json +2 -2
- package/readme-assets/badge-version.svg +1 -1
package/README-Ko-KR.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 머신의 칸이 차례로 켜지고, 셋째 칸의 LitCodex 머신이 주황 바이저와 테두리를 밝힌 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/badge-version.svg" alt="1.0.36" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/badge-license.svg" alt="MIT license" /></a>
|
|
6
6
|
</p>
|
|
7
7
|
|
|
8
8
|
<p align="center">
|
|
9
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
9
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-book-open.svg" width="16" alt="" /> 문서</a> <a href="#설치">설치</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
Node.js 22 이상과 Codex CLI가 필요합니다.
|
|
24
24
|
|
|
25
25
|
```sh
|
|
26
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
26
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex install
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
설치기는 어떤 모델이 이끌지, 어떤 모델이 거들지, 답변 스타일은 무엇으로 할지 묻고, 쓰려는 내용을 먼저 보여 준 뒤
|
|
30
30
|
`~/.codex/config.toml`에서 자기가 관리하는 항목만 고칩니다. 계획만 먼저 보려면
|
|
31
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.
|
|
31
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
|
|
32
32
|
설치하려면 `install` 뒤에 `--yes`를 붙이세요.
|
|
33
33
|
|
|
34
34
|
```sh
|
|
@@ -39,7 +39,7 @@ litcodex install
|
|
|
39
39
|
전역으로 설치하면 영상 스킬이 쓸 도구를 미리 준비하느라 버전이 고정된 파일 몇 개를 내려받습니다. 무엇을 받는지와
|
|
40
40
|
건너뛰는 방법은 [설치 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install-Ko-KR.md#전역-명령으로-쓰기)에 있습니다.
|
|
41
41
|
|
|
42
|
-
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.
|
|
42
|
+
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex <command>` 형식을 사용하세요.
|
|
43
43
|
|
|
44
44
|
## 첫 작업
|
|
45
45
|
|
|
@@ -91,7 +91,7 @@ lit 회원가입 폼에 입력 검증을 추가해줘
|
|
|
91
91
|
## 확인, 문제 해결, 제거
|
|
92
92
|
|
|
93
93
|
```sh
|
|
94
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
94
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex doctor
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
`litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
|
|
@@ -99,7 +99,7 @@ npm exec --yes --package @litfamily/litcodex@1.0.34 -- litcodex doctor
|
|
|
99
99
|
[문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)에 있습니다.
|
|
100
100
|
|
|
101
101
|
```sh
|
|
102
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
102
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex uninstall
|
|
103
103
|
```
|
|
104
104
|
|
|
105
105
|
플러그인과 LitCodex가 관리하는 설정을 지우고, 관련 없는 설정은 그대로 둡니다.
|
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored machines power on bay by bay, the LitCodex machine in the third bay wakes with a glowing orange visor and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/badge-version.svg" alt="1.0.36" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/badge-license.svg" alt="MIT license" /></a>
|
|
6
6
|
</p>
|
|
7
7
|
|
|
8
8
|
<p align="center">
|
|
9
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
9
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> <a href="#install">Install</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.36/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -24,12 +24,12 @@ today's stopped.
|
|
|
24
24
|
You need Node.js 22 or later and Codex CLI.
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
27
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex install
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
The installer asks which model leads, which model helps and which output style you like, shows what it is
|
|
31
31
|
about to write, and changes only the keys it manages in `~/.codex/config.toml`. To see the plan first, run
|
|
32
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.
|
|
32
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex --dry-run install`. To skip the
|
|
33
33
|
questions, add `--yes` after `install`.
|
|
34
34
|
|
|
35
35
|
```sh
|
|
@@ -41,7 +41,7 @@ A global install also gets the video skill's tools ready with a few pinned downl
|
|
|
41
41
|
[install guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install.md#a-global-command) lists them
|
|
42
42
|
and shows how to skip them.
|
|
43
43
|
|
|
44
|
-
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.
|
|
44
|
+
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex <command>`.
|
|
45
45
|
|
|
46
46
|
## First task
|
|
47
47
|
|
|
@@ -97,7 +97,7 @@ rather have neither, set `LITCODEX_NO_UPDATE_CHECK=1`. A doctor run that failed,
|
|
|
97
97
|
## Check, fix, remove
|
|
98
98
|
|
|
99
99
|
```sh
|
|
100
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
100
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex doctor
|
|
101
101
|
```
|
|
102
102
|
|
|
103
103
|
`litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks
|
|
@@ -105,7 +105,7 @@ the current project's loop state. If `lit` does nothing, run doctor and check th
|
|
|
105
105
|
in Codex. More fixes are under [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
|
|
106
106
|
|
|
107
107
|
```sh
|
|
108
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
108
|
+
npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex uninstall
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
|
|
@@ -963,7 +963,7 @@ export declare const MOTION_PAYLOAD_HASHES: {
|
|
|
963
963
|
readonly "engine/cover-sheet.mjs": "6dd044f480dac904e7647f8776f36353a234db89bdf67db9db45ab74f2ebab59";
|
|
964
964
|
readonly "engine/cover-treatment.mjs": "16be56609dda2a7163f111108d8dff8188dd86493c39e0d527e6b414310a6f4e";
|
|
965
965
|
readonly "engine/cover-worker.mjs": "703c458791ef963faeb5a221e07d1686950303235e2d978efe0f239c1c5fba1c";
|
|
966
|
-
readonly "engine/cover.mjs": "
|
|
966
|
+
readonly "engine/cover.mjs": "e9fd65fdf5d3170f551f8e378ae89c3cf5629966d65c5eea28f2addccca8d2b3";
|
|
967
967
|
readonly "engine/driver.mjs": "ba9e6c072797d54768a394ca51966d5819a837ee9086c93fb5896eb7eaccda4f";
|
|
968
968
|
readonly "engine/encode.mjs": "1a1ff4a1637d71c9cad88106a425dd100a4f038b8cff793494c9f317d3965c06";
|
|
969
969
|
readonly "engine/flash.mjs": "783bad57bf72292038b20a6e62d59e602dc56b8ebbe5682c7a19e191d9eda652";
|
|
@@ -983,14 +983,14 @@ export declare const MOTION_PAYLOAD_HASHES: {
|
|
|
983
983
|
readonly "engine/scenes.mjs": "55257926ca326c8fa4816a716d7118811241a858960a5748921b95938d96ea49";
|
|
984
984
|
readonly "engine/score.mjs": "3e3aa72c8f19c8812dc973634e57c18127039f0b9e144959c0b29afb2045c952";
|
|
985
985
|
readonly "engine/sound.mjs": "a7f9cd0fdcc3fea59968b65ceaaa5d5e8e34b30e274d8ea445ff8c1a6b13a3d9";
|
|
986
|
-
readonly "engine/stage-gate.mjs": "
|
|
986
|
+
readonly "engine/stage-gate.mjs": "56f031b3ee100b435575974d198479b4b14dcf250da8f9737029d6d647a48fc3";
|
|
987
987
|
readonly "engine/stage-init.js": "fce7fcb56f6c8511b95dde3491a873347e342850c7419eed802746ceecf4b3d8";
|
|
988
|
-
readonly "engine/stage-kit.js": "
|
|
988
|
+
readonly "engine/stage-kit.js": "7d7a03e5460c8cb0d5220defffb96ebf2d657e674d5d8387df342660390effb6";
|
|
989
989
|
readonly "engine/stage-qa.js": "34b941aa2047d069dafdf09a45486d830f89fc23c4b1dfbff7cf516be0fc5e93";
|
|
990
990
|
readonly "engine/stage-qa.mjs": "0e0dbdc7f56794208d7a4d0ee9b19ec6e9e4e117a1215aeaaeac056ef7acc63b";
|
|
991
|
-
readonly "engine/stage-render.mjs": "
|
|
991
|
+
readonly "engine/stage-render.mjs": "dca7464f537828a0cc70df8ac5a0f90453d0d60c17f745c5611fb455d2403865";
|
|
992
992
|
readonly "engine/stage-worker.mjs": "664b08d1307b0c5a7fe3b3cf555458d6afd5da08d519b5bd67758d03810fc5c2";
|
|
993
|
-
readonly "engine/stage.mjs": "
|
|
993
|
+
readonly "engine/stage.mjs": "14a6978fa1aee301a72d2e6d6548e04efc52f77076c4abfb650eec36b8d17a76";
|
|
994
994
|
readonly "engine/stroke.mjs": "dfd9b826f88a83f3472ba14b24557a918adc0258e3b636796c4fcad05126e15b";
|
|
995
995
|
readonly "engine/styles.mjs": "e44aa8f1e157d229d865e3ec74e10c532e2d22b60e97a9b42de355b66b229a45";
|
|
996
996
|
readonly "engine/timeline.mjs": "6c6c0523733f2c86371a40c417a6542555a70ba64370ed9da5cd4ede01807980";
|
|
@@ -1047,7 +1047,7 @@ export declare const MOTION_PAYLOAD_HASHES: {
|
|
|
1047
1047
|
readonly "references/runtime.md": "64ed90c7d3fc125a052e78a1e95bb6ed3d5e3992a18c2012845845ae139a3836";
|
|
1048
1048
|
readonly "references/scene-author.md": "931828d407c6bff2ef8c3918ed3b58fdf17a0546389b93aa65e43caf6ca5357c";
|
|
1049
1049
|
readonly "references/sound.md": "e67559a9e9c5bea9c34449881fa2e8d95fc39b44f226e7d112807c7391fc34da";
|
|
1050
|
-
readonly "references/stage.md": "
|
|
1050
|
+
readonly "references/stage.md": "795b6b6fe8f6f7497c0ed143c27a313aa75f927a9d5b7876e3bdf1f3c9f7dc77";
|
|
1051
1051
|
readonly "references/studio.md": "e5dcbe9cd9600b450d110cb81fe4f4dc20844204bb71a8288df97d1f097db999";
|
|
1052
1052
|
readonly "references/style-bibles.md": "51165d92bbfa33533eb232195365350f2d6129324a5a499f75a953bf9f955e31";
|
|
1053
1053
|
readonly "references/treatment.md": "a79ba7f5f2c02528a34fafabac1d561363134a3822edaf76f9da0aab4b6b96d0";
|
|
@@ -964,7 +964,7 @@ export const MOTION_PAYLOAD_HASHES = {
|
|
|
964
964
|
"engine/cover-sheet.mjs": "6dd044f480dac904e7647f8776f36353a234db89bdf67db9db45ab74f2ebab59",
|
|
965
965
|
"engine/cover-treatment.mjs": "16be56609dda2a7163f111108d8dff8188dd86493c39e0d527e6b414310a6f4e",
|
|
966
966
|
"engine/cover-worker.mjs": "703c458791ef963faeb5a221e07d1686950303235e2d978efe0f239c1c5fba1c",
|
|
967
|
-
"engine/cover.mjs": "
|
|
967
|
+
"engine/cover.mjs": "e9fd65fdf5d3170f551f8e378ae89c3cf5629966d65c5eea28f2addccca8d2b3",
|
|
968
968
|
"engine/driver.mjs": "ba9e6c072797d54768a394ca51966d5819a837ee9086c93fb5896eb7eaccda4f",
|
|
969
969
|
"engine/encode.mjs": "1a1ff4a1637d71c9cad88106a425dd100a4f038b8cff793494c9f317d3965c06",
|
|
970
970
|
"engine/flash.mjs": "783bad57bf72292038b20a6e62d59e602dc56b8ebbe5682c7a19e191d9eda652",
|
|
@@ -984,14 +984,14 @@ export const MOTION_PAYLOAD_HASHES = {
|
|
|
984
984
|
"engine/scenes.mjs": "55257926ca326c8fa4816a716d7118811241a858960a5748921b95938d96ea49",
|
|
985
985
|
"engine/score.mjs": "3e3aa72c8f19c8812dc973634e57c18127039f0b9e144959c0b29afb2045c952",
|
|
986
986
|
"engine/sound.mjs": "a7f9cd0fdcc3fea59968b65ceaaa5d5e8e34b30e274d8ea445ff8c1a6b13a3d9",
|
|
987
|
-
"engine/stage-gate.mjs": "
|
|
987
|
+
"engine/stage-gate.mjs": "56f031b3ee100b435575974d198479b4b14dcf250da8f9737029d6d647a48fc3",
|
|
988
988
|
"engine/stage-init.js": "fce7fcb56f6c8511b95dde3491a873347e342850c7419eed802746ceecf4b3d8",
|
|
989
|
-
"engine/stage-kit.js": "
|
|
989
|
+
"engine/stage-kit.js": "7d7a03e5460c8cb0d5220defffb96ebf2d657e674d5d8387df342660390effb6",
|
|
990
990
|
"engine/stage-qa.js": "34b941aa2047d069dafdf09a45486d830f89fc23c4b1dfbff7cf516be0fc5e93",
|
|
991
991
|
"engine/stage-qa.mjs": "0e0dbdc7f56794208d7a4d0ee9b19ec6e9e4e117a1215aeaaeac056ef7acc63b",
|
|
992
|
-
"engine/stage-render.mjs": "
|
|
992
|
+
"engine/stage-render.mjs": "dca7464f537828a0cc70df8ac5a0f90453d0d60c17f745c5611fb455d2403865",
|
|
993
993
|
"engine/stage-worker.mjs": "664b08d1307b0c5a7fe3b3cf555458d6afd5da08d519b5bd67758d03810fc5c2",
|
|
994
|
-
"engine/stage.mjs": "
|
|
994
|
+
"engine/stage.mjs": "14a6978fa1aee301a72d2e6d6548e04efc52f77076c4abfb650eec36b8d17a76",
|
|
995
995
|
"engine/stroke.mjs": "dfd9b826f88a83f3472ba14b24557a918adc0258e3b636796c4fcad05126e15b",
|
|
996
996
|
"engine/styles.mjs": "e44aa8f1e157d229d865e3ec74e10c532e2d22b60e97a9b42de355b66b229a45",
|
|
997
997
|
"engine/timeline.mjs": "6c6c0523733f2c86371a40c417a6542555a70ba64370ed9da5cd4ede01807980",
|
|
@@ -1048,7 +1048,7 @@ export const MOTION_PAYLOAD_HASHES = {
|
|
|
1048
1048
|
"references/runtime.md": "64ed90c7d3fc125a052e78a1e95bb6ed3d5e3992a18c2012845845ae139a3836",
|
|
1049
1049
|
"references/scene-author.md": "931828d407c6bff2ef8c3918ed3b58fdf17a0546389b93aa65e43caf6ca5357c",
|
|
1050
1050
|
"references/sound.md": "e67559a9e9c5bea9c34449881fa2e8d95fc39b44f226e7d112807c7391fc34da",
|
|
1051
|
-
"references/stage.md": "
|
|
1051
|
+
"references/stage.md": "795b6b6fe8f6f7497c0ed143c27a313aa75f927a9d5b7876e3bdf1f3c9f7dc77",
|
|
1052
1052
|
"references/studio.md": "e5dcbe9cd9600b450d110cb81fe4f4dc20844204bb71a8288df97d1f097db999",
|
|
1053
1053
|
"references/style-bibles.md": "51165d92bbfa33533eb232195365350f2d6129324a5a499f75a953bf9f955e31",
|
|
1054
1054
|
"references/treatment.md": "a79ba7f5f2c02528a34fafabac1d561363134a3822edaf76f9da0aab4b6b96d0",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litcodex/lit-loop",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.36",
|
|
4
4
|
"description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": true,
|
|
@@ -115,7 +115,7 @@ function prepare(outDir) {
|
|
|
115
115
|
}
|
|
116
116
|
const coverDir = join(outDir, COVER_DIR);
|
|
117
117
|
if (!existsSync(join(coverDir, "index.html"))) throw new Exit(EXIT.STAGE_CONTRACT_ERROR, `STAGE_CONTRACT_ERROR: no cover/index.html in ${outDir}; write the cover page first (references/cover.md)`);
|
|
118
|
-
const scan = scanStage(coverDir);
|
|
118
|
+
const scan = scanStage(coverDir, { clips: false });
|
|
119
119
|
const { assets } = checkAssets({ outDir, treatment, files: scan.files, coverDir: COVER_DIR });
|
|
120
120
|
const runtime = resolveRuntime();
|
|
121
121
|
if (!runtime.deps.ready) throw new Exit(EXIT.BLOCKED_DEPS_NOT_PREWARMED, `BLOCKED_DEPS_NOT_PREWARMED: ${runtime.deps.missing.join("; ")}. Run \`${INSTALL_COMMAND}\` outside the sandboxed session, then rerun.`);
|
|
@@ -181,6 +181,7 @@ export function renderStageReport({ manifest, rules, outputs, round, framesViewe
|
|
|
181
181
|
lines.push(`outputs: ${outputs.mp4} · ${outputs.preview} (encoder: ${manifest.previewEncoder ?? "none"}) · ${outputs.poster} · ${outputs.still}`);
|
|
182
182
|
lines.push(`path: stage · format ${manifest.format} ${manifest.width}x${manifest.height} @ ${manifest.fps} fps · ${manifest.durationSec} s (treatment ${manifest.targetDurationSec} s)`);
|
|
183
183
|
lines.push(`capture: ${manifest.rung ?? "software"} rung ${manifest.renderer ?? "(no WebGL requested)"} · per frame p50 ${manifest.timing?.p50Ms ?? "?"} ms, p95 ${manifest.timing?.p95Ms ?? "?"} ms · master ${manifest.timing?.masterSec ?? "?"} s, determinism and text QA replays ${manifest.timing?.replaysSec ?? "?"} s, total ${manifest.timing?.totalSec ?? "?"} s`);
|
|
184
|
+
if (manifest.clips?.length) lines.push(`clips: ${manifest.clips.map((c) => `${c.id} ${c.frames} frames at ${c.fps} fps`).join(", ")} (keyed overlays, chosen from film time)`);
|
|
184
185
|
if (manifest.plate) lines.push(`plate: Blender ${manifest.plate.blender}, ${manifest.plate.engine} ${manifest.plate.device}, ${manifest.plate.samples} spp, ${manifest.plate.frames} frames at ${manifest.plate.fps} fps`);
|
|
185
186
|
lines.push("");
|
|
186
187
|
const failed = rules.some((r) => r.status === "FAIL");
|
|
@@ -586,6 +586,48 @@
|
|
|
586
586
|
};
|
|
587
587
|
}
|
|
588
588
|
|
|
589
|
+
/**
|
|
590
|
+
* A declared keyed clip (stage/clips/clips.json, served as window.LitClips by /lit/clips.js): one wrapper
|
|
591
|
+
* at `box` over the film holding the clip's frame for t. The frame is a pure function of film time,
|
|
592
|
+
* floor((t - start) * fps) + 1 within from..to, so no <video> and no real clock is involved. Before
|
|
593
|
+
* `start` and after `to` the wrapper is hidden (and show returns null) unless `hold` keeps the last
|
|
594
|
+
* frame or `loop` wraps by frame index. The wrapper is the element a page scales or fades; the <img>
|
|
595
|
+
* inside is replaced on a frame change, so the renderer waits for its decode before the capture.
|
|
596
|
+
* Register once, then call the returned show(t, { start, from, to, loop, hold }) from render(t).
|
|
597
|
+
*/
|
|
598
|
+
function keyedClip({ parent, id, box } = {}) {
|
|
599
|
+
const all = global.LitClips;
|
|
600
|
+
if (!all) throw new Error('LitStage.keyedClip: load <script src="/lit/clips.js"></script> before the page script; the stage declares no clips (clips/clips.json)');
|
|
601
|
+
const c = all[id];
|
|
602
|
+
if (!c) throw new Error(`LitStage.keyedClip: no clip "${id}" in clips/clips.json (declared: ${Object.keys(all).join(", ")})`);
|
|
603
|
+
if (!parent || !box || !(box.w > 0) || !(box.h > 0)) throw new Error("LitStage.keyedClip: needs { parent, id, box: { x, y, w, h } }");
|
|
604
|
+
const wrap = document.createElement("div");
|
|
605
|
+
wrap.setAttribute("data-lit-clip", id);
|
|
606
|
+
Object.assign(wrap.style, { position: "absolute", left: `${box.x}px`, top: `${box.y}px`, width: `${box.w}px`, height: `${box.h}px`, display: "none", pointerEvents: "none" });
|
|
607
|
+
parent.append(wrap);
|
|
608
|
+
let shown = 0;
|
|
609
|
+
let img = null;
|
|
610
|
+
return (t, { start = 0, from = 1, to = c.count, loop = false, hold = false } = {}) => {
|
|
611
|
+
if (!(from >= 1 && to <= c.count && from <= to)) throw new Error(`LitStage.keyedClip: from..to must lie within 1..${c.count} (got ${from}..${to})`);
|
|
612
|
+
const n = to - from + 1;
|
|
613
|
+
const k = Math.floor((t - start) * c.fps + 1e-6);
|
|
614
|
+
const i = k < 0 ? 0 : k < n ? from + k : loop ? from + (k % n) : hold ? to : 0;
|
|
615
|
+
wrap.style.display = i ? "block" : "none";
|
|
616
|
+
if (!i) return null;
|
|
617
|
+
if (i !== shown) {
|
|
618
|
+
const next = document.createElement("img");
|
|
619
|
+
next.src = `${c.src}/frame_${String(i).padStart(4, "0")}.png`;
|
|
620
|
+
next.alt = "";
|
|
621
|
+
Object.assign(next.style, { display: "block", width: "100%", height: "100%", objectFit: "contain" });
|
|
622
|
+
if (img) img.replaceWith(next);
|
|
623
|
+
else wrap.append(next);
|
|
624
|
+
img = next;
|
|
625
|
+
shown = i;
|
|
626
|
+
}
|
|
627
|
+
return wrap;
|
|
628
|
+
};
|
|
629
|
+
}
|
|
630
|
+
|
|
589
631
|
// ---------------------------------------------------------------- contract and text
|
|
590
632
|
|
|
591
633
|
/**
|
|
@@ -609,5 +651,5 @@
|
|
|
609
651
|
return config;
|
|
610
652
|
}
|
|
611
653
|
|
|
612
|
-
global.LitStage = Object.freeze({ define, text, ease, cubicBezier, spring, kf, at, stagger, seq, rand, splitText, drawPath, morph, clip, maskSweep, mix, alpha, clamp, lerp, invLerp, remap, shot, zone, place, tokens, plate });
|
|
654
|
+
global.LitStage = Object.freeze({ define, text, ease, cubicBezier, spring, kf, at, stagger, seq, rand, splitText, drawPath, morph, clip, maskSweep, mix, alpha, clamp, lerp, invLerp, remap, shot, zone, place, tokens, plate, keyedClip });
|
|
613
655
|
})(window);
|
|
@@ -304,6 +304,7 @@ export async function runStage({ outDir, treatment, round, stillsOnly, log = ()
|
|
|
304
304
|
chromeFlags: stageFlags(width, height, process.platform, ctx.rung),
|
|
305
305
|
rung: ctx.rung,
|
|
306
306
|
renderer: report.webgl?.renderer ?? null,
|
|
307
|
+
clips: scan.clips.map((c) => ({ id: c.id, frames: c.count, fps: c.fps, width: c.width, height: c.height, bytes: c.bytes })),
|
|
307
308
|
plate: scan.plate ? { blender: scan.plate.blender, engine: scan.plate.engine, device: scan.plate.device, samples: scan.plate.samples, fps: scan.plate.fps, frames: scan.plate.frames.length } : null,
|
|
308
309
|
notices: ctx.notices,
|
|
309
310
|
assetUsed: assetUsed(treatment, scan.files),
|
|
@@ -10,6 +10,7 @@ import { BLENDER, readPlate } from "./blender.mjs";
|
|
|
10
10
|
import { EXIT, Exit, INSTALL_COMMAND, SOFTWARE_GL, STAGE_ORIGIN } from "./constants.mjs";
|
|
11
11
|
import { launchStage } from "./driver.mjs";
|
|
12
12
|
import { FONTS, fontPath, SKILL_ROOT } from "./fonts.mjs";
|
|
13
|
+
import { decodePng } from "./image.mjs";
|
|
13
14
|
import { firstLine } from "./runtime.mjs";
|
|
14
15
|
import { readStyle, styleCss, styleScript } from "./styles.mjs";
|
|
15
16
|
|
|
@@ -34,6 +35,11 @@ export const CONTENT_TYPES = Object.freeze({
|
|
|
34
35
|
const TEXT_TYPES = new Set([".html", ".js", ".mjs", ".css", ".svg", ".json"]);
|
|
35
36
|
const RASTER_TYPES = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif"]);
|
|
36
37
|
export const RASTER_LIMITS = Object.freeze({ count: 24, bytes: 8 * 1024 * 1024, flipbook: 10 });
|
|
38
|
+
// Keyed overlay clips (references/stage.md, Clips): frame folders declared in stage/clips/clips.json are held
|
|
39
|
+
// to these caps instead of RASTER_LIMITS. A clip is a sticker on the film, never the film: 8-bit RGBA PNG
|
|
40
|
+
// frames with real transparency, at most `side` px on the long side, at most 30 fps.
|
|
41
|
+
export const CLIP_LIMITS = Object.freeze({ clips: 12, framesPerClip: 360, framesTotal: 1500, bytesPerClip: 40 * 1024 * 1024, bytesTotal: 128 * 1024 * 1024, side: 720, fps: 30 });
|
|
42
|
+
export const CLIPS_DIR = "clips";
|
|
37
43
|
const NAMESPACES = /^https?:\/\/www\.w3\.org\/(?:2000\/svg|1999\/xlink|1999\/xhtml|XML\/1998\/namespace|2000\/xmlns\/?)$/u;
|
|
38
44
|
const ABSOLUTE_URL = /\bhttps?:\/\/[^\s"'()<>`]+/giu;
|
|
39
45
|
const PROTOCOL_RELATIVE = /(?:["'(=]\s*)(\/\/[a-z0-9-]+(?:\.[a-z0-9-]+)+[^\s"')]*)/giu;
|
|
@@ -60,7 +66,7 @@ export function rasterInfo(bytes, ext) {
|
|
|
60
66
|
if (type === "IDAT") break;
|
|
61
67
|
o += 12 + length;
|
|
62
68
|
}
|
|
63
|
-
return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20), animated };
|
|
69
|
+
return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20), animated, bitDepth: bytes[24], colorType: bytes[25] };
|
|
64
70
|
}
|
|
65
71
|
if (ext === ".gif" && bytes.length > 10) {
|
|
66
72
|
let frames = 0;
|
|
@@ -89,12 +95,112 @@ export function rasterInfo(bytes, ext) {
|
|
|
89
95
|
return null;
|
|
90
96
|
}
|
|
91
97
|
|
|
98
|
+
const clipFail = (message) => new Exit(EXIT.STAGE_CONTRACT_ERROR, `STAGE_CONTRACT_ERROR: ${message}`);
|
|
99
|
+
const clipFrame = (i) => `frame_${String(i).padStart(4, "0")}.png`;
|
|
100
|
+
const CLIP_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,39}$/u;
|
|
101
|
+
const CLIP_DIR = /^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$/u;
|
|
102
|
+
|
|
103
|
+
/** The clips stage/clips/clips.json declares ([] without the file), checked for shape only. Throws exit 17. */
|
|
104
|
+
export function declaredClips(stageDir, limits = CLIP_LIMITS) {
|
|
105
|
+
const file = join(stageDir, CLIPS_DIR, "clips.json");
|
|
106
|
+
if (!existsSync(file)) return [];
|
|
107
|
+
let doc;
|
|
108
|
+
try {
|
|
109
|
+
doc = JSON.parse(readFileSync(file, "utf8"));
|
|
110
|
+
} catch (error) {
|
|
111
|
+
throw clipFail(`${CLIPS_DIR}/clips.json is not valid JSON (${error.message})`);
|
|
112
|
+
}
|
|
113
|
+
if (!doc || !Array.isArray(doc.clips)) throw clipFail(`${CLIPS_DIR}/clips.json needs { "clips": [ { "id", "dir", "count", "fps" } ] }`);
|
|
114
|
+
if (doc.clips.length > limits.clips) throw clipFail(`${doc.clips.length} clips declared (at most ${limits.clips} clips)`);
|
|
115
|
+
const ids = new Set();
|
|
116
|
+
const dirs = new Set();
|
|
117
|
+
return doc.clips.map((c, n) => {
|
|
118
|
+
const at = `${CLIPS_DIR}/clips.json clip #${n + 1}`;
|
|
119
|
+
if (!c || typeof c !== "object") throw clipFail(`${at} is not an object`);
|
|
120
|
+
if (typeof c.id !== "string" || !CLIP_ID.test(c.id)) throw clipFail(`${at}: id must be a plain token of letters, digits, - and _ (got ${JSON.stringify(c.id)})`);
|
|
121
|
+
if (ids.has(c.id)) throw clipFail(`${at}: duplicate id ${c.id}`);
|
|
122
|
+
ids.add(c.id);
|
|
123
|
+
if (typeof c.dir !== "string" || !CLIP_DIR.test(c.dir) || c.dir.includes("..")) throw clipFail(`clip "${c.id}": dir must be a folder name directly under ${CLIPS_DIR}/ (got ${JSON.stringify(c.dir)})`);
|
|
124
|
+
if (dirs.has(c.dir)) throw clipFail(`clip "${c.id}": dir ${c.dir} is already declared by another clip`);
|
|
125
|
+
dirs.add(c.dir);
|
|
126
|
+
if (!Number.isInteger(c.count) || c.count < 1) throw clipFail(`clip "${c.id}": count must be a whole number of frames (got ${JSON.stringify(c.count)})`);
|
|
127
|
+
if (!Number.isInteger(c.fps) || c.fps < 1 || c.fps > limits.fps) throw clipFail(`clip "${c.id}": fps must be a whole number from 1 to ${limits.fps} (got ${JSON.stringify(c.fps)})`);
|
|
128
|
+
return { id: c.id, dir: c.dir, count: c.count, fps: c.fps };
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Check every declared clip against its bytes: exactly frame_0001.png..frame_<count>.png in clips/<dir>/,
|
|
134
|
+
* each an 8-bit non-animated RGBA PNG of one size within the overlay cap, with real transparency in the first,
|
|
135
|
+
* middle and last frame, and the per-clip and total caps. Returns [{ id, dir, count, fps, width, height, bytes,
|
|
136
|
+
* frames }] where `frames` are stage-relative posix paths. Throws exit 17 naming the clip.
|
|
137
|
+
*/
|
|
138
|
+
export function scanClips(stageDir, { limits = CLIP_LIMITS } = {}) {
|
|
139
|
+
const root = realpathSync(stageDir);
|
|
140
|
+
let totalFrames = 0;
|
|
141
|
+
let totalBytes = 0;
|
|
142
|
+
const clips = declaredClips(root, limits).map((d) => {
|
|
143
|
+
if (d.count > limits.framesPerClip) throw clipFail(`clip "${d.id}": ${d.count} frames (at most ${limits.framesPerClip} per clip)`);
|
|
144
|
+
const folder = join(root, CLIPS_DIR, d.dir);
|
|
145
|
+
const have = new Map();
|
|
146
|
+
if (existsSync(folder)) {
|
|
147
|
+
for (const name of readdirSync(folder).sort()) {
|
|
148
|
+
if (!RASTER_TYPES.has(extname(name).toLowerCase())) continue;
|
|
149
|
+
const real = realpathSync(join(folder, name));
|
|
150
|
+
if (!inside(root, real) || !statSync(real).isFile()) continue;
|
|
151
|
+
have.set(name, real);
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
const frames = [];
|
|
155
|
+
for (let i = 1; i <= d.count; i++) {
|
|
156
|
+
const real = have.get(clipFrame(i));
|
|
157
|
+
if (!real) throw clipFail(`clip "${d.id}": ${CLIPS_DIR}/${d.dir}/${clipFrame(i)} is missing (declared ${d.count} frames, named frame_0001.png onward)`);
|
|
158
|
+
frames.push({ rel: `${CLIPS_DIR}/${d.dir}/${clipFrame(i)}`, real });
|
|
159
|
+
}
|
|
160
|
+
const expected = new Set(frames.map((f) => f.rel.slice(f.rel.lastIndexOf("/") + 1)));
|
|
161
|
+
const stray = [...have.keys()].find((name) => !expected.has(name));
|
|
162
|
+
if (stray) throw clipFail(`clip "${d.id}": ${CLIPS_DIR}/${d.dir}/${stray} is not one of the ${d.count} declared frames; raise count or remove it`);
|
|
163
|
+
let size = null;
|
|
164
|
+
let bytes = 0;
|
|
165
|
+
for (const f of frames) {
|
|
166
|
+
const buffer = readFileSync(f.real);
|
|
167
|
+
bytes += buffer.length;
|
|
168
|
+
const info = rasterInfo(buffer, ".png");
|
|
169
|
+
if (!info) throw clipFail(`clip "${d.id}": ${f.rel} is not a readable PNG`);
|
|
170
|
+
if (info.animated) throw clipFail(`clip "${d.id}": ${f.rel} is an animated image; a clip is a folder of still frames`);
|
|
171
|
+
if (info.colorType !== 6 || info.bitDepth !== 8) throw clipFail(`clip "${d.id}": ${f.rel} must be an 8-bit RGBA PNG with an alpha channel (a keyed frame), not an opaque image`);
|
|
172
|
+
if (Math.max(info.width, info.height) > limits.side) throw clipFail(`clip "${d.id}": ${f.rel} is ${info.width}x${info.height}; a clip is an overlay of at most ${limits.side} px on the long side`);
|
|
173
|
+
if (size && (size.width !== info.width || size.height !== info.height)) throw clipFail(`clip "${d.id}": ${f.rel} is ${info.width}x${info.height} but frame_0001.png is ${size.width}x${size.height}; one size per clip`);
|
|
174
|
+
size = { width: info.width, height: info.height };
|
|
175
|
+
}
|
|
176
|
+
if (bytes > limits.bytesPerClip) throw clipFail(`clip "${d.id}": ${(bytes / 1048576).toFixed(1)} MB (at most ${(limits.bytesPerClip / 1048576).toFixed(0)} MB per clip)`);
|
|
177
|
+
for (const f of [frames[0], frames[Math.floor((frames.length - 1) / 2)], frames[frames.length - 1]]) {
|
|
178
|
+
let pixels;
|
|
179
|
+
try {
|
|
180
|
+
({ pixels } = decodePng(readFileSync(f.real)));
|
|
181
|
+
} catch (error) {
|
|
182
|
+
throw clipFail(`clip "${d.id}": ${f.rel} cannot be decoded (${error.message}); use a non-interlaced 8-bit RGBA PNG`);
|
|
183
|
+
}
|
|
184
|
+
let keyed = false;
|
|
185
|
+
for (let i = 3; i < pixels.length && !keyed; i += 4) keyed = pixels[i] < 255;
|
|
186
|
+
if (!keyed) throw clipFail(`clip "${d.id}": ${f.rel} has no transparent pixel; a clip is keyed, not a full-frame video`);
|
|
187
|
+
}
|
|
188
|
+
totalFrames += d.count;
|
|
189
|
+
totalBytes += bytes;
|
|
190
|
+
return { ...d, ...size, bytes, frames: frames.map((f) => f.rel) };
|
|
191
|
+
});
|
|
192
|
+
if (totalFrames > limits.framesTotal) throw clipFail(`${totalFrames} clip frames in all (at most ${limits.framesTotal})`);
|
|
193
|
+
if (totalBytes > limits.bytesTotal) throw clipFail(`${(totalBytes / 1048576).toFixed(1)} MB of clip frames in all (at most ${(limits.bytesTotal / 1048576).toFixed(0)} MB)`);
|
|
194
|
+
return clips;
|
|
195
|
+
}
|
|
196
|
+
|
|
92
197
|
/**
|
|
93
198
|
* Pre-flight scan of the stage folder before any browser starts. Returns the file list, the raster
|
|
94
|
-
* URLs to decode
|
|
95
|
-
* the file and the reason.
|
|
199
|
+
* URLs to decode, the Blender plate (or null) and the declared keyed clips (scanClips; their frames are not
|
|
200
|
+
* page rasters); throws Exit 17 (contract) or 19 (network) naming the file and the reason. `clips: false`
|
|
201
|
+
* (cover mode) ignores clips.json, so a declared folder is held to the raster limits.
|
|
96
202
|
*/
|
|
97
|
-
export function scanStage(stageDir) {
|
|
203
|
+
export function scanStage(stageDir, { clips: allowClips = true } = {}) {
|
|
98
204
|
if (!existsSync(join(stageDir, "index.html"))) throw new Exit(EXIT.STAGE_CONTRACT_ERROR, `STAGE_CONTRACT_ERROR: no stage/index.html in ${stageDir}; author the page first (references/stage.md)`);
|
|
99
205
|
const root = realpathSync(stageDir);
|
|
100
206
|
const files = [];
|
|
@@ -125,6 +231,8 @@ export function scanStage(stageDir) {
|
|
|
125
231
|
const plate = readPlate(root, "plate");
|
|
126
232
|
const preview = readPlate(root, "plate-preview");
|
|
127
233
|
const listed = new Set([plate, preview].filter(Boolean).flatMap((p) => p.frames.map((f) => `${p.dir}/${f.name}`)));
|
|
234
|
+
const clips = allowClips ? scanClips(root) : [];
|
|
235
|
+
for (const c of clips) for (const rel of c.frames) listed.add(rel);
|
|
128
236
|
for (const file of files) {
|
|
129
237
|
if (RASTER_TYPES.has(file.ext) && listed.has(file.rel.split(sep).join("/"))) continue;
|
|
130
238
|
if (TEXT_TYPES.has(file.ext)) {
|
|
@@ -156,7 +264,25 @@ export function scanStage(stageDir) {
|
|
|
156
264
|
const bySize = new Map();
|
|
157
265
|
for (const r of rasters) bySize.set(r.size, (bySize.get(r.size) ?? 0) + 1);
|
|
158
266
|
for (const [size, count] of bySize) if (size !== "unknown" && count >= RASTER_LIMITS.flipbook) throw new Exit(EXIT.STAGE_CONTRACT_ERROR, `STAGE_CONTRACT_ERROR: ${count} rasters of ${size} look like a flipbook; animate with the page, not a frame sequence`);
|
|
159
|
-
return { root, files, rasters: rasters.map((r) => `/${r.rel.split(sep).join("/")}`), plate };
|
|
267
|
+
return { root, files, rasters: rasters.map((r) => `/${r.rel.split(sep).join("/")}`), plate, clips };
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
/**
|
|
271
|
+
* window.LitClips for LitStage.keyedClip: id -> { src, count, fps, width, height }, written from clips.json and
|
|
272
|
+
* the first frame's header. null when the stage declares no clips (or one the scan would refuse).
|
|
273
|
+
*/
|
|
274
|
+
function clipsScript(root) {
|
|
275
|
+
try {
|
|
276
|
+
const table = Object.fromEntries(
|
|
277
|
+
declaredClips(root).map((c) => {
|
|
278
|
+
const info = rasterInfo(readFileSync(join(root, CLIPS_DIR, c.dir, clipFrame(1))), ".png");
|
|
279
|
+
return [c.id, { src: `${CLIPS_DIR}/${c.dir}`, count: c.count, fps: c.fps, width: info.width, height: info.height }];
|
|
280
|
+
}),
|
|
281
|
+
);
|
|
282
|
+
return Object.keys(table).length ? `window.LitClips = ${JSON.stringify(table)};\n` : null;
|
|
283
|
+
} catch {
|
|
284
|
+
return null;
|
|
285
|
+
}
|
|
160
286
|
}
|
|
161
287
|
|
|
162
288
|
const FONT_FORMAT = { ".ttf": "truetype", ".otf": "opentype", ".woff": "woff", ".woff2": "woff2" };
|
|
@@ -193,6 +319,7 @@ export function stageRouter({ root, fonts, record, style = null }) {
|
|
|
193
319
|
const kit = readFileSync(join(SKILL_ROOT, "engine", "stage-kit.js"));
|
|
194
320
|
const loopKit = readFileSync(join(SKILL_ROOT, "engine", "loop-kit.js"));
|
|
195
321
|
const threeRoot = realpathSync(THREE_DIR);
|
|
322
|
+
const clipsJs = clipsScript(root);
|
|
196
323
|
return async (route) => {
|
|
197
324
|
const url = route.request().url();
|
|
198
325
|
if (!url.startsWith(`${STAGE_ORIGIN}/`)) {
|
|
@@ -210,6 +337,7 @@ export function stageRouter({ root, fonts, record, style = null }) {
|
|
|
210
337
|
if (path === "/lit/stage-kit.js") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".js"], body: kit });
|
|
211
338
|
if (path === "/lit/loop-kit.js") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".js"], body: loopKit });
|
|
212
339
|
if (path === "/lit/fonts.css") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".css"], body: fonts.css });
|
|
340
|
+
if (clipsJs && path === "/lit/clips.js") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".js"], body: clipsJs });
|
|
213
341
|
// The film's house style (references/studio.md): type, colour and zone tokens, and the shot timeline.
|
|
214
342
|
if (style && path === "/lit/style.css") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".css"], body: style.css });
|
|
215
343
|
if (style && path === "/lit/style.js") return route.fulfill({ status: 200, contentType: CONTENT_TYPES[".js"], body: style.js });
|
|
@@ -11,6 +11,7 @@ Load this file after `treatment.json` says `path: stage`, together with `referen
|
|
|
11
11
|
index.html the film (start from `scaffold`)
|
|
12
12
|
assets/ a named product's real files (`assets`, treatment.md)
|
|
13
13
|
scene.py, plate/ the Blender rung only (depth.md)
|
|
14
|
+
clips/ declared keyed clips: clips.json and one folder of frames per clip (Clips)
|
|
14
15
|
*.svg *.png *.jpg *.webp *.js *.css *.wav your own local assets
|
|
15
16
|
```
|
|
16
17
|
|
|
@@ -19,7 +20,7 @@ Assets are your own work: SVG you draw, small rasters you make as textures or st
|
|
|
19
20
|
- `<video>`, `<audio>`, `<iframe>`, `<object>`, `<embed>`, `<frame>` (exit 17);
|
|
20
21
|
- `new Audio()`, `AudioContext`, `OfflineAudioContext`, workers and service workers (exit 17);
|
|
21
22
|
- `WebSocket`, `WebTransport`, `RTCPeerConnection`, `EventSource`, any absolute or protocol-relative URL other than an XML namespace, and preconnect or prefetch links (exit 19);
|
|
22
|
-
- more than 24 raster images or 8 MB of rasters, 10 or more rasters of one size (a flipbook), and any animated GIF, APNG or WebP (exit 17). Rasters are textures and stills, never a frame sequence;
|
|
23
|
+
- more than 24 raster images or 8 MB of rasters, 10 or more rasters of one size (a flipbook), and any animated GIF, APNG or WebP (exit 17). Rasters are textures and stills, never a frame sequence. The one frame sequence a page may carry is a declared keyed clip (Clips);
|
|
23
24
|
- any file type outside html, js, mjs, css, svg, png, jpg, webp, gif, wav, woff, woff2, ttf, otf and json, a `node_modules` folder, and links that leave `stage/` (exit 17).
|
|
24
25
|
|
|
25
26
|
The page loads these product routes (the scaffold writes them):
|
|
@@ -31,7 +32,7 @@ The page loads these product routes (the scaffold writes them):
|
|
|
31
32
|
<script src="/lit/stage-kit.js"></script>
|
|
32
33
|
```
|
|
33
34
|
|
|
34
|
-
`/lit/style.css` and `/lit/style.js` carry the treatment's house style and shot timeline (`studio.md`, The page).
|
|
35
|
+
`/lit/style.css` and `/lit/style.js` carry the treatment's house style and shot timeline (`studio.md`, The page). A page with declared keyed clips also loads `<script src="/lit/clips.js"></script>` after the kit (Clips).
|
|
35
36
|
|
|
36
37
|
`/lit/fonts.css` declares this product's verified faces with `font-display: block`: `"Archivo"` (weights 400, 700, 900; `font-stretch` 75 %, 100 %, 125 %), `"Pretendard"` (400, 700) for Hangul, `"VT323"`, `"Galmuri9"`, `"MesloLGS NF"` and `"JetBrains Mono"` (variable `wght` 100 to 800, a fixed advance, so weight motion never reflows). Name only these families; any other face is a system fallback the text check reports.
|
|
37
38
|
|
|
@@ -144,6 +145,29 @@ LitStage.clip.wipe(panel, LitStage.at(t, 5, 0.5, "snap"), "up");
|
|
|
144
145
|
document.body.style.background = LitStage.mix(palette.dusk, palette.night, LitStage.at(t, 8, 3));
|
|
145
146
|
```
|
|
146
147
|
|
|
148
|
+
## Clips
|
|
149
|
+
|
|
150
|
+
Real keyed footage (a reaction clip, a spinning loop shot on green screen) joins the film as a layer inside the page. The footage is keyed outside the renderer into one 8-bit RGBA PNG per frame, the frames are declared, and the page picks the frame from film time. A declared clip is not counted as a flipbook or against the raster limits; every other raster keeps them. Nothing is encoded by hand: the frames are captured with the page, so the flash audit, the determinism replay and the text checks run on the final pixels like any other film.
|
|
151
|
+
|
|
152
|
+
1. Put each clip's frames in `stage/clips/<dir>/` as `frame_0001.png`, `frame_0002.png` and so on, with no gaps and no other image in the folder.
|
|
153
|
+
2. Declare them in `stage/clips/clips.json`:
|
|
154
|
+
|
|
155
|
+
```json
|
|
156
|
+
{ "clips": [ { "id": "boom", "dir": "01-vine-boom", "count": 122, "fps": 30 } ] }
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
`id` is the name the page uses (letters, digits, `-`, `_`), `dir` is a folder directly under `clips/`, `count` is the number of frames and `fps` is the clip's own rate, 1 to 30. A clip used twice is declared once.
|
|
160
|
+
3. The page loads `<script src="/lit/clips.js"></script>` after the kit, registers each use once with `LitStage.keyedClip({ parent, id, box })` and calls the returned `show(t, opts)` from `render(t)`. `parent` is the element the clip sits in; `box` is its place in pixels, with the frame fitted inside it. `show` returns the clip's wrapper element, or `null` while it is hidden; scale, fade or move that wrapper from `t` like any other layer.
|
|
161
|
+
|
|
162
|
+
```js
|
|
163
|
+
const boom = LitStage.keyedClip({ parent: layer, id: "boom", box: { x: 1200, y: 300, w: 520, h: 511 } });
|
|
164
|
+
LitStage.define({ width: 1920, height: 1080, fps: 30, duration: 4, render(t) { boom(t, { start: 2.1 }); } });
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
The frame shown is `floor((t - start) * fps) + 1`, counted from `from`, so a cue is plain arithmetic: a clip whose own sound begins at frame 85 and must land on a cue at 0.12 s has `start = 0.12 - 84 / 30`. Options: `start` (film seconds, default 0), `from` and `to` (the frame range, default the whole clip), `loop` (wrap by frame index) and `hold` (keep the last frame). Before `start`, and past `to` without `loop` or `hold`, the clip is hidden. The existing `LitStage.clip` helpers (circle, inset, wipe, polygon) are CSS masks and are unchanged.
|
|
168
|
+
|
|
169
|
+
The scan refuses, with exit 17 and the clip named: more than 12 clips, more than 360 frames in a clip or 1500 in all, more than 40 MB in a clip or 128 MB in all, a frame whose long side is above 720 px (a clip is an overlay, not the film), a frame rate above 30, frames of mixed sizes, a missing or extra frame, a frame that is not an 8-bit RGBA PNG or has no transparent pixel in its first, middle and last frame (an opaque video is not keyed), an animated image and a duplicate `id`. A folder that is not declared, or any frame sequence beside a declared clip, is a flipbook as before. A README cover takes no clips. Keep clips clear of copy: the text checks read DOM text, so a clip laid over a line is yours to catch on the stills. `manifest.json` and `gate-report.txt` list each clip.
|
|
170
|
+
|
|
147
171
|
## Craft on the stage
|
|
148
172
|
|
|
149
173
|
Build the film beat by beat from the treatment: each beat's `onScreen` is a drawing you make, its `motion` is a curve you choose, and its `sound` is a moment the cut lands on. Draw the subject with SVG, Canvas or CSS shapes in layers (a far layer, the subject, a near layer) and move them at different rates for depth. Change the transition from beat to beat: a match cut on a shape that carries over, a mask wipe, a morph from one form to the next, a push, a hard cut on the pulse. Give type a clear hierarchy (one line leads, the rest support) and let it enter with its own ease rather than a shared fade. Every beat should show something the previous one did not.
|
|
@@ -180,7 +204,7 @@ The gate checks the flash audit on the master and the looping preview (the audit
|
|
|
180
204
|
| 13 | A gate rule failed | Fix the named cause and render the next round |
|
|
181
205
|
| 14 / 15 | Runtime or fonts not pre-warmed / pin mismatch | `litcodex motion-runtime install` outside the sandbox |
|
|
182
206
|
| 16 | Treatment invalid (field named) | Fix that field |
|
|
183
|
-
| 17 | Stage contract (element, API, asset, size, define) | Remove or redraw the named thing |
|
|
207
|
+
| 17 | Stage contract (element, API, asset, clip, size, define) | Remove or redraw the named thing |
|
|
184
208
|
| 18 | Nondeterministic frame (frame and region named) | Replace the leaking source with `t` or `LitStage.rand` |
|
|
185
209
|
| 19 | Network request or connection | Make the asset local |
|
|
186
210
|
| 20 | Sound invalid | See the sound plan in the treatment |
|
|
@@ -2,17 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
- **Advisory server id:** `typescript` — `typescript-language-server --stdio`
|
|
4
4
|
- **Extensions:** `.ts .tsx .js .jsx .mjs .cjs .mts .cts`
|
|
5
|
-
- **Install hint:** `npm install -g typescript-language-server typescript`
|
|
5
|
+
- **Install hint:** `npm install -g typescript-language-server typescript@6`
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
9
|
-
- **macOS:** `npm install -g typescript-language-server typescript`
|
|
10
|
-
- **Linux:** `npm install -g typescript-language-server typescript`
|
|
11
|
-
- **Windows:** `npm install -g typescript-language-server typescript` (PowerShell or cmd)
|
|
9
|
+
- **macOS:** `npm install -g typescript-language-server typescript@6`
|
|
10
|
+
- **Linux:** `npm install -g typescript-language-server typescript@6`
|
|
11
|
+
- **Windows:** `npm install -g typescript-language-server typescript@6` (PowerShell or cmd)
|
|
12
12
|
|
|
13
13
|
`typescript-language-server` is only a thin wrapper — it needs the `typescript`
|
|
14
14
|
package (`tsserver`) present too, either globally or in the project's
|
|
15
|
-
`node_modules`. Always install both.
|
|
15
|
+
`node_modules`. Always install both. TypeScript 7 ships no lib/tsserver.js, which typescript-language-server loads.
|
|
16
16
|
|
|
17
17
|
Confirm it resolves:
|
|
18
18
|
|
|
@@ -17,7 +17,8 @@ export const LANGUAGES: readonly LanguageServer[] = [
|
|
|
17
17
|
serverId: "typescript",
|
|
18
18
|
command: ["typescript-language-server", "--stdio"],
|
|
19
19
|
extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"],
|
|
20
|
-
installHint:
|
|
20
|
+
installHint:
|
|
21
|
+
"npm install -g typescript-language-server typescript@6 (TypeScript 7 ships no lib/tsserver.js, which typescript-language-server loads)",
|
|
21
22
|
},
|
|
22
23
|
{
|
|
23
24
|
language: "python",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litcodex/lit-loop",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.36",
|
|
4
4
|
"description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": true,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@litfamily/litcodex",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.36",
|
|
4
4
|
"description": "Codex CLI plugin that turns a request into a goal with checks, keeps the evidence in your project and hands unfinished work to the next session.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"codex",
|
|
@@ -53,7 +53,7 @@
|
|
|
53
53
|
"readme-assets"
|
|
54
54
|
],
|
|
55
55
|
"dependencies": {
|
|
56
|
-
"@litcodex/lit-loop": "1.0.
|
|
56
|
+
"@litcodex/lit-loop": "1.0.36"
|
|
57
57
|
},
|
|
58
58
|
"bundledDependencies": [
|
|
59
59
|
"@litcodex/lit-loop"
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.36"><title>release: 1.0.36</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.36</text></g></svg>
|