@stxt-lang/core 0.6.2 → 0.6.3

package/out/schema/SchemaProviderMeta.d.ts

@@ -16,9 +16,13 @@ export declare class SchemaProviderMeta implements SchemaProvider {
     /**
      * Serves the meta-schema of the schema language.
      *
+     * Follows the {@link SchemaProvider} contract: providers never throw "not found". Any
+     * namespace other than `@stxt.schema` yields `null`, so that this provider can sit at
+     * the end of a fallback chain (it is the default parent of {@link SchemaProviderMemory})
+     * and the {@link SchemaValidator} is the only one reporting `SCHEMA_NOT_FOUND`.
+     *
      * @param namespace namespace whose schema is wanted; only `@stxt.schema` is served.
-     * @returns the meta-schema of the schema language.
-     * @throws RuntimeException with code `RESOURCE_NOT_FOUND` if any other namespace is asked for.
+     * @returns the meta-schema of the schema language, or `null` for any other namespace.
      */
-    getSchema(namespace: string): Schema;
+    getSchema(namespace: string): Schema | null;
 }

package/out/schema/SchemaProviderMeta.js

@@ -4,7 +4,6 @@ exports.SchemaProviderMeta = void 0;
 const Schema_1 = require("./Schema");
 const Parser_1 = require("../core/Parser");
 const ValidationException_1 = require("../exceptions/ValidationException");
-const RuntimeException_1 = require("../exceptions/RuntimeException");
 const SchemaParser_1 = require("./SchemaParser");
 /**
  * {@link SchemaProvider} that defines in code the meta-schema of the schema language itself
@@ -27,13 +26,17 @@ class SchemaProviderMeta {
     /**
      * Serves the meta-schema of the schema language.
      *
+     * Follows the {@link SchemaProvider} contract: providers never throw "not found". Any
+     * namespace other than `@stxt.schema` yields `null`, so that this provider can sit at
+     * the end of a fallback chain (it is the default parent of {@link SchemaProviderMemory})
+     * and the {@link SchemaValidator} is the only one reporting `SCHEMA_NOT_FOUND`.
+     *
      * @param namespace namespace whose schema is wanted; only `@stxt.schema` is served.
-     * @returns the meta-schema of the schema language.
-     * @throws RuntimeException with code `RESOURCE_NOT_FOUND` if any other namespace is asked for.
+     * @returns the meta-schema of the schema language, or `null` for any other namespace.
      */
     getSchema(namespace) {
         if (namespace !== Schema_1.Schema.SCHEMA_NAMESPACE) {
-            throw new RuntimeException_1.RuntimeException("RESOURCE_NOT_FOUND", `Not found '${namespace}' in namespace: ${Schema_1.Schema.SCHEMA_NAMESPACE}`);
+            return null;
         }
         if (!this.meta) {
             throw new ValidationException_1.ValidationException(0, "META_SCHEMA_NOT_AVAILABLE", "Meta schema not available");

package/out/template/MetaTemplateSchemaProvider.d.ts

@@ -16,9 +16,12 @@ export declare class MetaTemplateSchemaProvider implements SchemaProvider {
     /**
      * Serves the meta-schema of the template language.
      *
+     * Follows the {@link SchemaProvider} contract: providers never throw "not found". Any
+     * namespace other than `@stxt.template` yields `null`; only the `SchemaValidator`
+     * reports `SCHEMA_NOT_FOUND`.
+     *
      * @param namespace namespace whose schema is wanted; only `@stxt.template` is served.
-     * @returns the meta-schema of the template language.
-     * @throws RuntimeException with code `RESOURCE_NOT_FOUND` if any other namespace is asked for.
+     * @returns the meta-schema of the template language, or `null` for any other namespace.
      */
-    getSchema(namespace: string): Schema;
+    getSchema(namespace: string): Schema | null;
 }

package/out/template/MetaTemplateSchemaProvider.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetaTemplateSchemaProvider = void 0;
 const Parser_1 = require("../core/Parser");
 const ValidationException_1 = require("../exceptions/ValidationException");
-const RuntimeException_1 = require("../exceptions/RuntimeException");
 const TemplateParser_1 = require("./TemplateParser");
 /**
  * {@link SchemaProvider} that defines in code the meta-schema of the template language itself
@@ -26,13 +25,16 @@ class MetaTemplateSchemaProvider {
     /**
      * Serves the meta-schema of the template language.
      *
+     * Follows the {@link SchemaProvider} contract: providers never throw "not found". Any
+     * namespace other than `@stxt.template` yields `null`; only the `SchemaValidator`
+     * reports `SCHEMA_NOT_FOUND`.
+     *
      * @param namespace namespace whose schema is wanted; only `@stxt.template` is served.
-     * @returns the meta-schema of the template language.
-     * @throws RuntimeException with code `RESOURCE_NOT_FOUND` if any other namespace is asked for.
+     * @returns the meta-schema of the template language, or `null` for any other namespace.
      */
     getSchema(namespace) {
         if (namespace !== "@stxt.template") {
-            throw new RuntimeException_1.RuntimeException("RESOURCE_NOT_FOUND", `Not found '${namespace}' in namespace: @stxt.template`);
+            return null;
         }
         // meta always exists once the constructor finished, but this mirrors the Java version
         if (!this.meta) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stxt-lang/core",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Parser and schema validator for STXT, an indentation-based structured-text format.",
   "main": "out/all.js",
   "types": "out/all.d.ts",