X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=src%2Forg%2Fxwt%2FTemplate.java;h=e7e72b5b5e88a3a6f9c473b3ba4f1cc8ed61247e;hb=81c4e615c6f9c9daddd24f4696bbd911a13c958d;hp=95846c1ce446f132c2be6b627c1401701191d223;hpb=8235361e8601ae7b36ab707058de3b52225d15a2;p=org.ibex.core.git

diff --git a/src/org/xwt/Template.java b/src/org/xwt/Template.java
index 95846c1..e7e72b5 100644
--- a/src/org/xwt/Template.java
+++ b/src/org/xwt/Template.java
@@ -21,107 +21,75 @@ import org.xwt.util.*;
  *  See the XWT reference for information on the order in which
  *  templates are applied, attributes are put, and scripts are run.
  */
-
-// FIXME imports
 public class Template {
 
     // Instance Members ///////////////////////////////////////////////////////
 
-    /** the id of this box */
-    String id = null;
-
-    /** the id of the redirect target; only meaningful on a root node */
-    String redirect = null;
-
-    /** templates that should be preapplied (in the order of application); only meaningful on a root node */
-    private Template[] preapply;
-
-    /** templates that should be postapplied (in the order of application); only meaningful on a root node */
-    private Template[] postapply;
-
-    /** keys to be "put" to instances of this template; elements correspond to those of vals */
-    private String[] keys;
+    String id = null;                  ///< the id of this box
+    String redirect = null;            ///< the id of the redirect target; only meaningful on a root node
+    private String[] keys;             ///< keys to be "put" to instances of this template; elements correspond to those of vals
+    private Object[] vals;             ///< values to be "put" to instances of this template; elements correspond to those of keys
+    private Vec children = new Vec();  ///< during XML parsing, this holds the list of currently-parsed children; null otherwise
+    private int numunits = -1;         ///< see numUnits(); -1 means that this value has not yet been computed
 
-    /** values to be "put" to instances of this template; elements correspond to those of keys */
-    private Object[] vals;
+    private JS.CompiledFunction script = null;       ///< the script on this node
+    private String fileName = "unknown";             ///< the filename this node came from; used only for debugging
+    private Vec preapply = new Vec();                ///< templates that should be preapplied (in the order of application)
 
-    /** child template objects */
-    private Template[] children;
 
-    /** see numUnits(); -1 means that this value has not yet been computed */
-    private int numunits = -1;
+    // Instance Members that are only meaningful on root Template //////////////////////////////////////
 
-    /** the scope in which the static block is executed */
-    private JS.Scope staticScope = null;
-
-    /** the script on the static node of this template, null if it has already been executed */
-    private JS.CompiledFunction staticscript = null;
-
-    /** the script on this node */
-    private JS.CompiledFunction script = null;
-
-    /** the filename this node came from; used only for debugging */
-    private String fileName = "unknown";
+    private JS.Scope staticScope = null;             ///< the scope in which the static block is executed
+    private JS.CompiledFunction staticscript = null; ///< the script on the static node of this template, null already performed
 
 
     // Only used during parsing /////////////////////////////////////////////////////////////////
 
-    /** during XML parsing, this holds the list of currently-parsed children; null otherwise */
-    private Vec childvect = new Vec();
-
-    /** during XML parsing, this holds partially-read character data; null otherwise */
-    private StringBuffer content = null;
-
-    /** line number of the first line of <tt>content</tt> */
-    private int content_start = 0;
-
-    /** number of lines in <tt>content</tt> */
-    private int content_lines = 0;
-
-    /** the line number that this element starts on */
-    private int startLine = -1;
+    private StringBuffer content = null; ///< during XML parsing, this holds partially-read character data; null otherwise
+    private int content_start = 0;       ///< line number of the first line of <tt>content</tt>
+    private int content_lines = 0;       ///< number of lines in <tt>content</tt>
+    private int startLine = -1;          ///< the line number that this element starts on
+    private final Res r;                 ///< the resource we came from
 
 
     // Static data/methods ///////////////////////////////////////////////////////////////////
 
-    private Template(String fileName) { this.fileName = fileName; }
-
     public static Template getTemplate(Res r) {
         try {
+            r = r.addExtension(".xwt");
             if (r.t != null) return r.t;
-            r.t = new Template(r.getDescriptiveName());
+            r.t = new Template(r);
             new TemplateHelper().parseit(r.getInputStream(), r.t);
             return r.t;
-        } catch (XML.SchemaException e) {
-            if (Log.on) Log.log(Template.class, "error parsing template " + r.t.fileName);
-            if (Log.on) Log.log(Template.class, e.getMessage());
-            return null;
-        } catch (XML.XMLException e) {
-            if (Log.on) Log.log(Template.class, "error parsing template at " + r.t.fileName + ":" + e.getLine() + "," + e.getCol());
-            if (Log.on) Log.log(Template.class, e.getMessage());
+        } catch (Exception e) {
+            if (Log.on) Log.log(r.t.fileName, e);
             return null;
-        } catch (IOException e) {
-            if (Log.on) Log.log(Template.class, "IOException while parsing template " + r.t.fileName + " -- this should never happen");
-            if (Log.on) Log.log(Template.class, e);
+        }
+    }
+
+    public static Res resolveStringToResource(String str, XWT xwt, boolean permitAbsolute) {
+        // URL
+        if (str.indexOf("://") != -1) {
+            if (permitAbsolute) return Res.stringToRes(str);
+            Log.log(Template.class, "absolute URL " + str + " not permitted here");
             return null;
         }
+
+        // root-relative
+        Res ret = xwt.rr;
+        while(str.indexOf('.') != -1) {
+            String path = str.substring(0, str.indexOf('.'));
+            str = str.substring(str.indexOf('.') + 1);
+            ret = (Res)ret.get(path);
+        }
+        ret = (Res)ret.get(str);
+        return ret;
     }
 
 
     // Methods to apply templates ////////////////////////////////////////////////////////
 
-    /** calculates, caches, and returns an integer approximation of how long it will take to apply this template,
-     *  including pre/post and children */
-    int numUnits() {
-        if (numunits != -1) return numunits;
-        numunits = 1;
-        for(int i=0; preapply != null && i<preapply.length; i++) numunits += preapply[i].numUnits();
-        for(int i=0; postapply != null && i<postapply.length; i++) numunits += postapply[i].numUnits();
-        if (script != null) numunits += 10;
-        numunits += keys == null ? 0 : keys.length;
-        for(int i=0; children != null && i<children.length; i++) numunits += children[i].numUnits();
-        return numunits;
-    }
+    private Template(Res r) { this.r = r; }
 
     /** called before this template is applied or its static object can be externally referenced */
     JS.Scope getStatic() {
@@ -137,48 +105,31 @@ public class Template {
      *  @param pboxes a vector of all box parents on which to put $-references
      *  @param ptemplates a vector of the fileNames to recieve private references on the pboxes
      */
-    // FIXME: $-vars not dealt with
-    void apply(Box b, JS.Callable callback, int numerator, int denominator, Res resourceRoot) {
+    void apply(Box b, JS.Callable c, XWT xwt) { apply(b, c, xwt, null); }
+    void apply(Box b, JS.Callable callback, XWT xwt, PerInstantiationScope parentPis) {
 
         getStatic();
-        int original_numerator = numerator;
 
-        for(int i=0; preapply != null && i<preapply.length; i++) {
-            preapply[i].apply(b, callback, numerator, denominator, resourceRoot);
-            numerator += preapply[i].numUnits();
+        if (id != null) parentPis.putDollar(id, b);
+        for(int i=0; i<preapply.size(); i++) {
+            Template t = getTemplate(resolveStringToResource((String)preapply.elementAt(i), xwt, false));
+            if (t == null) throw new RuntimeException("unable to resolve resource " + preapply.elementAt(i));
+            t.apply(b, callback, xwt);
         }
 
-        for (int i=0; children != null && i<children.length; i++) {
+        PerInstantiationScope pis = new PerInstantiationScope(b, xwt, parentPis, staticScope);
+        for (int i=0; children != null && i<children.size(); i++) {
             Box kid = new Box();
-            children[i].apply(kid, callback, numerator, denominator, resourceRoot);
-            numerator += children[i].numUnits();
+            ((Template)children.elementAt(i)).apply(kid, callback, xwt, pis);
             b.put(b.numChildren(), kid);
         }
 
-        // whom to redirect to; doesn't take effect until after script runs
-        Box redir = (redirect != null && !"self".equals(redirect)) ? (Box)b.get("$" + redirect) : null;
-
-        if (script != null) script.call(new JS.Array(), new PerInstantiationScope(b, resourceRoot));
-
-        for(int i=0; keys != null && i<keys.length; i++) b.put(keys[i], vals[i]);
-
-        if (redirect != null && !"self".equals(redirect)) b.redirect = redir;
-
-        for(int i=0; postapply != null && i<postapply.length; i++) {
-            postapply[i].apply(b, callback, numerator, denominator, resourceRoot);
-            numerator += postapply[i].numUnits();
-        }
-
-        numerator = original_numerator + numUnits();
-
-        if (callback != null) try {
-            JS.Array args = new JS.Array();
-            args.addElement(new Double(numerator));
-            args.addElement(new Double(denominator));
-            callback.call(args);
-        } catch (JS.Exn e) { if (Log.on) Log.log(this, "WARNING: uncaught ecmascript exception: " + e); }
+        if (script != null) script.call(new JS.Array(), pis);
 
-        if (Thread.currentThread() instanceof ThreadMessage) XWT.sleep(0);
+        for(int i=0; keys != null && i<keys.length; i++)
+            if (vals[i] instanceof String && ((String)vals[i]).charAt(0) == '$') b.put(keys[i], pis.get(vals[i]));
+            else if ("image".equals(keys[i])) b.put("image", resolveStringToResource((String)vals[i], xwt, true));
+            else if (keys[i] != null) b.put(keys[i], vals[i]);
     }
 
 
@@ -190,138 +141,108 @@ public class Template {
 
         TemplateHelper() { }
 
+        private int state;
+        private static final int STATE_INITIAL = 0;
+        private static final int STATE_IN_XWT_NODE = 1;
+        private static final int STATE_IN_TEMPLATE_NODE = 2;
+        private static final int STATE_FINISHED_TEMPLATE_NODE = 3;
+
+        private String nameOfHeaderNodeBeingProcessed;
+
+        Vec nodeStack = new Vec();  ///< stack of Templates whose XML elements we have seen open-tags for but not close-tags
+        Template t = null;          ///< the template we're currently working on
+
         /** parse an XML input stream, building a Template tree off of <tt>root</tt> */
         void parseit(InputStream is, Template root) throws XML.XMLException, IOException {
-            rootNodeHasBeenEncountered = false;
-            templateNodeHasBeenEncountered = false;
-            staticNodeHasBeenEncountered = false;
-            templateNodeHasBeenFinished = false;
+            state = STATE_INITIAL;
             nameOfHeaderNodeBeingProcessed = null;
-
             nodeStack.setSize(0);
-            preapply.setSize(0);
-            postapply.setSize(0);
-
             t = root;
             parse(new InputStreamReader(is)); 
         }
 
-        /** parsing state: true iff we have already encountered the <xwt> open-tag */
-        boolean rootNodeHasBeenEncountered = false;
-
-        /** parsing state: true iff we have already encountered the <template> open-tag */
-        boolean templateNodeHasBeenEncountered = false;
-
-        /** parsing state: true iff we have already encountered the <static> open-tag */
-        boolean staticNodeHasBeenEncountered = false;
-
-        /** parsing state: true iff we have already encountered the <template> close-tag */
-        boolean templateNodeHasBeenFinished = false;
-
-        /** parsing state: If we have encountered the open tag of a header node, but not the close tag, this is the name of
-         *  that tag; otherwise, it is null. */
-        String nameOfHeaderNodeBeingProcessed = null;
-
-        /** stack of Templates whose XML elements we have seen open-tags for but not close-tags */
-        Vec nodeStack = new Vec();
-
-        /** builds up the list of preapplies */
-        Vec preapply = new Vec();
-
-        /** builds up the list of postapplies */
-        Vec postapply = new Vec();
-
-        /** the template we're currently working on */
-        Template t = null;
-
         public void startElement(XML.Element c) throws XML.SchemaException {
-            if (templateNodeHasBeenFinished) {
-                throw new XML.SchemaException("no elements may appear after the <template> node");
-
-            } else if (!rootNodeHasBeenEncountered) {
+            switch(state) {
+            case STATE_INITIAL:
                 if (!"xwt".equals(c.localName)) throw new XML.SchemaException("root element was not <xwt>");
                 if (c.len != 0) throw new XML.SchemaException("root element must not have attributes");
-                rootNodeHasBeenEncountered = true;
+                state = STATE_IN_XWT_NODE;
                 return;
-        
-            } else if (!templateNodeHasBeenEncountered) {
+
+            case STATE_IN_XWT_NODE:
                 if (nameOfHeaderNodeBeingProcessed != null) throw new XML.SchemaException("can't nest header nodes");
                 nameOfHeaderNodeBeingProcessed = c.localName;
-
-                if (c.localName.equals("import")) {
-                    if (c.len != 1 || !c.keys[0].equals("name"))
-                        throw new XML.SchemaException("<import> node must have exactly one attribute, which must be called 'name'");
-                    String importpackage = c.vals[0].toString();
-                    if (importpackage.endsWith(".*")) importpackage = importpackage.substring(0, importpackage.length() - 2);
-                    return;
-
-                } else if (c.localName.equals("redirect")) {
-                    if (c.len != 1 || !c.keys[0].equals("target"))
-                        throw new XML.SchemaException("<redirect> node must have exactly one attribute, which must be called 'target'");
-                    if (t.redirect != null)
-                        throw new XML.SchemaException("the <redirect> header element may not appear more than once");
-                    t.redirect = c.vals[0].toString();
-                    if(t.redirect.equals("null")) t.redirect = null;
-                    return;
-
-                } else if (c.localName.equals("preapply")) {
-                    if (c.len != 1 || !c.keys[0].equals("name"))
-                        throw new XML.SchemaException("<preapply> node must have exactly one attribute, which must be called 'name'");
-                    preapply.addElement(c.vals[0]);
-                    return;
-
-                } else if (c.localName.equals("postapply")) {
-                    if (c.len != 1 || !c.keys[0].equals("name"))
-                        throw new XML.SchemaException("<postapply> node must have exactly one attribute, which must be called 'name'");
-                    postapply.addElement(c.vals[0]);
-                    return;
-
+                if (c.localName.equals("doc")) {
+                    // FIXME: ignore
                 } else if (c.localName.equals("static")) {
-                    if (staticNodeHasBeenEncountered)
+                    if (t.staticscript != null)
                         throw new XML.SchemaException("the <static> header node may not appear more than once");
                     if (c.len > 0)
                         throw new XML.SchemaException("the <static> node may not have attributes");
-                    staticNodeHasBeenEncountered = true;
-                    return;
-
                 } else if (c.localName.equals("template")) {
-                    // finalize importlist/preapply/postapply, since they can't change from here on
                     t.startLine = getLine();
-                    if (preapply.size() > 0) preapply.copyInto(t.preapply = new Template[preapply.size()]);
-                    if (postapply.size() > 0) postapply.copyInto(t.postapply = new Template[postapply.size()]);
-                    templateNodeHasBeenEncountered = true;
-
+                    state = STATE_IN_TEMPLATE_NODE;
+                    processBodyElement(c);
                 } else {
                     throw new XML.SchemaException("unrecognized header node \"" + c.localName + "\"");
-
                 }
+                return;
 
-            } else {
-
+            case STATE_IN_TEMPLATE_NODE:
                 // push the last node we were in onto the stack
                 nodeStack.addElement(t);
-
                 // instantiate a new node, and set its fileName/importlist/preapply
-                Template t2 = new Template(t.fileName);
+                Template t2 = new Template(t.r);
                 t2.startLine = getLine();
-                if (!c.localName.equals("box")) t2.preapply = new Template[] { /*c.localName FIXME */ };
-
+                if (!c.localName.equals("box") && !c.localName.equals("template"))
+                    t2.preapply.addElement((c.uri == null ? "" : (c.uri + ".")) + c.localName);
                 // make the new node the current node
                 t = t2;
+                processBodyElement(c);
+                return;
 
+            case STATE_FINISHED_TEMPLATE_NODE:
+                throw new XML.SchemaException("no elements may appear after the <template> node");
             }
+        }        
 
-            t.keys = new String[c.len];
-            t.vals = new Object[c.len];
+        private void processBodyElement(XML.Element c) {
             Hash h = new Hash(c.len * 2, 3);
-            for(int i=0; i<c.len; i++) h.put(c.keys[i], c.vals[i]);
-            Vec v = new Vec(c.len, c.keys);
-            v.sort(new Vec.CompareFunc() { public int compare(Object a, Object b) { return ((String)a).compareTo((String)b); } });
             for(int i=0; i<c.len; i++) {
-                // FIXME: height must come after image
-                // FIXME: thisbox must come first
-                t.keys[i] = (String)v.elementAt(i);
-                t.vals[i] = h.get(t.keys[i]);
+                if (c.keys[i].endsWith(":image")) {
+                    String uri = (String)c.urimap.get(c.keys[i].substring(0, c.keys[i].indexOf(':')));
+                    c.keys[i] = c.keys[i].substring(c.keys[i].lastIndexOf(':') + 1);
+                    c.vals[i] = uri + "." + c.vals[i];
+                }                    
+                if ((c.keys[i].equals("preapply") || c.keys[i].endsWith(":preapply")) && c.localName.equals("template")) {
+                    String uri = "";
+                    if (c.keys[i].endsWith(":preapply")) {
+                        uri = "." + c.urimap.get(c.keys[i].substring(0, c.keys[i].indexOf(':')));
+                        c.keys[i] = c.keys[i].substring(c.keys[i].lastIndexOf(':') + 1);
+                    }
+                    StringTokenizer tok = new StringTokenizer(c.vals[i].toString(), " ");
+                    while(tok.hasMoreTokens()) t.preapply.addElement(uri + tok.nextToken());
+                    c.keys[i] = c.keys[c.keys.length - 1];
+                    c.vals[i] = c.vals[c.vals.length - 1];
+                    i--;
+                    continue;
+                }
+                h.put(c.keys[i], c.vals[i]);
+            }
+            t.keys = new String[h.size()];
+            t.vals = new Object[h.size()];
+
+            Vec v = new Vec(h.size(), c.keys);
+            v.sort(new Vec.CompareFunc() { public int compare(Object a, Object b) { return ((String)a).compareTo((String)b); } });
+            for(int i=0; i<h.size(); i++) {
+                if (c.keys[i].equals("thisbox")) {
+                    for(int j=i; j>0; j--) { t.keys[j] = t.keys[j - 1]; t.vals[j] = t.vals[j - 1]; }
+                    t.keys[0] = (String)v.elementAt(i);
+                    t.vals[0] = h.get(t.keys[0]);
+                } else {
+                    t.keys[i] = (String)v.elementAt(i);
+                    t.vals[i] = h.get(t.keys[i]);
+                }
             }
 
             for(int i=0; i<t.keys.length; i++) {
@@ -352,19 +273,10 @@ public class Template {
                     if (valString.length() > 0 && !hasNonNumeral) t.vals[i] = new Double(valString);
                     else t.vals[i] = valString.intern();
                 }
-
-                // bump thisbox to the front of the pack
-                if (t.keys[i].equals("thisbox")) {
-                    t.keys[i] = t.keys[0];
-                    t.keys[0] = "thisbox";
-                    Object o = t.vals[0];
-                    t.vals[0] = t.vals[i];
-                    t.vals[i] = o;
-                }
             }
         }
 
-        private JS.CompiledFunction genscript(boolean isstatic) {
+        private JS.CompiledFunction parseScript(boolean isstatic) {
             JS.CompiledFunction thisscript = null;
             try {
                 thisscript = JS.parse(t.fileName + (isstatic ? "._" : ""), t.content_start, new StringReader(t.content.toString()));
@@ -372,7 +284,6 @@ public class Template {
                 if (Log.on) Log.log(this, "  ERROR: " + ioe.getMessage());
                 thisscript = null;
             }
-
             t.content = null;
             t.content_start = 0;
             t.content_lines = 0;
@@ -380,26 +291,22 @@ public class Template {
         }
 
         public void endElement(XML.Element c) throws XML.SchemaException {
-            if (rootNodeHasBeenEncountered && !templateNodeHasBeenEncountered) {
-                if ("static".equals(nameOfHeaderNodeBeingProcessed) && t.content != null) t.staticscript = genscript(true);
+            if (state == STATE_IN_XWT_NODE) {
+                if ("static".equals(nameOfHeaderNodeBeingProcessed) && t.content != null) t.staticscript = parseScript(true);
                 nameOfHeaderNodeBeingProcessed = null;
                 
-            } else if (templateNodeHasBeenEncountered && !templateNodeHasBeenFinished) {
-                // turn our childvect into a Template[]
-                t.childvect.copyInto(t.children = new Template[t.childvect.size()]);
-                t.childvect = null;
-                if (t.content != null) t.script = genscript(false);
-                
+            } else if (state == STATE_IN_TEMPLATE_NODE) {
+                if (t.content != null) t.script = parseScript(false);
                 if (nodeStack.size() == 0) {
                     // </template>
-                    templateNodeHasBeenFinished = true;
+                    state = STATE_FINISHED_TEMPLATE_NODE;
                     
                 } else {
                     // add this template as a child of its parent
                     Template oldt = t;
                     t = (Template)nodeStack.lastElement();
                     nodeStack.setSize(nodeStack.size() - 1);
-                    t.childvect.addElement(oldt);
+                    t.children.addElement(oldt);
                 }
             }
          }
@@ -409,7 +316,7 @@ public class Template {
             for (int i=0; length >i; i++) if (ch[start+i] == '\t') throw new XML.SchemaException(
                 t.fileName+ ":" + getLine() + "," + getCol() + ": tabs are not allowed in XWT files");
 
-            if ("static".equals(nameOfHeaderNodeBeingProcessed) || templateNodeHasBeenEncountered) {
+            if ("static".equals(nameOfHeaderNodeBeingProcessed) || state == STATE_IN_TEMPLATE_NODE) {
                 if (t.content == null) {
                     t.content_start = getLine();
                     t.content_lines = 0;
@@ -419,41 +326,41 @@ public class Template {
                 t.content.append(ch, start, length);
                 t.content_lines++;
 
-            } else if (nameOfHeaderNodeBeingProcessed != null) {
+            } else if (nameOfHeaderNodeBeingProcessed != null && state != STATE_FINISHED_TEMPLATE_NODE) {
                 throw new XML.SchemaException("header node <" + nameOfHeaderNodeBeingProcessed + "> cannot have text content");
             }
         }
 
-        public void whitespace(char[] ch, int start, int length) throws XML.SchemaException {
-        }
+        public void whitespace(char[] ch, int start, int length) throws XML.SchemaException { }
     }
 
     private static class PerInstantiationScope extends JS.Scope {
-        Res resourceRoot = null;
-        public PerInstantiationScope(Scope parentScope, Res resourceRoot) {
+        XWT xwt = null;
+        PerInstantiationScope parentBoxPis = null;
+        JS.Scope myStatic = null;
+        void putDollar(String key, Box target) {
+            if (parentBoxPis != null) parentBoxPis.putDollar(key, target);
+            declare("$" + key);
+            put("$" + key, target);
+        }
+        public PerInstantiationScope(Scope parentScope, XWT xwt, PerInstantiationScope parentBoxPis, JS.Scope myStatic) {
             super(parentScope);
-            this.resourceRoot = resourceRoot;
+            this.parentBoxPis = parentBoxPis;
+            this.xwt = xwt;
+            this.myStatic = myStatic;
         }
         public boolean isTransparent() { return true; }
-        public boolean has(Object key) { return false; }
-        public void declare(String s) { super.declare(s); }
         public Object get(Object key) {
-            // FIXME: access statics here
-            if (Box.SpecialBoxProperty.specialBoxProperties.get(key) == null &&
-                !super.has(key)) {
-                Object ret = resourceRoot.get(key);
-                if (ret != null) return ret;
-                throw new JS.Exn("must declare " + key + " before using it!");
-            }
-            return super.get(key);
+            if (super.has(key)) return super.get(key);
+            if (key.equals("xwt")) return xwt;
+            if (key.equals("static")) return myStatic;
+            if (Box.SpecialBoxProperty.specialBoxProperties.get(key.toString()) != null) return getParentScope().get(key);
+            throw new JS.Exn("must declare " + key + " before using it!");
         }
         public void put(Object key, Object val) {
-            // FIXME: access statics here
-            if (Box.SpecialBoxProperty.specialBoxProperties.get(key) == null &&
-                !super.has(key)) {
-                throw new JS.Exn("must declare " + key + " before using it!");
-            }
-            super.put(key, val);
+            if (super.has(key)) super.put(key, val);
+            else if (Box.SpecialBoxProperty.specialBoxProperties.get(key.toString()) != null) getParentScope().put(key, val);
+            else throw new JS.Exn("must declare " + key + " before using it!");
         }
     }