@voxgig/sdkgen 3.4.3 → 3.4.6

package/dist/utility.js

@@ -3,13 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SdkGenError = void 0;
+exports.CONFIG_REPR_VALUES = exports.CONFIG_DATA_THRESHOLD = exports.SdkGenError = void 0;
 exports.resolvePath = resolvePath;
 exports.requirePath = requirePath;
 exports.isAuthActive = isAuthActive;
 exports.resolveAuthPrefix = resolveAuthPrefix;
+exports.isConfigData = isConfigData;
+exports.configRepr = configRepr;
+exports.configReprSetting = configReprSetting;
+exports.configDefinition = configDefinition;
+exports.clean = clean;
+exports.rawStringLiteral = rawStringLiteral;
 const node_path_1 = __importDefault(require("node:path"));
+const jostraca_1 = require("jostraca");
 const apidef_1 = require("@voxgig/apidef");
+const serverVars_1 = require("./helpers/serverVars");
 // Where a per-target component is loaded from: `<project>/.sdk/dist/<path>`.
 //
 // `ctx$.folder` is jostraca's OUTPUT folder, which is the project for an
@@ -79,4 +87,201 @@ class SdkGenError extends Error {
     }
 }
 exports.SdkGenError = SdkGenError;
+// CONFIG REPRESENTATION (design rung L1, threshold from design Q7).
+//
+// Above a size threshold the API model is emitted as DATA - a JSON string
+// constant parsed once - rather than as a composite literal. Below it the
+// literal stays, because for a small model the literal is smaller, simpler,
+// faster to load and far easier to debug, and a symbol table would be pure
+// complexity.
+//
+// The threshold is on the JSON, not the emitted source, because the emitted
+// source size varies by language while the model does not. It is measured in
+// UTF-8 BYTES rather than string length: `.length` counts UTF-16 code units,
+// so a CJK-heavy model would read as roughly a third of its real size and
+// stay on the expensive literal path well past the point where it hurts.
+//
+// Measured on the real gitlab model (923.5 KB of JSON), Go, cold cache,
+// recompiling only the config package:
+//
+//                       composite literal   JSON string constant
+//   compile+link wall        30.80 s              0.34 s     91x faster
+//   peak compiler RSS         2.49 GB             0.06 GB    39x less
+//   binary                    7.44 MB             3.51 MB    2.1x smaller
+//
+// The reader side is unchanged either way: make_config returns the same map,
+// so nothing downstream can tell which representation it got.
+const CONFIG_DATA_THRESHOLD = 256 * 1024;
+exports.CONFIG_DATA_THRESHOLD = CONFIG_DATA_THRESHOLD;
+// Should this model be emitted as data rather than as a literal?
+//
+// `repr` is the per-SDK override from `main.kit.config.repr`: 'auto' (the
+// default) decides by size, 'data' and 'literal' pin it. The override is what
+// lets a small fixture exercise the data path - by size alone no test model
+// comes near the threshold, so the branch every large SDK depends on would
+// never be generated, compiled or run in CI.
+const CONFIG_REPR_VALUES = ['auto', 'data', 'literal'];
+exports.CONFIG_REPR_VALUES = CONFIG_REPR_VALUES;
+function isConfigData(configJson, repr) {
+    // An unknown value is REJECTED, not ignored. The aontu declaration
+    // documents the closed set but does not enforce it here, and silently
+    // treating `repr: 'date'` as `auto` would quietly restore the compile cost
+    // this exists to remove - the failure mode being a slow build nobody
+    // connects to a typo.
+    if (null != repr && '' !== repr && !CONFIG_REPR_VALUES.includes(repr)) {
+        throw new SdkGenError('sdkgen: main.kit.config.repr must be one of ' +
+            CONFIG_REPR_VALUES.join(', ') + ' (got: ' + repr + ')', {});
+    }
+    if ('data' === repr) {
+        return true;
+    }
+    if ('literal' === repr) {
+        return false;
+    }
+    return CONFIG_DATA_THRESHOLD < Buffer.byteLength(configJson, 'utf8');
+}
+// The chosen representation, as a word - for generation logs and for the
+// per-SDK reporting the fleet regen needs, so a model crossing the threshold
+// is visible rather than showing up as an unexplained whole-file diff.
+function configRepr(configJson, repr) {
+    return isConfigData(configJson, repr) ? 'data' : 'literal';
+}
+// The per-SDK override, or 'auto'. `main.kit.config.repr` is optional, and
+// getModelPath throws rather than returning undefined for an absent path.
+function configReprSetting(model) {
+    try {
+        return (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.config.repr`) || 'auto';
+    }
+    catch (_e) {
+        return 'auto';
+    }
+}
+// L0 NORMALISATION: strip what the emitted config must not carry.
+//
+// Three kinds of noise, and the distinction between them matters:
+//
+//   MODEL_META      jostraca's `each` injects index$/key$/val$ into every node
+//                   it iterates. Pure bookkeeping, and it leaked into every
+//                   generated SDK for years (5,231 occurrences in gitlab
+//                   alone) because this helper deleted keys during a walk that
+//                   assigned them straight back.
+//
+//   CONFIG_DEFAULT  a key whose value equals the default the reader already
+//                   applies. Emitting it is pure bulk. Only these three names
+//                   are dropped, and only at their default value - `entity$`
+//                   is real Seneca data, so no blanket suffix rule.
+//
+//   PAYLOAD_KEYS    the boundary. Under `default`/`example`/`examples` the
+//                   value is API DATA, not config, and an example that happens
+//                   to contain `active: true` must survive intact. Below one of
+//                   these keys default-dropping stops; metadata stripping does
+//                   not, because jostraca's bookkeeping is never payload.
+const MODEL_META = ['index$', 'key$', 'val$'];
+const CONFIG_DEFAULT = {
+    active: true,
+    req: false,
+    reqd: false,
+};
+const PAYLOAD_KEYS = ['default', 'example', 'examples'];
+function clean(o, dropDefaults) {
+    // Rebuild rather than delete in place: the caller's model is shared with
+    // every other component, and mutating it here would strip metadata a later
+    // target still needs.
+    const prune = (node, defaults) => {
+        if (Array.isArray(node))
+            return node.map((n) => prune(n, defaults));
+        if (null != node && 'object' === typeof node) {
+            const out = {};
+            for (const k of Object.keys(node)) {
+                if (MODEL_META.includes(k))
+                    continue;
+                // An ABSENT optional member, dropped rather than carried as undefined.
+                //
+                // Callers build `{fields, name, op, relations}` from an entity, and
+                // `op` and `relations` are optional - so the key exists with value
+                // undefined. JSON.stringify silently omits such a key, while the
+                // literal formatters emit it as None/nil/null, and the two
+                // representations would describe different configs for any entity
+                // without an `op`. Dropping it here fixes both branches at once,
+                // because both reach the emitter through this function.
+                if (undefined === node[k])
+                    continue;
+                if (defaults && k in CONFIG_DEFAULT && CONFIG_DEFAULT[k] === node[k])
+                    continue;
+                out[k] = prune(node[k], defaults && !PAYLOAD_KEYS.includes(k));
+            }
+            return out;
+        }
+        return node;
+    };
+    return prune(o, true === dropDefaults);
+}
+// The JSON as a source-level string literal, for a language whose SINGLE
+// quoted literal neither interpolates nor processes escapes beyond the quote
+// and the backslash - Ruby, PHP, Perl, Lua.
+//
+// Reproducing the JSON text VERBATIM is all that is needed, because the JSON
+// already encodes control characters and non-ASCII itself. That is why this is
+// preferred over the double-quoted form in those languages: Ruby and PHP
+// interpolate (`#{...}`, `$var`) and Lua does not understand `\uXXXX` at all,
+// so a double-quoted literal would need a language-specific escape table and
+// would get it wrong for exactly the inputs nobody tests.
+function rawStringLiteral(s) {
+    return "'" + s.replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+}
+// THE CANONICAL CONFIG OBJECT, and the JSON the threshold is measured on.
+//
+// Every target builds its config from this one function, so the literal a
+// target emits and the data that replaces it above the threshold cannot
+// describe different configs - which is the entire promise of rung L1. Before
+// this existed each target assembled its own, and they had already drifted:
+// `feature.<name>` came out as `{}` in Go and as nothing at all in ts when a
+// feature declared no config.
+//
+// Key order is `each`'s order, which is sorted, so the JSON is byte-stable
+// across runs exactly like the literal it replaces.
+function configDefinition(model) {
+    const entity = (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.entity`);
+    const feature = (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.feature`);
+    const headers = (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.config.headers`) || {};
+    const authActive = isAuthActive(model);
+    const authPrefix = resolveAuthPrefix(model);
+    let baseUrl = '';
+    try {
+        baseUrl = (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.info.servers.0.url`);
+    }
+    catch (_e) { }
+    const svars = (0, serverVars_1.serverVariables)(model);
+    const entityDefs = {};
+    const entityStubs = {};
+    (0, jostraca_1.each)(entity, (e) => {
+        entityDefs[e.name] = clean({
+            fields: e.fields,
+            name: e.name,
+            op: e.op,
+            relations: e.relations,
+        }, true);
+        entityStubs[e.name] = {};
+    });
+    const featureDefs = {};
+    (0, jostraca_1.each)(feature, (f) => {
+        featureDefs[f.name] = f.config || {};
+    });
+    const options = { base: baseUrl };
+    if (0 < svars.length) {
+        options.server = svars.reduce((a, v) => (a[v.name] = v.dflt, a), {});
+    }
+    if (authActive) {
+        options.auth = { prefix: authPrefix };
+    }
+    options.headers = headers;
+    options.entity = entityStubs;
+    const def = {
+        main: { name: model.const.Name },
+        feature: featureDefs,
+        options,
+        entity: entityDefs,
+    };
+    return { def, json: JSON.stringify(def) };
+}
 //# sourceMappingURL=utility.js.map

package/dist/utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"utility.js","sourceRoot":"","sources":["../src/utility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../src/utility.ts"],"names":[],"mappings":"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"}

package/model/sdkgen.aontu

@@ -13,6 +13,17 @@ main: def: {
 # `<sdk>/.sdk/model/config.aontu`.
 main: kit: config: docs_order: *['ts','py','php','go','rb','lua'] | [&: string]
 
+# How the API model is embedded in a generated SDK (design rung L1).
+#
+#   auto     by size - data above the threshold, literal below (the default)
+#   literal  always a composite literal, whatever the size
+#   data     always a parsed JSON constant, whatever the size
+#
+# Declared as a closed set so a typo is REJECTED at model-compile time rather
+# than silently falling through to `auto`, which would quietly restore the
+# compile cost this exists to remove.
+main: kit: config: repr: *'auto' | 'literal' | 'data'
+
 # How the generated test suites behave.
 main: kit: test: {
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/sdkgen",
-  "version": "3.4.3",
+  "version": "3.4.6",
   "main": "dist/sdkgen.js",
   "type": "commonjs",
   "engines": {

package/project/.sdk/src/cmp/c/Config_c.ts

@@ -3,8 +3,11 @@ import {
   Content,
   File,
   cmp,
+  configDefinition,
+  configReprSetting,
   each,
   isAuthActive,
+  isConfigData,
   resolveAuthPrefix,
 } from '@voxgig/sdkgen'
 
@@ -17,6 +20,7 @@ import {
 
 
 import {
+  cStringLiteral,
   clean,
   formatCValue,
 } from './utility_c'
@@ -75,8 +79,48 @@ const Config = cmp(async function Config(props: any) {
     entity: entityConfig,
   }
 
+  // The same config as an OBJECT, built by the shared helper so this target's
+  // literal and the data that replaces it above the threshold are the same
+  // config by construction. The JSON is what the threshold is measured on -
+  // emitted source size varies by language, the model does not.
+  const { json: configJson } = configDefinition(model)
+  const asData = isConfigData(configJson, configReprSetting(model))
+
   File({ name: 'config.c' }, () => {
 
+    // ABOVE THE THRESHOLD: emit the model as DATA.
+    //
+    // The literal is a single nested `cmap(...)`/`clist(...)` expression. For a
+    // real model that is one function whose expression nests hundreds of
+    // thousands of calls deep - the shape that makes a C compiler's parser and
+    // register allocator quadratic, and the reason gcc can be seen taking
+    // minutes on a generated config. A string constant is one token, and
+    // `json_parse` (declared in sdk.h, reached through api.h) builds the same
+    // voxgig_value tree at runtime.
+    if (asData) {
+      Content(`// Generated API configuration (mirrors core/config.go).
+
+#include "api.h"
+
+#include <string.h>
+
+// THE API MODEL, EMBEDDED AS DATA (sdkgen rung L1).
+//
+// Emitted only above a size threshold, or when \`main.kit.config.repr\` pins
+// it: for a small model the cmap() literal is smaller and far easier to read
+// when debugging.
+static const char CONFIG_DATA[] =
+${cStringLiteral(configJson)};
+
+voxgig_value* make_config(void) {
+  return json_parse(CONFIG_DATA);
+}
+
+Feature* make_feature(const char* name) {
+`)
+    }
+    else {
+
     Content(`// Generated API configuration (mirrors core/config.go).
 
 #include "api.h"
@@ -89,6 +133,7 @@ voxgig_value* make_config(void) {
 
 Feature* make_feature(const char* name) {
 `)
+    }
 
     // Dispatch to the features the MODEL declares, and only those.
     //

package/project/.sdk/src/cmp/c/utility_c.ts

@@ -150,7 +150,43 @@ function clean(o: any, dropDefaults?: boolean): any {
 }
 
 
+
+// The JSON as a C string literal, split into ADJACENT literals.
+//
+// C99 only guarantees 4095 characters in a single string literal, and a real
+// model runs to hundreds of kilobytes. Adjacent literals are concatenated by
+// the translation phase before that limit applies, so this stays portable
+// rather than relying on gcc/clang having no practical limit.
+//
+// Only `\` and `"` need escaping: JSON.stringify output contains no raw
+// control characters (it writes them as the six TEXT characters \u00XX), and
+// C string literals take UTF-8 bytes verbatim. Escaping the backslash also
+// means no `\uXXXX` ever reaches the C lexer, which matters - a universal
+// character name below 0xA0 is ill-formed C, so the JSON's own escapes would
+// have been rejected if they had been passed through.
+//
+// Chunks are cut from the RAW text and escaped afterwards, so a cut can never
+// land inside an escape sequence. Surrogate pairs are kept whole, or the cut
+// would emit a lone surrogate as invalid UTF-8.
+function cStringLiteral(json: string, chunkSize: number = 2000): string {
+  const parts: string[] = []
+  let i = 0
+  while (i < json.length) {
+    let end = Math.min(i + chunkSize, json.length)
+    const code = json.charCodeAt(end - 1)
+    if (end < json.length && 0xd800 <= code && code <= 0xdbff) {
+      end++
+    }
+    parts.push(json.slice(i, end))
+    i = end
+  }
+  return parts
+    .map((p) => '  "' + p.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"')
+    .join('\n')
+}
+
 export {
+  cStringLiteral,
   clean,
   cIdent,
   cName,

package/project/.sdk/src/cmp/go/Config_go.ts

@@ -9,7 +9,11 @@ import {
   Line,
   cmp,
   each,
+  clean,
+  configDefinition,
+  configReprSetting,
   isAuthActive,
+  isConfigData,
   resolveAuthPrefix,
   serverVariables,
 } from '@voxgig/sdkgen'
@@ -24,7 +28,6 @@ import {
 
 
 import {
-  clean,
   formatGoMap,
   goFeatureName,
 } from './utility_go'
@@ -62,9 +65,87 @@ const Config = cmp(async function Config(props: any) {
 			},\n`
     : ''
 
-  // Config is now in core/ package
+  // The same config as an OBJECT, built by the shared helper so this target's
+  // literal and the data that replaces it above the threshold are the same
+  // config by construction. The JSON is what the threshold is measured on -
+  // emitted source size varies by language, the model does not.
+  const { json: configJson } = configDefinition(model)
+  const asData = isConfigData(configJson, configReprSetting(model))
+
   File({ name: 'config.' + target.ext }, () => {
 
+    // ABOVE THE THRESHOLD: emit the model as DATA.
+    //
+    // A composite literal makes the compiler walk every node of the model;
+    // a string constant is one token. On the real gitlab model that is 30.8 s
+    // and 2.49 GB of compiler memory versus 0.34 s and 0.06 GB, and a binary
+    // 2.1x smaller. MakeConfig still returns the same map, so nothing
+    // downstream can tell which representation it got.
+    //
+    // JSON.stringify output is a valid Go interpreted string literal: JSON
+    // escapes are a subset of Go's, and Go source is UTF-8 so non-ASCII needs
+    // no escaping. A raw (backtick) literal could NOT be used - the model
+    // contains backticks in values like `$STRING`.
+    if (asData) {
+      Content(`package core
+
+import (
+	"encoding/json"
+	"math"
+	"sync"
+)
+
+// The API model, emitted as data rather than as a composite literal: see
+// sdkgen rung L1. Parsed by MakeConfig, and parsed once by SharedConfig.
+const configJSON = ${JSON.stringify(configJson)}
+
+// json.Unmarshal decodes EVERY JSON number as float64, but the literal
+// representation emits an integer token as an untyped constant that lands in
+// map[string]any as an int. MakeConfig is public API and consumers type-assert
+// against it, so the two representations must not disagree about the type of
+// a whole number just because the model crossed a size threshold.
+//
+// Whole values become int; anything fractional, or too large to be exact in a
+// float64, stays float64 - which is what the literal branch does too.
+func configNormalise(val any) any {
+	switch v := val.(type) {
+	case map[string]any:
+		for k, c := range v {
+			v[k] = configNormalise(c)
+		}
+		return v
+	case []any:
+		for i, c := range v {
+			v[i] = configNormalise(c)
+		}
+		return v
+	case float64:
+		if v == math.Trunc(v) && math.Abs(v) <= 1<<53 {
+			return int(v)
+		}
+		return v
+	}
+	return val
+}
+
+// MakeConfig parses a fresh, fully materialised config map. Every call
+// re-parses, so prefer SharedConfig unless you need a private copy you
+// intend to mutate.
+func MakeConfig() map[string]any {
+	var out map[string]any
+	if err := json.Unmarshal([]byte(configJSON), &out); err != nil {
+		// Unreachable: the constant is generated by json.Marshal's
+		// counterpart and never edited by hand. Panic rather than return a
+		// silently empty config, which would fail far from the cause.
+		panic("${model.const.Name}: embedded config is not valid JSON: " + err.Error())
+	}
+	out, _ = configNormalise(out).(map[string]any)
+	return out
+}
+`)
+    }
+    else {
+
     Content(`package core
 
 import (
@@ -113,7 +194,10 @@ ${serverBlock}${authBlock}			"headers": ${formatGoMap(headers, 3)},
       }, true), a), {}), 2)},
 	}
 }
+`)
+    }
 
+    Content(`
 var (
 	sharedConfigOnce sync.Once
 	sharedConfigVal  map[string]any

package/project/.sdk/src/cmp/js/Config_js.ts

@@ -8,9 +8,13 @@ import {
   Fragment,
   Line,
   cmp,
+  clean,
+  configDefinition,
+  configReprSetting,
   each,
   indent,
   isAuthActive,
+  isConfigData,
   resolveAuthPrefix,
   serverVariables,
 } from '@voxgig/sdkgen'
@@ -25,7 +29,6 @@ import {
 
 
 import {
-  clean,
   formatJson,
 } from './utility_js'
 
@@ -62,13 +65,58 @@ const Config = cmp(async function Config(props: any) {
     svars.map((v: any) => `      ${JSON.stringify(v.name)}: ${JSON.stringify(v.dflt)},\n`).join('') +
     '    },\n\n    '
 
+  // Read the base URL here rather than leaving it to a `$$...$$` stdrep
+  // placeholder in the fragment. stdrep can only substitute a path the model
+  // actually has: a model with no `info.servers` left the placeholder itself in
+  // the generated source, so `options.base` came out as the literal string
+  // '$main.kit.info.servers.0.url$'. Reading it explicitly yields '' in that
+  // case, which is what every other target already emits, and is identical to
+  // the old output whenever the model does define a server.
+  let baseUrl = ''
+  try {
+    baseUrl = getModelPath(model, `main.${KIT}.info.servers.0.url`)
+  } catch (_e) { }
+
+  // The same config as an OBJECT, built by the shared helper so this target's
+  // literal and the data that replaces it above the threshold are the same
+  // config by construction. The JSON is what the threshold is measured on -
+  // emitted source size varies by language, the model does not.
+  const { json: configJson } = configDefinition(model)
+  const asData = isConfigData(configJson, configReprSetting(model))
+
   File({ name: 'Config.' + target.ext }, () => {
 
+    if (asData) {
+      Fragment({
+        from: ff + 'Config.data.fragment.js',
+
+        replace: {
+
+          '// #ImportFeatures': () => each(feature, (f: any) => {
+            Line(`const { ${nom(f, 'Name')}Feature } = ` +
+              `require('./feature/${f.name}/${nom(f, 'Name')}Feature')`)
+          }),
+
+          '// #FeatureClasses': () => each(feature, (f: any) => {
+            Line(` ${f.name}: ${nom(f, 'Name')}Feature,`)
+          }),
+
+          // A JS string literal, so the JSON survives verbatim. JSON.stringify
+          // escapes the quotes and backslashes the model contains (values like
+          // `$STRING` carry backticks, which a template literal could not).
+          "'CONFIGJSON'": JSON.stringify(configJson),
+        }
+      })
+      return
+    }
+
     Fragment({
       from: ff + 'Config.fragment.js',
 
       replace: {
 
+        "'BASEURL'": JSON.stringify(baseUrl),
+
         "'SERVERBLOCK'": serverBlock,
 
         "'AUTHBLOCK'": authBlock,

package/project/.sdk/src/cmp/js/fragment/Config.data.fragment.js

@@ -0,0 +1,50 @@
+
+const { BaseFeature } = require('./feature/base/BaseFeature')
+// #ImportFeatures
+
+
+const FEATURE_CLASS = {
+  // #FeatureClasses
+}
+
+
+// THE API MODEL, EMBEDDED AS DATA (sdkgen rung L1).
+//
+// The literal form of this file declares the whole model as nested object
+// literals on the class. For a large API that is megabytes of source the
+// JavaScript engine must build node by node on every module load, and that
+// every tool reading this file must parse.
+//
+// As a single string constant it is one token, and V8's JSON parser builds the
+// object far faster than the equivalent literal - JSON.parse is the well-worn
+// trick for exactly this shape of data.
+//
+// Emitted only above a size threshold, or when `main.kit.config.repr` pins it:
+// for a small model the literal is smaller, loads no slower, and is far easier
+// to read when debugging.
+const CONFIG_DATA = 'CONFIGJSON'
+
+
+class Config {
+
+  makeFeature(fn) {
+    const fc = FEATURE_CLASS[fn]
+    const fi = new fc()
+    // TODO: errors etc
+    return fi
+  }
+
+}
+
+
+// Parsed ONCE, at module load, exactly like the literal form was built once.
+//
+// The parsed data is assigned onto an instance rather than replacing it, so
+// `config.main` / `.feature` / `.options` / `.entity` read exactly as they did
+// when they were field initialisers, and `makeFeature` stays where it was on
+// the prototype. Callers cannot tell which representation they were given.
+const config = Object.assign(new Config(), JSON.parse(CONFIG_DATA))
+
+module.exports = {
+  config
+}

package/project/.sdk/src/cmp/js/fragment/Config.fragment.js

@@ -29,7 +29,7 @@ class Config {
 
 
   options = {
-    base: '$$main.kit.info.servers.0.url$$',
+    base: 'BASEURL',
 
     'SERVERBLOCK''AUTHBLOCK'headers: 'HEADERS',