@ailuracode/alpine-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) ailuracode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @ailuracode/alpine-core
+
+Lazy plugin registry and initializer for [Alpine.js](https://alpinejs.dev/) v3.
+
+Use this package to register plugins without running them at import time, then initialize only the plugins you need — keeping bundles tree-shakeable and SSR-safe.
+
+## Install
+
+```bash
+npm install @ailuracode/alpine-core alpinejs
+```
+
+## Quick start
+
+```js
+import Alpine from "alpinejs";
+import {
+  createAlpinePlugin,
+  defineMagicPlugin,
+  defineStorePlugin,
+  initPlugins,
+  registerPlugin,
+} from "@ailuracode/alpine-core";
+import share from "@ailuracode/alpine-share";
+import theme from "@ailuracode/alpine-theme";
+
+registerPlugin(
+  "share",
+  defineMagicPlugin(["share"], share)
+);
+
+registerPlugin(
+  "theme",
+  defineStorePlugin(["theme"], theme({
+    onChange({ resolved }) {
+      document.documentElement.dataset.theme = resolved;
+    },
+  }))
+);
+
+// Sync entry (factory plugins must be resolved before registerPlugin)
+Alpine.plugin(createAlpinePlugin(["share", "theme"]));
+Alpine.start();
+```
+
+## Lazy dynamic imports
+
+```js
+import { initPlugins, lazyPlugin, registerPlugin } from "@ailuracode/alpine-core";
+
+registerPlugin(
+  "share",
+  lazyPlugin({
+    kind: "magic",
+    magics: ["share"],
+    import: () => import("@ailuracode/alpine-share"),
+  })
+);
+
+await initPlugins(Alpine, "share");
+Alpine.start();
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `registerPlugin(name, definition)` | Register a plugin without initializing it |
+| `initPlugins(Alpine, names?)` | Initialize all or selected plugins (async-safe) |
+| `initPluginsSync(Alpine, names?)` | Initialize sync plugins only |
+| `createAlpinePlugin(names?)` | Alpine.js bridge for sync plugins |
+| `defineMagicPlugin(magics, loader)` | Helper for magic plugins |
+| `defineStorePlugin(stores, loader)` | Helper for store plugins |
+| `defineHybridPlugin(options)` | Helper for plugins that register both |
+| `lazyPlugin(options)` | Helper for dynamic `import()` loaders |
+| `isPluginInitialized(name)` | Whether a plugin has been initialized |
+| `getRegisteredPlugins()` | List registered plugins |
+
+## Plugin kinds
+
+- **magic** — registers Alpine magics such as `$share` or `$calendar`
+- **store** — registers Alpine stores such as `$store.theme`
+- **both** — registers multiple magics and/or stores in one plugin (e.g. `$wakelock`, `$idle`)
+
+## SSR
+
+The core never touches `window` or `navigator` at import time. Plugin loaders run only when you call `initPlugins()` or `createAlpinePlugin()`.
+
+## TypeScript
+
+```ts
+/// <reference types="@types/alpinejs" />
+/// <reference types="@ailuracode/alpine-core" />
+```
+
+Also reference individual plugin `global.d.ts` files for magic and store typings.
+
+## License
+
+MIT

package/dist/global.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="@types/alpinejs" />
+
+export {};

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+import AlpineType from 'alpinejs';
+
+/** Alpine.js plugin callback registered with `Alpine.plugin()`. */
+type AlpinePluginCallback = (Alpine: AlpineType.Alpine) => void;
+/**
+ * Lazy plugin source. Resolved only when `initPlugins()` runs — never at import time.
+ * Supports sync callbacks, lazy factories, and dynamic `import()` loaders.
+ */
+type PluginLoader = AlpinePluginCallback | (() => AlpinePluginCallback) | (() => Promise<AlpinePluginCallback>);
+/** Plugin that registers one or more Alpine magics (`$share`, `$calendar`, …). */
+interface MagicPluginDefinition {
+    readonly kind: "magic";
+    readonly magics: readonly string[];
+    readonly plugin: PluginLoader;
+}
+/** Plugin that registers one or more Alpine stores (`$store.theme`, …). */
+interface StorePluginDefinition {
+    readonly kind: "store";
+    readonly stores: readonly string[];
+    readonly plugin: PluginLoader;
+}
+/** Plugin that registers both magics and stores (`$wakelock` + `$idle`, …). */
+interface HybridPluginDefinition {
+    readonly kind: "both";
+    readonly magics?: readonly string[];
+    readonly stores?: readonly string[];
+    readonly plugin: PluginLoader;
+}
+type PluginDefinition = MagicPluginDefinition | StorePluginDefinition | HybridPluginDefinition;
+interface RegisteredPlugin {
+    readonly name: string;
+    readonly definition: PluginDefinition;
+}
+interface PluginRegistryEntry {
+    readonly name: string;
+    readonly definition: PluginDefinition;
+    initialized: boolean;
+}
+
+/** Creates a magic plugin definition. */
+declare function defineMagicPlugin(magics: readonly string[], plugin: PluginLoader): MagicPluginDefinition;
+/** Creates a store plugin definition. */
+declare function defineStorePlugin(stores: readonly string[], plugin: PluginLoader): StorePluginDefinition;
+/** Creates a hybrid plugin definition for magics and stores together. */
+declare function defineHybridPlugin(options: {
+    magics?: readonly string[];
+    stores?: readonly string[];
+    plugin: PluginLoader;
+}): HybridPluginDefinition;
+type LazyPluginModule = {
+    default: PluginLoader;
+};
+/** Creates a plugin definition backed by a dynamic `import()`. */
+declare function lazyPlugin(definition: Omit<MagicPluginDefinition, "plugin"> & {
+    import: () => Promise<LazyPluginModule>;
+}): MagicPluginDefinition;
+declare function lazyPlugin(definition: Omit<StorePluginDefinition, "plugin"> & {
+    import: () => Promise<LazyPluginModule>;
+}): StorePluginDefinition;
+declare function lazyPlugin(definition: Omit<HybridPluginDefinition, "plugin"> & {
+    import: () => Promise<LazyPluginModule>;
+}): HybridPluginDefinition;
+
+declare class PluginLoaderError extends Error {
+    constructor(message: string);
+}
+
+/** Registers a plugin definition without initializing it. Safe to call at import time. */
+declare function registerPlugin(name: string, definition: PluginDefinition): void;
+/** Removes a plugin from the registry. Returns whether it existed. */
+declare function unregisterPlugin(name: string): boolean;
+/** Returns a registered plugin entry, if present. */
+declare function getRegisteredPlugin(name: string): PluginRegistryEntry | undefined;
+/** Returns all registered plugins in registration order. */
+declare function getRegisteredPlugins(): readonly PluginRegistryEntry[];
+/** Returns whether a plugin has been initialized with Alpine. */
+declare function isPluginInitialized(name: string): boolean;
+/** Clears the registry. Intended for tests. */
+declare function resetPluginRegistry(): void;
+
+/**
+ * Initializes registered plugins on demand. Supports async dynamic imports.
+ * Call before `Alpine.start()` in SSR and client entrypoints.
+ */
+declare function initPlugins(Alpine: AlpineType.Alpine, names?: string | readonly string[]): Promise<readonly RegisteredPlugin[]>;
+/**
+ * Initializes registered plugins synchronously.
+ * Throws when a plugin uses an async loader — use `initPlugins()` instead.
+ */
+declare function initPluginsSync(Alpine: AlpineType.Alpine, names?: string | readonly string[]): readonly RegisteredPlugin[];
+/**
+ * Returns an Alpine.js plugin callback that initializes the given registered plugins.
+ * Only supports sync loaders — use `initPlugins()` for dynamic imports.
+ */
+declare function createAlpinePlugin(names?: string | readonly string[]): AlpineType.PluginCallback;
+
+export { type AlpinePluginCallback, type HybridPluginDefinition, type MagicPluginDefinition, type PluginDefinition, type PluginLoader, PluginLoaderError, type PluginRegistryEntry, type RegisteredPlugin, type StorePluginDefinition, createAlpinePlugin, defineHybridPlugin, defineMagicPlugin, defineStorePlugin, getRegisteredPlugin, getRegisteredPlugins, initPlugins, initPluginsSync, isPluginInitialized, lazyPlugin, registerPlugin, resetPluginRegistry, unregisterPlugin };

package/dist/index.js

@@ -0,0 +1,227 @@
+// src/loader.ts
+var PluginLoaderError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PluginLoaderError";
+  }
+};
+function isPluginCallback(value) {
+  return typeof value === "function";
+}
+function isLazyFactory(loader) {
+  return typeof loader === "function" && loader.length === 0;
+}
+async function resolvePluginLoader(loader) {
+  if (!isLazyFactory(loader)) {
+    return loader;
+  }
+  const candidate = loader();
+  const resolved = candidate instanceof Promise ? await candidate : candidate;
+  if (!isPluginCallback(resolved)) {
+    throw new PluginLoaderError("Plugin loader must resolve to a function");
+  }
+  return resolved;
+}
+function resolvePluginLoaderSync(loader) {
+  if (!isLazyFactory(loader)) {
+    return loader;
+  }
+  const candidate = loader();
+  if (candidate instanceof Promise) {
+    throw new PluginLoaderError("Async plugin loaders require initPlugins() before Alpine.start()");
+  }
+  if (!isPluginCallback(candidate)) {
+    throw new PluginLoaderError("Plugin loader must resolve to a function");
+  }
+  return candidate;
+}
+
+// src/registry.ts
+var registry = /* @__PURE__ */ new Map();
+function normalizePluginName(name) {
+  const normalized = name.trim();
+  if (!normalized) {
+    throw new Error("Plugin name must be a non-empty string");
+  }
+  return normalized;
+}
+function assertValidDefinition(definition) {
+  switch (definition.kind) {
+    case "magic": {
+      if (definition.magics.length === 0) {
+        throw new Error(`Magic plugin must declare at least one magic name`);
+      }
+      break;
+    }
+    case "store": {
+      if (definition.stores.length === 0) {
+        throw new Error(`Store plugin must declare at least one store name`);
+      }
+      break;
+    }
+    case "both": {
+      const hasMagics = (definition.magics?.length ?? 0) > 0;
+      const hasStores = (definition.stores?.length ?? 0) > 0;
+      if (!(hasMagics || hasStores)) {
+        throw new Error(`Hybrid plugin must declare at least one magic or store name`);
+      }
+      break;
+    }
+    default: {
+      const unknownKind = definition;
+      throw new Error(`Unknown plugin kind: ${String(unknownKind)}`);
+    }
+  }
+}
+function registerPlugin(name, definition) {
+  const normalizedName = normalizePluginName(name);
+  assertValidDefinition(definition);
+  if (registry.has(normalizedName)) {
+    throw new Error(`Plugin "${normalizedName}" is already registered`);
+  }
+  registry.set(normalizedName, {
+    name: normalizedName,
+    definition,
+    initialized: false
+  });
+}
+function unregisterPlugin(name) {
+  return registry.delete(normalizePluginName(name));
+}
+function getRegisteredPlugin(name) {
+  return registry.get(normalizePluginName(name));
+}
+function getRegisteredPlugins() {
+  return [...registry.values()];
+}
+function isPluginInitialized(name) {
+  return registry.get(normalizePluginName(name))?.initialized ?? false;
+}
+function markPluginInitialized(name) {
+  const entry = registry.get(normalizePluginName(name));
+  if (!entry) {
+    throw new Error(`Cannot mark unknown plugin "${name}" as initialized`);
+  }
+  entry.initialized = true;
+}
+function resetPluginRegistry() {
+  registry.clear();
+}
+function resolvePluginEntries(names) {
+  if (names === void 0) {
+    return [...getRegisteredPlugins()];
+  }
+  const requested = Array.isArray(names) ? names : [names];
+  if (requested.length === 0) {
+    return [];
+  }
+  const entries = [];
+  for (const name of requested) {
+    const entry = getRegisteredPlugin(name);
+    if (!entry) {
+      throw new Error(`Plugin "${name}" is not registered`);
+    }
+    entries.push(entry);
+  }
+  return entries;
+}
+
+// src/define.ts
+function defineMagicPlugin(magics, plugin) {
+  return {
+    kind: "magic",
+    magics,
+    plugin
+  };
+}
+function defineStorePlugin(stores, plugin) {
+  return {
+    kind: "store",
+    stores,
+    plugin
+  };
+}
+function defineHybridPlugin(options) {
+  return {
+    kind: "both",
+    magics: options.magics,
+    stores: options.stores,
+    plugin: options.plugin
+  };
+}
+function lazyPlugin(definition) {
+  const { import: importModule, ...rest } = definition;
+  const plugin = async () => {
+    const module = await importModule();
+    return resolvePluginLoader(module.default);
+  };
+  switch (rest.kind) {
+    case "magic":
+      return defineMagicPlugin(rest.magics ?? [], plugin);
+    case "store":
+      return defineStorePlugin(rest.stores ?? [], plugin);
+    case "both":
+      return defineHybridPlugin({
+        magics: rest.magics,
+        stores: rest.stores,
+        plugin
+      });
+  }
+}
+
+// src/index.ts
+function toRegisteredPlugin(entry) {
+  return {
+    name: entry.name,
+    definition: entry.definition
+  };
+}
+async function initializeEntry(Alpine, entry) {
+  if (entry.initialized) {
+    return;
+  }
+  const callback = await resolvePluginLoader(entry.definition.plugin);
+  Alpine.plugin(callback);
+  markPluginInitialized(entry.name);
+}
+async function initPlugins(Alpine, names) {
+  const entries = resolvePluginEntries(names);
+  for (const entry of entries) {
+    await initializeEntry(Alpine, entry);
+  }
+  return entries.map(toRegisteredPlugin);
+}
+function initPluginsSync(Alpine, names) {
+  const entries = resolvePluginEntries(names);
+  for (const entry of entries) {
+    if (entry.initialized) {
+      continue;
+    }
+    const callback = resolvePluginLoaderSync(entry.definition.plugin);
+    Alpine.plugin(callback);
+    markPluginInitialized(entry.name);
+  }
+  return entries.map(toRegisteredPlugin);
+}
+function createAlpinePlugin(names) {
+  return (Alpine) => {
+    initPluginsSync(Alpine, names);
+  };
+}
+export {
+  PluginLoaderError,
+  createAlpinePlugin,
+  defineHybridPlugin,
+  defineMagicPlugin,
+  defineStorePlugin,
+  getRegisteredPlugin,
+  getRegisteredPlugins,
+  initPlugins,
+  initPluginsSync,
+  isPluginInitialized,
+  lazyPlugin,
+  registerPlugin,
+  resetPluginRegistry,
+  unregisterPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/registry.ts","../src/define.ts","../src/index.ts"],"sourcesContent":["import type { AlpinePluginCallback, PluginLoader } from \"./types.js\";\n\nexport class PluginLoaderError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PluginLoaderError\";\n  }\n}\n\nfunction isPluginCallback(value: unknown): value is AlpinePluginCallback {\n  return typeof value === \"function\";\n}\n\nfunction isLazyFactory(\n  loader: PluginLoader\n): loader is (() => AlpinePluginCallback) | (() => Promise<AlpinePluginCallback>) {\n  return typeof loader === \"function\" && loader.length === 0;\n}\n\n/** Resolves a lazy plugin loader to an Alpine plugin callback. */\nexport async function resolvePluginLoader(loader: PluginLoader): Promise<AlpinePluginCallback> {\n  if (!isLazyFactory(loader)) {\n    return loader;\n  }\n\n  const candidate = loader();\n  const resolved = candidate instanceof Promise ? await candidate : candidate;\n\n  if (!isPluginCallback(resolved)) {\n    throw new PluginLoaderError(\"Plugin loader must resolve to a function\");\n  }\n\n  return resolved;\n}\n\n/** Resolves a lazy plugin loader synchronously. Throws when the loader is async. */\nexport function resolvePluginLoaderSync(loader: PluginLoader): AlpinePluginCallback {\n  if (!isLazyFactory(loader)) {\n    return loader;\n  }\n\n  const candidate = loader();\n\n  if (candidate instanceof Promise) {\n    throw new PluginLoaderError(\"Async plugin loaders require initPlugins() before Alpine.start()\");\n  }\n\n  if (!isPluginCallback(candidate)) {\n    throw new PluginLoaderError(\"Plugin loader must resolve to a function\");\n  }\n\n  return candidate;\n}\n","import type { PluginDefinition, PluginRegistryEntry } from \"./types.js\";\n\nconst registry = new Map<string, PluginRegistryEntry>();\n\nfunction normalizePluginName(name: string): string {\n  const normalized = name.trim();\n\n  if (!normalized) {\n    throw new Error(\"Plugin name must be a non-empty string\");\n  }\n\n  return normalized;\n}\n\nfunction assertValidDefinition(definition: PluginDefinition): void {\n  switch (definition.kind) {\n    case \"magic\": {\n      if (definition.magics.length === 0) {\n        throw new Error(`Magic plugin must declare at least one magic name`);\n      }\n      break;\n    }\n    case \"store\": {\n      if (definition.stores.length === 0) {\n        throw new Error(`Store plugin must declare at least one store name`);\n      }\n      break;\n    }\n    case \"both\": {\n      const hasMagics = (definition.magics?.length ?? 0) > 0;\n      const hasStores = (definition.stores?.length ?? 0) > 0;\n\n      if (!(hasMagics || hasStores)) {\n        throw new Error(`Hybrid plugin must declare at least one magic or store name`);\n      }\n      break;\n    }\n    default: {\n      const unknownKind: never = definition;\n      throw new Error(`Unknown plugin kind: ${String(unknownKind)}`);\n    }\n  }\n}\n\n/** Registers a plugin definition without initializing it. Safe to call at import time. */\nexport function registerPlugin(name: string, definition: PluginDefinition): void {\n  const normalizedName = normalizePluginName(name);\n  assertValidDefinition(definition);\n\n  if (registry.has(normalizedName)) {\n    throw new Error(`Plugin \"${normalizedName}\" is already registered`);\n  }\n\n  registry.set(normalizedName, {\n    name: normalizedName,\n    definition,\n    initialized: false,\n  });\n}\n\n/** Removes a plugin from the registry. Returns whether it existed. */\nexport function unregisterPlugin(name: string): boolean {\n  return registry.delete(normalizePluginName(name));\n}\n\n/** Returns a registered plugin entry, if present. */\nexport function getRegisteredPlugin(name: string): PluginRegistryEntry | undefined {\n  return registry.get(normalizePluginName(name));\n}\n\n/** Returns all registered plugins in registration order. */\nexport function getRegisteredPlugins(): readonly PluginRegistryEntry[] {\n  return [...registry.values()];\n}\n\n/** Returns whether a plugin has been initialized with Alpine. */\nexport function isPluginInitialized(name: string): boolean {\n  return registry.get(normalizePluginName(name))?.initialized ?? false;\n}\n\n/** Marks a plugin as initialized. */\nexport function markPluginInitialized(name: string): void {\n  const entry = registry.get(normalizePluginName(name));\n\n  if (!entry) {\n    throw new Error(`Cannot mark unknown plugin \"${name}\" as initialized`);\n  }\n\n  entry.initialized = true;\n}\n\n/** Clears the registry. Intended for tests. */\nexport function resetPluginRegistry(): void {\n  registry.clear();\n}\n\n/** Resolves plugin names to registry entries, preserving registration order. */\nexport function resolvePluginEntries(names?: string | readonly string[]): PluginRegistryEntry[] {\n  if (names === undefined) {\n    return [...getRegisteredPlugins()];\n  }\n\n  const requested = Array.isArray(names) ? names : [names];\n\n  if (requested.length === 0) {\n    return [];\n  }\n\n  const entries: PluginRegistryEntry[] = [];\n\n  for (const name of requested) {\n    const entry = getRegisteredPlugin(name);\n\n    if (!entry) {\n      throw new Error(`Plugin \"${name}\" is not registered`);\n    }\n\n    entries.push(entry);\n  }\n\n  return entries;\n}\n","import { resolvePluginLoader } from \"./loader.js\";\nimport type {\n  HybridPluginDefinition,\n  MagicPluginDefinition,\n  PluginLoader,\n  StorePluginDefinition,\n} from \"./types.js\";\n\n/** Creates a magic plugin definition. */\nexport function defineMagicPlugin(\n  magics: readonly string[],\n  plugin: PluginLoader\n): MagicPluginDefinition {\n  return {\n    kind: \"magic\",\n    magics,\n    plugin,\n  };\n}\n\n/** Creates a store plugin definition. */\nexport function defineStorePlugin(\n  stores: readonly string[],\n  plugin: PluginLoader\n): StorePluginDefinition {\n  return {\n    kind: \"store\",\n    stores,\n    plugin,\n  };\n}\n\n/** Creates a hybrid plugin definition for magics and stores together. */\nexport function defineHybridPlugin(options: {\n  magics?: readonly string[];\n  stores?: readonly string[];\n  plugin: PluginLoader;\n}): HybridPluginDefinition {\n  return {\n    kind: \"both\",\n    magics: options.magics,\n    stores: options.stores,\n    plugin: options.plugin,\n  };\n}\n\ntype LazyPluginModule = {\n  default: PluginLoader;\n};\n\n/** Creates a plugin definition backed by a dynamic `import()`. */\nexport function lazyPlugin(\n  definition: Omit<MagicPluginDefinition, \"plugin\"> & {\n    import: () => Promise<LazyPluginModule>;\n  }\n): MagicPluginDefinition;\nexport function lazyPlugin(\n  definition: Omit<StorePluginDefinition, \"plugin\"> & {\n    import: () => Promise<LazyPluginModule>;\n  }\n): StorePluginDefinition;\nexport function lazyPlugin(\n  definition: Omit<HybridPluginDefinition, \"plugin\"> & {\n    import: () => Promise<LazyPluginModule>;\n  }\n): HybridPluginDefinition;\nexport function lazyPlugin(definition: {\n  kind: \"magic\" | \"store\" | \"both\";\n  magics?: readonly string[];\n  stores?: readonly string[];\n  import: () => Promise<LazyPluginModule>;\n}): MagicPluginDefinition | StorePluginDefinition | HybridPluginDefinition {\n  const { import: importModule, ...rest } = definition;\n  const plugin = async () => {\n    const module = await importModule();\n    return resolvePluginLoader(module.default);\n  };\n\n  switch (rest.kind) {\n    case \"magic\":\n      return defineMagicPlugin(rest.magics ?? [], plugin);\n    case \"store\":\n      return defineStorePlugin(rest.stores ?? [], plugin);\n    case \"both\":\n      return defineHybridPlugin({\n        magics: rest.magics,\n        stores: rest.stores,\n        plugin,\n      });\n  }\n}\n","import type AlpineType from \"alpinejs\";\nimport { resolvePluginLoader, resolvePluginLoaderSync } from \"./loader.js\";\nimport { markPluginInitialized, resolvePluginEntries } from \"./registry.js\";\nimport type { PluginDefinition, RegisteredPlugin } from \"./types.js\";\n\nexport {\n  defineHybridPlugin,\n  defineMagicPlugin,\n  defineStorePlugin,\n  lazyPlugin,\n} from \"./define.js\";\nexport { PluginLoaderError } from \"./loader.js\";\nexport {\n  getRegisteredPlugin,\n  getRegisteredPlugins,\n  isPluginInitialized,\n  registerPlugin,\n  resetPluginRegistry,\n  unregisterPlugin,\n} from \"./registry.js\";\nexport type {\n  AlpinePluginCallback,\n  HybridPluginDefinition,\n  MagicPluginDefinition,\n  PluginDefinition,\n  PluginLoader,\n  PluginRegistryEntry,\n  RegisteredPlugin,\n  StorePluginDefinition,\n} from \"./types.js\";\n\nfunction toRegisteredPlugin(entry: {\n  name: string;\n  definition: PluginDefinition;\n}): RegisteredPlugin {\n  return {\n    name: entry.name,\n    definition: entry.definition,\n  };\n}\n\nasync function initializeEntry(\n  Alpine: AlpineType.Alpine,\n  entry: ReturnType<typeof resolvePluginEntries>[number]\n): Promise<void> {\n  if (entry.initialized) {\n    return;\n  }\n\n  const callback = await resolvePluginLoader(entry.definition.plugin);\n  Alpine.plugin(callback);\n  markPluginInitialized(entry.name);\n}\n\n/**\n * Initializes registered plugins on demand. Supports async dynamic imports.\n * Call before `Alpine.start()` in SSR and client entrypoints.\n */\nexport async function initPlugins(\n  Alpine: AlpineType.Alpine,\n  names?: string | readonly string[]\n): Promise<readonly RegisteredPlugin[]> {\n  const entries = resolvePluginEntries(names);\n\n  for (const entry of entries) {\n    await initializeEntry(Alpine, entry);\n  }\n\n  return entries.map(toRegisteredPlugin);\n}\n\n/**\n * Initializes registered plugins synchronously.\n * Throws when a plugin uses an async loader — use `initPlugins()` instead.\n */\nexport function initPluginsSync(\n  Alpine: AlpineType.Alpine,\n  names?: string | readonly string[]\n): readonly RegisteredPlugin[] {\n  const entries = resolvePluginEntries(names);\n\n  for (const entry of entries) {\n    if (entry.initialized) {\n      continue;\n    }\n\n    const callback = resolvePluginLoaderSync(entry.definition.plugin);\n    Alpine.plugin(callback);\n    markPluginInitialized(entry.name);\n  }\n\n  return entries.map(toRegisteredPlugin);\n}\n\n/**\n * Returns an Alpine.js plugin callback that initializes the given registered plugins.\n * Only supports sync loaders — use `initPlugins()` for dynamic imports.\n */\nexport function createAlpinePlugin(names?: string | readonly string[]): AlpineType.PluginCallback {\n  return (Alpine) => {\n    initPluginsSync(Alpine, names);\n  };\n}\n"],"mappings":";AAEO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,iBAAiB,OAA+C;AACvE,SAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,cACP,QACgF;AAChF,SAAO,OAAO,WAAW,cAAc,OAAO,WAAW;AAC3D;AAGA,eAAsB,oBAAoB,QAAqD;AAC7F,MAAI,CAAC,cAAc,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO;AACzB,QAAM,WAAW,qBAAqB,UAAU,MAAM,YAAY;AAElE,MAAI,CAAC,iBAAiB,QAAQ,GAAG;AAC/B,UAAM,IAAI,kBAAkB,0CAA0C;AAAA,EACxE;AAEA,SAAO;AACT;AAGO,SAAS,wBAAwB,QAA4C;AAClF,MAAI,CAAC,cAAc,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO;AAEzB,MAAI,qBAAqB,SAAS;AAChC,UAAM,IAAI,kBAAkB,kEAAkE;AAAA,EAChG;AAEA,MAAI,CAAC,iBAAiB,SAAS,GAAG;AAChC,UAAM,IAAI,kBAAkB,0CAA0C;AAAA,EACxE;AAEA,SAAO;AACT;;;AClDA,IAAM,WAAW,oBAAI,IAAiC;AAEtD,SAAS,oBAAoB,MAAsB;AACjD,QAAM,aAAa,KAAK,KAAK;AAE7B,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC1D;AAEA,SAAO;AACT;AAEA,SAAS,sBAAsB,YAAoC;AACjE,UAAQ,WAAW,MAAM;AAAA,IACvB,KAAK,SAAS;AACZ,UAAI,WAAW,OAAO,WAAW,GAAG;AAClC,cAAM,IAAI,MAAM,mDAAmD;AAAA,MACrE;AACA;AAAA,IACF;AAAA,IACA,KAAK,SAAS;AACZ,UAAI,WAAW,OAAO,WAAW,GAAG;AAClC,cAAM,IAAI,MAAM,mDAAmD;AAAA,MACrE;AACA;AAAA,IACF;AAAA,IACA,KAAK,QAAQ;AACX,YAAM,aAAa,WAAW,QAAQ,UAAU,KAAK;AACrD,YAAM,aAAa,WAAW,QAAQ,UAAU,KAAK;AAErD,UAAI,EAAE,aAAa,YAAY;AAC7B,cAAM,IAAI,MAAM,6DAA6D;AAAA,MAC/E;AACA;AAAA,IACF;AAAA,IACA,SAAS;AACP,YAAM,cAAqB;AAC3B,YAAM,IAAI,MAAM,wBAAwB,OAAO,WAAW,CAAC,EAAE;AAAA,IAC/D;AAAA,EACF;AACF;AAGO,SAAS,eAAe,MAAc,YAAoC;AAC/E,QAAM,iBAAiB,oBAAoB,IAAI;AAC/C,wBAAsB,UAAU;AAEhC,MAAI,SAAS,IAAI,cAAc,GAAG;AAChC,UAAM,IAAI,MAAM,WAAW,cAAc,yBAAyB;AAAA,EACpE;AAEA,WAAS,IAAI,gBAAgB;AAAA,IAC3B,MAAM;AAAA,IACN;AAAA,IACA,aAAa;AAAA,EACf,CAAC;AACH;AAGO,SAAS,iBAAiB,MAAuB;AACtD,SAAO,SAAS,OAAO,oBAAoB,IAAI,CAAC;AAClD;AAGO,SAAS,oBAAoB,MAA+C;AACjF,SAAO,SAAS,IAAI,oBAAoB,IAAI,CAAC;AAC/C;AAGO,SAAS,uBAAuD;AACrE,SAAO,CAAC,GAAG,SAAS,OAAO,CAAC;AAC9B;AAGO,SAAS,oBAAoB,MAAuB;AACzD,SAAO,SAAS,IAAI,oBAAoB,IAAI,CAAC,GAAG,eAAe;AACjE;AAGO,SAAS,sBAAsB,MAAoB;AACxD,QAAM,QAAQ,SAAS,IAAI,oBAAoB,IAAI,CAAC;AAEpD,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,+BAA+B,IAAI,kBAAkB;AAAA,EACvE;AAEA,QAAM,cAAc;AACtB;AAGO,SAAS,sBAA4B;AAC1C,WAAS,MAAM;AACjB;AAGO,SAAS,qBAAqB,OAA2D;AAC9F,MAAI,UAAU,QAAW;AACvB,WAAO,CAAC,GAAG,qBAAqB,CAAC;AAAA,EACnC;AAEA,QAAM,YAAY,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAEvD,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,UAAiC,CAAC;AAExC,aAAW,QAAQ,WAAW;AAC5B,UAAM,QAAQ,oBAAoB,IAAI;AAEtC,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,WAAW,IAAI,qBAAqB;AAAA,IACtD;AAEA,YAAQ,KAAK,KAAK;AAAA,EACpB;AAEA,SAAO;AACT;;;AChHO,SAAS,kBACd,QACA,QACuB;AACvB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,kBACd,QACA,QACuB;AACvB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,mBAAmB,SAIR;AACzB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,QAAQ;AAAA,IAChB,QAAQ,QAAQ;AAAA,IAChB,QAAQ,QAAQ;AAAA,EAClB;AACF;AAsBO,SAAS,WAAW,YAKgD;AACzE,QAAM,EAAE,QAAQ,cAAc,GAAG,KAAK,IAAI;AAC1C,QAAM,SAAS,YAAY;AACzB,UAAM,SAAS,MAAM,aAAa;AAClC,WAAO,oBAAoB,OAAO,OAAO;AAAA,EAC3C;AAEA,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,kBAAkB,KAAK,UAAU,CAAC,GAAG,MAAM;AAAA,IACpD,KAAK;AACH,aAAO,kBAAkB,KAAK,UAAU,CAAC,GAAG,MAAM;AAAA,IACpD,KAAK;AACH,aAAO,mBAAmB;AAAA,QACxB,QAAQ,KAAK;AAAA,QACb,QAAQ,KAAK;AAAA,QACb;AAAA,MACF,CAAC;AAAA,EACL;AACF;;;AC3DA,SAAS,mBAAmB,OAGP;AACnB,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,YAAY,MAAM;AAAA,EACpB;AACF;AAEA,eAAe,gBACb,QACA,OACe;AACf,MAAI,MAAM,aAAa;AACrB;AAAA,EACF;AAEA,QAAM,WAAW,MAAM,oBAAoB,MAAM,WAAW,MAAM;AAClE,SAAO,OAAO,QAAQ;AACtB,wBAAsB,MAAM,IAAI;AAClC;AAMA,eAAsB,YACpB,QACA,OACsC;AACtC,QAAM,UAAU,qBAAqB,KAAK;AAE1C,aAAW,SAAS,SAAS;AAC3B,UAAM,gBAAgB,QAAQ,KAAK;AAAA,EACrC;AAEA,SAAO,QAAQ,IAAI,kBAAkB;AACvC;AAMO,SAAS,gBACd,QACA,OAC6B;AAC7B,QAAM,UAAU,qBAAqB,KAAK;AAE1C,aAAW,SAAS,SAAS;AAC3B,QAAI,MAAM,aAAa;AACrB;AAAA,IACF;AAEA,UAAM,WAAW,wBAAwB,MAAM,WAAW,MAAM;AAChE,WAAO,OAAO,QAAQ;AACtB,0BAAsB,MAAM,IAAI;AAAA,EAClC;AAEA,SAAO,QAAQ,IAAI,kBAAkB;AACvC;AAMO,SAAS,mBAAmB,OAA+D;AAChG,SAAO,CAAC,WAAW;AACjB,oBAAgB,QAAQ,KAAK;AAAA,EAC/B;AACF;","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ailuracode/alpine-core",
+  "version": "0.1.0",
+  "description": "Lazy plugin registry and initializer for Alpine.js",
+  "type": "module",
+  "license": "MIT",
+  "author": "ailuracode",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ailuracode/alpine.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/ailuracode/alpine/issues"
+  },
+  "homepage": "https://github.com/ailuracode/alpine/tree/master/packages/core#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./global": {
+      "types": "./dist/global.d.ts"
+    }
+  },
+  "types": "./dist/global.d.ts",
+  "peerDependencies": {
+    "alpinejs": "^3.0.0",
+    "@types/alpinejs": "^3.13.11"
+  },
+  "peerDependenciesMeta": {
+    "@types/alpinejs": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "alpinejs",
+    "alpine",
+    "plugin",
+    "lazy",
+    "registry",
+    "tree-shaking"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --sourcemap --out-dir dist && cp src/global.d.ts dist/global.d.ts",
+    "test": "vitest run --config ../../vitest.config.js test"
+  }
+}