agnostics 0.0.3 → 0.0.5

package/lib/bases/_BaseOnCall.js

@@ -0,0 +1,41 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//                BASE                  //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+import { CreateLogger } from 'agnostics/logger'
+const { ERR } = CreateLogger( import.meta.url )
+
+export class BaseOnCall {
+	
+	className = 'Base'
+
+	$listenerCbs = {}
+
+	constructor() {}
+
+	$call( name, res ) {
+		const alls = ['all', '*']
+		const includesKey = Object.keys(this.$listenerCbs).includes(name)
+		if (!includesKey) return ERR(`NONEXISTENT:`, name)
+		for (const callback of this.$listenerCbs[name]) callback(res)
+		for (const all of alls) {
+			if (this.$listenerCbs[all]) {
+				for (const callback of this.$listenerCbs[all]) callback(name, res)
+			}
+		}
+
+	}
+
+	on( name, callback ) {
+		const isAll = name === 'all' || name === '*'
+		const includesKey = Object.keys(this.$listenerCbs).includes(name)
+		if (!includesKey && !isAll) return ERR(`NONEXISTENT:`, name)
+		if (!this.$listenerCbs[name]) this.$listenerCbs[name] = []
+		this.$listenerCbs[name].push(callback)
+	}
+
+}

package/lib/bases/_BasePrompt.js

@@ -0,0 +1,33 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//             BASE PROMPT              //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+import { CreateLogger } from 'agnostics/logger'
+const { SAY, HMM, ERR, YAY } = CreateLogger( import.meta.url )
+
+import { BaseOnCall } from './_BaseOnCall.js'
+
+export class BasePrompt extends BaseOnCall {
+
+	className = 'BasePrompt:BaseOnCall'
+
+	constructor( ) {
+		super()
+	}
+
+	ask( config = { message: '', schema: {} } ) {
+
+		HMM('ASK NOT IMPLEMENTED:', this.className)
+		const { message, schema } = config
+		return new Promise( resolve => {
+			const res = {}
+			for (const [key,value] of Object.entries(schema)) res[key] = true
+			resolve(res)
+		})
+	}
+}
+

package/lib/bases/_BaseRemote.js

@@ -0,0 +1,118 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//             BASE REMOTE              //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+/*
+	
+	CLASSES MUST HAVE:
+
+	1) single config on constructor
+	2) some way to post / receive
+	3) 
+
+
+*/
+
+import { CreateLogger } from 'agnostics/logger'
+const { SAY, ERR, YAY, HMM, HUH } = CreateLogger( import.meta.url )
+
+import { BaseOnCall } from './_BaseOnCall.js'
+
+export class BaseRemote extends BaseOnCall {
+
+	className = 'BaseRemote:BaseOnCall'
+
+	$methodReqs = {
+	}
+
+	constructor() {
+		super()
+		this.isIniting = true
+	}
+
+	construct() {}
+
+	getMethodListenerNames() {
+		let methodNames = new Set()
+		let current = this
+		const exclude = ['getMethodListenerNames', 'construct', 'on']
+
+		do {
+			Object.getOwnPropertyNames(current).forEach(prop => {
+				if (prop === 'constructor') return
+				const desc = Object.getOwnPropertyDescriptor(current, prop)
+				if (!desc || prop[0] === '$' || exclude.includes(prop)) return
+				if (
+					typeof desc.value === 'function' ||
+					typeof desc.get === 'function' ||
+					typeof desc.set === 'function'
+				) {
+					methodNames.add(prop)
+				}
+			})
+
+			current = Object.getPrototypeOf(current)
+		} while (current !== null && current !== Object.prototype)
+
+		methodNames = [...methodNames].sort()
+		const listenerNames = Object.keys(this.$listenerCbs || {})
+		return { methodNames, listenerNames }
+	}
+
+	$initMethodsAndListeners( methodNames, listenerNames ) {
+
+		// ========= METHODS =========
+
+		for (const name of methodNames) {
+			this.$methodReqs[name] = []
+
+			this[name] = (...req) => {
+
+				const type = 'method'
+				const index = this.$methodReqs[name].length
+				this.$sendRequest( type, name, req, index ) 
+				return new Promise( resolve => {
+					this.$methodReqs[name].push( resolve )
+				})
+			}
+		}
+
+		// ========= CALLBACKS =========
+
+		for (const listenerCb of listenerNames) {
+			this.$listenerCbs[listenerCb] = []
+		}
+
+		// ========= READY =========
+
+		YAY('REMOTE:', this.className)
+
+		HUH('➔ METHODS:', methodNames.join(' '))
+		HUH('➔ LISTENERS:', listenerNames.join(' '))
+		this.isIniting = false
+	}
+
+	$handleResponse( type, index, name, res ) {
+
+		if (type === 'method') {
+			const resolver = this.$methodReqs[name]?.[index]
+			if (!resolver) {
+				ERR(`REMOTE NO RESOLVER:`, name, index)
+			} else {
+				this.$methodReqs[name][index](res)
+				this.$methodReqs[name][index] = null
+				const allDone = this.$methodReqs[name].every(item => item === null)
+				if (allDone) this.$methodReqs[name] = []
+			}
+		}  else if (type === 'listener') {
+			this.$call( name, res )
+		} else {
+			HMM(`UNKNOWN RESPONSE:`, {type,name})
+		}
+	}
+
+}

package/lib/bases/index.js

@@ -0,0 +1,12 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//                BASES                 //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+
+export * from './_BaseOnCall.js'
+export * from './_BasePrompt.js'
+export * from './_BaseRemote.js'

package/lib/helpers/_Yargs.js

@@ -10,45 +10,15 @@ import { Obj, isArr, isNum, isBool } from '../inputs/index.js'
 import { NormaliseAccept } from './_Parsers.js'
 
 import { CreateLogger } from '../logger/index.js'
+import path from 'path'
 const { SAY, ERR, HMM, HUH } = CreateLogger( import.meta.url )
 
-
-async function LoadYargs() {
-
-	if (!globalThis.yargsLib || !globalThis.yargsHideBin) {
-		try {
-			globalThis.yargsLib = (await import ('yargs')).default
-			globalThis.yargsHideBin = (await import ('yargs/helpers')).hideBin
-			return true
-		} catch(err) {
-			return ERR(`YARGS UNAVAILABLE`, err)	
-		}
-	}
-}
-
-async function LoadGlobby() {
-
-	if (!globalThis.globbyLib || !globalThis.pathExtname) {
-		try {
-			globalThis.globbyLib = (await import ('globby')).globby
-			globalThis.pathExtname = (await import ('path')).extname
-			return true
-		} catch(err) {
-			return ERR(`GLOBS UNAVAILABLE`, err)	
-		}
-	}
-}
-
 async function GetYargsFiles( value, extensions ) {
 
 	try {
-
-		if (!(await LoadGlobby())) return []
-
-
 		const anything = (extensions.length === 0 || extensions.includes('*'))
 
-		const found = await globalThis.globbyLib(value, {
+		const found = await globalThis.Yargs(value, {
 			onlyFiles: true,
 			expandDirectories: false,
 			caseSensitiveMatch: false
@@ -56,7 +26,7 @@ async function GetYargsFiles( value, extensions ) {
 
 		const exts = extensions.map( ext => ext.toLowerCase().replaceAll('.',''))
 		const files = anything ? found : found.filter(file => {
-			const ext = globalThis.pathExtname(file).replaceAll('.','')
+			const ext = path.extname(file).replaceAll('.','')
 			return exts.includes(ext)
 		})
 
@@ -111,14 +81,17 @@ export function ConvertYargsProperty( def, override = {} ) {
 
 	const array = def.gui == 'files' || isArr(def.type)
 
-	return Object.assign({
+	const yargsDef = Object.assign({
 		array,
 		describe: def.description,
 		type: GetYargsType(def.type),
-		coerce: def.oncheck,
+		coerce: def.onsend,
 		default: def.default,
-		accept: NormaliseAccept( def.accept )
+		accept: NormaliseAccept( def.accept ),
+		choices: def.enum
 	}, override)
+
+	return yargsDef
 }
 
 
@@ -136,7 +109,7 @@ export function YargsProcessWorkaround() {
 
 export class YargsCommand {
 
-	command = '$0'
+	command = null
 	description = 'N/A'
 	version = 'N/A'
 	positionals = {}
@@ -146,11 +119,13 @@ export class YargsCommand {
 	$options = {}
 	$aliasStore = []
 
-	constructor( { positionals, options = {}, description = 'N/A', version = 'N/A' } ) {
-
+	constructor( 
+		{ positionals, options = {}, description = 'N/A', version = 'N/A' }, 
+		runCallback = async options => {} ) {
 
 		this.description = description
 		this.version = version
+		this.runCallback = runCallback
 
 		// --------- OPTIONS ---------
 
@@ -187,17 +162,14 @@ export class YargsCommand {
 
 	}
 
-	async run( runCallback = async yargsData => {} ) {
-
-		if (!(await LoadYargs())) return
+	async run() {
 
-		YargsProcessWorkaround()
 
-		const args = globalThis.yargsHideBin( process.argv )
-		const instance = globalThis.yargsLib( args )
+		const args = globalThis.YargsBin( process.argv )
+		const instance = globalThis.Yargs( args )
 
 		instance.command(
-			this.command,
+			'$0 '+ this.command + ' [run]', // hack
 			this.description,
 			yargsData => {
 				const positionals = Object.entries(this.positionals)
@@ -218,7 +190,7 @@ export class YargsCommand {
 					}
 				}
 
-				await runCallback( yargsData )
+				if (this.runCallback) await this.runCallback( yargsData )
 
 			}
 		)
@@ -248,7 +220,9 @@ export class YargsCLI {
 	$options = {}
 	$commands = {}
 
-	constructor( { commands, options = {}, description = 'N/A', version = 'N/A' } ) {
+	constructor( 
+		{ commands, options = {}, description = 'N/A', version = 'N/A' }, 
+		runCallback = async options => {} ) {
 
 		if (typeof commands != 'object') throw Error('no commands defined')
 		if (!description) HMM('no description defined (recommended)')
@@ -256,6 +230,7 @@ export class YargsCLI {
 
 		this.description = description
 		this.version = version
+		this.runCallback = runCallback
 
 		// --------- OPTIONS ---------
 
@@ -268,15 +243,10 @@ export class YargsCLI {
 
 	}
 
-	async run( runCallback = async (cmdKey, yargsData) => {} ) {
-
-		if (!(await LoadYargs())) return
-
-		// YargsProcessWorkaround()
-
+	async run() {
 
-		const args = globalThis.yargsHideBin( process.argv )
-		const instance = globalThis.yargsLib( args )
+		const args = globalThis.YargsBin( process.argv )
+		const instance = globalThis.Yargs( args )
 
 		for (const [cmdKey, cmdObj] of Object.entries(this.$commands)) {
 
@@ -303,7 +273,8 @@ export class YargsCLI {
 						}
 					}
 
-					await runCallback( cmdKey, yargsData )
+					if (cmdObj.runCallback) await cmdObj.runCallback( yargsData )
+					if (this.runCallback) await this.runCallback( yargsData )
 
 				})
 		}

package/lib/index.js

@@ -6,6 +6,9 @@
 //                                      //
 //////////////////////////////////////////
 
+import { fileURLToPath } from 'node:url'
+import { dirname } from 'node:path'
+
 export * from './helpers/index.js'
 export * from './inputs/index.js'
 export * from './specification/index.js'

package/lib/loaders/_Loaders.js

@@ -0,0 +1,62 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//               LOADERS                //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+import { CreateLogger } from 'agnostics/logger'
+const { YAY, ERR, SAY } = CreateLogger( import.meta.url )
+
+import path from 'path'
+import fs from 'fs/promises'
+import { pathToFileURL } from 'node:url'
+
+export async function LoadDep( name, url ) {
+
+	const [ base, stem ] = url.split('.')
+	let mod
+
+	if (!globalThis[base]) {
+		try {
+			mod = (await import (base))
+		} catch(err) {
+			try {
+				const pkgDir = path.join(process.cwd(), 'node_modules', base)
+				const pkgJsonPath = path.join(pkgDir, 'package.json')
+				const pkgJson = JSON.parse(await fs.readFile(pkgJsonPath))
+				let entry = pkgJson.main || pkgJson.module || 'index.js'
+				if (pkgJson.exports && pkgJson.exports['.']) {
+					const exportIndex = pkgJson.exports['.']?.index || pkgJson.exports['.']
+					entry = exportIndex.replace(/^\.\//, '')
+				}
+				const fullEntryPath = path.join(pkgDir, entry)
+				const entryUrl = pathToFileURL(fullEntryPath).href
+				mod = (await import (entryUrl))
+			} catch(err) {
+				return ERR(`FAIL:`, name, err.message)	
+			}
+		}
+		if (stem) mod = mod[stem]
+		globalThis[name] = mod
+		YAY(`LOADED:`, name)
+		return globalThis[name]
+	}
+}
+
+export async function LoadWebview() {
+	return await LoadDep('Webview', '@webviewjs/webview.Application')
+}
+
+export async function LoadYargs() {
+
+	const YargsLib = await LoadDep('Yargs', 'yargs.default')
+	const YargsBin = await LoadDep('YargsBin', 'yargs/helpers.hideBin')
+
+	return { YargsLib, YargsBin }
+}
+
+export async function LoadGlobby() {
+	return await LoadDep('Globby', 'globby.globby')
+}

package/lib/loaders/index.js

@@ -0,0 +1,9 @@
+//////////////////////////////////////////
+//                                      //
+//                                      //
+//               LOADERS                //
+//                                      //
+//                                      //
+//////////////////////////////////////////
+
+export * from './_Loaders.js'

package/lib/logger/_Logger.js

@@ -51,7 +51,7 @@ function CreateMethod( method, name, filename, timestamp, prepend, color, log, t
 
 		} else {
 
-			const isDarkMode = window.matchMedia('(prefers-color-scheme: dark)').matches
+			const isDarkMode = typeof window !== 'undefined' && window.matchMedia?.('(prefers-color-scheme: dark)')?.matches
 			const cssColor = isDarkMode ? ANSIDark[color] : ANSILight[color]
 
 			const parts = [`%c${ts}${label}${prepend || ''}`, `color:${cssColor}`]

package/lib/logger/index.js

@@ -1,5 +1,3 @@
 export * from './_Defs.js'
 export * from './_Settings.js'
-export * from './_Logger.js'
-export * from './_System.js'
-export * from './_ASCII.js'
+export * from './_Logger.js'

package/lib/specification/_Properties.js

@@ -8,6 +8,29 @@
 
 export const Properties = {
 
+	// --------- EVENTS ---------
+
+	onsend: {
+		description: 'callback for checking value before sending', 
+		matches: [ 'oncheck', 'validate', 'coerce', 'check']
+	},
+	onreceive: {
+		description: 'callback for checking value when received', 
+		matches: [ 'onreceive', 'validate', 'coerce', 'check']
+	},
+	onupdate: {
+		description: 'callback for updated value', 
+		matches: [ 'onupdate', 'update', 'change', 'onchange']
+	},
+	onencode: {
+		description: 'callback for encoding (sending origin)', 
+		matches: [ 'onencode', 'encode']
+	},
+	ondecode: {
+		description: 'callback for decoding (receiving end)', 
+		matches: [ 'ondecode', 'decode']
+	},
+
 	// --------- DEFINITION ---------
 
 	type: {
@@ -68,14 +91,6 @@ export const Properties = {
 		description: 'property can only be read',
 		matches: ['readonly', 'ro']
 	},
-	oncheck: {
-		description: 'callback for checking value', 
-		matches: [ 'oncheck', 'validate', 'coerce', 'check']
-	},
-	onupdate: {
-		description: 'callback for updated value', 
-		matches: [ 'onupdate', 'update', 'change', 'onchange']
-	},
 
 	// --------- STRUCTURAL ---------
 

package/lib/targets/_InquirerTarget.js

@@ -0,0 +1,15 @@
+
+
+// @inquirer/prompts
+
+async function LoadInquirer() {
+
+	if (!globalThis.inquirerLib) {
+		try {
+			globalThis.inquirerLib = (await import ('inquirer')).inquirer
+			return true
+		} catch(err) {
+			return ERR(`GLOBS UNAVAILABLE`, err)	
+		}
+	}
+}