@weavelogic/knowledge-graph-agent 0.4.0 → 0.6.0

package/dist/services/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sources":["../../src/services/manager.ts"],"sourcesContent":["/**\n * Service Manager - Background process management\n *\n * Provides centralized management for background services including:\n * - Service registration and lifecycle management\n * - Health monitoring with configurable intervals\n * - Automatic restart on failure\n * - Graceful shutdown coordination\n *\n * @module services/manager\n */\n\nimport { EventEmitter } from 'events';\nimport { createLogger } from '../utils/index.js';\nimport type {\n  ServiceConfig,\n  ServiceState,\n  ServiceHandler,\n  ServiceMetrics,\n} from './types.js';\n\nconst logger = createLogger('service-manager');\n\n/**\n * Manages background services with lifecycle control and health monitoring.\n *\n * @example\n * ```typescript\n * const manager = createServiceManager();\n *\n * await manager.register(\n *   { id: 'watcher', name: 'File Watcher', type: 'watcher', autoStart: true },\n *   new FileWatcherService(['/path/to/watch'])\n * );\n *\n * manager.on('started', (state) => console.log(`${state.name} started`));\n *\n * // Graceful shutdown\n * process.on('SIGTERM', () => manager.shutdown());\n * ```\n */\nexport class ServiceManager extends EventEmitter {\n  private services: Map<string, ServiceState> = new Map();\n  private handlers: Map<string, ServiceHandler> = new Map();\n  private configs: Map<string, ServiceConfig> = new Map();\n  private healthCheckTimers: Map<string, NodeJS.Timeout> = new Map();\n  private isShuttingDown = false;\n\n  constructor() {\n    super();\n    logger.info('ServiceManager initialized');\n  }\n\n  /**\n   * Register a new service with the manager.\n   *\n   * @param config - Service configuration\n   * @param handler - Service implementation\n   * @throws Error if service ID is already registered\n   */\n  async register(config: ServiceConfig, handler: ServiceHandler): Promise<void> {\n    if (this.services.has(config.id)) {\n      throw new Error(`Service ${config.id} already registered`);\n    }\n\n    const state: ServiceState = {\n      id: config.id,\n      name: config.name,\n      type: config.type,\n      status: 'stopped',\n      restarts: 0,\n      metrics: {\n        uptime: 0,\n        requests: 0,\n        errors: 0,\n        healthStatus: 'healthy',\n      },\n    };\n\n    this.services.set(config.id, state);\n    this.handlers.set(config.id, handler);\n    this.configs.set(config.id, config);\n\n    logger.info(`Service registered: ${config.name}`, {\n      id: config.id,\n      type: config.type,\n      autoStart: config.autoStart,\n    });\n    this.emit('registered', state);\n\n    if (config.autoStart) {\n      await this.start(config.id);\n    }\n\n    if (config.healthCheckInterval && config.healthCheckInterval > 0) {\n      this.startHealthCheck(config.id, config.healthCheckInterval);\n    }\n  }\n\n  /**\n   * Start a registered service.\n   *\n   * @param id - Service identifier\n   * @throws Error if service is not found\n   */\n  async start(id: string): Promise<void> {\n    const state = this.services.get(id);\n    const handler = this.handlers.get(id);\n\n    if (!state || !handler) {\n      throw new Error(`Service ${id} not found`);\n    }\n\n    if (state.status === 'running' || state.status === 'starting') {\n      logger.debug(`Service ${state.name} already ${state.status}`);\n      return;\n    }\n\n    state.status = 'starting';\n    this.emit('starting', state);\n\n    try {\n      await handler.start();\n      state.status = 'running';\n      state.startTime = new Date();\n      state.lastError = undefined;\n      logger.info(`Service started: ${state.name}`);\n      this.emit('started', state);\n    } catch (error) {\n      state.status = 'failed';\n      state.lastError = error instanceof Error ? error.message : String(error);\n      state.metrics.errors++;\n      logger.error(`Service failed to start: ${state.name}`, undefined, { error: state.lastError });\n      this.emit('failed', state);\n\n      // Handle auto-restart\n      await this.handleFailure(id);\n    }\n  }\n\n  /**\n   * Stop a running service.\n   *\n   * @param id - Service identifier\n   * @throws Error if service is not found\n   */\n  async stop(id: string): Promise<void> {\n    const state = this.services.get(id);\n    const handler = this.handlers.get(id);\n\n    if (!state || !handler) {\n      throw new Error(`Service ${id} not found`);\n    }\n\n    if (state.status === 'stopped' || state.status === 'stopping') {\n      logger.debug(`Service ${state.name} already ${state.status}`);\n      return;\n    }\n\n    state.status = 'stopping';\n    this.emit('stopping', state);\n\n    try {\n      await handler.stop();\n      state.status = 'stopped';\n\n      // Calculate final uptime\n      if (state.startTime) {\n        state.metrics.uptime += Date.now() - state.startTime.getTime();\n      }\n\n      logger.info(`Service stopped: ${state.name}`);\n      this.emit('stopped', state);\n    } catch (error) {\n      state.status = 'failed';\n      state.lastError = error instanceof Error ? error.message : String(error);\n      state.metrics.errors++;\n      logger.error(`Service failed to stop: ${state.name}`, undefined, { error: state.lastError });\n      this.emit('failed', state);\n    }\n  }\n\n  /**\n   * Restart a service.\n   *\n   * @param id - Service identifier\n   * @throws Error if service is not found\n   */\n  async restart(id: string): Promise<void> {\n    const state = this.services.get(id);\n    if (!state) {\n      throw new Error(`Service ${id} not found`);\n    }\n\n    logger.info(`Restarting service: ${state.name}`);\n    state.restarts++;\n\n    await this.stop(id);\n    await this.start(id);\n\n    this.emit('restarted', state);\n  }\n\n  /**\n   * Handle service failure with optional auto-restart.\n   */\n  private async handleFailure(id: string): Promise<void> {\n    const state = this.services.get(id);\n    const config = this.configs.get(id);\n\n    if (!state || !config) return;\n\n    if (!config.restartOnFailure) return;\n\n    const maxRestarts = config.maxRestarts ?? 3;\n    if (state.restarts >= maxRestarts) {\n      logger.error(`Service ${state.name} exceeded max restarts (${maxRestarts})`);\n      return;\n    }\n\n    const delay = config.restartDelay ?? 1000;\n    logger.info(`Scheduling restart for ${state.name} in ${delay}ms`);\n\n    await new Promise(resolve => setTimeout(resolve, delay));\n\n    if (!this.isShuttingDown && state.status === 'failed') {\n      state.restarts++;\n      await this.start(id);\n    }\n  }\n\n  /**\n   * Get the current state of a service.\n   *\n   * @param id - Service identifier\n   * @returns Service state or undefined if not found\n   */\n  getStatus(id: string): ServiceState | undefined {\n    const state = this.services.get(id);\n    if (!state) return undefined;\n\n    const handler = this.handlers.get(id);\n    if (handler && state.status === 'running') {\n      // Update metrics from handler\n      const metrics = handler.getMetrics();\n      state.metrics = { ...state.metrics, ...metrics };\n    }\n\n    return { ...state };\n  }\n\n  /**\n   * List all registered services.\n   *\n   * @returns Array of service states\n   */\n  listServices(): ServiceState[] {\n    return Array.from(this.services.values()).map(state => ({ ...state }));\n  }\n\n  /**\n   * Get services by type.\n   *\n   * @param type - Service type to filter by\n   * @returns Array of matching service states\n   */\n  getServicesByType(type: string): ServiceState[] {\n    return this.listServices().filter(s => s.type === type);\n  }\n\n  /**\n   * Get services by status.\n   *\n   * @param status - Service status to filter by\n   * @returns Array of matching service states\n   */\n  getServicesByStatus(status: string): ServiceState[] {\n    return this.listServices().filter(s => s.status === status);\n  }\n\n  /**\n   * Start periodic health checks for a service.\n   */\n  private startHealthCheck(id: string, interval: number): void {\n    // Clear any existing timer\n    const existingTimer = this.healthCheckTimers.get(id);\n    if (existingTimer) {\n      clearInterval(existingTimer);\n    }\n\n    const timer = setInterval(async () => {\n      if (this.isShuttingDown) return;\n\n      const handler = this.handlers.get(id);\n      const state = this.services.get(id);\n\n      if (!handler || !state || state.status !== 'running') return;\n\n      try {\n        const healthy = await handler.healthCheck();\n        state.metrics.lastHealthCheck = new Date();\n\n        if (healthy) {\n          state.metrics.healthStatus = 'healthy';\n        } else {\n          state.metrics.healthStatus = 'degraded';\n          logger.warn(`Service ${state.name} health check returned unhealthy`);\n        }\n\n        this.emit('healthCheck', { id, healthy });\n      } catch (error) {\n        state.metrics.healthStatus = 'unhealthy';\n        state.metrics.errors++;\n        logger.error(\n          `Service ${state.name} health check failed`,\n          error instanceof Error ? error : undefined,\n        );\n        this.emit('healthCheck', { id, healthy: false });\n      }\n    }, interval);\n\n    this.healthCheckTimers.set(id, timer);\n    logger.debug(`Started health checks for ${id} every ${interval}ms`);\n  }\n\n  /**\n   * Stop health checks for a service.\n   */\n  private stopHealthCheck(id: string): void {\n    const timer = this.healthCheckTimers.get(id);\n    if (timer) {\n      clearInterval(timer);\n      this.healthCheckTimers.delete(id);\n    }\n  }\n\n  /**\n   * Unregister a service.\n   *\n   * @param id - Service identifier\n   */\n  async unregister(id: string): Promise<void> {\n    const state = this.services.get(id);\n    if (!state) return;\n\n    // Stop if running\n    if (state.status === 'running' || state.status === 'starting') {\n      await this.stop(id);\n    }\n\n    // Clean up\n    this.stopHealthCheck(id);\n    this.services.delete(id);\n    this.handlers.delete(id);\n    this.configs.delete(id);\n\n    logger.info(`Service unregistered: ${state.name}`);\n  }\n\n  /**\n   * Check if manager is shutting down.\n   */\n  get shuttingDown(): boolean {\n    return this.isShuttingDown;\n  }\n\n  /**\n   * Gracefully shutdown all services.\n   */\n  async shutdown(): Promise<void> {\n    if (this.isShuttingDown) {\n      logger.debug('Shutdown already in progress');\n      return;\n    }\n\n    this.isShuttingDown = true;\n    logger.info('Shutting down all services...');\n\n    // Clear all health check timers\n    const timerEntries = Array.from(this.healthCheckTimers.entries());\n    for (const [id, timer] of timerEntries) {\n      clearInterval(timer);\n      logger.debug(`Cleared health check timer for ${id}`);\n    }\n    this.healthCheckTimers.clear();\n\n    // Stop all services in parallel\n    const serviceIds = Array.from(this.services.keys());\n    const stopPromises = serviceIds.map(async id => {\n      try {\n        await this.stop(id);\n      } catch (error) {\n        logger.error(\n          `Error stopping service ${id}`,\n          error instanceof Error ? error : undefined,\n        );\n      }\n    });\n\n    await Promise.allSettled(stopPromises);\n\n    // Clear all maps\n    this.services.clear();\n    this.handlers.clear();\n    this.configs.clear();\n\n    logger.info('All services stopped');\n    this.emit('shutdown');\n  }\n\n  /**\n   * Get aggregate metrics for all services.\n   */\n  getAggregateMetrics(): {\n    totalServices: number;\n    running: number;\n    stopped: number;\n    failed: number;\n    totalRequests: number;\n    totalErrors: number;\n    healthyCount: number;\n  } {\n    const services = this.listServices();\n\n    return {\n      totalServices: services.length,\n      running: services.filter(s => s.status === 'running').length,\n      stopped: services.filter(s => s.status === 'stopped').length,\n      failed: services.filter(s => s.status === 'failed').length,\n      totalRequests: services.reduce((sum, s) => sum + s.metrics.requests, 0),\n      totalErrors: services.reduce((sum, s) => sum + s.metrics.errors, 0),\n      healthyCount: services.filter(s => s.metrics.healthStatus === 'healthy').length,\n    };\n  }\n}\n\n/**\n * Create a new ServiceManager instance.\n *\n * @returns Configured ServiceManager\n */\nexport function createServiceManager(): ServiceManager {\n  return new ServiceManager();\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weavelogic/knowledge-graph-agent",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Knowledge graph agent for Claude Code - generates knowledge graphs, initializes docs, and integrates with claude-flow",
   "type": "module",
   "main": "dist/index.js",
@@ -18,7 +18,10 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "graphql:dev": "tsx src/graphql/server.ts",
+    "serve": "tsx src/cli/bin.ts serve",
+    "plugin:list": "tsx src/cli/bin.ts plugin list"
   },
   "keywords": [
     "knowledge-graph",
@@ -28,31 +31,54 @@
     "obsidian",
     "docs",
     "weave-nn",
-    "mcp"
+    "mcp",
+    "graphql"
   ],
   "author": "Weave-NN",
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.32.0",
+    "@graphql-tools/schema": "^10.0.0",
+    "@tanstack/react-query": "^5.62.0",
+    "@tanstack/react-table": "^8.20.0",
+    "@typescript-eslint/typescript-estree": "^8.51.0",
     "better-sqlite3": "^11.7.0",
     "chalk": "^5.3.0",
+    "clsx": "^2.1.0",
     "commander": "^14.0.1",
     "cosmiconfig": "^9.0.0",
+    "cytoscape": "^3.30.0",
+    "cytoscape-dagre": "^2.5.0",
     "fast-glob": "^3.3.3",
+    "graphql": "^16.8.0",
+    "graphql-ws": "^5.14.0",
+    "graphql-yoga": "^5.1.0",
     "gray-matter": "^4.0.3",
     "handlebars": "^4.7.8",
     "ignore": "^7.0.5",
     "inquirer": "^12.3.0",
     "js-yaml": "^4.1.0",
+    "lucide-react": "^0.468.0",
     "ora": "^8.1.1",
+    "react": "^18.3.1",
+    "react-cytoscapejs": "^2.0.0",
+    "react-dom": "^18.3.1",
     "simple-git": "^3.28.0",
+    "tailwind-merge": "^2.6.0",
+    "uuid": "^9.0.0",
+    "ws": "^8.16.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
+    "@types/cytoscape": "^3.21.0",
     "@types/inquirer": "^9.0.7",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.2",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@types/uuid": "^9.0.0",
+    "@types/ws": "^8.5.10",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vite": "^6.3.0",

package/dist/_virtual/additionalItems.js

@@ -1,5 +0,0 @@
-var additionalItems = {};
-export {
-  additionalItems as __exports
-};
-//# sourceMappingURL=additionalItems.js.map

package/dist/_virtual/additionalItems.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"additionalItems.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/additionalProperties.js

@@ -1,5 +0,0 @@
-var additionalProperties = {};
-export {
-  additionalProperties as __exports
-};
-//# sourceMappingURL=additionalProperties.js.map

package/dist/_virtual/additionalProperties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"additionalProperties.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/ajv.js

@@ -1,6 +0,0 @@
-import { __require as requireAjv } from "../node_modules/ajv/dist/ajv.js";
-var ajvExports = requireAjv();
-export {
-  ajvExports as a
-};
-//# sourceMappingURL=ajv.js.map

package/dist/_virtual/ajv.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ajv.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/_virtual/ajv2.js

@@ -1,5 +0,0 @@
-var ajv = { exports: {} };
-export {
-  ajv as __module
-};
-//# sourceMappingURL=ajv2.js.map

package/dist/_virtual/ajv2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ajv2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/allOf.js

@@ -1,5 +0,0 @@
-var allOf = {};
-export {
-  allOf as __exports
-};
-//# sourceMappingURL=allOf.js.map

package/dist/_virtual/allOf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"allOf.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/anyOf.js

@@ -1,5 +0,0 @@
-var anyOf = {};
-export {
-  anyOf as __exports
-};
-//# sourceMappingURL=anyOf.js.map

package/dist/_virtual/anyOf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"anyOf.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/applicability.js

@@ -1,5 +0,0 @@
-var applicability = {};
-export {
-  applicability as __exports
-};
-//# sourceMappingURL=applicability.js.map

package/dist/_virtual/applicability.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"applicability.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/boolSchema.js

@@ -1,5 +0,0 @@
-var boolSchema = {};
-export {
-  boolSchema as __exports
-};
-//# sourceMappingURL=boolSchema.js.map

package/dist/_virtual/boolSchema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boolSchema.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/code.js

@@ -1,5 +0,0 @@
-var code = {};
-export {
-  code as __exports
-};
-//# sourceMappingURL=code.js.map

package/dist/_virtual/code.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"code.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/code2.js

@@ -1,5 +0,0 @@
-var code = {};
-export {
-  code as __exports
-};
-//# sourceMappingURL=code2.js.map

package/dist/_virtual/code2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"code2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/const.js

@@ -1,5 +0,0 @@
-var _const = {};
-export {
-  _const as __exports
-};
-//# sourceMappingURL=const.js.map

package/dist/_virtual/const.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"const.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/contains.js

@@ -1,5 +0,0 @@
-var contains = {};
-export {
-  contains as __exports
-};
-//# sourceMappingURL=contains.js.map

package/dist/_virtual/contains.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"contains.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/core.js

@@ -1,5 +0,0 @@
-var core = {};
-export {
-  core as __exports
-};
-//# sourceMappingURL=core.js.map

package/dist/_virtual/core.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/dataType.js

@@ -1,5 +0,0 @@
-var dataType = {};
-export {
-  dataType as __exports
-};
-//# sourceMappingURL=dataType.js.map

package/dist/_virtual/dataType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataType.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/defaults.js

@@ -1,5 +0,0 @@
-var defaults = {};
-export {
-  defaults as __exports
-};
-//# sourceMappingURL=defaults.js.map

package/dist/_virtual/defaults.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"defaults.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/dependencies.js

@@ -1,5 +0,0 @@
-var dependencies = {};
-export {
-  dependencies as __exports
-};
-//# sourceMappingURL=dependencies.js.map

package/dist/_virtual/dependencies.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dependencies.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/draft7.js

@@ -1,5 +0,0 @@
-var draft7 = {};
-export {
-  draft7 as __exports
-};
-//# sourceMappingURL=draft7.js.map

package/dist/_virtual/draft7.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"draft7.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/enum.js

@@ -1,5 +0,0 @@
-var _enum = {};
-export {
-  _enum as __exports
-};
-//# sourceMappingURL=enum.js.map

package/dist/_virtual/enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enum.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/equal.js

@@ -1,5 +0,0 @@
-var equal = {};
-export {
-  equal as __exports
-};
-//# sourceMappingURL=equal.js.map

package/dist/_virtual/equal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"equal.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/errors.js

@@ -1,5 +0,0 @@
-var errors = {};
-export {
-  errors as __exports
-};
-//# sourceMappingURL=errors.js.map

package/dist/_virtual/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/format.js

@@ -1,5 +0,0 @@
-var format = {};
-export {
-  format as __exports
-};
-//# sourceMappingURL=format.js.map

package/dist/_virtual/format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"format.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/formats.js

@@ -1,5 +0,0 @@
-var formats = {};
-export {
-  formats as __exports
-};
-//# sourceMappingURL=formats.js.map

package/dist/_virtual/formats.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formats.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/id.js

@@ -1,5 +0,0 @@
-var id = {};
-export {
-  id as __exports
-};
-//# sourceMappingURL=id.js.map

package/dist/_virtual/id.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"id.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/if.js

@@ -1,5 +0,0 @@
-var _if = {};
-export {
-  _if as __exports
-};
-//# sourceMappingURL=if.js.map

package/dist/_virtual/if.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"if.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/index12.js

@@ -1,5 +0,0 @@
-var fastUri = { exports: {} };
-export {
-  fastUri as __module
-};
-//# sourceMappingURL=index12.js.map

package/dist/_virtual/index12.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index12.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/items.js

@@ -1,5 +0,0 @@
-var items = {};
-export {
-  items as __exports
-};
-//# sourceMappingURL=items.js.map

package/dist/_virtual/items.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"items.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/items2020.js

@@ -1,5 +0,0 @@
-var items2020 = {};
-export {
-  items2020 as __exports
-};
-//# sourceMappingURL=items2020.js.map

package/dist/_virtual/items2020.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"items2020.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/keyword.js

@@ -1,5 +0,0 @@
-var keyword = {};
-export {
-  keyword as __exports
-};
-//# sourceMappingURL=keyword.js.map

package/dist/_virtual/keyword.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keyword.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/limit.js

@@ -1,5 +0,0 @@
-var limit = {};
-export {
-  limit as __exports
-};
-//# sourceMappingURL=limit.js.map

package/dist/_virtual/limit.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"limit.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/limitItems.js

@@ -1,5 +0,0 @@
-var limitItems = {};
-export {
-  limitItems as __exports
-};
-//# sourceMappingURL=limitItems.js.map

package/dist/_virtual/limitItems.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"limitItems.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/limitLength.js

@@ -1,5 +0,0 @@
-var limitLength = {};
-export {
-  limitLength as __exports
-};
-//# sourceMappingURL=limitLength.js.map

package/dist/_virtual/limitLength.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"limitLength.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/limitNumber.js

@@ -1,5 +0,0 @@
-var limitNumber = {};
-export {
-  limitNumber as __exports
-};
-//# sourceMappingURL=limitNumber.js.map

package/dist/_virtual/limitNumber.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"limitNumber.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/limitProperties.js

@@ -1,5 +0,0 @@
-var limitProperties = {};
-export {
-  limitProperties as __exports
-};
-//# sourceMappingURL=limitProperties.js.map

package/dist/_virtual/limitProperties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"limitProperties.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/metadata.js

@@ -1,5 +0,0 @@
-var metadata = {};
-export {
-  metadata as __exports
-};
-//# sourceMappingURL=metadata.js.map

package/dist/_virtual/metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metadata.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/multipleOf.js

@@ -1,5 +0,0 @@
-var multipleOf = {};
-export {
-  multipleOf as __exports
-};
-//# sourceMappingURL=multipleOf.js.map

package/dist/_virtual/multipleOf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multipleOf.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/names.js

@@ -1,5 +0,0 @@
-var names = {};
-export {
-  names as __exports
-};
-//# sourceMappingURL=names.js.map

package/dist/_virtual/names.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"names.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/not.js

@@ -1,5 +0,0 @@
-var not = {};
-export {
-  not as __exports
-};
-//# sourceMappingURL=not.js.map

package/dist/_virtual/not.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"not.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/oneOf.js

@@ -1,5 +0,0 @@
-var oneOf = {};
-export {
-  oneOf as __exports
-};
-//# sourceMappingURL=oneOf.js.map

package/dist/_virtual/oneOf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"oneOf.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/pattern.js

@@ -1,5 +0,0 @@
-var pattern = {};
-export {
-  pattern as __exports
-};
-//# sourceMappingURL=pattern.js.map

package/dist/_virtual/pattern.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pattern.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/patternProperties.js

@@ -1,5 +0,0 @@
-var patternProperties = {};
-export {
-  patternProperties as __exports
-};
-//# sourceMappingURL=patternProperties.js.map

package/dist/_virtual/patternProperties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"patternProperties.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/prefixItems.js

@@ -1,5 +0,0 @@
-var prefixItems = {};
-export {
-  prefixItems as __exports
-};
-//# sourceMappingURL=prefixItems.js.map

package/dist/_virtual/prefixItems.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prefixItems.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/properties.js

@@ -1,5 +0,0 @@
-var properties = {};
-export {
-  properties as __exports
-};
-//# sourceMappingURL=properties.js.map

package/dist/_virtual/properties.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"properties.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/propertyNames.js

@@ -1,5 +0,0 @@
-var propertyNames = {};
-export {
-  propertyNames as __exports
-};
-//# sourceMappingURL=propertyNames.js.map

package/dist/_virtual/propertyNames.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"propertyNames.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/ref.js

@@ -1,5 +0,0 @@
-var ref = {};
-export {
-  ref as __exports
-};
-//# sourceMappingURL=ref.js.map

package/dist/_virtual/ref.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ref.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/ref_error.js

@@ -1,5 +0,0 @@
-var ref_error = {};
-export {
-  ref_error as __exports
-};
-//# sourceMappingURL=ref_error.js.map

package/dist/_virtual/ref_error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ref_error.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/required.js

@@ -1,5 +0,0 @@
-var required = {};
-export {
-  required as __exports
-};
-//# sourceMappingURL=required.js.map

package/dist/_virtual/required.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"required.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}