react-native-control-center 0.1.0

package/lib/commonjs/core/generate/swift.js

@@ -0,0 +1,140 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAppGroupId = defaultAppGroupId;
+exports.collectStateKeys = collectStateKeys;
+exports.pascalCase = pascalCase;
+exports.generateSwiftFiles = generateSwiftFiles;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const handlebars_1 = __importDefault(require("handlebars"));
+function defaultAppGroupId(bundleId) {
+    return `group.${bundleId}.controls`;
+}
+/**
+ * 토글 컨트롤들의 stateKey 목록.
+ * - 생성된 ControlStore.swift의 정적 화이트리스트로 박힘
+ * - Native Module의 snapshot() 정제를 위해 메인 앱 Info.plist
+ *   ("RNControlCenterStateKeys")로도 주입됨
+ */
+function collectStateKeys(controls) {
+    return controls
+        .filter((c) => c.type === 'toggle')
+        .map((c) => c.stateKey);
+}
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
+const templateCache = {};
+function loadTemplate(name) {
+    if (!templateCache[name]) {
+        const filePath = path.join(TEMPLATES_DIR, `${name}.hbs`);
+        const source = fs.readFileSync(filePath, 'utf-8');
+        templateCache[name] = handlebars_1.default.compile(source, { noEscape: true });
+    }
+    return templateCache[name];
+}
+// Handlebars 헬퍼 등록 (한 번만)
+let helpersRegistered = false;
+function registerHelpers() {
+    if (helpersRegistered)
+        return;
+    handlebars_1.default.registerHelper('pascalCase', (str) => pascalCase(str));
+    helpersRegistered = true;
+}
+function pascalCase(str) {
+    return str
+        .replace(/[-_]/g, ' ')
+        .replace(/(^|\s)(\w)/g, (_, __, c) => c.toUpperCase())
+        .replace(/\s/g, '');
+}
+function generateSwiftFiles(opts) {
+    registerHelpers();
+    const bundleStructName = opts.bundleStructName ?? 'ControlCenterBundle';
+    const appGroupId = opts.appGroupId ?? defaultAppGroupId(opts.bundleId);
+    const files = [];
+    // 1. Bundle
+    files.push({
+        path: 'ControlBundle.swift',
+        content: loadTemplate('ControlBundle.swift')({
+            bundleStructName,
+            controls: opts.controls,
+        }),
+    });
+    // 1b. ControlStore (shared between targets)
+    //  토글의 stateKey 목록을 정적으로 박아넣어, snapshot()이 시스템 전역 키를
+    //  긁지 않고 우리가 관리하는 상태 키만 정확히 반환하게 한다. (Week 6)
+    const stateKeys = collectStateKeys(opts.controls);
+    files.push({
+        path: 'ControlStore.swift',
+        content: loadTemplate('ControlStore.swift')({ appGroupId, stateKeys }),
+    });
+    // 2. Controls + Intents (컨트롤당 2파일)
+    for (const control of opts.controls) {
+        if (control.type === 'button') {
+            files.push({
+                path: `Controls/${pascalCase(control.id)}Control.swift`,
+                content: loadTemplate('ButtonControl.swift')({
+                    ...control,
+                    bundleId: opts.bundleId,
+                }),
+            });
+            files.push({
+                path: `Intents/${pascalCase(control.id)}Intent.swift`,
+                content: loadTemplate('ButtonIntent.swift')({
+                    ...control,
+                    deepLink: control.deepLink ?? `${opts.urlScheme}://control/${control.id}`,
+                }),
+            });
+        }
+        else if (control.type === 'toggle') {
+            files.push({
+                path: `Controls/${pascalCase(control.id)}Control.swift`,
+                content: loadTemplate('ToggleControl.swift')({
+                    ...control,
+                    bundleId: opts.bundleId,
+                }),
+            });
+            files.push({
+                path: `Intents/${pascalCase(control.id)}Intent.swift`,
+                content: loadTemplate('ToggleIntent.swift')({
+                    ...control,
+                }),
+            });
+        }
+    }
+    return files;
+}

package/lib/commonjs/core/parseControls.d.ts

@@ -0,0 +1,9 @@
+import { type ParsedControl } from './types';
+/**
+ * TS 파일을 읽어 defineControls({...}) 호출을 찾고 컨트롤 배열을 추출.
+ */
+export declare function parseControlsFile(filePath: string): ParsedControl[];
+/**
+ * 소스 문자열을 받아 파싱 (테스트에 편리).
+ */
+export declare function parseControlsSource(source: string, filePath?: string): ParsedControl[];

package/lib/commonjs/core/parseControls.js

@@ -0,0 +1,206 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseControlsFile = parseControlsFile;
+exports.parseControlsSource = parseControlsSource;
+const fs = __importStar(require("node:fs"));
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const types_1 = require("./types");
+// @babel/traverse는 ESM/CJS 혼합 때문에 .default가 있을 수 있음
+const traverse = typeof traverse_1.default === 'function' ? traverse_1.default : traverse_1.default.default;
+/**
+ * TS 파일을 읽어 defineControls({...}) 호출을 찾고 컨트롤 배열을 추출.
+ */
+function parseControlsFile(filePath) {
+    const source = fs.readFileSync(filePath, 'utf-8');
+    return parseControlsSource(source, filePath);
+}
+/**
+ * 소스 문자열을 받아 파싱 (테스트에 편리).
+ */
+function parseControlsSource(source, filePath = '<source>') {
+    let ast;
+    try {
+        ast = (0, parser_1.parse)(source, {
+            sourceType: 'module',
+            plugins: ['typescript'],
+        });
+    }
+    catch (err) {
+        throw new types_1.ParseError(`Failed to parse TypeScript: ${err.message}`, filePath);
+    }
+    let defineCallArg = null;
+    traverse(ast, {
+        CallExpression(path) {
+            const callee = path.node.callee;
+            if (callee.type !== 'Identifier' || callee.name !== 'defineControls')
+                return;
+            const firstArg = path.node.arguments[0];
+            if (!firstArg || firstArg.type !== 'ObjectExpression') {
+                throw new types_1.ParseError('defineControls() must receive an object literal as its first argument.', filePath, path.node.loc?.start.line, path.node.loc?.start.column);
+            }
+            defineCallArg = firstArg;
+            path.stop();
+        },
+    });
+    if (!defineCallArg) {
+        throw new types_1.ParseError('No defineControls({...}) call found in file.', filePath);
+    }
+    return extractControls(defineCallArg, filePath);
+}
+function extractControls(obj, filePath) {
+    const controls = [];
+    for (const prop of obj.properties) {
+        if (prop.type !== 'ObjectProperty') {
+            throw new types_1.ParseError(`Unsupported property kind "${prop.type}" inside defineControls. Use plain key: value pairs only.`, filePath, prop.loc?.start.line, prop.loc?.start.column);
+        }
+        const id = getKeyName(prop, filePath);
+        if (prop.value.type !== 'ObjectExpression') {
+            throw new types_1.ParseError(`Control "${id}" must be an object literal.`, filePath, prop.value.loc?.start.line, prop.value.loc?.start.column);
+        }
+        const configRaw = objectExpressionToLiteral(prop.value, filePath);
+        controls.push(validateControl(id, configRaw, filePath));
+    }
+    return controls;
+}
+function getKeyName(prop, filePath) {
+    if (prop.key.type === 'Identifier')
+        return prop.key.name;
+    if (prop.key.type === 'StringLiteral')
+        return prop.key.value;
+    throw new types_1.ParseError(`Control key must be a plain identifier or string literal.`, filePath, prop.key.loc?.start.line, prop.key.loc?.start.column);
+}
+/**
+ * ObjectExpression / ArrayExpression / Literal을 일반 JS 값으로 재귀 변환.
+ * literal 값만 허용 — 변수 참조/함수 호출 발견 시 에러.
+ */
+function objectExpressionToLiteral(node, filePath) {
+    switch (node.type) {
+        case 'StringLiteral':
+        case 'NumericLiteral':
+        case 'BooleanLiteral':
+            return node.value;
+        case 'NullLiteral':
+            return null;
+        case 'TemplateLiteral':
+            if (node.expressions.length > 0) {
+                throw literalOnly(node, filePath, 'template string with ${} interpolation');
+            }
+            return node.quasis.map((q) => q.value.cooked).join('');
+        case 'ArrayExpression':
+            return node.elements.map((el) => {
+                if (el === null)
+                    return null;
+                if (el.type === 'SpreadElement')
+                    throw literalOnly(el, filePath, 'spread element');
+                return objectExpressionToLiteral(el, filePath);
+            });
+        case 'ObjectExpression': {
+            const out = {};
+            for (const prop of node.properties) {
+                if (prop.type !== 'ObjectProperty') {
+                    throw literalOnly(prop, filePath, prop.type);
+                }
+                const key = prop.key.type === 'Identifier'
+                    ? prop.key.name
+                    : prop.key.type === 'StringLiteral'
+                        ? prop.key.value
+                        : null;
+                if (key === null) {
+                    throw literalOnly(prop.key, filePath, 'computed key');
+                }
+                out[key] = objectExpressionToLiteral(prop.value, filePath);
+            }
+            return out;
+        }
+        case 'Identifier':
+            throw literalOnly(node, filePath, `variable reference "${node.name}"`);
+        case 'CallExpression':
+            throw literalOnly(node, filePath, 'function call');
+        case 'MemberExpression':
+            throw literalOnly(node, filePath, 'member access');
+        default:
+            throw literalOnly(node, filePath, node.type);
+    }
+}
+function literalOnly(node, filePath, kind) {
+    return new types_1.ParseError(`Only literal values allowed — found ${kind}.`, filePath, node.loc?.start.line, node.loc?.start.column);
+}
+// 최소 검증 — 더 엄격한 검증은 validateControls 단계에서
+function validateControl(id, raw, filePath) {
+    const type = raw['type'];
+    if (type === 'button') {
+        if (typeof raw['title'] !== 'string')
+            throw missingField(id, 'title', filePath);
+        if (typeof raw['icon'] !== 'string')
+            throw missingField(id, 'icon', filePath);
+        return {
+            id,
+            type: 'button',
+            title: raw['title'],
+            icon: raw['icon'],
+            ...(raw['tint'] !== undefined && { tint: raw['tint'] }),
+            ...(raw['description'] !== undefined && { description: raw['description'] }),
+            ...(raw['deepLink'] !== undefined && { deepLink: raw['deepLink'] }),
+        };
+    }
+    if (type === 'toggle') {
+        if (typeof raw['title'] !== 'string')
+            throw missingField(id, 'title', filePath);
+        if (typeof raw['stateKey'] !== 'string')
+            throw missingField(id, 'stateKey', filePath);
+        const icons = raw['icons'];
+        if (!icons || typeof icons.on !== 'string' || typeof icons.off !== 'string') {
+            throw new types_1.ParseError(`Toggle "${id}" requires icons.on and icons.off as strings.`, filePath);
+        }
+        return {
+            id,
+            type: 'toggle',
+            title: raw['title'],
+            icons: { on: icons.on, off: icons.off },
+            stateKey: raw['stateKey'],
+            ...(raw['tint'] !== undefined && { tint: raw['tint'] }),
+            ...(raw['description'] !== undefined && { description: raw['description'] }),
+        };
+    }
+    throw new types_1.ParseError(`Control "${id}" has invalid type "${String(type)}". Expected "button" or "toggle".`, filePath);
+}
+function missingField(id, field, filePath) {
+    return new types_1.ParseError(`Control "${id}" is missing required field "${field}".`, filePath);
+}

package/lib/commonjs/core/sf-symbols-data.d.ts

@@ -0,0 +1,3 @@
+export declare const SF_SYMBOL_NAMES: readonly string[];
+/** 빠른 멤버십 검사를 위한 Set. 빌드타임 심볼 검증에서 사용. */
+export declare const SF_SYMBOLS: ReadonlySet<string>;