@m1kapp/kit 0.0.26 → 0.0.28

package/README.md

@@ -750,6 +750,42 @@ export const GET = handler(async () => {
 });
 ```
 
+### 서버 유틸 (의존성 0)
+
+API 라우트에서 자주 손으로 만들던 것들 — 전부 `@m1kapp/kit/server`에 있어요.
+
+```ts
+import {
+  requireEnv, fetchWithRetry, withRetry, recoverJsonFromText,
+  scrapeOg, todayKST, dateInTz, idToSlug, slugToId, appHost,
+} from "@m1kapp/kit/server";
+
+// 필수 env 검증 (없으면 500 throw, 있으면 타입된 객체)
+const { XAI_API_KEY } = requireEnv(["XAI_API_KEY"]);
+
+// fetch + 타임아웃 + 429/5xx 자동 재시도 (마지막 응답 반환)
+const res = await fetchWithRetry(url, { headers: { authorization: `Bearer ${XAI_API_KEY}` } });
+
+// 아무 async나 재시도 (Neon 콜드스타트 등)
+const rows = await withRetry(() => db.query.users.findMany(), {
+  shouldRetry: (e) => String(e).includes("fetch failed"),
+});
+
+// LLM 응답에서 JSON 복구 (```json 펜스·트레일링 콤마·노이즈 제거)
+const data = recoverJsonFromText<{ items: string[] }>(llmReply);
+
+// Open Graph 스크래핑
+const og = await scrapeOg("example.com");   // { title, description, image, siteName, url }
+
+// 타임존 날짜
+todayKST();                                  // "2026-06-04"
+dateInTz(Date.now(), "America/New_York");
+
+// base62 slug + 호스트
+idToSlug(42, 1000);                          // "..."  (slugToId로 역변환)
+const base = `https://${appHost("m1k.app")}`;
+```
+
 ---
 
 ## Utils

package/bin/stats.mjs

@@ -155,11 +155,10 @@ for (const name of allImports) {
   // 카테고리별 사용 수 (loc 0이어도 카운트 — "Tab"도 사용한 거니까)
   usedByCategory[meta.category] = (usedByCategory[meta.category] || 0) + 1;
 
-  // LOC 절약은 소스 파일 단위로 1번만
-  if (meta.source && countedSources.has(meta.source)) continue;
-  if (meta.source) countedSources.add(meta.source);
-
-  if (meta.loc > 0) {
+  // LOC 절약은 소스 파일 단위로 1번만. 대표(loc>0)만 카운트하므로 import
+  // 순서와 무관 — 비대표(loc 0)가 먼저 와도 source를 선점하지 않는다.
+  if (meta.loc > 0 && !(meta.source && countedSources.has(meta.source))) {
+    if (meta.source) countedSources.add(meta.source);
     usedFeatures.push({ name, loc: meta.loc, category: meta.category });
     savedLines += meta.loc;
   }

package/dist/index.d.mts

@@ -49,15 +49,24 @@ interface AppShellProps {
      * Accent color (any CSS color) propagated to kit components as `--kit-accent`.
      * Lets you re-skin the whole shell — Switch, SegmentedControl, ChatBubble,
      * ActionCard, ListRow… — in one place. e.g. accent="#e2603f"
+     *
+     * When `accent` is a hex color, a contrasting foreground (`--kit-accent-fg`,
+     * black/white) is derived automatically so labels on the accent stay legible.
      */
     accent?: string;
+    /**
+     * Foreground color used *on top of* the accent (`--kit-accent-fg`). Defaults
+     * to an auto-derived black/white for hex accents, else white. Set this when
+     * `accent` is a non-hex CSS color (named/rgb/hsl) and the default contrasts poorly.
+     */
+    accentFg?: string;
     style?: CSSProperties;
 }
 /**
  * Mobile app-like container with rounded corners, shadow, and ring.
  * Centers content and constrains width for a phone-like viewport.
  */
-declare function AppShell({ children, className, maxWidth, maxHeight, accent, style, }: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ children, className, maxWidth, maxHeight, accent, accentFg, style, }: AppShellProps): react_jsx_runtime.JSX.Element;
 interface AppShellHeaderProps {
     children: ReactNode;
     className?: string;

package/dist/index.d.ts

@@ -49,15 +49,24 @@ interface AppShellProps {
      * Accent color (any CSS color) propagated to kit components as `--kit-accent`.
      * Lets you re-skin the whole shell — Switch, SegmentedControl, ChatBubble,
      * ActionCard, ListRow… — in one place. e.g. accent="#e2603f"
+     *
+     * When `accent` is a hex color, a contrasting foreground (`--kit-accent-fg`,
+     * black/white) is derived automatically so labels on the accent stay legible.
      */
     accent?: string;
+    /**
+     * Foreground color used *on top of* the accent (`--kit-accent-fg`). Defaults
+     * to an auto-derived black/white for hex accents, else white. Set this when
+     * `accent` is a non-hex CSS color (named/rgb/hsl) and the default contrasts poorly.
+     */
+    accentFg?: string;
     style?: CSSProperties;
 }
 /**
  * Mobile app-like container with rounded corners, shadow, and ring.
  * Centers content and constrains width for a phone-like viewport.
  */
-declare function AppShell({ children, className, maxWidth, maxHeight, accent, style, }: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ children, className, maxWidth, maxHeight, accent, accentFg, style, }: AppShellProps): react_jsx_runtime.JSX.Element;
 interface AppShellHeaderProps {
     children: ReactNode;
     className?: string;