react-native-control-center 0.1.0

package/lib/commonjs/plugin/index.d.ts

@@ -0,0 +1,43 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+import type { ParsedControl } from '../core/types';
+import type { NativeFile } from '../core/generate';
+export interface ControlCenterPluginProps {
+    /** controls.ts 파일 경로 (사용자 프로젝트 루트 기준) */
+    controls: string;
+    /** 딥링크용 URL scheme. 예: "myapp" */
+    urlScheme: string;
+    /** App Group ID. 기본 "group.{bundleId}.controls" */
+    appGroupId?: string;
+    /** Widget Extension 폴더/타겟 이름. 기본 "ControlCenterExtension" */
+    extensionName?: string;
+    /** 위젯 deployment target. 기본 "18.0" */
+    deploymentTarget?: string;
+    /** Swift 버전. 기본 "5.0" */
+    swiftVersion?: string;
+}
+declare const withControlCenter: ConfigPlugin<ControlCenterPluginProps>;
+/**
+ * generateNativeFiles 출력에서 'shared' 라벨 파일들을 추출해
+ * extensionName/ 접두 부분을 제거한 상대 경로 리스트로 반환.
+ *
+ * 예: "ControlCenterExtension/Intents/X.swift" → "Intents/X.swift"
+ */
+declare function deriveSharedFiles(files: NativeFile[], extensionName: string): string[];
+/**
+ * 단위 테스트용 — mod 안에서 일어나는 핵심 로직(controls 파싱 + 파일 생성 + 디스크 쓰기)을
+ * Expo의 mod 시스템 없이 직접 호출 가능하게 추출.
+ */
+export declare function generateAndWriteFiles(opts: {
+    projectRoot: string;
+    platformRoot: string;
+    bundleId: string;
+    controls: string;
+    urlScheme: string;
+    appGroupId?: string;
+    extensionName?: string;
+}): {
+    files: NativeFile[];
+    controls: ParsedControl[];
+};
+export default withControlCenter;
+export { deriveSharedFiles };

package/lib/commonjs/plugin/index.js

@@ -0,0 +1,177 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAndWriteFiles = generateAndWriteFiles;
+exports.deriveSharedFiles = deriveSharedFiles;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const config_plugins_1 = require("@expo/config-plugins");
+const parseControls_1 = require("../core/parseControls");
+const validateSymbols_1 = require("../core/validateSymbols");
+const generate_1 = require("../core/generate");
+const swift_1 = require("../core/generate/swift");
+const wire_1 = require("../core/xcode/wire");
+const withControlCenter = (config, props) => {
+    validateProps(props);
+    const extensionName = props.extensionName ?? 'ControlCenterExtension';
+    // 두 mod가 공유할 상태. 첫 mod에서 채우고, 두 번째 mod에서 사용.
+    let cachedFiles = null;
+    let cachedControls = null;
+    // Step 1: 사용자 controls.ts 읽고 → 8개 파일을 ios/ 에 쓴다.
+    config = (0, config_plugins_1.withDangerousMod)(config, [
+        'ios',
+        async (cfg) => {
+            const projectRoot = cfg.modRequest.projectRoot;
+            const platformRoot = cfg.modRequest.platformProjectRoot;
+            const bundleId = cfg.ios?.bundleIdentifier;
+            if (!bundleId) {
+                throw new Error('[react-native-control-center] ios.bundleIdentifier must be set in app.json.');
+            }
+            const controlsAbs = path.resolve(projectRoot, props.controls);
+            if (!fs.existsSync(controlsAbs)) {
+                throw new Error(`[react-native-control-center] controls file not found: ${controlsAbs}`);
+            }
+            cachedControls = (0, parseControls_1.parseControlsFile)(controlsAbs);
+            (0, validateSymbols_1.warnUnknownSymbols)(cachedControls); // 심볼 오타 경고 (빌드는 막지 않음)
+            cachedFiles = (0, generate_1.generateNativeFiles)({
+                controls: cachedControls,
+                bundleId,
+                urlScheme: props.urlScheme,
+                ...(props.appGroupId !== undefined && { appGroupId: props.appGroupId }),
+                extensionName,
+            });
+            for (const file of cachedFiles) {
+                const fullPath = path.join(platformRoot, file.path);
+                fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+                fs.writeFileSync(fullPath, file.content);
+            }
+            return cfg;
+        },
+    ]);
+    // Step 1b: 메인 앱 Info.plist에 런타임 스토어가 읽을 키를 주입한다.
+    //   Native Module(Pod 모듈)은 생성된 ControlStore(앱 모듈)를 볼 수 없으므로
+    //   App Group ID와 stateKey 목록을 Info.plist를 통해 전달한다. 값은 codegen이
+    //   쓰는 것과 정확히 동일해야 양쪽이 같은 사물함/큐를 바라본다.
+    config = (0, config_plugins_1.withInfoPlist)(config, (cfg) => {
+        const bundleId = cfg.ios?.bundleIdentifier;
+        if (!bundleId)
+            return cfg; // 상단에서 이미 검증됨 — 방어적 처리
+        const appGroupId = props.appGroupId ?? (0, swift_1.defaultAppGroupId)(bundleId);
+        let controls = cachedControls;
+        if (!controls) {
+            // mod 실행 순서가 dangerous mod보다 앞설 경우를 대비해 한 번 더 파싱.
+            const controlsAbs = path.resolve(cfg.modRequest.projectRoot, props.controls);
+            controls = fs.existsSync(controlsAbs) ? (0, parseControls_1.parseControlsFile)(controlsAbs) : [];
+        }
+        cfg.modResults['RNControlCenterAppGroup'] = appGroupId;
+        cfg.modResults['RNControlCenterStateKeys'] = (0, generate_1.collectStateKeys)(controls);
+        return cfg;
+    });
+    // Step 2: pbxproj 변형 — wireXcodeProject 호출.
+    config = (0, config_plugins_1.withXcodeProject)(config, (cfg) => {
+        if (!cachedFiles) {
+            // dangerous mod가 먼저 돌아야 함. Expo의 mod 순서가 어긋나면 발생 가능.
+            throw new Error('[react-native-control-center] internal: file generation must run before pbxproj wiring.');
+        }
+        const bundleId = cfg.ios?.bundleIdentifier;
+        if (!bundleId) {
+            throw new Error('[react-native-control-center] ios.bundleIdentifier missing during pbxproj wiring.');
+        }
+        const sharedFiles = deriveSharedFiles(cachedFiles, extensionName);
+        const widgetBundleId = `${bundleId}.${extensionName.toLowerCase()}`;
+        (0, wire_1.wireXcodeProject)(cfg.modResults, {
+            mainAppBundleId: bundleId,
+            widgetTargetName: extensionName,
+            widgetBundleId,
+            sharedFiles,
+            ...(props.deploymentTarget !== undefined && {
+                deploymentTarget: props.deploymentTarget,
+            }),
+            ...(props.swiftVersion !== undefined && { swiftVersion: props.swiftVersion }),
+        });
+        return cfg;
+    });
+    return config;
+};
+/**
+ * generateNativeFiles 출력에서 'shared' 라벨 파일들을 추출해
+ * extensionName/ 접두 부분을 제거한 상대 경로 리스트로 반환.
+ *
+ * 예: "ControlCenterExtension/Intents/X.swift" → "Intents/X.swift"
+ */
+function deriveSharedFiles(files, extensionName) {
+    const prefix = `${extensionName}/`;
+    return files
+        .filter((f) => f.target === 'shared')
+        .map((f) => (f.path.startsWith(prefix) ? f.path.slice(prefix.length) : f.path));
+}
+function validateProps(props) {
+    if (!props || typeof props !== 'object') {
+        throw new Error('[react-native-control-center] Plugin props are required. ' +
+            'Add ["react-native-control-center", { controls: "./src/controls.ts", urlScheme: "..." }] to app.json plugins.');
+    }
+    if (!props.controls || typeof props.controls !== 'string') {
+        throw new Error('[react-native-control-center] `controls` prop must be a path to your controls.ts file.');
+    }
+    if (!props.urlScheme || typeof props.urlScheme !== 'string') {
+        throw new Error('[react-native-control-center] `urlScheme` prop is required (e.g. "myapp").');
+    }
+}
+/**
+ * 단위 테스트용 — mod 안에서 일어나는 핵심 로직(controls 파싱 + 파일 생성 + 디스크 쓰기)을
+ * Expo의 mod 시스템 없이 직접 호출 가능하게 추출.
+ */
+function generateAndWriteFiles(opts) {
+    const extensionName = opts.extensionName ?? 'ControlCenterExtension';
+    const controlsAbs = path.resolve(opts.projectRoot, opts.controls);
+    if (!fs.existsSync(controlsAbs)) {
+        throw new Error(`[react-native-control-center] controls file not found: ${controlsAbs}`);
+    }
+    const controls = (0, parseControls_1.parseControlsFile)(controlsAbs);
+    const files = (0, generate_1.generateNativeFiles)({
+        controls,
+        bundleId: opts.bundleId,
+        urlScheme: opts.urlScheme,
+        ...(opts.appGroupId !== undefined && { appGroupId: opts.appGroupId }),
+        extensionName,
+    });
+    for (const file of files) {
+        const fullPath = path.join(opts.platformRoot, file.path);
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+        fs.writeFileSync(fullPath, file.content);
+    }
+    return { files, controls };
+}
+exports.default = withControlCenter;

package/lib/commonjs/src/ControlCenter.d.ts

@@ -0,0 +1,34 @@
+interface ControlActionEvent {
+    id: string;
+    deepLink?: string;
+    t: number;
+}
+type Unsubscribe = () => void;
+declare class ControlCenterAPI {
+    private emitter;
+    constructor();
+    /**
+     * 캐시된 마지막 값을 동기로 반환. 모르면 undefined.
+     * useControlState 훅이 첫 렌더 초기값으로 사용 (깜빡임 방지).
+     */
+    getCachedState<T>(key: string): T | undefined;
+    /** 라이브러리가 현재 환경에서 실제로 동작 가능한지 (iOS + Native Module 로드됨). */
+    isAvailable(): boolean;
+    /**
+     * 사용자가 제어센터의 Button을 탭했을 때 발사되는 이벤트 구독.
+     * @returns unsubscribe 함수
+     */
+    onAction(cb: (event: ControlActionEvent) => void): Unsubscribe;
+    /**
+     * 특정 stateKey의 값이 바뀌었을 때 발사되는 이벤트 구독.
+     * Swift는 모든 키를 하나의 이벤트로 발사하므로 여기서 키 필터링.
+     * @returns unsubscribe 함수
+     */
+    onStateChange<T>(key: string, cb: (value: T) => void): Unsubscribe;
+    /** App Group UserDefaults에서 값 읽기. iOS 외에선 null. */
+    getState<T>(key: string): Promise<T | null>;
+    /** App Group UserDefaults에 값 쓰기. iOS 외에선 no-op. */
+    setState<T>(key: string, value: T): Promise<void>;
+}
+export declare const ControlCenter: ControlCenterAPI;
+export {};

package/lib/commonjs/src/ControlCenter.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlCenter = void 0;
+const react_native_1 = require("react-native");
+const stateCache_1 = require("./stateCache");
+// ─────────────────────────────────────────────────────────────────────────
+//  ControlCenter — Native Module JS wrapper
+//
+//  Swift의 RNControlCenter가 발사하는 이벤트를 받고,
+//  메서드 호출(getState/setState)을 Promise로 노출한다.
+//
+//  iOS 외 플랫폼 또는 Native Module 미설치 시 모든 메서드는 no-op.
+// ─────────────────────────────────────────────────────────────────────────
+const RNControlCenter = react_native_1.NativeModules.RNControlCenter;
+class ControlCenterAPI {
+    emitter;
+    constructor() {
+        if (react_native_1.Platform.OS === 'ios' && RNControlCenter) {
+            // NativeEventEmitter는 NativeModule을 받아 startObserving/stopObserving을
+            // 자동으로 호출해 준다. addListener가 첫 등록되는 순간 Swift의
+            // startObserving이 발사되고, 마지막 listener가 제거되면 stopObserving이 발사된다.
+            this.emitter = new react_native_1.NativeEventEmitter(react_native_1.NativeModules.RNControlCenter);
+            // 콜드 스타트 시드 — 네이티브가 넘겨준 초기 스냅샷으로 캐시를 미리 채운다.
+            (0, stateCache_1.seedCache)(RNControlCenter.initialState);
+            // 모든 ControlStateChange 이벤트를 캐시에 반영하는 내부 리스너.
+            // 키별 구독(onStateChange)과 별개로, 어떤 키가 바뀌든 캐시는 항상 최신.
+            this.emitter.addListener('ControlStateChange', (event) => {
+                (0, stateCache_1.setCachedState)(event.key, event.value);
+            });
+        }
+        else {
+            this.emitter = null;
+        }
+    }
+    /**
+     * 캐시된 마지막 값을 동기로 반환. 모르면 undefined.
+     * useControlState 훅이 첫 렌더 초기값으로 사용 (깜빡임 방지).
+     */
+    getCachedState(key) {
+        return (0, stateCache_1.getCachedState)(key);
+    }
+    /** 라이브러리가 현재 환경에서 실제로 동작 가능한지 (iOS + Native Module 로드됨). */
+    isAvailable() {
+        return this.emitter !== null;
+    }
+    /**
+     * 사용자가 제어센터의 Button을 탭했을 때 발사되는 이벤트 구독.
+     * @returns unsubscribe 함수
+     */
+    onAction(cb) {
+        if (!this.emitter)
+            return () => { };
+        const sub = this.emitter.addListener('ControlAction', cb);
+        return () => sub.remove();
+    }
+    /**
+     * 특정 stateKey의 값이 바뀌었을 때 발사되는 이벤트 구독.
+     * Swift는 모든 키를 하나의 이벤트로 발사하므로 여기서 키 필터링.
+     * @returns unsubscribe 함수
+     */
+    onStateChange(key, cb) {
+        if (!this.emitter)
+            return () => { };
+        const sub = this.emitter.addListener('ControlStateChange', (event) => {
+            if (event.key === key)
+                cb(event.value);
+        });
+        return () => sub.remove();
+    }
+    /** App Group UserDefaults에서 값 읽기. iOS 외에선 null. */
+    async getState(key) {
+        if (!RNControlCenter)
+            return null;
+        try {
+            const value = await RNControlCenter.getState(key);
+            (0, stateCache_1.setCachedState)(key, value); // 응답을 캐시에 반영
+            return value;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** App Group UserDefaults에 값 쓰기. iOS 외에선 no-op. */
+    async setState(key, value) {
+        (0, stateCache_1.setCachedState)(key, value); // optimistic — 네이티브 왕복 전에 캐시 먼저 갱신
+        if (!RNControlCenter)
+            return;
+        await RNControlCenter.setState(key, value);
+    }
+}
+exports.ControlCenter = new ControlCenterAPI();

package/lib/commonjs/src/defineControls.d.ts

@@ -0,0 +1,6 @@
+import type { Control } from './types';
+/**
+ * 컨트롤 선언. 이 함수는 타입 헬퍼일 뿐, 런타임에 아무 동작도 하지 않습니다.
+ * 실제 처리는 빌드 타임에 AST 파싱으로 이뤄집니다.
+ */
+export declare function defineControls<T extends Record<string, Control>>(controls: T): T;

package/lib/commonjs/src/defineControls.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineControls = defineControls;
+/**
+ * 컨트롤 선언. 이 함수는 타입 헬퍼일 뿐, 런타임에 아무 동작도 하지 않습니다.
+ * 실제 처리는 빌드 타임에 AST 파싱으로 이뤄집니다.
+ */
+function defineControls(controls) {
+    return controls;
+}

package/lib/commonjs/src/hooks.d.ts

@@ -0,0 +1,8 @@
+/**
+ * App Group에 저장된 control 상태에 React 친화적 접근을 제공.
+ *
+ * Week 6: 캐시 레이어로 sync 초기값 보장.
+ * 첫 렌더에서 ControlCenter의 캐시(네이티브 initialState 시드 + 직전 값)를
+ * 동기로 읽어 깜빡임을 없앤다. 캐시에 없으면 null로 시작해 getState 응답을 기다림.
+ */
+export declare function useControlState<T>(key: string): [T | null, (value: T) => void];

package/lib/commonjs/src/hooks.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useControlState = useControlState;
+const react_1 = require("react");
+const ControlCenter_1 = require("./ControlCenter");
+/**
+ * App Group에 저장된 control 상태에 React 친화적 접근을 제공.
+ *
+ * Week 6: 캐시 레이어로 sync 초기값 보장.
+ * 첫 렌더에서 ControlCenter의 캐시(네이티브 initialState 시드 + 직전 값)를
+ * 동기로 읽어 깜빡임을 없앤다. 캐시에 없으면 null로 시작해 getState 응답을 기다림.
+ */
+function useControlState(key) {
+    const [value, setValue] = (0, react_1.useState)(() => {
+        const cached = ControlCenter_1.ControlCenter.getCachedState(key);
+        return cached !== undefined ? cached : null;
+    });
+    // 초기값 — native에 비동기로 물어봄 (캐시가 오래됐을 수 있으니 최신값으로 보정)
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        ControlCenter_1.ControlCenter.getState(key).then((v) => {
+            if (!cancelled)
+                setValue(v);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [key]);
+    // 변경 이벤트 구독
+    (0, react_1.useEffect)(() => {
+        return ControlCenter_1.ControlCenter.onStateChange(key, (newVal) => setValue(newVal));
+    }, [key]);
+    const setter = (0, react_1.useCallback)((newVal) => {
+        ControlCenter_1.ControlCenter.setState(key, newVal);
+        setValue(newVal); // optimistic update — 다음 이벤트가 같은 값을 다시 보내도 무해
+    }, [key]);
+    return [value, setter];
+}

package/lib/commonjs/src/index.d.ts

@@ -0,0 +1,5 @@
+export { defineControls } from './defineControls';
+export { ControlCenter } from './ControlCenter';
+export { useControlState } from './hooks';
+export type { ButtonControl, ToggleControl, Control, SFSymbolName, StrictSFSymbolName, HexColor, } from './types';
+export type { KnownSFSymbol } from './sf-symbols';

package/lib/commonjs/src/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useControlState = exports.ControlCenter = exports.defineControls = void 0;
+var defineControls_1 = require("./defineControls");
+Object.defineProperty(exports, "defineControls", { enumerable: true, get: function () { return defineControls_1.defineControls; } });
+var ControlCenter_1 = require("./ControlCenter");
+Object.defineProperty(exports, "ControlCenter", { enumerable: true, get: function () { return ControlCenter_1.ControlCenter; } });
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useControlState", { enumerable: true, get: function () { return hooks_1.useControlState; } });

package/lib/commonjs/src/sf-symbols.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 자주 쓰이는 SF Symbols 큐레이션 리스트.
+ * 자동완성용 — 실제 타입은 string도 허용합니다.
+ *
+ * 전체 5000+ 심볼은 https://developer.apple.com/sf-symbols/ 참조.
+ * Xcode → SF Symbols.app 에서 원하는 심볼 이름 검색 가능.
+ */
+export type KnownSFSymbol = 'square.and.pencil' | 'pencil' | 'pencil.circle' | 'pencil.circle.fill' | 'plus' | 'plus.circle' | 'plus.circle.fill' | 'minus' | 'minus.circle' | 'minus.circle.fill' | 'xmark' | 'xmark.circle' | 'xmark.circle.fill' | 'checkmark' | 'checkmark.circle' | 'checkmark.circle.fill' | 'trash' | 'trash.fill' | 'chevron.left' | 'chevron.right' | 'chevron.up' | 'chevron.down' | 'arrow.left' | 'arrow.right' | 'arrow.up' | 'arrow.down' | 'arrow.clockwise' | 'arrow.counterclockwise' | 'square.and.arrow.up' | 'square.and.arrow.down' | 'paperplane' | 'paperplane.fill' | 'envelope' | 'envelope.fill' | 'bubble.left' | 'bubble.right' | 'phone' | 'phone.fill' | 'play' | 'play.fill' | 'play.circle' | 'play.circle.fill' | 'pause' | 'pause.fill' | 'pause.circle' | 'pause.circle.fill' | 'stop' | 'stop.fill' | 'forward' | 'forward.fill' | 'backward' | 'backward.fill' | 'speaker' | 'speaker.fill' | 'speaker.slash' | 'speaker.slash.fill' | 'mic' | 'mic.fill' | 'mic.slash' | 'gear' | 'gearshape' | 'gearshape.fill' | 'power' | 'bolt' | 'bolt.fill' | 'bolt.slash' | 'bolt.slash.fill' | 'battery.100' | 'battery.75' | 'battery.50' | 'battery.25' | 'battery.0' | 'lock' | 'lock.fill' | 'lock.open' | 'lock.open.fill' | 'lock.shield' | 'lock.shield.fill' | 'key' | 'key.fill' | 'shield' | 'shield.fill' | 'shield.slash' | 'eye' | 'eye.fill' | 'eye.slash' | 'eye.slash.fill' | 'person' | 'person.fill' | 'person.circle' | 'person.circle.fill' | 'person.2' | 'person.2.fill' | 'person.3' | 'person.crop.circle' | 'person.crop.circle.fill' | 'doc' | 'doc.fill' | 'doc.text' | 'doc.text.fill' | 'note' | 'note.text' | 'folder' | 'folder.fill' | 'book' | 'book.fill' | 'bookmark' | 'bookmark.fill' | 'tag' | 'tag.fill' | 'heart' | 'heart.fill' | 'heart.slash' | 'star' | 'star.fill' | 'star.slash' | 'flag' | 'flag.fill' | 'flag.slash' | 'bell' | 'bell.fill' | 'bell.slash' | 'bell.slash.fill' | 'wifi' | 'wifi.slash' | 'antenna.radiowaves.left.and.right' | 'airplane' | 'airplayaudio' | 'airplayvideo' | 'network' | 'globe' | 'location' | 'location.fill' | 'location.slash' | 'mappin' | 'mappin.circle.fill' | 'map' | 'map.fill' | 'house' | 'house.fill' | 'building' | 'building.2' | 'clock' | 'clock.fill' | 'alarm' | 'alarm.fill' | 'timer' | 'stopwatch' | 'stopwatch.fill' | 'calendar' | 'calendar.badge.plus' | 'calendar.badge.clock' | 'camera' | 'camera.fill' | 'camera.circle' | 'camera.circle.fill' | 'photo' | 'photo.fill' | 'photo.on.rectangle' | 'video' | 'video.fill' | 'video.slash' | 'creditcard' | 'creditcard.fill' | 'cart' | 'cart.fill' | 'bag' | 'bag.fill' | 'dollarsign.circle' | 'dollarsign.circle.fill' | 'magnifyingglass' | 'magnifyingglass.circle' | 'info' | 'info.circle' | 'info.circle.fill' | 'questionmark' | 'questionmark.circle' | 'questionmark.circle.fill' | 'exclamationmark' | 'exclamationmark.circle' | 'exclamationmark.triangle' | 'exclamationmark.triangle.fill' | 'heart.text.square' | 'figure.walk' | 'figure.run' | 'figure.stand' | 'flame' | 'flame.fill' | 'drop' | 'drop.fill' | 'leaf' | 'leaf.fill' | 'sun.max' | 'sun.max.fill' | 'moon' | 'moon.fill' | 'moon.stars' | 'moon.stars.fill' | 'cloud' | 'cloud.fill' | 'cloud.rain' | 'cloud.rain.fill' | 'snowflake' | 'tv' | 'tv.fill' | 'lightbulb' | 'lightbulb.fill' | 'lightbulb.slash' | 'thermometer' | 'fan' | 'air.conditioner.horizontal' | 'rectangle.stack' | 'square.stack' | 'square.grid.2x2' | 'square.grid.3x3' | 'list.bullet' | 'list.dash' | 'ellipsis' | 'ellipsis.circle' | 'line.3.horizontal' | 'line.3.horizontal.decrease' | 'slider.horizontal.3' | 'arrow.up.arrow.down';

package/lib/commonjs/src/sf-symbols.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/commonjs/src/stateCache.d.ts

@@ -0,0 +1,8 @@
+/** 캐시된 마지막 값을 동기로 반환. 한 번도 본 적 없으면 undefined. */
+export declare function getCachedState<T>(key: string): T | undefined;
+/** 새 값을 캐시에 기록 (getState 응답 / setState / onStateChange 이벤트에서 호출). */
+export declare function setCachedState(key: string, value: unknown): void;
+/** 네이티브 initialState 스냅샷으로 캐시를 한 번에 채움 (콜드 스타트 시드). */
+export declare function seedCache(initial: Record<string, unknown> | undefined): void;
+/** 테스트 전용 — 캐시를 비운다. */
+export declare function __resetCacheForTests(): void;

package/lib/commonjs/src/stateCache.js

@@ -0,0 +1,36 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────
+//  stateCache — control 상태의 동기 보관함 (Week 6)
+//
+//  getState는 Promise라 값이 "다음 tick"에 도착한다. 그 사이 UI가 null로
+//  깜빡이는 걸 막기 위해, 마지막으로 알던 값을 모듈 레벨 Map에 둔다.
+//  useControlState 훅이 첫 렌더에서 이 캐시를 동기로 읽어 바로 표시한다.
+//
+//  react-native에 의존하지 않는 순수 모듈 — 그래서 node 환경에서 단독 테스트 가능.
+// ─────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedState = getCachedState;
+exports.setCachedState = setCachedState;
+exports.seedCache = seedCache;
+exports.__resetCacheForTests = __resetCacheForTests;
+const cache = new Map();
+/** 캐시된 마지막 값을 동기로 반환. 한 번도 본 적 없으면 undefined. */
+function getCachedState(key) {
+    return cache.has(key) ? cache.get(key) : undefined;
+}
+/** 새 값을 캐시에 기록 (getState 응답 / setState / onStateChange 이벤트에서 호출). */
+function setCachedState(key, value) {
+    cache.set(key, value);
+}
+/** 네이티브 initialState 스냅샷으로 캐시를 한 번에 채움 (콜드 스타트 시드). */
+function seedCache(initial) {
+    if (!initial)
+        return;
+    for (const key of Object.keys(initial)) {
+        cache.set(key, initial[key]);
+    }
+}
+/** 테스트 전용 — 캐시를 비운다. */
+function __resetCacheForTests() {
+    cache.clear();
+}

package/lib/commonjs/src/types.d.ts

@@ -0,0 +1,36 @@
+import type { KnownSFSymbol } from './sf-symbols';
+export type HexColor = `#${string}`;
+/**
+ * 유연 모드: 큐레이션된 ~200개는 자동완성 + 그 외 문자열도 허용.
+ * TypeScript 트릭: `(string & {})` 는 자동완성을 비활성화하지 않으면서
+ * 임의 문자열을 받게 해줌.
+ */
+export type SFSymbolName = KnownSFSymbol | (string & {});
+/**
+ * 엄격 모드: 큐레이션 리스트에 있는 심볼만 허용.
+ * 오타/잘못된 이름 방지가 중요할 때 사용.
+ */
+export type StrictSFSymbolName = KnownSFSymbol;
+export interface ButtonControl {
+    type: 'button';
+    title: string;
+    icon: SFSymbolName;
+    tint?: HexColor;
+    description?: string;
+    deepLink?: string;
+}
+export interface ToggleControl {
+    type: 'toggle';
+    title: string;
+    icons: {
+        on: SFSymbolName;
+        off: SFSymbolName;
+    };
+    tint?: {
+        on: HexColor;
+        off: HexColor;
+    };
+    stateKey: string;
+    description?: string;
+}
+export type Control = ButtonControl | ToggleControl;

package/lib/commonjs/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "react-native-control-center",
+  "version": "0.1.0",
+  "description": "iOS 18+ Control Center custom controls for React Native — declare in TypeScript, zero Swift required.",
+  "main": "lib/commonjs/src/index.js",
+  "types": "lib/commonjs/src/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "lib",
+    "ios",
+    "cli/bin",
+    "app.plugin.js",
+    "LICENSE",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/*.test.*",
+    "!**/.DS_Store"
+  ],
+  "bin": {
+    "rn-control-center": "cli/bin/rn-control-center.js"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "build": "rm -rf lib && tsc -p tsconfig.build.json && cp -R core/templates lib/commonjs/core/templates",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "control-center",
+    "control-widget",
+    "widget",
+    "expo",
+    "expo-config-plugin",
+    "ios18",
+    "app-intents"
+  ],
+  "author": "darby <darby@glorang.com>",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.74.0"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@babel/parser": "^7.26.0",
+    "@babel/traverse": "^7.26.0",
+    "@expo/config-plugins": "^9.0.0",
+    "handlebars": "^4.7.8",
+    "plist": "^3.1.0",
+    "xcode": "^3.0.1"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.26.0",
+    "@types/babel__traverse": "^7.20.6",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.1",
+    "@types/plist": "^3.0.5",
+    "@types/react": "^19.0.0",
+    "jest": "^29.7.0",
+    "react": "19.0.0",
+    "react-native": "0.81.5",
+    "react-native-builder-bob": "^0.35.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.2"
+  }
+}