tona 0.0.1

package/README.md

@@ -0,0 +1,116 @@
+# Tona
+
+API for creating cnblog theme.
+
+## Install
+
+```shell
+npm i tona
+```
+
+## API
+
+### createTheme
+
+Returns a theme instance that provides a theme context.
+
+```js
+import { createTheme } from 'tona'
+
+const theme = createTheme()
+```
+
+### defineOptions
+
+Returns a generic configuration object.
+
+```js
+import { defineOptions } from 'tona'
+
+const getBackgroundOptions = defineOptions('bodyBackground', {
+  enable: false,
+  value: '',
+  opacity: 0.85,
+  repeat: false,
+})
+```
+
+Cnblog theme users can add the following configuration:
+
+```js
+const opts = {
+  bodyBackground: {
+    enable: false,
+    value: '',
+    opacity: 0.85,
+    repeat: false,
+  },
+}
+```
+
+Using configuration aliases:
+
+```javascript
+import { defineOptions } from 'tona'
+
+const getBackgroundOptions = defineOptions(['bodyBackground', 'background'], {
+  enable: false,
+  value: '',
+  opacity: 0.85,
+  repeat: false,
+})
+```
+
+## Plugin System
+
+```js
+// plugin.js
+import { defineOptions } from 'tona'
+
+export function backgroundPlugin(theme, devOptions, pluginOptions) {
+  const getBackgroundOptions = defineOptions('bodyBackground', {
+    enable: false,
+    value: '',
+    opacity: 0.85,
+    repeat: false,
+  })
+
+  const { enable, value, opacity, repeat } = getBackgroundOptions(devOptions)
+
+  if (!enable)
+    return
+
+  const { opacitySelector } = Object.assign(
+    {},
+    {
+      opacitySelector: '#main,#navigator',
+    },
+    pluginOptions
+  )
+
+  setBackground(value, repeat)
+  setOpacity(opacity, opacitySelector)
+}
+```
+
+```js
+// theme/index.js
+import { createTheme } from 'tona'
+import { backgroundPlugin } from './plugin'
+
+const theme = createTheme()
+
+theme.use(
+  backgroundPlugin,
+  {
+    // Set the default configuration of the theme
+    enable: true,
+    value: '#ffb3cc',
+    opacity: 0.85,
+  },
+  {
+    // Set the default configuration of the plugin
+    opacitySelector: '#main',
+  }
+)
+```

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+//#region src/createThemeApi.d.ts
+interface Theme {
+  version: string;
+  _context: ThemeContext;
+  config: ThemeConfig;
+  use: (plugin: Plugin, ...options: any[]) => this;
+}
+interface ThemeConfig {
+  globalProperties: Record<string, any>;
+}
+interface ThemeContext {
+  theme: Theme;
+  config: ThemeConfig;
+}
+type PluginInstallFunction = (theme: Theme, ...options: any[]) => any;
+type Plugin = (PluginInstallFunction & {
+  install?: PluginInstallFunction;
+}) | {
+  install: PluginInstallFunction;
+};
+interface CreateThemeConfig {
+  log: boolean;
+}
+declare function createTheme(options?: CreateThemeConfig): Theme;
+//#endregion
+//#region src/defineOptionsApi.d.ts
+type DefineOptionsFn = <F extends object, D extends object, U extends object>(userOptionName: string | Array<string>, defaultOptions: F) => (devOptions?: D) => F & U & D;
+declare const defineOptions: DefineOptionsFn;
+//#endregion
+export { CreateThemeConfig, Plugin, PluginInstallFunction, Theme, ThemeConfig, ThemeContext, createTheme, defineOptions };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+//#region src/createThemeApi.d.ts
+interface Theme {
+  version: string;
+  _context: ThemeContext;
+  config: ThemeConfig;
+  use: (plugin: Plugin, ...options: any[]) => this;
+}
+interface ThemeConfig {
+  globalProperties: Record<string, any>;
+}
+interface ThemeContext {
+  theme: Theme;
+  config: ThemeConfig;
+}
+type PluginInstallFunction = (theme: Theme, ...options: any[]) => any;
+type Plugin = (PluginInstallFunction & {
+  install?: PluginInstallFunction;
+}) | {
+  install: PluginInstallFunction;
+};
+interface CreateThemeConfig {
+  log: boolean;
+}
+declare function createTheme(options?: CreateThemeConfig): Theme;
+//#endregion
+//#region src/defineOptionsApi.d.ts
+type DefineOptionsFn = <F extends object, D extends object, U extends object>(userOptionName: string | Array<string>, defaultOptions: F) => (devOptions?: D) => F & U & D;
+declare const defineOptions: DefineOptionsFn;
+//#endregion
+export { CreateThemeConfig, Plugin, PluginInstallFunction, Theme, ThemeConfig, ThemeContext, createTheme, defineOptions };

package/dist/index.js

@@ -0,0 +1,95 @@
+
+//#region src/constants/env.ts
+const __DEV__ = false;
+
+//#endregion
+//#region src/init.ts
+function setDevOptions() {
+	if (__DEV__) window.opts = {};
+}
+function hideLoading() {
+	const loading = $("#loading,.loading");
+	if (loading.length) loading.fadeOut(300);
+}
+var init_default = (_) => {
+	setDevOptions();
+	hideLoading();
+};
+
+//#endregion
+//#region src/utils/shared.ts
+const extend = Object.assign;
+const isArray = Array.isArray;
+function isFunction(x) {
+	return typeof x === "function";
+}
+
+//#endregion
+//#region src/createThemeApi.ts
+function createThemeContext() {
+	return {
+		theme: null,
+		config: { globalProperties: {} }
+	};
+}
+function createThemeAPI() {
+	return function createTheme$1() {
+		const context = createThemeContext();
+		const installedPlugins = /* @__PURE__ */ new Set();
+		const themeObject = {
+			_context: context,
+			version: "3.0",
+			get config() {
+				return context.config;
+			},
+			set config(_) {
+				if (__DEV__) console.warn(`theme.config cannot be replaced. Modify individual options instead.`);
+			},
+			use(plugin, ...options) {
+				if (installedPlugins.has(plugin)) __DEV__ && console.warn(`Plugin has already been applied to target theme.`);
+				else if (plugin && isFunction(plugin.install)) {
+					installedPlugins.add(plugin);
+					plugin.install(themeObject, ...options);
+				} else if (isFunction(plugin)) {
+					installedPlugins.add(plugin);
+					plugin(themeObject, ...options);
+				} else if (__DEV__) console.warn("A plugin must either be a function or an object with an \"install\" function.");
+				return themeObject;
+			}
+		};
+		const theme = themeObject;
+		context.theme = themeObject;
+		return theme;
+	};
+}
+function baseCreateTheme(options) {
+	init_default(options);
+	return { createTheme: createThemeAPI() };
+}
+function createTheme(options) {
+	return baseCreateTheme(options).createTheme();
+}
+
+//#endregion
+//#region src/defineOptionsApi.ts
+const mergeOptions = (def = {}, user = {}, dev = {}) => {
+	return extend({}, extend({}, def, dev), user);
+};
+function getValue(valueKeys = [], obj = {}) {
+	const key = Object.keys(obj).find((key$1) => valueKeys.includes(key$1));
+	return key ? obj[key] : null;
+}
+function ensureUserOptions(userOptionName) {
+	const userConfig = window.opts || {};
+	if (typeof userOptionName === "string") return userConfig[userOptionName];
+	else if (isArray(userOptionName)) return getValue(userOptionName, userConfig);
+}
+const defineOptions = (userOptionName, defaultOptions) => {
+	return (devOptions) => {
+		return mergeOptions(defaultOptions, ensureUserOptions(userOptionName), devOptions);
+	};
+};
+
+//#endregion
+exports.createTheme = createTheme;
+exports.defineOptions = defineOptions;

package/dist/index.mjs

@@ -0,0 +1,93 @@
+//#region src/constants/env.ts
+const __DEV__ = false;
+
+//#endregion
+//#region src/init.ts
+function setDevOptions() {
+	if (__DEV__) window.opts = {};
+}
+function hideLoading() {
+	const loading = $("#loading,.loading");
+	if (loading.length) loading.fadeOut(300);
+}
+var init_default = (_) => {
+	setDevOptions();
+	hideLoading();
+};
+
+//#endregion
+//#region src/utils/shared.ts
+const extend = Object.assign;
+const isArray = Array.isArray;
+function isFunction(x) {
+	return typeof x === "function";
+}
+
+//#endregion
+//#region src/createThemeApi.ts
+function createThemeContext() {
+	return {
+		theme: null,
+		config: { globalProperties: {} }
+	};
+}
+function createThemeAPI() {
+	return function createTheme$1() {
+		const context = createThemeContext();
+		const installedPlugins = /* @__PURE__ */ new Set();
+		const themeObject = {
+			_context: context,
+			version: "3.0",
+			get config() {
+				return context.config;
+			},
+			set config(_) {
+				if (__DEV__) console.warn(`theme.config cannot be replaced. Modify individual options instead.`);
+			},
+			use(plugin, ...options) {
+				if (installedPlugins.has(plugin)) __DEV__ && console.warn(`Plugin has already been applied to target theme.`);
+				else if (plugin && isFunction(plugin.install)) {
+					installedPlugins.add(plugin);
+					plugin.install(themeObject, ...options);
+				} else if (isFunction(plugin)) {
+					installedPlugins.add(plugin);
+					plugin(themeObject, ...options);
+				} else if (__DEV__) console.warn("A plugin must either be a function or an object with an \"install\" function.");
+				return themeObject;
+			}
+		};
+		const theme = themeObject;
+		context.theme = themeObject;
+		return theme;
+	};
+}
+function baseCreateTheme(options) {
+	init_default(options);
+	return { createTheme: createThemeAPI() };
+}
+function createTheme(options) {
+	return baseCreateTheme(options).createTheme();
+}
+
+//#endregion
+//#region src/defineOptionsApi.ts
+const mergeOptions = (def = {}, user = {}, dev = {}) => {
+	return extend({}, extend({}, def, dev), user);
+};
+function getValue(valueKeys = [], obj = {}) {
+	const key = Object.keys(obj).find((key$1) => valueKeys.includes(key$1));
+	return key ? obj[key] : null;
+}
+function ensureUserOptions(userOptionName) {
+	const userConfig = window.opts || {};
+	if (typeof userOptionName === "string") return userConfig[userOptionName];
+	else if (isArray(userOptionName)) return getValue(userOptionName, userConfig);
+}
+const defineOptions = (userOptionName, defaultOptions) => {
+	return (devOptions) => {
+		return mergeOptions(defaultOptions, ensureUserOptions(userOptionName), devOptions);
+	};
+};
+
+//#endregion
+export { createTheme, defineOptions };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "tona",
+  "version": "0.0.1",
+  "description": "",
+  "author": {
+    "name": "guangzan",
+    "url": "https://www.cnblogs.com/guangzan",
+    "email": "guangzan1999@outlook.com"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/acnblogs/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/acnblogs/core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/acnblogs/core/issues"
+  },
+  "keywords": [
+    "博客园"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "devDependencies": {
+    "@types/jquery": "catalog:",
+    "@vitest/ui": "catalog:",
+    "happy-dom": "catalog:",
+    "tsdown": "catalog:",
+    "vitest": "catalog:"
+  }
+}