@rollipop/common 0.0.0 → 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @rollipop/common
+
+## 0.1.0-alpha.1
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- 7a1d9a7: pre-alpha

package/README.md

@@ -1 +1 @@
-# rollipop-empty
+# @rollipop/common

package/dist/index.cjs

@@ -0,0 +1,290 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let chalk = require("chalk");
+chalk = __toESM(chalk);
+let gradient_string = require("gradient-string");
+gradient_string = __toESM(gradient_string);
+let dayjs = require("dayjs");
+dayjs = __toESM(dayjs);
+let es_toolkit = require("es-toolkit");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+
+//#region src/logo.ts
+const CANDY = `
+    _....._
+  .' _..._ '.
+ / /\`  __ \`\\ \\
+; ;  /\`  \\  | ;
+| | |  (_/  ; |
+; ;  \\_  _.' .;
+ \\ '.  \`\` _.'/
+  '._\`"'"\`_.'`;
+const STICK = `
+    /  /\`\`
+   /  /
+  /__/`;
+const DESCRIPTIONS = [
+	"Rollipop",
+	"Modern build toolkit for React Native",
+	"Powered by Rolldown"
+];
+const PRIMARY_COLOR = "#42A5F5";
+const BASE_GRADIENT_COLORS = [PRIMARY_COLOR, "#BBDEFB"];
+const PADDING = 20;
+function printLogo() {
+	let maxLogoWidth = 0;
+	const padding = " ".repeat(PADDING);
+	const gradientColors = [...BASE_GRADIENT_COLORS];
+	const styledCandy = CANDY.split("\n").map((line) => {
+		maxLogoWidth = Math.max(line.length, maxLogoWidth);
+		return (0, gradient_string.default)(gradientColors.reverse())(line);
+	}).join("\n") + STICK;
+	console.log(styledCandy.split("\n").map((line) => padding + line).join("\n"));
+	console.log("");
+	DESCRIPTIONS.forEach((description, index) => {
+		const descriptionHalfLength = description.length / 2;
+		const logoHalfWidth = maxLogoWidth / 2;
+		const padding$1 = " ".repeat(PADDING - descriptionHalfLength + logoHalfWidth);
+		if (index === 0) console.log(padding$1 + chalk.default.bold.hex(PRIMARY_COLOR)(description));
+		else console.log(padding$1 + description);
+	});
+	console.log("");
+}
+let _printed = false;
+const Logo = {
+	print: printLogo,
+	printOnce: () => {
+		if (_printed) return;
+		_printed = true;
+		printLogo();
+	}
+};
+
+//#endregion
+//#region src/constants.ts
+const DEBUG_KEY = "rollipop";
+const SHARED_DATA_PATH = ".rollipop";
+const DEV_SERVER_ASSET_PATH = "assets";
+
+//#endregion
+//#region src/debug.ts
+const TRUTHY_VALUES = [
+	"yes",
+	"on",
+	"true",
+	"enabled"
+];
+const FALSY_VALUES = [
+	"no",
+	"off",
+	"false",
+	"disabled"
+];
+function parseDebugKeys() {
+	return Object.keys(process.env).filter((key) => /^debug_/i.test(key)).reduce((acc, key) => {
+		const prop = key.slice(6).toLowerCase().replace(/_([a-z])/g, (_, key$1) => key$1.toUpperCase());
+		let value = process.env[key];
+		const lowerCase = typeof value === "string" ? value.toLowerCase() : value.toString();
+		if (TRUTHY_VALUES.includes(lowerCase)) value = true;
+		else if (FALSY_VALUES.includes(lowerCase)) value = false;
+		else value = Boolean(Number(value));
+		acc[prop] = value;
+		return acc;
+	}, {});
+}
+let debugKeys = null;
+function isDebugEnabled() {
+	if (debugKeys == null) debugKeys = parseDebugKeys();
+	return debugKeys[DEBUG_KEY] ?? false;
+}
+
+//#endregion
+//#region src/logger.ts
+var Logger = class Logger {
+	static blocked = false;
+	static queuedMessages = [];
+	static Colors = {
+		trace: chalk.default.gray,
+		debug: chalk.default.blue,
+		log: chalk.default.green,
+		info: chalk.default.cyan,
+		warn: chalk.default.yellow,
+		error: chalk.default.red
+	};
+	format = "HH:mm:ss.SSS";
+	debugEnabled;
+	static block() {
+		this.blocked = true;
+	}
+	static unblock(flush = true) {
+		this.blocked = false;
+		if (flush) for (const args of Logger.queuedMessages) console.log(...args);
+		Logger.queuedMessages.length = 0;
+	}
+	constructor(scope) {
+		this.scope = scope;
+		this.debugEnabled = isDebugEnabled();
+	}
+	getFormat() {
+		return this.format;
+	}
+	setFormat(format) {
+		this.format = format;
+	}
+	getTimestamp() {
+		return (0, dayjs.default)().format(this.getFormat());
+	}
+	print(logLevel, ...args) {
+		const timestamp = chalk.default.gray(this.getTimestamp());
+		const level = Logger.Colors[logLevel](logLevel);
+		if (this.scope) args = [
+			timestamp,
+			level,
+			chalk.default.magenta(this.scope),
+			...args
+		];
+		else args = [
+			timestamp,
+			level,
+			...args
+		];
+		if (Logger.blocked) Logger.queuedMessages.push(args);
+		else console.log(...args);
+	}
+	trace(...args) {
+		this.debugEnabled && this.print("trace", ...args);
+	}
+	debug(...args) {
+		this.debugEnabled && this.print("debug", ...args);
+	}
+	log(...args) {
+		this.print("log", ...args);
+	}
+	info(...args) {
+		this.print("info", ...args);
+	}
+	warn(...args) {
+		this.print("warn", ...args);
+	}
+	error(...args) {
+		this.print("error", ...args);
+	}
+	child(scope) {
+		(0, es_toolkit.invariant)(this.scope, "Logger must have a scope to create a child logger");
+		return new Logger(`${this.scope}:${scope}`);
+	}
+};
+function loggerFilter(logger, options) {
+	const originalLog = logger[options.level];
+	logger[options.level] = (...args) => {
+		const filteredArgs = options.filter(args);
+		if (filteredArgs.length === 0) return;
+		originalLog(...filteredArgs);
+	};
+	return logger;
+}
+
+//#endregion
+//#region src/fs.ts
+function getSharedDataPath(basePath) {
+	return node_path.default.join(basePath, SHARED_DATA_PATH);
+}
+function ensureSharedDataPath(basePath) {
+	const sharedDataPath = getSharedDataPath(basePath);
+	if (!node_fs.default.existsSync(sharedDataPath)) node_fs.default.mkdirSync(sharedDataPath, { recursive: true });
+	return sharedDataPath;
+}
+function getSettingsPath(basePath) {
+	return node_path.default.join(getSharedDataPath(basePath), "settings.json");
+}
+function loadSettings(basePath) {
+	const settingsPath = getSettingsPath(basePath);
+	if (!node_fs.default.existsSync(settingsPath)) return {};
+	return JSON.parse(node_fs.default.readFileSync(settingsPath, "utf-8"));
+}
+function saveSettings(basePath, settings) {
+	const newSettings = (0, es_toolkit.merge)(loadSettings(basePath), settings);
+	node_fs.default.writeFileSync(getSettingsPath(basePath), JSON.stringify(newSettings, null, 2));
+}
+function getCachePath(basePath) {
+	return node_path.default.join(getSharedDataPath(basePath), "cache");
+}
+function resetCache(basePath) {
+	node_fs.default.rmSync(getCachePath(basePath), {
+		recursive: true,
+		force: true
+	});
+}
+
+//#endregion
+//#region src/storage.ts
+const DEFAULT_DATA = { build: {} };
+var FileStorage = class FileStorage {
+	static instance = null;
+	dataFilePath;
+	data;
+	static getInstance(basePath) {
+		if (FileStorage.instance == null) FileStorage.instance = new FileStorage(basePath);
+		return new FileStorage(basePath);
+	}
+	constructor(basePath) {
+		this.basePath = basePath;
+		this.dataFilePath = node_path.default.join(getSharedDataPath(basePath), "rollipop.json");
+		if (node_fs.default.existsSync(this.dataFilePath)) this.data = JSON.parse(node_fs.default.readFileSync(this.dataFilePath, "utf-8"));
+		else this.data = DEFAULT_DATA;
+	}
+	get() {
+		return this.data;
+	}
+	set(data) {
+		this.data = (0, es_toolkit.merge)(this.data, data);
+		node_fs.default.writeFileSync(this.dataFilePath, JSON.stringify(this.data, null, 2));
+	}
+};
+
+//#endregion
+exports.DEBUG_KEY = DEBUG_KEY;
+exports.DEV_SERVER_ASSET_PATH = DEV_SERVER_ASSET_PATH;
+exports.FileStorage = FileStorage;
+exports.Logger = Logger;
+exports.Logo = Logo;
+exports.SHARED_DATA_PATH = SHARED_DATA_PATH;
+exports.chalk = chalk.default;
+exports.ensureSharedDataPath = ensureSharedDataPath;
+exports.getCachePath = getCachePath;
+exports.getSettingsPath = getSettingsPath;
+exports.getSharedDataPath = getSharedDataPath;
+exports.isDebugEnabled = isDebugEnabled;
+exports.loadSettings = loadSettings;
+exports.loggerFilter = loggerFilter;
+exports.parseDebugKeys = parseDebugKeys;
+exports.resetCache = resetCache;
+exports.saveSettings = saveSettings;

package/dist/index.d.cts

@@ -0,0 +1,91 @@
+import chalk, { ChalkInstance } from "chalk";
+
+//#region src/logo.d.ts
+declare function printLogo(): void;
+declare const Logo: {
+  print: typeof printLogo;
+  printOnce: () => void;
+};
+//#endregion
+//#region src/logger.d.ts
+type LogLevel = 'trace' | 'debug' | 'log' | 'info' | 'warn' | 'error';
+declare class Logger {
+  private readonly scope?;
+  private static blocked;
+  private static queuedMessages;
+  static Colors: {
+    trace: ChalkInstance;
+    debug: ChalkInstance;
+    log: ChalkInstance;
+    info: ChalkInstance;
+    warn: ChalkInstance;
+    error: ChalkInstance;
+  };
+  private format;
+  private debugEnabled;
+  static block(): void;
+  static unblock(flush?: boolean): void;
+  constructor(scope?: string | undefined);
+  getFormat(): string;
+  setFormat(format: string): void;
+  private getTimestamp;
+  private print;
+  trace(...args: unknown[]): void;
+  debug(...args: unknown[]): void;
+  log(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  child(scope: string): Logger;
+}
+interface LoggerFilterOptions {
+  level: LogLevel;
+  filter: (args: unknown[]) => unknown[];
+}
+declare function loggerFilter(logger: Logger, options: LoggerFilterOptions): Logger;
+//#endregion
+//#region src/constants.d.ts
+declare const DEBUG_KEY = "rollipop";
+declare const SHARED_DATA_PATH = ".rollipop";
+declare const DEV_SERVER_ASSET_PATH = "assets";
+//#endregion
+//#region src/types.d.ts
+interface FileStorageData {
+  build: {
+    [buildHash: string]: {
+      totalModules: number;
+    };
+  };
+}
+interface Settings {
+  devtools?: {
+    autoOpen?: boolean;
+  };
+}
+//#endregion
+//#region src/fs.d.ts
+declare function getSharedDataPath(basePath: string): string;
+declare function ensureSharedDataPath(basePath: string): string;
+declare function getSettingsPath(basePath: string): string;
+declare function loadSettings(basePath: string): Settings;
+declare function saveSettings(basePath: string, settings: Partial<Settings>): void;
+declare function getCachePath(basePath: string): string;
+declare function resetCache(basePath: string): void;
+//#endregion
+//#region src/debug.d.ts
+declare function parseDebugKeys(): Record<string, boolean>;
+declare function isDebugEnabled(): boolean;
+//#endregion
+//#region src/storage.d.ts
+declare class FileStorage {
+  private readonly basePath;
+  private static instance;
+  private dataFilePath;
+  private data;
+  static getInstance(basePath: string): FileStorage;
+  private constructor();
+  get(): FileStorageData;
+  set(data: Partial<FileStorageData>): void;
+}
+//#endregion
+export { DEBUG_KEY, DEV_SERVER_ASSET_PATH, FileStorage, FileStorageData, LogLevel, Logger, LoggerFilterOptions, Logo, SHARED_DATA_PATH, Settings, chalk, ensureSharedDataPath, getCachePath, getSettingsPath, getSharedDataPath, isDebugEnabled, loadSettings, loggerFilter, parseDebugKeys, resetCache, saveSettings };

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+import chalk, { ChalkInstance } from "chalk";
+
+//#region src/logo.d.ts
+declare function printLogo(): void;
+declare const Logo: {
+  print: typeof printLogo;
+  printOnce: () => void;
+};
+//#endregion
+//#region src/logger.d.ts
+type LogLevel = 'trace' | 'debug' | 'log' | 'info' | 'warn' | 'error';
+declare class Logger {
+  private readonly scope?;
+  private static blocked;
+  private static queuedMessages;
+  static Colors: {
+    trace: ChalkInstance;
+    debug: ChalkInstance;
+    log: ChalkInstance;
+    info: ChalkInstance;
+    warn: ChalkInstance;
+    error: ChalkInstance;
+  };
+  private format;
+  private debugEnabled;
+  static block(): void;
+  static unblock(flush?: boolean): void;
+  constructor(scope?: string | undefined);
+  getFormat(): string;
+  setFormat(format: string): void;
+  private getTimestamp;
+  private print;
+  trace(...args: unknown[]): void;
+  debug(...args: unknown[]): void;
+  log(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  child(scope: string): Logger;
+}
+interface LoggerFilterOptions {
+  level: LogLevel;
+  filter: (args: unknown[]) => unknown[];
+}
+declare function loggerFilter(logger: Logger, options: LoggerFilterOptions): Logger;
+//#endregion
+//#region src/constants.d.ts
+declare const DEBUG_KEY = "rollipop";
+declare const SHARED_DATA_PATH = ".rollipop";
+declare const DEV_SERVER_ASSET_PATH = "assets";
+//#endregion
+//#region src/types.d.ts
+interface FileStorageData {
+  build: {
+    [buildHash: string]: {
+      totalModules: number;
+    };
+  };
+}
+interface Settings {
+  devtools?: {
+    autoOpen?: boolean;
+  };
+}
+//#endregion
+//#region src/fs.d.ts
+declare function getSharedDataPath(basePath: string): string;
+declare function ensureSharedDataPath(basePath: string): string;
+declare function getSettingsPath(basePath: string): string;
+declare function loadSettings(basePath: string): Settings;
+declare function saveSettings(basePath: string, settings: Partial<Settings>): void;
+declare function getCachePath(basePath: string): string;
+declare function resetCache(basePath: string): void;
+//#endregion
+//#region src/debug.d.ts
+declare function parseDebugKeys(): Record<string, boolean>;
+declare function isDebugEnabled(): boolean;
+//#endregion
+//#region src/storage.d.ts
+declare class FileStorage {
+  private readonly basePath;
+  private static instance;
+  private dataFilePath;
+  private data;
+  static getInstance(basePath: string): FileStorage;
+  private constructor();
+  get(): FileStorageData;
+  set(data: Partial<FileStorageData>): void;
+}
+//#endregion
+export { DEBUG_KEY, DEV_SERVER_ASSET_PATH, FileStorage, FileStorageData, LogLevel, Logger, LoggerFilterOptions, Logo, SHARED_DATA_PATH, Settings, chalk, ensureSharedDataPath, getCachePath, getSettingsPath, getSharedDataPath, isDebugEnabled, loadSettings, loggerFilter, parseDebugKeys, resetCache, saveSettings };

package/dist/index.js

@@ -0,0 +1,242 @@
+import chalk, { default as chalk$1 } from "chalk";
+import gradient from "gradient-string";
+import dayjs from "dayjs";
+import { invariant, merge } from "es-toolkit";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/logo.ts
+const CANDY = `
+    _....._
+  .' _..._ '.
+ / /\`  __ \`\\ \\
+; ;  /\`  \\  | ;
+| | |  (_/  ; |
+; ;  \\_  _.' .;
+ \\ '.  \`\` _.'/
+  '._\`"'"\`_.'`;
+const STICK = `
+    /  /\`\`
+   /  /
+  /__/`;
+const DESCRIPTIONS = [
+	"Rollipop",
+	"Modern build toolkit for React Native",
+	"Powered by Rolldown"
+];
+const PRIMARY_COLOR = "#42A5F5";
+const BASE_GRADIENT_COLORS = [PRIMARY_COLOR, "#BBDEFB"];
+const PADDING = 20;
+function printLogo() {
+	let maxLogoWidth = 0;
+	const padding = " ".repeat(PADDING);
+	const gradientColors = [...BASE_GRADIENT_COLORS];
+	const styledCandy = CANDY.split("\n").map((line) => {
+		maxLogoWidth = Math.max(line.length, maxLogoWidth);
+		return gradient(gradientColors.reverse())(line);
+	}).join("\n") + STICK;
+	console.log(styledCandy.split("\n").map((line) => padding + line).join("\n"));
+	console.log("");
+	DESCRIPTIONS.forEach((description, index) => {
+		const descriptionHalfLength = description.length / 2;
+		const logoHalfWidth = maxLogoWidth / 2;
+		const padding$1 = " ".repeat(PADDING - descriptionHalfLength + logoHalfWidth);
+		if (index === 0) console.log(padding$1 + chalk$1.bold.hex(PRIMARY_COLOR)(description));
+		else console.log(padding$1 + description);
+	});
+	console.log("");
+}
+let _printed = false;
+const Logo = {
+	print: printLogo,
+	printOnce: () => {
+		if (_printed) return;
+		_printed = true;
+		printLogo();
+	}
+};
+
+//#endregion
+//#region src/constants.ts
+const DEBUG_KEY = "rollipop";
+const SHARED_DATA_PATH = ".rollipop";
+const DEV_SERVER_ASSET_PATH = "assets";
+
+//#endregion
+//#region src/debug.ts
+const TRUTHY_VALUES = [
+	"yes",
+	"on",
+	"true",
+	"enabled"
+];
+const FALSY_VALUES = [
+	"no",
+	"off",
+	"false",
+	"disabled"
+];
+function parseDebugKeys() {
+	return Object.keys(process.env).filter((key) => /^debug_/i.test(key)).reduce((acc, key) => {
+		const prop = key.slice(6).toLowerCase().replace(/_([a-z])/g, (_, key$1) => key$1.toUpperCase());
+		let value = process.env[key];
+		const lowerCase = typeof value === "string" ? value.toLowerCase() : value.toString();
+		if (TRUTHY_VALUES.includes(lowerCase)) value = true;
+		else if (FALSY_VALUES.includes(lowerCase)) value = false;
+		else value = Boolean(Number(value));
+		acc[prop] = value;
+		return acc;
+	}, {});
+}
+let debugKeys = null;
+function isDebugEnabled() {
+	if (debugKeys == null) debugKeys = parseDebugKeys();
+	return debugKeys[DEBUG_KEY] ?? false;
+}
+
+//#endregion
+//#region src/logger.ts
+var Logger = class Logger {
+	static blocked = false;
+	static queuedMessages = [];
+	static Colors = {
+		trace: chalk$1.gray,
+		debug: chalk$1.blue,
+		log: chalk$1.green,
+		info: chalk$1.cyan,
+		warn: chalk$1.yellow,
+		error: chalk$1.red
+	};
+	format = "HH:mm:ss.SSS";
+	debugEnabled;
+	static block() {
+		this.blocked = true;
+	}
+	static unblock(flush = true) {
+		this.blocked = false;
+		if (flush) for (const args of Logger.queuedMessages) console.log(...args);
+		Logger.queuedMessages.length = 0;
+	}
+	constructor(scope) {
+		this.scope = scope;
+		this.debugEnabled = isDebugEnabled();
+	}
+	getFormat() {
+		return this.format;
+	}
+	setFormat(format) {
+		this.format = format;
+	}
+	getTimestamp() {
+		return dayjs().format(this.getFormat());
+	}
+	print(logLevel, ...args) {
+		const timestamp = chalk$1.gray(this.getTimestamp());
+		const level = Logger.Colors[logLevel](logLevel);
+		if (this.scope) args = [
+			timestamp,
+			level,
+			chalk$1.magenta(this.scope),
+			...args
+		];
+		else args = [
+			timestamp,
+			level,
+			...args
+		];
+		if (Logger.blocked) Logger.queuedMessages.push(args);
+		else console.log(...args);
+	}
+	trace(...args) {
+		this.debugEnabled && this.print("trace", ...args);
+	}
+	debug(...args) {
+		this.debugEnabled && this.print("debug", ...args);
+	}
+	log(...args) {
+		this.print("log", ...args);
+	}
+	info(...args) {
+		this.print("info", ...args);
+	}
+	warn(...args) {
+		this.print("warn", ...args);
+	}
+	error(...args) {
+		this.print("error", ...args);
+	}
+	child(scope) {
+		invariant(this.scope, "Logger must have a scope to create a child logger");
+		return new Logger(`${this.scope}:${scope}`);
+	}
+};
+function loggerFilter(logger, options) {
+	const originalLog = logger[options.level];
+	logger[options.level] = (...args) => {
+		const filteredArgs = options.filter(args);
+		if (filteredArgs.length === 0) return;
+		originalLog(...filteredArgs);
+	};
+	return logger;
+}
+
+//#endregion
+//#region src/fs.ts
+function getSharedDataPath(basePath) {
+	return path.join(basePath, SHARED_DATA_PATH);
+}
+function ensureSharedDataPath(basePath) {
+	const sharedDataPath = getSharedDataPath(basePath);
+	if (!fs.existsSync(sharedDataPath)) fs.mkdirSync(sharedDataPath, { recursive: true });
+	return sharedDataPath;
+}
+function getSettingsPath(basePath) {
+	return path.join(getSharedDataPath(basePath), "settings.json");
+}
+function loadSettings(basePath) {
+	const settingsPath = getSettingsPath(basePath);
+	if (!fs.existsSync(settingsPath)) return {};
+	return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+}
+function saveSettings(basePath, settings) {
+	const newSettings = merge(loadSettings(basePath), settings);
+	fs.writeFileSync(getSettingsPath(basePath), JSON.stringify(newSettings, null, 2));
+}
+function getCachePath(basePath) {
+	return path.join(getSharedDataPath(basePath), "cache");
+}
+function resetCache(basePath) {
+	fs.rmSync(getCachePath(basePath), {
+		recursive: true,
+		force: true
+	});
+}
+
+//#endregion
+//#region src/storage.ts
+const DEFAULT_DATA = { build: {} };
+var FileStorage = class FileStorage {
+	static instance = null;
+	dataFilePath;
+	data;
+	static getInstance(basePath) {
+		if (FileStorage.instance == null) FileStorage.instance = new FileStorage(basePath);
+		return new FileStorage(basePath);
+	}
+	constructor(basePath) {
+		this.basePath = basePath;
+		this.dataFilePath = path.join(getSharedDataPath(basePath), "rollipop.json");
+		if (fs.existsSync(this.dataFilePath)) this.data = JSON.parse(fs.readFileSync(this.dataFilePath, "utf-8"));
+		else this.data = DEFAULT_DATA;
+	}
+	get() {
+		return this.data;
+	}
+	set(data) {
+		this.data = merge(this.data, data);
+		fs.writeFileSync(this.dataFilePath, JSON.stringify(this.data, null, 2));
+	}
+};
+
+//#endregion
+export { DEBUG_KEY, DEV_SERVER_ASSET_PATH, FileStorage, Logger, Logo, SHARED_DATA_PATH, chalk, ensureSharedDataPath, getCachePath, getSettingsPath, getSharedDataPath, isDebugEnabled, loadSettings, loggerFilter, parseDebugKeys, resetCache, saveSettings };

package/package.json

@@ -1,4 +1,49 @@
 {
   "name": "@rollipop/common",
-  "version": "0.0.0"
-}
+  "version": "0.1.0-alpha.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leegeunhyeok/rollipop.git",
+    "directory": "packages/common"
+  },
+  "author": "leegeunhyeok <dev.ghlee@gmail.com> (https://github.com/leegeunhyeok)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/leegeunhyeok/rollipop/issues"
+  },
+  "homepage": "https://github.com/leegeunhyeok/rollipop#readme",
+  "scripts": {
+    "prepack": "yarn build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
+    "build": "tsdown"
+  },
+  "devDependencies": {
+    "tsdown": "0.18.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "dayjs": "^1.11.19",
+    "es-toolkit": "1.43.0",
+    "gradient-string": "^3.0.0"
+  }
+}

package/.editorconfig

@@ -1,10 +0,0 @@
-root = true
-
-[*]
-end_of_line = lf
-insert_final_newline = true
-
-[*.{js,json,yml}]
-charset = utf-8
-indent_style = space
-indent_size = 2

package/.gitattributes

@@ -1,4 +0,0 @@
-/.yarn/**            linguist-vendored
-/.yarn/releases/*    binary
-/.yarn/plugins/**/*  binary
-/.pnp.*              binary linguist-generated