glost-registry 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GLOST Contributors
+
+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,283 @@
+# glost-registry
+
+Enhanced plugin registry with discovery, metadata, validation, and conflict detection for GLOST.
+
+## Overview
+
+`glost-registry` provides a comprehensive plugin registry system for managing GLOST plugins with:
+
+- Plugin discovery and search
+- Metadata management
+- Conflict detection
+- Dependency resolution
+- Validation
+- Statistics
+
+## Installation
+
+```bash
+npm install glost-registry
+# or
+pnpm add glost-registry
+```
+
+## Usage
+
+### Registering Plugins
+
+```typescript
+import { pluginRegistry } from "glost-registry";
+import { myExtension } from "./my-plugin";
+
+pluginRegistry.register(myExtension, {
+  version: "1.0.0",
+  description: "Adds transcription support for Thai",
+  category: "enhancer",
+  tags: ["transcription", "thai", "ipa"],
+  author: "Your Name",
+  repository: "https://github.com/yourusername/my-plugin",
+  supports: {
+    languages: ["th"],
+    async: true,
+    parallel: false
+  },
+  requires: {
+    plugins: ["frequency"],
+    glostVersion: ">=0.4.0"
+  }
+});
+```
+
+### Searching for Plugins
+
+```typescript
+// Search by keyword
+const results = pluginRegistry.search({ keyword: "transcription" });
+
+// Filter by category
+const enhancers = pluginRegistry.search({ category: "enhancer" });
+
+// Filter by language
+const thaiPlugins = pluginRegistry.search({ language: "th" });
+
+// Multiple filters
+const results = pluginRegistry.search({
+  category: "enhancer",
+  language: "th",
+  tags: ["transcription"]
+});
+```
+
+### Get Plugin Metadata
+
+```typescript
+const metadata = pluginRegistry.getMetadata("my-plugin");
+console.log(metadata.version);
+console.log(metadata.category);
+console.log(metadata.supports.languages);
+```
+
+### Check for Conflicts
+
+```typescript
+const report = pluginRegistry.checkConflicts([
+  "plugin1",
+  "plugin2",
+  "plugin3"
+]);
+
+if (report.hasConflicts) {
+  for (const conflict of report.conflicts) {
+    console.error(`Conflict: ${conflict.plugin1} <-> ${conflict.plugin2}`);
+    console.error(`Reason: ${conflict.reason}`);
+    console.error(`Severity: ${conflict.severity}`);
+  }
+}
+```
+
+### Resolve Dependencies
+
+```typescript
+const orderedPlugins = pluginRegistry.resolveDependencies([
+  "plugin-c", // depends on plugin-a
+  "plugin-a",
+  "plugin-b"  // depends on plugin-a
+]);
+// Returns: ["plugin-a", "plugin-c", "plugin-b"]
+```
+
+### Validate Plugins
+
+```typescript
+const result = pluginRegistry.validate("my-plugin", {
+  scheme: "ipa",
+  target: "en"
+});
+
+if (!result.valid) {
+  console.error("Validation errors:", result.errors);
+}
+
+if (result.warnings.length > 0) {
+  console.warn("Validation warnings:", result.warnings);
+}
+```
+
+### Get Registry Statistics
+
+```typescript
+const stats = pluginRegistry.getStatistics();
+console.log(`Total plugins: ${stats.total}`);
+console.log(`By category:`, stats.byCategory);
+console.log(`By language:`, stats.byLanguage);
+console.log(`Top tags:`, stats.topTags);
+```
+
+## Advanced Usage
+
+### Plugin Discovery
+
+```typescript
+import { PluginDiscovery, pluginRegistry } from "glost-registry";
+
+// Find related plugins
+const related = PluginDiscovery.findRelated(
+  pluginRegistry.list(),
+  "my-plugin"
+);
+
+// Suggest plugins based on current selection
+const suggestions = PluginDiscovery.suggestPlugins(
+  currentPlugins,
+  pluginRegistry.list()
+);
+```
+
+### Filtering and Sorting
+
+```typescript
+import { PluginFilter, PluginSorter } from "glost-registry";
+
+let plugins = pluginRegistry.list();
+
+// Filter
+plugins = PluginFilter.byLanguage(plugins, "th");
+plugins = PluginFilter.asyncOnly(plugins);
+
+// Sort
+plugins = PluginSorter.byName(plugins);
+plugins = PluginSorter.byCategory(plugins);
+plugins = PluginSorter.byDate(plugins, false); // newest first
+```
+
+### Custom Validation
+
+```typescript
+import { PluginValidator } from "glost-registry";
+
+const metadata = pluginRegistry.getMetadata("my-plugin");
+
+// Validate metadata
+const metaResult = PluginValidator.validateMetadata(metadata);
+
+// Validate compatibility
+const compResult = PluginValidator.validateCompatibility(
+  metadata,
+  "0.4.0",  // GLOST version
+  "20.0.0"  // Node.js version
+);
+
+// Validate dependencies
+const depResult = PluginValidator.validateDependencies(
+  metadata,
+  new Set(["plugin-a", "plugin-b"])
+);
+```
+
+## Plugin Metadata Schema
+
+```typescript
+interface PluginMetadata {
+  // Required
+  id: string;
+  name: string;
+  version: string;
+  description: string;
+  category: "transformer" | "enhancer" | "generator" | "analyzer" | "utility";
+  tags: string[];
+  supports: {
+    languages?: string[];
+    nodeTypes?: string[];
+    async: boolean;
+    parallel?: boolean;
+  };
+  
+  // Optional
+  author?: string;
+  repository?: string;
+  homepage?: string;
+  requires?: {
+    plugins?: string[];
+    glostVersion?: string;
+    nodeVersion?: string;
+  };
+  conflicts?: string[];
+  options?: PluginOptionsSchema;
+  examples?: PluginExample[];
+}
+```
+
+## API
+
+### PluginRegistry
+
+- `register(extension, metadata)` - Register a plugin
+- `getMetadata(id)` - Get plugin metadata
+- `getExtension(id)` - Get plugin extension
+- `list()` - List all plugins
+- `search(query)` - Search for plugins
+- `getByCategory(category)` - Get plugins by category
+- `getLanguageSupport(language)` - Get plugins supporting a language
+- `isLanguageSupported(id, language)` - Check language support
+- `isCompatible(id, version)` - Check version compatibility
+- `checkConflicts(ids)` - Check for conflicts
+- `resolveDependencies(ids)` - Resolve dependencies
+- `validate(id, options)` - Validate plugin configuration
+- `getStatistics()` - Get registry statistics
+- `has(id)` - Check if plugin exists
+- `unregister(id)` - Unregister a plugin
+- `clear()` - Clear all plugins
+
+### PluginFilter
+
+- `byKeyword(plugins, keyword)` - Filter by keyword
+- `byCategory(plugins, category)` - Filter by category
+- `byLanguage(plugins, language)` - Filter by language
+- `byTags(plugins, tags)` - Filter by tags
+- `byAuthor(plugins, author)` - Filter by author
+- `asyncOnly(plugins)` - Filter async plugins
+- `parallelOnly(plugins)` - Filter parallel plugins
+- `apply(plugins, query)` - Apply multiple filters
+
+### PluginSorter
+
+- `byName(plugins, ascending)` - Sort by name
+- `byDate(plugins, ascending)` - Sort by date
+- `byCategory(plugins)` - Sort by category
+
+### PluginDiscovery
+
+- `findRelated(plugins, id)` - Find related plugins
+- `findDependents(plugins, extensions, id)` - Find dependent plugins
+- `findMissingDependencies(plugins, extensions)` - Find missing deps
+- `suggestPlugins(current, all)` - Suggest plugins
+
+### PluginValidator
+
+- `validateMetadata(metadata)` - Validate metadata
+- `validateCompatibility(metadata, glost, node)` - Validate compatibility
+- `validateDependencies(metadata, available)` - Validate dependencies
+
+## License
+
+MIT

package/dist/discovery.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Plugin Discovery
+ *
+ * Utilities for discovering and filtering plugins.
+ *
+ * @packageDocumentation
+ */
+import type { PluginMetadata, PluginQuery, PluginCategory } from "./types.js";
+/**
+ * Filter plugins by various criteria
+ */
+export declare class PluginFilter {
+    /**
+     * Filter plugins by keyword
+     *
+     * @param plugins - Plugins to filter
+     * @param keyword - Keyword to search for
+     * @returns Filtered plugins
+     */
+    static byKeyword(plugins: PluginMetadata[], keyword: string): PluginMetadata[];
+    /**
+     * Filter plugins by category
+     *
+     * @param plugins - Plugins to filter
+     * @param category - Category to filter by
+     * @returns Filtered plugins
+     */
+    static byCategory(plugins: PluginMetadata[], category: PluginCategory): PluginMetadata[];
+    /**
+     * Filter plugins by language support
+     *
+     * @param plugins - Plugins to filter
+     * @param language - Language code
+     * @returns Filtered plugins
+     */
+    static byLanguage(plugins: PluginMetadata[], language: string): PluginMetadata[];
+    /**
+     * Filter plugins by tags
+     *
+     * @param plugins - Plugins to filter
+     * @param tags - Tags to match (any)
+     * @returns Filtered plugins
+     */
+    static byTags(plugins: PluginMetadata[], tags: string[]): PluginMetadata[];
+    /**
+     * Filter plugins by author
+     *
+     * @param plugins - Plugins to filter
+     * @param author - Author name
+     * @returns Filtered plugins
+     */
+    static byAuthor(plugins: PluginMetadata[], author: string): PluginMetadata[];
+    /**
+     * Filter plugins that support async
+     *
+     * @param plugins - Plugins to filter
+     * @returns Filtered plugins
+     */
+    static asyncOnly(plugins: PluginMetadata[]): PluginMetadata[];
+    /**
+     * Filter plugins that support parallel execution
+     *
+     * @param plugins - Plugins to filter
+     * @returns Filtered plugins
+     */
+    static parallelOnly(plugins: PluginMetadata[]): PluginMetadata[];
+    /**
+     * Apply multiple filters
+     *
+     * @param plugins - Plugins to filter
+     * @param query - Filter query
+     * @returns Filtered plugins
+     */
+    static apply(plugins: PluginMetadata[], query: PluginQuery): PluginMetadata[];
+}
+/**
+ * Sort plugins by various criteria
+ */
+export declare class PluginSorter {
+    /**
+     * Sort plugins by name
+     *
+     * @param plugins - Plugins to sort
+     * @param ascending - Sort order
+     * @returns Sorted plugins
+     */
+    static byName(plugins: PluginMetadata[], ascending?: boolean): PluginMetadata[];
+    /**
+     * Sort plugins by registration date
+     *
+     * @param plugins - Plugins to sort
+     * @param ascending - Sort order
+     * @returns Sorted plugins
+     */
+    static byDate(plugins: PluginMetadata[], ascending?: boolean): PluginMetadata[];
+    /**
+     * Sort plugins by category
+     *
+     * @param plugins - Plugins to sort
+     * @returns Sorted plugins
+     */
+    static byCategory(plugins: PluginMetadata[]): PluginMetadata[];
+}
+/**
+ * Plugin discovery helpers
+ */
+export declare class PluginDiscovery {
+    /**
+     * Find plugins related to a given plugin
+     *
+     * @param plugins - All plugins
+     * @param pluginId - Plugin to find related plugins for
+     * @returns Related plugins
+     */
+    static findRelated(plugins: PluginMetadata[], pluginId: string): PluginMetadata[];
+    /**
+     * Find plugins that depend on a given plugin
+     *
+     * @param plugins - All plugins
+     * @param allExtensions - Map of extensions (for dependency info)
+     * @param pluginId - Plugin to find dependents for
+     * @returns Dependent plugins
+     */
+    static findDependents(plugins: PluginMetadata[], allExtensions: Map<string, {
+        dependencies?: string[];
+    }>, pluginId: string): PluginMetadata[];
+    /**
+     * Find missing dependencies for plugins
+     *
+     * @param plugins - Plugins to check
+     * @param allExtensions - Map of all extensions
+     * @returns Map of plugin ID to missing dependencies
+     */
+    static findMissingDependencies(plugins: PluginMetadata[], allExtensions: Map<string, {
+        dependencies?: string[];
+    }>): Map<string, string[]>;
+    /**
+     * Suggest plugins based on a user's current plugins
+     *
+     * @param currentPlugins - Currently used plugins
+     * @param allPlugins - All available plugins
+     * @returns Suggested plugins
+     */
+    static suggestPlugins(currentPlugins: PluginMetadata[], allPlugins: PluginMetadata[]): PluginMetadata[];
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAY9E;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,cAAc,EAAE,EACzB,QAAQ,EAAE,cAAc,GACvB,cAAc,EAAE;IAInB;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAShF;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAM1E;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5E;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAI7D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAIhE;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE;CAyB9E;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,UAAO,GAAG,cAAc,EAAE;IAO5E;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,UAAO,GAAG,cAAc,EAAE;IAS5E;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;CAa/D;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,cAAc,EAAE,EACzB,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE;IAiBnB;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EACvD,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE;IAOnB;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAC5B,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GACtD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAmBxB;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACnB,cAAc,EAAE,cAAc,EAAE,EAChC,UAAU,EAAE,cAAc,EAAE,GAC3B,cAAc,EAAE;CA6BpB"}