create-lesa-app 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -8,6 +8,49 @@
 
 ## [Unreleased]
 
+## [0.0.3] — 2026-09-15
+
+### Changed
+
+- 받아오는 템플릿을 `v0.0.3` 으로 올린다(`TEMPLATE_REF`). 프리로더 콜백 격리·딥링크
+  인코딩·Android 서명 앵커·auth 로그인 라우트가 새 프로젝트에 들어간다
+
+## [0.0.2] — 2026-09-14
+
+### Changed
+
+- 받아오는 템플릿을 `v0.0.2` 로 올린다(`TEMPLATE_REF`)
+
+### Fixed
+
+- 번역된 README(`README.ko.md`)가 생성된 앱에 그대로 복사됐다. 이름 목록이 아니라
+  패턴으로 걸러 `README.<lang>.md` 를 전부 제외한다
+
+- Java 예약어를 slug 으로 받아들여 `com.class.development` 같은 패키지를 만들었다.
+  Android 가 그 이름으로 Java 를 생성하므로 Gradle 이 깨지고, 에러는 한참 뒤
+  빌드에서 난다. 이제 입력 시점에 거부한다 — 검사는 하이픈을 뺀 세그먼트 기준이라
+  `gym-class` 는 통과한다
+
+- 표시 이름에 작은따옴표가 있으면(`Dev's App`) `env-candidates.ts` 가 문법적으로
+  깨진 채 커밋됐다. 역슬래시는 escape 로 먹혀 조용히 사라졌고, 줄바꿈은 파일을
+  깼다. 이제 리터럴에 맞게 escape 한다
+
+- 완료 안내가 없어진 문서 절(`README "Make it yours" §3`)을 가리키고 있었다 —
+  생성된 앱의 README 를 짧은 것으로 바꾸면서 그 절이 사라졌다. 이제 교체할 파일
+  이름을 직접 말한다
+
+### Changed
+
+- 생성된 앱이 자기 정체를 갖는다 — `package.json` 의 `name` 을 slug 로, `version` 을
+  `1.0.0` 으로 두고 템플릿 `license` 를 지운다. 스토어 버전인
+  `env-candidates.ts` 의 `version.app` 도 같이 맞춘다
+
+- 템플릿 레포 전용 파일(`CHANGELOG.md`·`LICENSE`·`README.md`)은 생성된 앱에 복사하지
+  않는다. 대신 앱 이름으로 짧은 `README.md` 를 새로 쓴다. `AGENTS.md`·`docs/` 는
+  앱과 같이 가는 게 목적이라 그대로 둔다
+- `receipt.fileCount` 를 초기 커밋의 추적 파일 수로 센다 — 원격 경로는 복사 콜백이
+  없어서 0 으로 찍히고 있었다
+
 ## [0.0.1] — 2026-09-11
 
 첫 공개 릴리즈. **PoC** 다 — `0.0.x` 는 안정성을 약속하지 않는다.
@@ -26,5 +69,7 @@
 
 ---
 
-[unreleased]: https://github.com/LESANF/create-lesa-app/compare/v0.0.1...HEAD
+[unreleased]: https://github.com/LESANF/create-lesa-app/compare/v0.0.3...HEAD
+[0.0.3]: https://github.com/LESANF/create-lesa-app/compare/v0.0.2...v0.0.3
+[0.0.2]: https://github.com/LESANF/create-lesa-app/compare/v0.0.1...v0.0.2
 [0.0.1]: https://github.com/LESANF/create-lesa-app/releases/tag/v0.0.1

package/README.ko.md

@@ -5,6 +5,10 @@
 lesa Expo 템플릿 발사대.<br/>
 slug 하나만 주면 스킴·번들 ID·Android 패키지·첫 커밋까지 나온다.
 
+[![npm](https://img.shields.io/npm/v/create-lesa-app?style=flat-square&logo=npm&color=CB3837)](https://www.npmjs.com/package/create-lesa-app)
+[![downloads](https://img.shields.io/npm/dm/create-lesa-app?style=flat-square&color=CB3837)](https://www.npmjs.com/package/create-lesa-app)
+[![license](https://img.shields.io/github/license/LESANF/create-lesa-app?style=flat-square)](./LICENSE)
+
 [![Expo SDK](https://img.shields.io/badge/Expo_SDK-57-000020?style=flat-square&logo=expo&logoColor=white)](https://docs.expo.dev/versions/v57.0.0/)
 [![React Native](https://img.shields.io/badge/React_Native-0.86-61DAFB?style=flat-square&logo=react&logoColor=white)](https://reactnative.dev)
 [![expo-router](https://img.shields.io/badge/expo--router-57-000020?style=flat-square&logo=expo&logoColor=white)](https://docs.expo.dev/router/introduction/)

package/README.md

@@ -5,6 +5,10 @@
 Launcher for the lesa Expo template.<br/>
 One slug in — schemes, bundle ids, Android packages and a first commit out.
 
+[![npm](https://img.shields.io/npm/v/create-lesa-app?style=flat-square&logo=npm&color=CB3837)](https://www.npmjs.com/package/create-lesa-app)
+[![downloads](https://img.shields.io/npm/dm/create-lesa-app?style=flat-square&color=CB3837)](https://www.npmjs.com/package/create-lesa-app)
+[![license](https://img.shields.io/github/license/LESANF/create-lesa-app?style=flat-square)](./LICENSE)
+
 [![Expo SDK](https://img.shields.io/badge/Expo_SDK-57-000020?style=flat-square&logo=expo&logoColor=white)](https://docs.expo.dev/versions/v57.0.0/)
 [![React Native](https://img.shields.io/badge/React_Native-0.86-61DAFB?style=flat-square&logo=react&logoColor=white)](https://reactnative.dev)
 [![expo-router](https://img.shields.io/badge/expo--router-57-000020?style=flat-square&logo=expo&logoColor=white)](https://docs.expo.dev/router/introduction/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lesa-app",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Create a new project from the lesa Expo SDK 57 template",
   "scripts": {
     "start": "tsx src/index.tsx",

package/src/apply.ts

@@ -33,6 +33,17 @@ const LEFTOVER = /write[-.]your/;
 export class ApplyError extends Error {}
 
 /** `env-candidates.ts` 치환. displayName 은 자리표시가 아니라 빈 문자열이라 따로 넣는다. */
+/**
+ * 작은따옴표 문자열 리터럴에 넣을 수 있게 escape 한다. `Dev's App` 같은 이름이
+ * 그대로 들어가면 `env-candidates.ts` 가 문법적으로 깨진다.
+ */
+function escapeSingleQuoted(value: string): string {
+  return value
+    .replace(/\\/g, '\\\\')
+    .replace(/'/g, "\\'")
+    .replace(/\r\n?|\n/g, '\\n');
+}
+
 export async function applyEnvCandidates(
   projectDir: string,
   fields: DerivedFields
@@ -51,7 +62,10 @@ export async function applyEnvCandidates(
 
   if (fields.displayName) {
     const before = source;
-    source = source.replace("displayName: '',", `displayName: '${fields.displayName}',`);
+    source = source.replace(
+      "displayName: '',",
+      `displayName: '${escapeSingleQuoted(fields.displayName)}',`
+    );
     if (source === before) {
       throw new ApplyError("Could not find the displayName slot (`displayName: '',`).");
     }

package/src/copy.ts

@@ -1,9 +1,6 @@
 /**
  * 로컬 템플릿 폴더 → 대상 디렉터리 복사.
  *
- * 템플릿 레포가 private 이라 tarball 을 쓸 수 없다(사유: 템플릿 `docs/cli.md`).
- * 배포 방식이 정해지면 이 파일만 교체한다 — 다른 모듈은 `copyTemplate` 시그니처만 안다.
- *
  * **복사 대상 = git 이 추적하는 파일.** 제외 목록을 손으로 들고 있으면 템플릿에 새 gitignore
  * 항목이 생길 때마다 놓친다(실제로 `.pnpm-store`·`expo-env.d.ts`·`npmlogin.log` 를 놓쳤다).
  * `git ls-files` 는 산출물·로컬 상태를 정의상 제외한다.

package/src/create.ts

@@ -12,6 +12,8 @@ import { applyEnvCandidates, applyEnvFile } from './apply.ts';
 import { assertEmptyTarget, copyTemplate } from './copy.ts';
 import { derive } from './derive.ts';
 import { fetchTemplate } from './fetch-template.ts';
+import { applyIdentity } from './identity.ts';
+import { pruneRepoOnly } from './repo-only.ts';
 
 import type { AppInput } from './derive.ts';
 
@@ -53,6 +55,13 @@ export type CreateResult = {
   receipt: { fileCount: number; wroteEnvFile: boolean; source: 'local' | 'github' };
 };
 
+async function countTracked(dir: string): Promise<number> {
+  const { stdout } = await run('git', ['-C', dir, 'ls-files', '-z'], {
+    maxBuffer: 32 * 1024 * 1024,
+  });
+  return stdout.split('\0').filter(Boolean).length;
+}
+
 async function gitInit(dir: string): Promise<void> {
   await run('git', ['-C', dir, 'init', '-q']);
   await run('git', ['-C', dir, 'add', '-A']);
@@ -95,6 +104,8 @@ export async function createApp(options: CreateOptions): Promise<CreateResult> {
       await fetchTemplate(targetDir, message => step({ index: 0, note: message }));
     }
     copied = true;
+    await pruneRepoOnly(targetDir, { displayName, slug });
+    await applyIdentity(targetDir, slug);
 
     step({ index: 1 });
     await applyEnvCandidates(targetDir, fields);
@@ -104,6 +115,8 @@ export async function createApp(options: CreateOptions): Promise<CreateResult> {
 
     step({ index: 3 });
     await gitInit(targetDir);
+    // 추적 파일 수가 유일한 정답이다 — 원격 경로는 복사 콜백이 없고, prune 이 3개를 뺀다.
+    fileCount = await countTracked(targetDir);
     step({ index: CREATE_STEPS.length });
   } catch (error) {
     if (copied) {
@@ -123,7 +136,7 @@ export async function createApp(options: CreateOptions): Promise<CreateResult> {
     nextSteps: [
       `cd ${name} && pnpm install`,
       'pnpm ios:development   (or pnpm android:development)',
-      'Replace the icon and splash in assets/ — README "Make it yours" §3',
+      'Replace assets/images/icon.png · adaptive-icon.png · splash-icon.png',
       'Drop your config files into firebase/ to turn push on — docs/push.md',
       'grep -rn "TODO(앱)" src   — the spots your project fills in',
     ],

package/src/derive.ts

@@ -25,6 +25,20 @@ export type DerivedFields = {
 
 export const SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
 
+/**
+ * Java 예약어는 패키지 세그먼트로 못 쓴다 — `com.class.development` 은 Gradle 에서
+ * 깨진다. Android 가 이 이름으로 Java 를 생성하기 때문이고, 에러는 한참 뒤 빌드에서 난다.
+ */
+const JAVA_RESERVED = new Set([
+  'abstract', 'assert', 'boolean', 'break', 'byte', 'case', 'catch', 'char',
+  'class', 'const', 'continue', 'default', 'do', 'double', 'else', 'enum',
+  'extends', 'false', 'final', 'finally', 'float', 'for', 'goto', 'if',
+  'implements', 'import', 'instanceof', 'int', 'interface', 'long', 'native',
+  'new', 'null', 'package', 'private', 'protected', 'public', 'return',
+  'short', 'static', 'strictfp', 'super', 'switch', 'synchronized', 'this',
+  'throw', 'throws', 'transient', 'true', 'try', 'void', 'volatile', 'while',
+]);
+
 /** 입력 검증 — 통과하지 못하면 이유를 돌려준다(호출부가 다시 묻는다). */
 export function validateSlug(slug: string): string | null {
   if (!slug) return 'Enter a slug.';
@@ -33,6 +47,11 @@ export function validateSlug(slug: string): string | null {
   }
   // reverse-domain 세그먼트로 들어가므로 하이픈으로 끝나면 `com.lesa-app-.development` 가 된다.
   if (slug.endsWith('-')) return 'Cannot end with a hyphen.';
+  // 패키지 세그먼트는 하이픈을 뺀 형태다 — `gym-class` 는 `gymclass` 라 괜찮다.
+  const segment = slug.replaceAll('-', '');
+  if (JAVA_RESERVED.has(segment)) {
+    return `"${segment}" is a Java keyword and cannot be an Android package segment.`;
+  }
   return null;
 }
 

package/src/fetch-template.ts

@@ -17,7 +17,7 @@ const run = promisify(execFile);
 
 export const TEMPLATE_REPO = 'LESANF/react-native-template-lesa';
 /** 템플릿을 릴리즈하면 이 값을 올린다. */
-export const TEMPLATE_REF = 'v0.0.1';
+export const TEMPLATE_REF = 'v0.0.3';
 
 export class FetchError extends Error {}
 

package/src/flow.test.mjs

@@ -1,7 +1,15 @@
 import assert from 'node:assert/strict';
 
-import { derive } from './derive.ts';
-import { advance, editingField, initialFlow, setField, stepOrder, toInput } from './flow.ts';
+import { derive, validateSlug } from './derive.ts';
+import {
+  advance,
+  editingField,
+  initialFlow,
+  isUsableAsSlug,
+  setField,
+  stepOrder,
+  toInput,
+} from './flow.ts';
 
 /** 타이핑 시뮬레이션: 문자열을 넣고 Enter. */
 function type(state, text) {
@@ -96,3 +104,17 @@ console.log('flow: 7/7 groups pass');
 }
 
 console.log('derive: hyphen slug produces a valid Android package');
+
+// 9) Java 예약어 — 패키지 세그먼트로 들어가면 Gradle 이 깬다
+{
+  for (const slug of ['class', 'new', 'int', 'true', 'cl-ass']) {
+    assert.match(validateSlug(slug) ?? '', /Java keyword/, `${slug} must be rejected`);
+  }
+  for (const slug of ['gym-class', 'classroom', 'gym-log']) {
+    assert.equal(validateSlug(slug), null, `${slug} must be accepted`);
+  }
+  // 이름 스텝도 같은 검사를 탄다 — 통과하지 못하면 slug 을 따로 묻는다
+  assert.equal(isUsableAsSlug('class'), false);
+}
+
+console.log('derive: Java keywords are rejected as package segments');

package/src/identity.ts

@@ -0,0 +1,35 @@
+/**
+ * 생성된 앱이 자기 정체를 갖게 한다 — 템플릿의 이름·버전·라이선스를 물려받지 않도록.
+ *
+ * 앱의 스토어 버전은 `env-candidates.ts` 의 `version.app` 이고 `package.json` 의 것이
+ * 아니다. 둘이 어긋나면 읽는 사람이 헷갈리므로 같이 맞춘다.
+ */
+
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+/** 새 앱의 첫 버전. 스토어 첫 배포 관례다. */
+export const INITIAL_VERSION = '1.0.0';
+
+export class IdentityError extends Error {}
+
+export async function applyIdentity(projectDir: string, slug: string): Promise<void> {
+  const pkgPath = path.join(projectDir, 'package.json');
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8')) as Record<string, unknown>;
+  pkg.name = slug;
+  pkg.version = INITIAL_VERSION;
+  delete pkg.license; // 템플릿 라이선스다. 앱은 자기 것을 고른다
+  await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+
+  const envPath = path.join(projectDir, 'env-candidates.ts');
+  const source = await readFile(envPath, 'utf8');
+  const block = /(version:\s*\{\s*app:\s*\{)([^}]*)(\})/;
+  const match = source.match(block);
+  if (!match) {
+    throw new IdentityError(
+      `Could not find version.app in env-candidates.ts — the template shape changed.`
+    );
+  }
+  const replaced = match[2].replace(/'\d+\.\d+\.\d+'/g, `'${INITIAL_VERSION}'`);
+  await writeFile(envPath, source.replace(block, `$1${replaced}$3`), 'utf8');
+}

package/src/repo-only.ts

@@ -0,0 +1,39 @@
+/**
+ * 템플릿 레포 전용 파일 — 생성된 앱에는 들어가면 안 된다.
+ * `AGENTS.md`·`docs/` 는 앱과 같이 가는 게 목적이라 여기 없다.
+ */
+
+import { readdir, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const REPO_ONLY = [
+  'CHANGELOG.md', // 템플릿의 릴리즈 이력
+  'LICENSE', // 템플릿 저작권 — 앱은 자기 것을 고른다
+  'README.md', // "MVP 라 사용을 권하지 않습니다" — 아래에서 새로 쓴다
+];
+
+/** 번역된 README — `README.ko.md` 처럼 언어 코드가 붙은 것들. */
+const LOCALIZED_README = /^README\.[a-z]{2}(-[A-Z]{2})?\.md$/;
+
+/** 레포 전용 파일을 지우고 앱 README 를 새로 쓴다. 복사·추출 어느 경로든 뒤에 한 번 돈다. */
+export async function pruneRepoOnly(
+  targetDir: string,
+  app: { displayName: string; slug: string }
+): Promise<void> {
+  const entries = await readdir(targetDir);
+  const remove = [...REPO_ONLY, ...entries.filter(name => LOCALIZED_README.test(name))];
+  await Promise.all(remove.map(name => rm(path.join(targetDir, name), { force: true })));
+
+  const title = app.displayName || app.slug;
+  await writeFile(
+    path.join(targetDir, 'README.md'),
+    `# ${title}\n\n` +
+      '```bash\n' +
+      'pnpm install\n' +
+      'pnpm ios:development   # or pnpm android:development\n' +
+      '```\n\n' +
+      '아이콘·스플래시는 `assets/images/` 의 `icon.png`·`adaptive-icon.png`·`splash-icon.png` 를 교체합니다.\n\n' +
+      '작업 규칙과 메커니즘은 [`AGENTS.md`](./AGENTS.md), 영역별 문서는 [`docs/`](./docs) 에 있습니다.\n',
+    'utf8'
+  );
+}