@naanlang/naan 1.0.16 → 1.2.0

package/lib/env_node.js

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2017-2023 by Richard C. Zulch
+ * Copyright (c) 2017-2024 by Richard C. Zulch
  *
  */
 
@@ -20,6 +20,10 @@
  * Currently defined options are:
  *  {
  *      replDisable:    <boolean>               // disable REPL and just respond to textCommand in API
+ *      noWelcome:      <boolean>               // suppress the welcome banner/messages
+ *      state:          <object>                // saved state to load
+ *      require:        <function>              // use the specified require function
+ *      import:         <function>              // use the specified import function
  *  }
  *
  */
@@ -29,6 +33,14 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
     "use strict";
     /*jshint -W024 */
     var undefined;
+ 
+    //
+    // Persistent
+    //
+
+    var
+        kStateFirstVersion = 200,                                           // increment when losing backwards compatbility
+        kStateCurrentVersion = 200;                                         // increment when adding features
 
     //
     // Initialization
@@ -48,7 +60,8 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
     var useConsoleOut = false;
     if (outEnable && process.env["RUNKIT_ENDPOINT_URL"])
         useConsoleOut = true;                                               // use console.log for output in RunKit
-
+    var dontSaveUntilWorking;                                               // true when state loaded, must be reset to save state again
+    var prefs = { };
 
     //==========================================================================
     // API
@@ -58,6 +71,10 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
         naanlib.js.r = req;
     };
 
+    this.setImport = function setImport(imp) {                              // override import function
+        naanlib.js.i = imp;
+    };
+
     this.setDirectory = function setDirectory(path) {                       // override base directory
         naanlib.js.d = path;
     };
@@ -94,11 +111,11 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
     
     if (!options.replDisable)
     {
-        replServer = repl.start({ prompt: 'Naan> ', eval: myEval});
+        replServer = repl.start({ prompt: '', eval: myEval});
     
-        replServer.on('line', function(cmd) {                                  // process raw command line
+        replServer.on('line', function(cmd) {                               // process raw command line
             if (cmd.charAt(0) != ".") {
-                textToRemoteTerm(cmd);
+                textToRemoteTerm("\x1b[90m\x1b[3m".concat(cmd, "\x1b[0m\n"));
                 naanlib.textLine(cmd + "\n");
             }
         });
@@ -139,7 +156,8 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
             if (termops)
             {
                 setTimeout(function () {
-                    termops.debugtext(text, level);
+                    if (termops)                                            // avoid crashing if it went away during delay
+                        termops.debugtext(text, level);
                 }, 1);
             }
         } else if (outEnable) {
@@ -237,7 +255,7 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
         else if (msg.id == "keyline")
         {                                                                   // typing from remote terminal
             setTimeout(function () {
-                process.stdout.write(msg.text + "\r\n");
+                process.stdout.write("\x1b[90m\x1b[3m".concat(msg.text.trim(), "\x1b[0m\r\n"));
                 outEnable = true;
                 naanlib.textLine(msg.text);                                 // keyboard text from terminal
             }, 1);
@@ -288,14 +306,85 @@ exports.NaanNodeREPL = function NaanNodeREPL(options) {
         }
     }, 1000);
     
+
+    //==========================================================================
+    // State load/save
+    //--------------------------------------------------------------------------
+     
+    // SavePref
+    //
+    // Save a persistent preference object that can be retrieved in the future.
+    //
+    this.SavePref = function SavePref(key, value) {
+        return (prefs[key] = value);
+    };
+ 
+    // LoadPref
+    //
+    // Load a previously-saved preference object for future retrieval.
+    //
+    this.LoadPref = function LoadPref(key) {
+        return (prefs[key]);
+    };
+
+    // Working
+    //
+    // Note that the application is working, so it is safe to save state.
+    //
+    this.Working = function Working() {
+        dontSaveUntilWorking = false;
+    };
+
+    // MakeState
+    //
+    // Save our state into a new object.
+    //
+    this.MakeState = function MakeState() {
+        if (dontSaveUntilWorking)
+            return (false);                                                 // didn't get far enough to call Working()
+        var statedoc = {};
+        statedoc.curversion = kStateCurrentVersion;
+        statedoc.firstver = kStateFirstVersion;
+        statedoc.date = new Date().toISOString();
+        statedoc.prefs = prefs;
+        statedoc.naan = naanlib.saveState(true);                            // true to optimize, which is a bit slower
+        return (statedoc);
+    };
+ 
+    // loadState
+    //
+    // Load our state from an object.
+    //
+    function loadState(statedoc) {
+        dontSaveUntilWorking = true;                                        // make sure we don't store bad state
+        if (typeof(statedoc) != "object" || typeof(statedoc.naan) != "string"
+            || statedoc.firstver > kStateCurrentVersion
+            || statedoc.curversion < kStateFirstVersion)
+        {
+            return (false);
+        }
+        if (typeof(statedoc.prefs) == "object")
+            prefs = statedoc.prefs;
+        return (statedoc.naan);
+    }
+
     
     //==========================================================================
     // Start the Naan Interpreter
     //--------------------------------------------------------------------------
+    if (options.require)
+        naanlib.js.r = options.require;
+    if (options.import)
+        naanlib.js.i = options.import;
     var startOptions = {};
     if (options.noWelcome)
         startOptions.noWelcome = true;
-    naanlib.banner();
+    else
+        naanlib.banner();
+    if (options.state)
+        startOptions.state = loadState(options.state);
+    if (options.cmd)
+        startOptions.cmd = options.cmd;
     naanlib.start(startOptions);
 };
 

package/lib/env_nodeworker.js

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2019-2021 by Richard C. Zulch
+ * Copyright (c) 2019-2024 by Richard C. Zulch
  *
  */
 
@@ -28,6 +28,18 @@ exports.NaanWorkerActivate = function NaanWorkerActivate(cbReady) {
         cbReady(naancon);
     });
     
+    if (process.execArgv.includes("--inspect-brk"))
+    {
+        import("node:inspector").then(
+            function (inspector) {
+                inspector.open();
+                inspector.waitForDebugger();
+                /*jshint debug:true */
+                debugger;
+            }
+        );
+    }
+    
     /*
      * NaanControllerNodeWorker
      *
@@ -59,7 +71,11 @@ exports.NaanWorkerActivate = function NaanWorkerActivate(cbReady) {
         this.setRequire = function setRequire(req) {                        // override require function
             naanlib.js.r = req;
         };
-    
+
+        this.setImport = function setImport(imp) {                          // override import function
+            naanlib.js.i = imp;
+        };
+
         this.setDirectory = function setDirectory(path) {                   // override base directory
             naanlib.js.d = path;
         };
@@ -140,7 +156,7 @@ exports.NaanWorkerActivate = function NaanWorkerActivate(cbReady) {
                 if (msg.altcmd)
                     naanlib.textLine(msg.altcmd);
                 /*
-                 ### already started ###
+                 ### already started by textLine() if not before ###
                 naanlib.start({
                     state: msg.state,
                     cmd: msg.altcmd
@@ -161,10 +177,12 @@ exports.NaanWorkerActivate = function NaanWorkerActivate(cbReady) {
             }
         });
         
+        naanlib.banner();
+        naanlib.start(false);                                               // start explicitly
+
         msgPort.postMessage({
             id: "loaded"                                                    // initialization complete
         });
-        naanlib.banner();
     }
 
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@naanlang/naan",
-    "version": "1.0.16",
+    "version": "1.2.0",
     "author": "Richard C. Zulch",
     "description": "Naan™ software platform",
     "main": "./lib/core/naanlib.js",

package/plugins/serviceAws/aws/lambda_rest_index.js

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2019-2021 by Richard C. Zulch
+ * Copyright (c) 2019-2023 by Richard C. Zulch
  *
  */
 
@@ -71,6 +71,10 @@ exports.handler = function awsHandler(event, context, callback) {
         naanlib.js.r = req;
     };
 
+    this.setImport = function setImport(imp) {                              // override import function
+        naanlib.js.i = imp;
+    };
+
     this.setDirectory = function setDirectory(path) {                       // override base directory
         naanlib.js.d = path;
     };

package/plugins/serviceAws/aws_dynamo.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2021-2023 by Richard C. Zulch
+ * Copyright (c) 2021-2024 by Richard C. Zulch
  *
  */
 
@@ -36,6 +36,7 @@
  */
 
 closure TimeKeys(prefix, baseMS, local timekeys, prelen) {
+    global(UUID)
     if !UUID.proc
         throw("TimeKeys requires UUID()")
     timekeys = new(object, this)
@@ -158,6 +159,7 @@ closure TimeKeys(prefix, baseMS, local timekeys, prelen) {
  */
 
 closure DynaConverter(local conv) {
+    global()
     conv = new(object, this)
     
     // fieldTypeDynToNaan
@@ -250,7 +252,7 @@ closure DynaConverter(local conv) {
         if dtype == "BS" || dtype == "SS"
             dvalue
         else if dtype == "NS"
-            new(dvalue).map(Number.parseFloat(item))
+            new(dvalue).map(function(item) { Number.parseFloat(item) })
         else if dtype == "M"
             recordDynToNaan(dvalue)
         else if dtype == "L"
@@ -294,12 +296,24 @@ closure DynaConverter(local conv) {
     // genAttributeNameAdder
     //
     //     Return a function that, when called repeatedly, adds attribute name definitions to the
-    // specified parameter block.
+    // specified parameter block. You can specify an attribute name that is a nested key expression
+    // resulting from makePath() below. This adds the individual components to the
+    // ExpressionAttributeNames list, but generates a return string that references nested elements.
     //
     closure genAttributeNameAdder(params, local adex) {
         function attrib(name, local key, data) {
-            if !string(name)
-                name = tostring(name)                                       // try to make it a string
+            if numeric(name) || name && symbol(name)
+                name = tostring(name)
+            else if !string(name) || string.trim().length == 0 {            // compound or invalid
+                if tuple(name) && name.length == 3 {
+                    if name.0 == `.                                         // quote(a.b) => (`. a b)
+                        return (strcat(attrib(name.1), ".", attrib(name.2)))
+                    else if name.0 == `deref && integer(name.2)             // quote(a[99]) => (`deref a 99)
+                        return (strcat(attrib(name.1), "[", attrib(name.2), "]"))
+                }
+                debuglog("DynaConverter.genAttributeNameAdder: can't make expression from", typeof(name), name)
+                name = tostring(name)
+            }
             if !params.ExpressionAttributeNames
                 params.ExpressionAttributeNames = { }
             if !adex
@@ -313,6 +327,33 @@ closure DynaConverter(local conv) {
         }
     }
 
+
+    // makePath
+    //
+    //     Make an attribute path expression that genAttributeNameAdder can use to make an evaluated
+    // attribute path. Specify a path expression and then list the symbols that should be evaluated,
+    // if any. For example:
+    //      >   b=4
+    //      >   makePath(a.b.c, b)
+    //      $:  a.4.c
+    //
+    conv.makePath = macro makePath args {
+        function mkatpa(path, local exp) {
+            exp = path.map(function(el) {
+                if tuple(el)
+                    exp = mkatpa(el)
+                else if member(el, args)
+                    car(el)
+                else
+                    el
+            })
+            if !tuple(exp) || exp.0 != `deref || integer(exp.2)
+                exp
+            else
+                cons(`., cdr(exp))                                          // use `. for dictionary lookup
+        } (pop(args))
+    }
+
     // genAttributeValueAdder
     //
     //     Return a function that, when called repeatedly, adds attribute value definitions to the
@@ -357,7 +398,7 @@ closure DynaConverter(local conv) {
     //
     // condition dictionary:
     //  {
-    //      key:        <keyname, e.g. partition key name or path tuple>    // required
+    //      key:        <keyname, e.g. partition key name or path>          // required
     //      "=":        <expression>                                        // exclusive of other comparisons
     //      ">":        <expression>                                        // exclusive of other comparisons
     //      "<":        <expression>                                        // exclusive of other comparisons
@@ -368,9 +409,12 @@ closure DynaConverter(local conv) {
     //      exists:     <boolean>                                           // keyname existence matches boolean
     //  }
     //
+    // The key entry above can be a keyname or a path expression resulting from a call to makePath().
+    // Please note that array subscripts, which index into lists, must be integers.
+    //
 
     conv.createKeyExpression = function createKeyExpression(params, conds
-        local attval, attname, rangename, range, keyname, op, expr, rangex, arg1, arg2) {
+        local attval, attname, rangename, ranges, range, keyname, op, expr, rangex, arg1, arg2) {
 
         // dupeop
         //
@@ -389,18 +433,9 @@ closure DynaConverter(local conv) {
                 ranges = [ranges]
             for range in ranges {
                 rangex = false
-                if tuple(range.key) {
-                    keyname = []
-                    expr = range.key
-                    while expr
-                        keyname.push(attname(pop(expr)))
-                    keyname = keyname.join(".")
-                }
-                else
-                    keyname = tostring(range.key)
-                if !keyname
+                if !range.key
                     return (list(Error("key expression requires key name")))
-                keyname = attname(keyname)
+                keyname = attname(range.key)
                 for `(op, expr) in range {
                     if op == "key"
                         continue
@@ -465,7 +500,7 @@ closure DynaConverter(local conv) {
     // value is a standard (error, data) tuple where the data is just { ok: true } if no error.
     //
     conv.createUpdateExpression = function createUpdateExpression(params, updates,
-        local attval, attname, output, item) {
+        local attval, attname, output, item, key, value) {
 
         if params.UpdateExpression
             return (list(Error("conv.createUpdateExpression: UpdateExpression already exists")))
@@ -519,13 +554,28 @@ closure DynaConverter(local conv) {
  *
  *     DynamoDB table.
  *
+ * options:
+ *  {
+ *      hashKey:    <symbol>                    // hash key symbol
+ *      rangeKey:   <symbol>                    // range key symbol (requres hash key)
+ *  }
+ *
  */
 
-closure DynaTable(dyna, tablename, local table) {
+closure DynaTable(dyna, tablename, options, local table) {
+    global()
     table = new(object, this)
     table.name = tablename
     if dyna.ycdb
         table.ycdb = true                                                   // Yandex Cloud version of DynamoDB
+    if options.hashKey || options.rangeKey {
+        if options.hashKey && symbol(options.hashKey) && symbol(options.rangeKey) { // NB: false is a symbol
+            table.hashKey = options.hashKey
+            if options.rangeKey
+                table.rangeKey = options.rangeKey
+        } else
+            debuglog("DynaTable: invalid (hashKey/rangeKey) option:", tablename, list(options.hashKey, options.rangeKey))
+    }
 
     // info
     //
@@ -544,13 +594,25 @@ closure DynaTable(dyna, tablename, local table) {
     //      rangeType:  <name>                  // string | numeric (if exists)
     //  }
     //
-    table.info = closure info(local params, pending) {
+    // 20240313: Note that the YCDB / AWS DynamoDB SDK combination has been found to occasionally
+    // fail to execute the callback within 30 seconds with multiple overlapping info() calls. In the
+    // current example three calls to a single table are made from inside asyncArray(), and all of
+    // them get hung up here lacking a callback. Unclear whether the cause is the SDK, the lack of
+    // using the newer promises API, or the underlying YDB service. The main reason this is called
+    // is to discover the hash and range keys, which can be statically specified. The pragmatic
+    // resolution is to allow the caller to specify the keys, which is faster and should avoid this
+    // particular challenge. But also info() now combines overlapping calls.
+    //
+    table.info = closure info(local params, pending, result) {
         if !dyna.aws
             return (list(Error("DynaTable.info: not logged into AWS")))
         params = {
             TableName: tablename
         }
+        if (pending = table.info_pending)
+            return (pending.wait())                                         // use the first call's results
         pending = new(nonce)
+        table.info_pending = pending                                        // combine overlapping info() calls
         dyna.aws.describeTable(params, function(error, data, local output, key) {
             if error {
                 dynaTableError = error
@@ -581,7 +643,9 @@ closure DynaTable(dyna, tablename, local table) {
             }
             pending.signal(list(error, output))
         })
-        pending.wait()
+        result = pending.wait()
+        table.info_pending = false
+        result
     }
 
     // create
@@ -817,7 +881,7 @@ closure DynaTable(dyna, tablename, local table) {
  
         
     table.deleteRecord = closure deleteRecord(hashValue, rangeValue, options,
-        local params, pending) {
+        local params, error, pending) {
         if preflightError(this)
             return
         params = {
@@ -881,7 +945,6 @@ closure DynaTable(dyna, tablename, local table) {
     //      indexHashKey:   <string>                                        // name of index hashKey
     //      range:          <key-expression>                                // range of keys to retrieve
     //      filter:         <key-expression>                                // conditions for items to return
-    //      attmap:         <dictionary>                                    // map attribute names to #shortcuts
     //      reverse:        <boolean>                                       // reverse order
     //      project:        <array>                                         // project only specified attributes
     //      paging:         <exclusive start key>                           // for paging; updated each call
@@ -924,8 +987,6 @@ closure DynaTable(dyna, tablename, local table) {
             if error
                 return (list(Error("table.queryRecords filter:", error)))
         }
-        if options.attmap
-            params.ExpressionAttributeNames = options.attmap
         if options.reverse
             params.ScanIndexForward = false
         if options.project
@@ -955,7 +1016,6 @@ closure DynaTable(dyna, tablename, local table) {
     //  {
     //      index:          <string>                                        // index name in table
     //      filter:         <key-expression>                                // conditions for items to return
-    //      attmap:         <dictionary>                                    // map attribute names to #shortcuts
     //      project:        <array>                                         // project only specified attributes
     //      paging:         <exclusive start key>                           // for paging; updated each call
     //      consistentRead: <boolean>                                       // true to use consistent read
@@ -980,8 +1040,6 @@ closure DynaTable(dyna, tablename, local table) {
             if error
                 return (list(Error("table.scanRecords filter:", error)))
         }
-        if options.attmap
-            params.ExpressionAttributeNames = attmap
         if options.project
             params.ProjectionExpression = options.project.join(", ")
         if options.paging
@@ -1016,6 +1074,7 @@ closure DynaTable(dyna, tablename, local table) {
  */
 
 closure DynamoDB(local dyna) {
+    global(awsSDK)
     dyna = new(object, this)
     dyna.timeout = 20000                                                    // default 20-second timeout
     dyna.conv = DynaConverter()
@@ -1045,12 +1104,12 @@ closure DynamoDB(local dyna) {
     // table
     //
     //     Return a new table access object for the table of the specified name. The table may not 
-    // yet exist; see DynaTable for methods.
+    // yet exist; see DynaTable for options and methods.
     //
-    dyna.table = function table(name) {
+    dyna.table = function table(name, options) {
         if !dyna.aws
             debuglog("DynamoDB.table: database not open:", name)
-        DynaTable(dyna, name)
+        DynaTable(dyna, name, options)
     }
     
     // timekeys

package/plugins/serviceAws/dbt_aws.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2020-2023 by Richard C. Zulch
+ * Copyright (c) 2020-2024 by Richard C. Zulch
  *
  */
 
@@ -318,7 +318,7 @@ closure dawsTable(database, path, tableOptions, local table) {
     //
     // For browsers, convert a ReadableStream to an array buffer.
     //
-    function readableStreamToArrayBuffer(stream, local result, reader, error, data, chunk) {
+    closure readableStreamToArrayBuffer(stream, local result, reader, error, data, chunk) {
         result = xnew(js.w.Uint8Array, 0)
         reader = stream.getReader()
         loop {
@@ -480,7 +480,7 @@ closure dawsTable(database, path, tableOptions, local table) {
     table.delete = closure delete(doc, callback) {
         if !callback
             return (syncAdapter(delete, doc))
-        if !doc._id || !doc._id.startsWith(table.s3prefix) || !(doc._md5 || doc._id.slice(-1) == "/")
+        if !doc._id || !doc._id.startsWith(table.s3prefix) || !(doc.md5 || doc._md5 || doc._id.slice(-1) == "/")
             return (asyncResult(callback, Error("invalid argument")))
         database.bucket.delete(doc._id, function(error, resp) {
             if error
@@ -537,8 +537,8 @@ closure dawsTable(database, path, tableOptions, local table) {
         database.bucket.get(id, true, function(error, resp) {
             if error
                 error = Error("md5 failed", error, id, { status: error.status })
-            else if resp._md5
-                resp = resp._md5
+            else if resp.md5
+                resp = resp.md5
             else
                 resp = ""
             callback(error, resp)

package/plugins/serviceAws/psm_aws.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2020-2021 by Richard C. Zulch
+ * Copyright (c) 2020-2024 by Richard C. Zulch
  *
  */
 
@@ -202,7 +202,7 @@ closure psmaConnector(psm, local connClassID, connector, watch) {
         info = {
             classID: "AWS S3"
             type: "AWS S3 bucket"
-            services: ["DBT", "FS"]
+            services: ["NideDB", "NideFS"]
         }
         `(error, creds) = connector.vault.accessResource(resID)
         if creds {

package/test/harness.nlg

@@ -18,7 +18,7 @@
  */
 
 loglevel(2);;
-Naan.module.chns("Play");;
+Naan.module.chns("Start");;
 
 
 /*

package/test/test_01_core.nlg

@@ -616,12 +616,12 @@ RegisterTestCategory("core", [
     ["oo;", "{ true: a, 0.3333333333333333: b }"],
 
     //
-    // object getters
+    // object getters/setters
     //
     
     [ "oo=new(object);", "Object{0}" ],
-    [ "oo['..prop'] = function(value) { oo.value };>", "(function lambda (value) (`. oo value))" ],
-    [ "oo['.=prop'] = function(value) { oo.value = value };>", "(function lambda (value) (Lib::set\\. oo (`` value) value))" ],
+    [ "oo@['..prop'] = function() { oo.value };>", "(function lambda false (`. oo value))" ],
+    [ "oo@['.=prop'] = function(value) { oo.value = value };>", "(function lambda (value) (Lib::set\\. oo (`` value) value))" ],
     [ "oo.prop = 8;", "8" ],
     [ "oo.prop;", "8" ],
     [ "oo['prop'] = 9;", "9" ],
@@ -633,8 +633,34 @@ RegisterTestCategory("core", [
     [ "xset(oo, 'prop', 11);", "11" ],
     [ "oo.prop;", "11" ],
     [ "oo.value;", "10" ],
-    [ "oo.*;", '("..prop", ".=prop", "value", "prop")' ],
+    [ "oo.*;", '("value", "prop")' ],
 
+    //
+    // object hierarchy
+    //
+
+    [ "oo=new(object);", "Object{0}" ],
+    [ "op=new(object);", "Object{0}" ],
+    [ "oc=new(object);", "Object{0}" ],
+    [ "oo@['.class'] = oc;", "Object{0}" ],
+    [ "oc@['.parent'] = op;", "Object{0}" ],
+    [ "op.print = function (x) { print(self.id) };>", "(function lambda (x) (print (`. self id)))" ],
+    [ "oo.id = `oo;", "oo" ],
+    [ "oc.id = `oc;", "oc" ],
+    [ "op.id = `op;", "op" ],
+    [ "oo.*", '("id")' ],
+    [ "oc.*", '("id")' ],
+    [ "op.*", '("print", "id")' ],
+    [ "oo.print()", "oo|oo" ],
+
+    [ "op@['..prop'] = function() { self.value };>", "(function lambda false (`. self value))" ],
+    [ "oc@['.=prop'] = function(value) { self.value = value };>", "(function lambda (value) (Lib::set\\. self (`` value) value))" ],
+    [ "op.prop = op55;", "op55" ],
+    [ "oo.prop;", "false" ],
+    [ "op.prop;", "op55" ],
+    [ "oo.prop = oo11;", "oo11" ],
+    [ "oo.prop;", "oo11" ],
+    [ "oc.prop;", "false" ],
 
     //
     // object hooks