@jucie.io/engine-command-manager 1.0.8 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/main.js CHANGED
@@ -1,2 +1,2 @@
1
- var W=Object.freeze(Object.create(null));function I(t,e,n="value"){if(Array.isArray(e)){for(let i of e)if(T(t,i))return!0;let r=e.map(d).join(" | ");throw new TypeError(`${n} must be one of: ${r}. Got ${d(t)}`)}if(!T(t,e))throw new TypeError(`${n} must be ${d(e)}. Got ${d(t)}`);return!0}function T(t,e){return e===String?typeof t=="string":e===Number?typeof t=="number"&&!isNaN(t):e===Boolean?typeof t=="boolean":e===Symbol?typeof t=="symbol":e===BigInt?typeof t=="bigint":e===Function?typeof t=="function":e===Array?Array.isArray(t):e===Object?t!==null&&typeof t=="object"&&!Array.isArray(t):t instanceof e}function d(t){return t===String?"String":t===Number?"Number":t===Boolean?"Boolean":t===Array?"Array":t===Object?"Object":t===Function?"Function":t===Date?"Date":t===RegExp?"RegExp":t===Promise?"Promise":t===Map?"Map":t===Set?"Set":t===WeakMap?"WeakMap":t===WeakSet?"WeakSet":t===Symbol?"Symbol":t===BigInt?"BigInt":t===Error?"Error":typeof t=="string"?"string":typeof t=="number"?"number":typeof t=="boolean"?"boolean":typeof t=="symbol"?"symbol":typeof t=="bigint"?"bigint":typeof t=="function"?"function":Array.isArray(t)?"Array":t===null?"null":t===void 0?"undefined":typeof t=="object"?t.constructor?.name||"Object":"unknown"}function l(t,e="value"){return n=>I(n,t,e)}var g=new Map,_=new WeakMap;var f=(t,e=[])=>{let n=e.length>0?l(e,"return value"):null;if(g.has(t))return console.warn(`Definition type "${t}" already exists`),g.get(t);let r=(i,s,...c)=>{l(String,"name")(i),l(Function,"factory")(s);let a=(...o)=>{try{let u=[...o,...c],y=s(...u);if(n&&y===void 0)throw new Error(`Factory ${t} must return a value for ${i}`);return n&&n(y),y}catch(u){throw console.error(`Error creating definition "${i}"`,u),u}};return Object.defineProperty(a,"_name",{value:i,enumerable:!1,configurable:!1}),_.set(a,t),a};return g.set(t,r),r};var F=new Set(["__proto__","prototype","constructor"]),v=new Set(["use","install","uninstall","relay","state","debug"]),$=64,L=/^[a-zA-Z_$][a-zA-Z_$0-9]*$/;function P(t,e="key"){if(F.has(t))throw new Error(`Illegal key "${t}" in ${e}`)}function m(t){if(P(t,"namespace"),typeof t!="string")throw new Error(`Namespace must be a string, got ${typeof t}`);if(!L.test(t))throw new Error(`Invalid namespace "${t}". Must be a valid JS identifier`);if(t.length>$)throw new Error(`Namespace "${t}" too long (max ${$} chars)`);if(v.has(t))throw new Error(`Namespace "${t}" is reserved`);return t}var b=f("MIDDLEWARE",[Function,Array]),w=f("ACTIONS",[Object]),A=f("UNINSTALL"),E=f("INITIALIZE"),x=f("GETTERS",[Object]);var p=class t{static create(e){return new t(e)}#e;#r;#t={MIDDLEWARE:null,GETTERS:null,ACTIONS:null,INITIALIZE:null,UNINSTALL:null};constructor(e){this.#e=e}#n(e,n,r){if(this.#t[e])throw new Error(`${e} already defined for ${this.#e}`);this.#t[e]=r(this.#e,n)}defineMiddleware=e=>this.#n("MIDDLEWARE",e,b);defineGetters=e=>this.#n("GETTERS",e,x);defineActions=e=>this.#n("ACTIONS",e,w);defineInitialize=e=>this.#n("INITIALIZE",e,E);defineUninstall=e=>this.#n("UNINSTALL",e,A);_toArray(){return[this.#t.MIDDLEWARE,this.#t.GETTERS,this.#t.ACTIONS,this.#t.INITIALIZE,this.#t.UNINSTALL].filter(Boolean)}};var h=class t{static#e=new Set;static manifest={name:"base",dependencies:[],version:"1.0.0",description:"Base extension template"};static config=null;static unique=!1;static configure(e={}){return{install:(n,r)=>this.install(n,r),manifest:this.manifest,config:{...this.config||this.manifest.defaults||{},...e},unique:!0,configured:!0}}static install(e,n){try{let{namespace:r}=this.manifest;m(r);let i=new this;t.#e.add(i),Object.defineProperty(i,"config",{value:Object.freeze({...n}),writable:!1,configurable:!1,enumerable:!1}),Object.defineProperty(i,"context",{get:()=>e(),configurable:!1,enumerable:!1}),Object.defineProperty(i,"useContext",{value:(...c)=>e(...c),writable:!1,configurable:!1,enumerable:!1});let s=p.create(r);if(i.setup){let c={defineActions:o=>s.defineActions(()=>o(e,n)),defineMiddleware:o=>s.defineMiddleware(()=>o(e,n)),defineGetters:o=>s.defineGetters(()=>o(e,n)),defineInitialize:o=>s.defineInitialize(()=>o(e,n)),defineUninstall:o=>s.defineUninstall(()=>o(e,n))},a=i.setup(c);return a?.then?a.then(()=>s._toArray()):s._toArray()}return i.middleware&&s.defineMiddleware(()=>i.middleware(e,n)),i.getters&&s.defineGetters(()=>i.getters(e,n)),i.actions&&s.defineActions(()=>i.actions(e,n)),i.initialize&&s.defineInitialize(()=>i.initialize(e,n)),i.uninstall&&s.defineUninstall(()=>i.uninstall(e,n)),s._toArray()}catch(r){throw r}}};var Ue=Symbol("jucie.engine");var O=class extends h{#e=[];#r=new Map;static manifest={name:"Command manager",namespace:"commandManager",description:"Manages commands for the engine",version:"1.0.0",author:"Jucie",license:"MIT",dependencies:[]};actions(e){return{useCommands:(...n)=>{let r=[];for(let i of n){let s=i._name,c=i(e),{target:a,commands:o}=c;this.#t({name:s,target:a,commands:o}),r.push(()=>this.#n(s))}return()=>{for(let i of r)i()}}}}#t({name:e,target:n,commands:r}){for(let i of r){let s=i.options||!1,c=`${i.event}-${n}`;if(!this.#r.has(c)){let a=o=>{this.#i(o,i.event)};n.addEventListener(i.event,a,s),this.#r.set(c,{handler:a,options:s,refCount:0})}this.#r.get(c).refCount++,this.#e.push({...i,target:n,name:e})}}#n(e){let n=this.#e.filter(r=>r.name===e);for(let r of n){let i=`${r.event}-${r.target}`,s=this.#r.get(i);s&&(s.refCount--,s.refCount===0&&(r.target.removeEventListener(r.event,s.handler,s.options),this.#r.delete(i)))}this.#e=this.#e.filter(r=>r.name!==e)}#i(e,n){for(let r of this.#e)r.event===n&&this.#s(r.keys,e)&&(r.matchTarget&&!this.#a(r.matchTarget,e)||r.when&&!r.when(this._engine)||(r.preventDefault&&e.preventDefault(),r.stopPropagation&&e.stopPropagation(),r.action(e)))}#s(e,n){if(!e||e.includes("*"))return!0;let r=this.#o(n);for(let i of e)if(this.#c(i,r))return!0;return!1}#o(e){let n=[];return e.ctrlKey&&n.push("Ctrl"),e.metaKey&&n.push("Meta"),e.altKey&&n.push("Alt"),e.shiftKey&&n.push("Shift"),n.push(e.key),n.join("+")}#c(e,n){if(e===n)return!0;if(e==="char")return n.length===1&&n.match(/^[a-z0-9]$/i);if(e==="Arrow*")return n.includes("Arrow");if(e.endsWith("+*")){let r=e.slice(0,-2);return n.startsWith(r+"+")}return!1}#a(e,n){let r=n.target;return e?typeof e=="function"?e(n):e.startsWith(".")||e.startsWith("#")?r.closest(e)!==null:r.tagName===e.toUpperCase():!0}};var V=f("commands",[Object]);export{O as CommandManager,V as defineCommands};
1
+ var u=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var v=(r,e)=>{for(var n in e)u(r,n,{get:e[n],enumerable:!0})},C=(r,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of d(e))!g.call(r,s)&&s!==n&&u(r,s,{get:()=>e[s],enumerable:!(t=p(e,s))||t.enumerable});return r};var y=r=>C(u({},"__esModule",{value:!0}),r);var K={};v(K,{CommandManager:()=>a,defineCommands:()=>l});module.exports=y(K);var h=require("@jucie.io/engine"),a=class extends h.ServiceProvider{#e=[];#t=new Map;static manifest={name:"Command manager",namespace:"commandManager",description:"Manages commands for the engine",version:"1.0.0",author:"Jucie",license:"MIT",dependencies:[]};actions(e){return{useCommands:(...n)=>{let t=[];for(let s of n){let i=s._name,o=s(e),{target:f,commands:c}=o;this.#n({name:i,target:f,commands:c}),t.push(()=>this.#s(i))}return()=>{for(let s of t)s()}}}}#n({name:e,target:n,commands:t}){for(let s of t){let i=s.options||!1,o=`${s.event}-${n}`;if(!this.#t.has(o)){let f=c=>{this.#i(c,s.event)};n.addEventListener(s.event,f,i),this.#t.set(o,{handler:f,options:i,refCount:0})}this.#t.get(o).refCount++,this.#e.push({...s,target:n,name:e})}}#s(e){let n=this.#e.filter(t=>t.name===e);for(let t of n){let s=`${t.event}-${t.target}`,i=this.#t.get(s);i&&(i.refCount--,i.refCount===0&&(t.target.removeEventListener(t.event,i.handler,i.options),this.#t.delete(s)))}this.#e=this.#e.filter(t=>t.name!==e)}#i(e,n){for(let t of this.#e)t.event===n&&this.#r(t.keys,e)&&(t.matchTarget&&!this.#a(t.matchTarget,e)||t.when&&!t.when(this._engine)||(t.preventDefault&&e.preventDefault(),t.stopPropagation&&e.stopPropagation(),t.action(e)))}#r(e,n){if(!e||e.includes("*"))return!0;let t=this.#o(n);for(let s of e)if(this.#f(s,t))return!0;return!1}#o(e){let n=[];return e.ctrlKey&&n.push("Ctrl"),e.metaKey&&n.push("Meta"),e.altKey&&n.push("Alt"),e.shiftKey&&n.push("Shift"),n.push(e.key),n.join("+")}#f(e,n){if(e===n)return!0;if(e==="char")return n.length===1&&n.match(/^[a-z0-9]$/i);if(e==="Arrow*")return n.includes("Arrow");if(e.endsWith("+*")){let t=e.slice(0,-2);return n.startsWith(t+"+")}return!1}#a(e,n){let t=n.target;return e?typeof e=="function"?e(n):e.startsWith(".")||e.startsWith("#")?t.closest(e)!==null:t.tagName===e.toUpperCase():!0}};var m=require("@jucie.io/engine"),l=(0,m.createDefinition)("commands",[Object]);0&&(module.exports={CommandManager,defineCommands});
2
2
  //# sourceMappingURL=main.js.map
package/dist/main.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
- "sources": ["../../../src/lib/relay/src/Relay.js", "../../../src/utils/typeChecker.js", "../../../src/definitions/createDefinition.js", "../../../src/utils/asserts.js", "../../../src/definitions/defaults.js", "../../../src/definitions/DefinitionBuilder.js", "../../../src/ServiceProvider.js", "../../../src/global.js", "../src/CommandManager.js", "../src/defineCommands.js"],
4
- "sourcesContent": ["// Simple, readable relay with wildcard matching and no indexing\n\nconst GLOBAL_NS_OBJ = Object.freeze(Object.create(null));\n\nfunction queueMicrotask(fn) {\n if (globalThis.queueMicrotask && typeof globalThis.queueMicrotask === 'function') {\n globalThis.queueMicrotask(fn);\n return;\n }\n setTimeout(fn, 0);\n}\n\nclass Channel {\n #nsObj; #relay;\n constructor(nsObj, relay) { this.#nsObj = nsObj; this.#relay = relay; }\n\n // Any source -> me\n on(event, handler) {\n return this.#relay.subscribe(event, GLOBAL_NS_OBJ, this.#nsObj, handler);\n }\n\n once(event, handler) {\n return this.#relay.once(event, GLOBAL_NS_OBJ, this.#nsObj, handler);\n }\n\n // Me -> everyone (sender never hears itself)\n broadcast(event, ...payload) {\n this.#relay.publish(event, this.#nsObj, GLOBAL_NS_OBJ, payload);\n }\n\n // Specific source -> me\n from(fromNs) {\n return {\n subscribe: (event, handler) => this.#relay.subscribe(event, fromNs, this.#nsObj, handler),\n once: (event, handler) => this.#relay.once(event, fromNs, this.#nsObj, handler),\n };\n }\n\n // Me -> specific target\n to(toNs) {\n return {\n publish: (event, ...payload) => this.#relay.publish(event, this.#nsObj, toNs, payload),\n publishAsync: (event, ...payload) => this.#relay.publishAsync(event, this.#nsObj, toNs, payload),\n };\n }\n}\n\nexport class Relay {\n #channels = new WeakMap(); // nsObj -> Channel\n #events = new Map(); // eventName -> Set<Listener>\n #onError = null;\n\n static create(config = {}) {\n return new Relay(config);\n }\n\n constructor({ onError = null } = {}) {\n this.#onError = onError;\n this.createChannel(GLOBAL_NS_OBJ);\n }\n\n // Public convenience\n channel(nsObj) { return this.createChannel(nsObj); }\n createChannel(nsObj) {\n if (this.#channels.has(nsObj)) return this.#channels.get(nsObj);\n const ch = new Channel(nsObj, this);\n this.#channels.set(nsObj, ch);\n return ch;\n }\n\n // Internal helpers\n #listeners(event) {\n let set = this.#events.get(event);\n if (!set) { set = new Set(); this.#events.set(event, set); }\n return set;\n }\n\n // Wildcard matcher:\n // - If published `from` is GLOBAL, it matches every listener.from\n // - If listener.from is GLOBAL, it matches every published from\n // Same for `to`. This makes broadcast (to = GLOBAL) hit specific targets too.\n static #matchSide(published, constraint) {\n return published === GLOBAL_NS_OBJ || constraint === GLOBAL_NS_OBJ || published === constraint;\n }\n\n static #matches(publishedFrom, publishedTo, listenerFrom, listenerTo) {\n return Relay.#matchSide(publishedFrom, listenerFrom)\n && Relay.#matchSide(publishedTo, listenerTo);\n }\n\n subscribe(event, from, to, handler) {\n const listener = { from, to, handler };\n this.#listeners(event).add(listener);\n return () => {\n const set = this.#events.get(event);\n if (set) set.delete(listener);\n };\n }\n\n once(event, from, to, handler) {\n let off = null;\n const wrapped = (payload) => {\n try { handler(payload); } finally { off && off(); }\n };\n off = this.subscribe(event, from, to, wrapped);\n return off;\n }\n\n offAllFor(nsObj) {\n for (const set of this.#events.values()) {\n for (const l of Array.from(set)) {\n if (l.from === nsObj || l.to === nsObj) set.delete(l);\n }\n }\n }\n\n listenerCount(event) {\n const set = this.#events.get(event);\n return set ? set.size : 0;\n }\n\n #deliver(event, from, to, payload) {\n const set = this.#events.get(event);\n if (!set || set.size === 0) return;\n\n for (const l of set) {\n // Always skip self-delivery\n if (l.to === from) continue;\n\n if (Relay.#matches(from, to, l.from, l.to)) {\n try { l.handler(...payload); }\n catch (err) { if (this.#onError) this.#onError(err, { event, from, to, listener: l }); }\n }\n }\n }\n\n publish(event, from, to, payload) {\n this.#deliver(event, from, to, payload);\n }\n\n publishAsync(event, from, to, payload) {\n queueMicrotask(() => this.#deliver(event, from, to, payload));\n }\n\n broadcast(event, from, payload) {\n this.publish(event, from, GLOBAL_NS_OBJ, payload);\n }\n}\n", "/**\n * Type Checker Utility\n * \n * Supports syntax like:\n * - createDefinition('action', [Array, Function]) // Array or Function\n * - createDefinition('name', String) // Must be String\n * - createDefinition('items', Array) // Must be Array\n * - createDefinition('callback', Function) // Must be Function\n * - createDefinition('value', [String, Number]) // String or Number\n */\n\n/**\n * Type definitions mapping constructor names to actual constructors\n */\nconst TYPE_MAP = {\n String,\n Number,\n Boolean,\n Array,\n Object,\n Function,\n Date,\n RegExp,\n Promise,\n Map,\n Set,\n WeakMap,\n WeakSet,\n Symbol,\n BigInt,\n Error,\n TypeError,\n RangeError,\n ReferenceError,\n SyntaxError,\n EvalError,\n URIError\n};\n\n/**\n * Checks if a value matches the expected type(s)\n * @param {*} value - The value to check\n * @param {Function|Array<Function>} expectedType - Single type or array of possible types\n * @param {string} name - Name of the parameter for error messages\n * @returns {boolean} - True if value matches expected type(s)\n */\nexport function checkType(value, expectedType, name = 'value') {\n // Handle array of possible types\n if (Array.isArray(expectedType)) {\n for (const type of expectedType) {\n if (matchesType(value, type)) {\n return true;\n }\n }\n \n const typeNames = expectedType.map(getTypeName).join(' | ');\n throw new TypeError(`${name} must be one of: ${typeNames}. Got ${getTypeName(value)}`);\n }\n \n // Handle single type\n if (!matchesType(value, expectedType)) {\n throw new TypeError(`${name} must be ${getTypeName(expectedType)}. Got ${getTypeName(value)}`);\n }\n \n return true;\n}\n\n/**\n * Checks if a value matches a specific type\n * @param {*} value - The value to check\n * @param {Function} type - The expected constructor/type\n * @returns {boolean} - True if value matches the type\n */\nfunction matchesType(value, type) {\n // Handle primitive constructors\n if (type === String) {\n return typeof value === 'string';\n }\n if (type === Number) {\n return typeof value === 'number' && !isNaN(value);\n }\n if (type === Boolean) {\n return typeof value === 'boolean';\n }\n if (type === Symbol) {\n return typeof value === 'symbol';\n }\n if (type === BigInt) {\n return typeof value === 'bigint';\n }\n if (type === Function) {\n return typeof value === 'function';\n }\n \n // Handle object constructors (including Array, Object, Date, etc.)\n if (type === Array) {\n return Array.isArray(value);\n }\n if (type === Object) {\n return value !== null && typeof value === 'object' && !Array.isArray(value);\n }\n \n // Handle other constructors (Date, RegExp, Map, Set, etc.)\n return value instanceof type;\n}\n\n/**\n * Gets a human-readable name for a type\n * @param {*} value - The value or constructor to get name for\n * @returns {string} - Human-readable type name\n */\nfunction getTypeName(value) {\n if (value === String) return 'String';\n if (value === Number) return 'Number';\n if (value === Boolean) return 'Boolean';\n if (value === Array) return 'Array';\n if (value === Object) return 'Object';\n if (value === Function) return 'Function';\n if (value === Date) return 'Date';\n if (value === RegExp) return 'RegExp';\n if (value === Promise) return 'Promise';\n if (value === Map) return 'Map';\n if (value === Set) return 'Set';\n if (value === WeakMap) return 'WeakMap';\n if (value === WeakSet) return 'WeakSet';\n if (value === Symbol) return 'Symbol';\n if (value === BigInt) return 'BigInt';\n if (value === Error) return 'Error';\n \n if (typeof value === 'string') return 'string';\n if (typeof value === 'number') return 'number';\n if (typeof value === 'boolean') return 'boolean';\n if (typeof value === 'symbol') return 'symbol';\n if (typeof value === 'bigint') return 'bigint';\n if (typeof value === 'function') return 'function';\n if (Array.isArray(value)) return 'Array';\n if (value === null) return 'null';\n if (value === undefined) return 'undefined';\n if (typeof value === 'object') {\n return value.constructor?.name || 'Object';\n }\n \n return 'unknown';\n}\n\n/**\n * Creates a type checker function for a specific parameter\n * @param {Function|Array<Function>} expectedType - Expected type(s)\n * @param {string} name - Parameter name\n * @returns {Function} - Type checker function\n */\nexport function createTypeChecker(expectedType, name = 'value') {\n return (value) => checkType(value, expectedType, name);\n}\n\n/**\n * Validates an object against a schema\n * @param {Object} obj - Object to validate\n * @param {Object} schema - Schema definition { prop: Type, prop2: [Type1, Type2] }\n * @param {string} objName - Name of the object for error messages\n */\nexport function validateObject(obj, schema, objName = 'object') {\n if (!obj || typeof obj !== 'object') {\n throw new TypeError(`${objName} must be an object`);\n }\n \n for (const [prop, expectedType] of Object.entries(schema)) {\n if (prop in obj) {\n checkType(obj[prop], expectedType, `${objName}.${prop}`);\n }\n }\n}\n\n/**\n * Creates a validator function for an object schema\n * @param {Object} schema - Schema definition\n * @param {string} objName - Name of the object\n * @returns {Function} - Validator function\n */\nexport function createObjectValidator(schema, objName = 'object') {\n return (obj) => validateObject(obj, schema, objName);\n}\n\n// Export the type map for advanced usage\nexport { TYPE_MAP };\n", "const DefinitionTypes = new Map();\nconst Definitions = new WeakMap();\nimport { createTypeChecker } from '../utils/typeChecker.js';\n\n/**\n * Creates a definition type with return type validation\n * @param {string} type - The definition type name\n * @param {Function|Array<Function>} returnTypes - Expected return type(s)\n * @returns {Function} - Definition creator function\n */\n\n\nexport const definitionType = (definition) => {\n if (Definitions.has(definition)) {\n return Definitions.get(definition);\n }\n return undefined;\n}\n\nexport const createDefinition = (type, returnTypes = []) => { \n // Create type checker for return values if returnTypes specified\n const returnTypeChecker = returnTypes.length > 0 ? createTypeChecker(returnTypes, 'return value') : null;\n \n if (DefinitionTypes.has(type)) {\n console.warn(`Definition type \"${type}\" already exists`);\n return DefinitionTypes.get(type);\n }\n\n const definitionType = (name, factory, ...defaultArgs) => {\n // Validate inputs using type checker\n createTypeChecker(String, 'name')(name);\n createTypeChecker(Function, 'factory')(factory);\n\n const definition = (...args) => {\n try {\n const combinedArgs = [...args, ...defaultArgs];\n const res = factory(...combinedArgs);\n \n if (returnTypeChecker && res === undefined) {\n throw new Error(`Factory ${type} must return a value for ${name}`);\n }\n\n // Use type checker to validate return value\n if (returnTypeChecker) {\n returnTypeChecker(res);\n }\n\n return res\n } catch (error) {\n console.error(`Error creating definition \"${name}\"`, error);\n throw error;\n }\n }\n\n Object.defineProperty(definition, '_name', {\n value: name,\n enumerable: false,\n configurable: false\n });\n\n Definitions.set(definition, type);\n\n return definition;\n }\n\n DefinitionTypes.set(type, definitionType);\n\n return definitionType;\n}; ", "// utils/asserts.js\n\nconst BAD_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\nconst RESERVED_NAMESPACES = new Set(['use', 'install', 'uninstall', 'relay', 'state', 'debug']);\n\nconst MAX_NAME_LENGTH = 64;\nconst VALID_NAME = /^[a-zA-Z_$][a-zA-Z_$0-9]*$/;\n\n/**\n * Throw if key is unsafe (__proto__, constructor, etc.)\n */\nexport function assertSafeKey(key, where = 'key') {\n if (BAD_KEYS.has(key)) {\n throw new Error(`Illegal key \"${key}\" in ${where}`);\n }\n}\n\n/**\n * Validate a namespace string: format, length, reserved words, proto poisoning.\n */\nexport function assertNamespace(ns) {\n assertSafeKey(ns, 'namespace');\n if (typeof ns !== 'string') {\n throw new Error(`Namespace must be a string, got ${typeof ns}`);\n }\n if (!VALID_NAME.test(ns)) {\n throw new Error(`Invalid namespace \"${ns}\". Must be a valid JS identifier`);\n }\n if (ns.length > MAX_NAME_LENGTH) {\n throw new Error(`Namespace \"${ns}\" too long (max ${MAX_NAME_LENGTH} chars)`);\n }\n if (RESERVED_NAMESPACES.has(ns)) {\n throw new Error(`Namespace \"${ns}\" is reserved`);\n }\n return ns;\n}\n\n/**\n * Validate an action or getter name within a namespace.\n */\nexport function assertMemberName(name, namespace, kind = 'member') {\n assertSafeKey(name, `${kind}:${namespace}`);\n if (typeof name !== 'string') {\n throw new Error(`${kind} name in ${namespace} must be a string`);\n }\n if (!VALID_NAME.test(name)) {\n throw new Error(`Invalid ${kind} name \"${name}\" in ${namespace}`);\n }\n if (name.length > MAX_NAME_LENGTH) {\n throw new Error(\n `${kind} name \"${name}\" in ${namespace} too long (max ${MAX_NAME_LENGTH})`\n );\n }\n return name;\n}\n", "import { createDefinition, definitionType } from './createDefinition.js';\nexport const defineMiddleware = createDefinition('MIDDLEWARE', [Function, Array]);\nexport const defineActions = createDefinition('ACTIONS', [Object]);\nexport const defineUninstall = createDefinition('UNINSTALL');\nexport const defineInitialize = createDefinition('INITIALIZE');\nexport const defineGetters = createDefinition('GETTERS', [Object]);\nexport { createDefinition, definitionType };", "// DefinitionBuilder.js\nimport { defineActions, defineGetters, defineMiddleware, defineInitialize, defineUninstall } from './defaults.js';\n\nexport class DefinitionBuilder {\n static create(namespace) {\n return new DefinitionBuilder(namespace);\n }\n\n #ns; #args;\n #slots = { MIDDLEWARE:null, GETTERS:null, ACTIONS:null, INITIALIZE:null, UNINSTALL:null };\n constructor(namespace) { this.#ns = namespace }\n\n #set(type, factory, creator) {\n if (this.#slots[type]) throw new Error(`${type} already defined for ${this.#ns}`);\n this.#slots[type] = creator(this.#ns, factory);\n }\n\n defineMiddleware = (factory) => this.#set('MIDDLEWARE', factory, defineMiddleware);\n defineGetters = (factory) => this.#set('GETTERS', factory, defineGetters);\n defineActions = (factory) => this.#set('ACTIONS', factory, defineActions);\n defineInitialize = (factory) => this.#set('INITIALIZE', factory, defineInitialize);\n defineUninstall = (factory) => this.#set('UNINSTALL', factory, defineUninstall);\n\n _toArray() {\n return [\n this.#slots.MIDDLEWARE,\n this.#slots.GETTERS,\n this.#slots.ACTIONS,\n this.#slots.INITIALIZE,\n this.#slots.UNINSTALL\n ].filter(Boolean);\n }\n}\n\n", "import { assertNamespace } from './utils/asserts.js';\nimport { DefinitionBuilder } from './definitions/DefinitionBuilder.js';\n\n\nexport class ServiceProvider {\n static #services = new Set();\n\n static manifest = {\n name: 'base',\n dependencies: [],\n version: '1.0.0',\n description: 'Base extension template',\n };\n\n static config = null;\n\n static unique = false;\n\n static configure(options = {}) {\n return {\n install: (useContext, config) => this.install(useContext, config),\n manifest: this.manifest,\n config: { ...(this.config || this.manifest.defaults || {}), ...options },\n unique: true,\n configured: true\n };\n }\n\n static install(useContext, config) { \n try {\n const {namespace} = this.manifest;\n assertNamespace(namespace);\n\n // instantiate\n const instance = new this();\n ServiceProvider.#services.add(instance);\n\n // bind context/config\n // bind config (frozen to avoid accidental mutation)\n Object.defineProperty(instance, 'config', {\n value: Object.freeze({ ...config }),\n writable: false,\n configurable: false,\n enumerable: false,\n });\n\n // expose both a live context getter AND the keyed accessor\n Object.defineProperty(instance, 'context', {\n get: () => useContext(), // always fresh, via your proxy\n configurable: false,\n enumerable: false,\n });\n \n Object.defineProperty(instance, 'useContext', {\n value: (...keys) => useContext(...keys),\n writable: false,\n configurable: false,\n enumerable: false,\n });\n\n const builder = DefinitionBuilder.create(namespace);\n\n if (instance.setup) {\n // Create properly bound context for setup pattern\n const setupContext = {\n defineActions: (factory) => builder.defineActions(() => factory(useContext, config)),\n defineMiddleware: (factory) => builder.defineMiddleware(() => factory(useContext, config)),\n defineGetters: (factory) => builder.defineGetters(() => factory(useContext, config)),\n defineInitialize: (factory) => builder.defineInitialize(() => factory(useContext, config)),\n defineUninstall: (factory) => builder.defineUninstall(() => factory(useContext, config))\n };\n const maybe = instance.setup(setupContext);\n return maybe?.then ? maybe.then(() => builder._toArray()) : builder._toArray();\n }\n\n if (instance.middleware) builder.defineMiddleware(() => instance.middleware(useContext, config));\n if (instance.getters) builder.defineGetters (() => instance.getters(useContext, config));\n if (instance.actions) builder.defineActions (() => instance.actions(useContext, config));\n if (instance.initialize) builder.defineInitialize(() => instance.initialize(useContext, config));\n if (instance.uninstall) builder.defineUninstall (() => instance.uninstall(useContext, config));\n\n return builder._toArray();\n } catch (error) {\n throw error;\n }\n }\n}", "const ENGINE_CONTEXT = Symbol('jucie.engine');\n\n/**\n * Registers the engine globally, but only if no engine has already been set.\n * @param {object} engine \n */\n\nexport function provideEngine(engine) {\n if (!globalThis[ENGINE_CONTEXT]) {\n globalThis[ENGINE_CONTEXT] = engine;\n }\n}\n\nexport function hasEngine() {\n return globalThis[ENGINE_CONTEXT] !== undefined;\n}\n\n/**\n * Forcefully override the engine in the global context.\n * Useful for testing or resetting.\n */\nexport function forceEngine(engine) {\n globalThis[ENGINE_CONTEXT] = engine;\n}\n\n/**\n * Retrieves the globally registered engine.\n */\nexport function getEngine() {\n return globalThis[ENGINE_CONTEXT] || null;\n}\n\n/**\n * Retrieves the globally registered engine.\n */\nexport function useEngine() {\n return getEngine();\n}", "import { ServiceProvider } from '@jucie.io/engine';\n\nexport class CommandManager extends ServiceProvider {\n #bindings = [];\n #listeners = new Map(); // Track event listeners to avoid duplicates\n\n static manifest = {\n name: 'Command manager',\n namespace: 'commandManager',\n description: 'Manages commands for the engine',\n version: '1.0.0',\n author: 'Jucie',\n license: 'MIT',\n dependencies: [],\n }\n\n actions(useContext) {\n return {\n useCommands: (...commands) => {\n const unregisterFns = []\n for (const command of commands) {\n const name = command._name;\n const config = command(useContext);\n const { target, commands } = config;\n this.#registerGroup({ name, target, commands });\n unregisterFns.push(() => this.#unregisterGroup(name));\n }\n\n return () => {\n for (const unregisterFn of unregisterFns) {\n unregisterFn();\n }\n }\n }\n }\n }\n\n #registerGroup({ name, target, commands }) {\n for (const command of commands) {\n const options = command.options || false;\n const listenerKey = `${command.event}-${target}`;\n\n // Only add ONE event listener per event type per target\n if (!this.#listeners.has(listenerKey)) {\n const handler = (e) => {\n this.#handleEvent(e, command.event);\n }\n\n target.addEventListener(command.event, handler, options);\n this.#listeners.set(listenerKey, { handler, options, refCount: 0 });\n }\n\n // Increment reference count\n this.#listeners.get(listenerKey).refCount++;\n\n // Store the binding without the handler (since it's shared)\n this.#bindings.push({ ...command, target, name });\n }\n }\n\n #unregisterGroup(name) {\n const toRemove = this.#bindings.filter(b => b.name === name);\n\n for (const b of toRemove) {\n const listenerKey = `${b.event}-${b.target}`;\n const listener = this.#listeners.get(listenerKey);\n\n if (listener) {\n listener.refCount--;\n\n // Only remove the event listener when ref count reaches 0\n if (listener.refCount === 0) {\n b.target.removeEventListener(b.event, listener.handler, listener.options);\n this.#listeners.delete(listenerKey);\n }\n }\n }\n\n this.#bindings = this.#bindings.filter(b => b.name !== name);\n }\n\n #handleEvent(e, eventType) { \n for (const binding of this.#bindings) {\n if (binding.event !== eventType) continue;\n if (!this.#matchesKey(binding.keys, e)) continue;\n if (binding.matchTarget && !this.#matchesTarget(binding.matchTarget, e)) continue;\n if (binding.when && !binding.when(this._engine)) continue;\n\n if (binding.preventDefault) { \n e.preventDefault()\n };\n\n if (binding.stopPropagation) {\n e.stopPropagation();\n }\n\n binding.action(e);\n }\n }\n\n #matchesKey(keys, e) {\n if (!keys || keys.includes('*')) return true;\n\n const combo = this.#normalizeCombo(e);\n\n for (const key of keys) {\n if (this.#matchPattern(key, combo)) return true;\n }\n\n return false;\n }\n\n #normalizeCombo(e) {\n const parts = [];\n if (e.ctrlKey) parts.push('Ctrl');\n if (e.metaKey) parts.push('Meta');\n if (e.altKey) parts.push('Alt');\n if (e.shiftKey) parts.push('Shift');\n parts.push(e.key);\n return parts.join('+');\n }\n\n #matchPattern(pattern, combo) {\n if (pattern === combo) return true;\n\n // Match typed characters only\n if (pattern === 'char') {\n return combo.length === 1 && combo.match(/^[a-z0-9]$/i);\n }\n\n // Match arrow keys\n if (pattern === 'Arrow*') {\n return combo.includes('Arrow');\n }\n\n // Match modifier combos like 'Ctrl+*'\n if (pattern.endsWith('+*')) {\n const prefix = pattern.slice(0, -2);\n return combo.startsWith(prefix + '+');\n }\n\n return false;\n }\n\n #matchesTarget(matchTarget, e) {\n const el = e.target;\n\n if (!matchTarget) return true;\n if (typeof matchTarget === 'function') return matchTarget(e);\n\n if (matchTarget.startsWith('.') || matchTarget.startsWith('#')) {\n return el.closest(matchTarget) !== null;\n }\n\n return el.tagName === matchTarget.toUpperCase();\n }\n}", "import { createDefinition } from '@jucie.io/engine';\n\nexport const defineCommands = createDefinition('commands', [Object]);"],
5
- "mappings": "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",
6
- "names": ["GLOBAL_NS_OBJ", "checkType", "value", "expectedType", "name", "type", "matchesType", "typeNames", "getTypeName", "createTypeChecker", "DefinitionTypes", "Definitions", "createDefinition", "type", "returnTypes", "returnTypeChecker", "createTypeChecker", "DefinitionTypes", "definitionType", "name", "factory", "defaultArgs", "definition", "args", "combinedArgs", "res", "error", "Definitions", "BAD_KEYS", "RESERVED_NAMESPACES", "MAX_NAME_LENGTH", "VALID_NAME", "assertSafeKey", "key", "where", "assertNamespace", "ns", "defineMiddleware", "createDefinition", "defineActions", "defineUninstall", "defineInitialize", "defineGetters", "DefinitionBuilder", "_DefinitionBuilder", "namespace", "#ns", "#args", "#slots", "#set", "type", "factory", "creator", "defineMiddleware", "defineGetters", "defineActions", "defineInitialize", "defineUninstall", "ServiceProvider", "_ServiceProvider", "#services", "options", "useContext", "config", "namespace", "assertNamespace", "instance", "keys", "builder", "DefinitionBuilder", "setupContext", "factory", "maybe", "error", "ENGINE_CONTEXT", "CommandManager", "ServiceProvider", "#bindings", "#listeners", "useContext", "commands", "unregisterFns", "command", "name", "config", "target", "#registerGroup", "#unregisterGroup", "unregisterFn", "options", "listenerKey", "handler", "e", "#handleEvent", "toRemove", "b", "listener", "eventType", "binding", "#matchesKey", "#matchesTarget", "keys", "combo", "#normalizeCombo", "key", "#matchPattern", "parts", "pattern", "prefix", "matchTarget", "el", "defineCommands", "createDefinition"]
3
+ "sources": ["../src/main.js", "../src/CommandManager.js", "../src/defineCommands.js"],
4
+ "sourcesContent": ["export { CommandManager } from './CommandManager';\nexport { defineCommands } from './defineCommands';", "import { ServiceProvider } from '@jucie.io/engine';\n\nexport class CommandManager extends ServiceProvider {\n #bindings = [];\n #listeners = new Map(); // Track event listeners to avoid duplicates\n\n static manifest = {\n name: 'Command manager',\n namespace: 'commandManager',\n description: 'Manages commands for the engine',\n version: '1.0.0',\n author: 'Jucie',\n license: 'MIT',\n dependencies: [],\n }\n\n actions(useContext) {\n return {\n useCommands: (...commands) => {\n const unregisterFns = []\n for (const command of commands) {\n const name = command._name;\n const config = command(useContext);\n const { target, commands } = config;\n this.#registerGroup({ name, target, commands });\n unregisterFns.push(() => this.#unregisterGroup(name));\n }\n\n return () => {\n for (const unregisterFn of unregisterFns) {\n unregisterFn();\n }\n }\n }\n }\n }\n\n #registerGroup({ name, target, commands }) {\n for (const command of commands) {\n const options = command.options || false;\n const listenerKey = `${command.event}-${target}`;\n\n // Only add ONE event listener per event type per target\n if (!this.#listeners.has(listenerKey)) {\n const handler = (e) => {\n this.#handleEvent(e, command.event);\n }\n\n target.addEventListener(command.event, handler, options);\n this.#listeners.set(listenerKey, { handler, options, refCount: 0 });\n }\n\n // Increment reference count\n this.#listeners.get(listenerKey).refCount++;\n\n // Store the binding without the handler (since it's shared)\n this.#bindings.push({ ...command, target, name });\n }\n }\n\n #unregisterGroup(name) {\n const toRemove = this.#bindings.filter(b => b.name === name);\n\n for (const b of toRemove) {\n const listenerKey = `${b.event}-${b.target}`;\n const listener = this.#listeners.get(listenerKey);\n\n if (listener) {\n listener.refCount--;\n\n // Only remove the event listener when ref count reaches 0\n if (listener.refCount === 0) {\n b.target.removeEventListener(b.event, listener.handler, listener.options);\n this.#listeners.delete(listenerKey);\n }\n }\n }\n\n this.#bindings = this.#bindings.filter(b => b.name !== name);\n }\n\n #handleEvent(e, eventType) { \n for (const binding of this.#bindings) {\n if (binding.event !== eventType) continue;\n if (!this.#matchesKey(binding.keys, e)) continue;\n if (binding.matchTarget && !this.#matchesTarget(binding.matchTarget, e)) continue;\n if (binding.when && !binding.when(this._engine)) continue;\n\n if (binding.preventDefault) { \n e.preventDefault()\n };\n\n if (binding.stopPropagation) {\n e.stopPropagation();\n }\n\n binding.action(e);\n }\n }\n\n #matchesKey(keys, e) {\n if (!keys || keys.includes('*')) return true;\n\n const combo = this.#normalizeCombo(e);\n\n for (const key of keys) {\n if (this.#matchPattern(key, combo)) return true;\n }\n\n return false;\n }\n\n #normalizeCombo(e) {\n const parts = [];\n if (e.ctrlKey) parts.push('Ctrl');\n if (e.metaKey) parts.push('Meta');\n if (e.altKey) parts.push('Alt');\n if (e.shiftKey) parts.push('Shift');\n parts.push(e.key);\n return parts.join('+');\n }\n\n #matchPattern(pattern, combo) {\n if (pattern === combo) return true;\n\n // Match typed characters only\n if (pattern === 'char') {\n return combo.length === 1 && combo.match(/^[a-z0-9]$/i);\n }\n\n // Match arrow keys\n if (pattern === 'Arrow*') {\n return combo.includes('Arrow');\n }\n\n // Match modifier combos like 'Ctrl+*'\n if (pattern.endsWith('+*')) {\n const prefix = pattern.slice(0, -2);\n return combo.startsWith(prefix + '+');\n }\n\n return false;\n }\n\n #matchesTarget(matchTarget, e) {\n const el = e.target;\n\n if (!matchTarget) return true;\n if (typeof matchTarget === 'function') return matchTarget(e);\n\n if (matchTarget.startsWith('.') || matchTarget.startsWith('#')) {\n return el.closest(matchTarget) !== null;\n }\n\n return el.tagName === matchTarget.toUpperCase();\n }\n}", "import { createDefinition } from '@jucie.io/engine';\n\nexport const defineCommands = createDefinition('commands', [Object]);"],
5
+ "mappings": "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",
6
+ "names": ["main_exports", "__export", "CommandManager", "defineCommands", "__toCommonJS", "import_engine", "CommandManager", "#bindings", "#listeners", "useContext", "commands", "unregisterFns", "command", "name", "config", "target", "#registerGroup", "#unregisterGroup", "unregisterFn", "options", "listenerKey", "handler", "e", "#handleEvent", "toRemove", "b", "listener", "eventType", "binding", "#matchesKey", "#matchesTarget", "keys", "combo", "#normalizeCombo", "key", "#matchPattern", "parts", "pattern", "prefix", "matchTarget", "el", "import_engine", "defineCommands"]
7
7
  }
package/package.json CHANGED
@@ -1,17 +1,18 @@
1
1
  {
2
2
  "name": "@jucie.io/engine-command-manager",
3
- "version": "1.0.8",
3
+ "version": "1.0.10",
4
4
  "description": "Command manager service for @jucie.io/engine with command definition and execution support",
5
5
  "type": "module",
6
6
  "main": "./dist/main.js",
7
7
  "exports": {
8
- ".": "./dist/index.js"
8
+ ".": "./dist/main.js"
9
9
  },
10
10
  "files": [
11
11
  "dist/",
12
12
  "README.md"
13
13
  ],
14
14
  "scripts": {
15
+ "build": "node build.js",
15
16
  "test": "vitest"
16
17
  },
17
18
  "keywords": [