@backstage/frontend-plugin-api 0.17.3 → 0.18.0

package/dist/schema/createPortableSchema.esm.js

@@ -1,13 +1,3 @@
-import { z } from 'zod/v3';
-import zodToJsonSchema from 'zod-to-json-schema';
-
-function createDeprecatedConfigSchema(fields) {
-  const resolved = {};
-  for (const [key, field] of Object.entries(fields)) {
-    resolved[key] = resolveZodField(key, field(z));
-  }
-  return buildPortableSchema(resolved);
-}
 function createConfigSchema(fields) {
   const resolved = {};
   for (const [key, field] of Object.entries(fields)) {
@@ -15,21 +5,6 @@ function createConfigSchema(fields) {
   }
   return buildPortableSchema(resolved);
 }
-function mergePortableSchemas(a, b) {
-  if (!a && !b) {
-    return void 0;
-  }
-  if (!a) {
-    return b;
-  }
-  if (!b) {
-    return a;
-  }
-  return buildPortableSchema({
-    ...a._fields,
-    ...b._fields
-  });
-}
 function buildPortableSchema(fields) {
   function parse(input) {
     if (input !== void 0 && input !== null && (typeof input !== "object" || Array.isArray(input))) {
@@ -38,23 +13,23 @@ function buildPortableSchema(fields) {
       );
     }
     const inputObj = input ?? {};
-    const result2 = {};
+    const result = {};
     const errors = [];
     for (const [key, field] of Object.entries(fields)) {
       const validated = field.validate(inputObj[key]);
       if ("errors" in validated) {
         errors.push(...validated.errors);
       } else if (validated.value !== void 0 || key in inputObj) {
-        result2[key] = validated.value;
+        result[key] = validated.value;
       }
     }
     if (errors.length > 0) {
       throw new Error(errors.join("; "));
     }
-    return result2;
+    return result;
   }
   let cached;
-  const result = {
+  return {
     parse,
     schema() {
       if (!cached) {
@@ -63,11 +38,6 @@ function buildPortableSchema(fields) {
       return cached;
     }
   };
-  Object.defineProperty(result, "_fields", {
-    value: fields,
-    enumerable: false
-  });
-  return result;
 }
 function resolveField(key, schema) {
   if (isZodV3Type(schema)) {
@@ -87,23 +57,6 @@ function resolveField(key, schema) {
     `Config schema for field '${key}' is not a valid Standard Schema`
   );
 }
-function resolveZodField(key, schema) {
-  const wrapper = z.object({ [key]: schema });
-  return {
-    validate(value) {
-      const result = wrapper.safeParse({ [key]: value });
-      if (result.success) {
-        return { value: result.data[key] };
-      }
-      return { errors: result.error.issues.map(formatZodIssue) };
-    },
-    toJsonSchema() {
-      const wholeJsonSchema = zodToJsonSchema(wrapper);
-      return wholeJsonSchema.properties?.[key] ?? {};
-    },
-    required: !schema.isOptional()
-  };
-}
 function resolveStandardField(key, schema) {
   const required = isFieldRequired(schema);
   return {
@@ -167,19 +120,6 @@ function isFieldRequired(schema) {
   }
   return (result.issues?.length ?? 0) > 0;
 }
-function formatZodIssue(issue) {
-  if (issue.code === "invalid_union" && issue.unionErrors?.[0]?.issues?.[0]) {
-    return formatZodIssue(issue.unionErrors[0].issues[0]);
-  }
-  let message = issue.message;
-  if (message === "Required") {
-    message = "Missing required value";
-  }
-  if (issue.path.length) {
-    message += ` at '${issue.path.join(".")}'`;
-  }
-  return message;
-}
 function formatStandardIssue(fieldKey, issue) {
   let message = issue.message;
   if (message === "Required") {
@@ -190,11 +130,6 @@ function formatStandardIssue(fieldKey, issue) {
   ).join(".")}` : fieldKey;
   return `${message} at '${path}'`;
 }
-function warnConfigSchemaPropDeprecation(callSite) {
-  console.warn(
-    `DEPRECATION WARNING: The \`config.schema\` option for extension config is deprecated. Use the \`configSchema\` option instead with Standard Schema values, for example \`configSchema: { title: z.string() }\` using the \`zod\` v4 package (\`zod@^4.0.0\`). Declared at ${callSite}`
-  );
-}
 
-export { createConfigSchema, createDeprecatedConfigSchema, mergePortableSchemas, warnConfigSchemaPropDeprecation };
+export { createConfigSchema };
 //# sourceMappingURL=createPortableSchema.esm.js.map

package/dist/schema/createPortableSchema.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPortableSchema.esm.js","sources":["../../src/schema/createPortableSchema.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonObject } from '@backstage/types';\nimport { z as zodV3, type ZodType } from 'zod/v3';\nimport zodToJsonSchema from 'zod-to-json-schema';\nimport { PortableSchema } from './types';\n\n/**\n * The Standard Schema interface.\n * @public\n */\nexport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type StandardSchemaV1 } from '@standard-schema/spec';\n\n/** @internal */\nexport function createDeprecatedConfigSchema(\n  fields: Record<string, (zImpl: typeof zodV3) => ZodType>,\n): MergeablePortableSchema {\n  const resolved: Record<string, ResolvedField> = {};\n\n  for (const [key, field] of Object.entries(fields)) {\n    resolved[key] = resolveZodField(key, field(zodV3));\n  }\n\n  return buildPortableSchema(resolved);\n}\n\n/**\n * Per-field resolved schema — validation is eager, JSON Schema is lazy.\n * @internal\n */\ninterface ResolvedField {\n  validate(value: unknown): { value: unknown } | { errors: string[] };\n  toJsonSchema(): JsonObject;\n  required: boolean;\n}\n\n/**\n * Internal representation that carries per-field resolvers alongside the\n * public PortableSchema surface, enabling schema merging.\n * @internal\n */\nexport interface MergeablePortableSchema<TOutput = any, TInput = any>\n  extends PortableSchema<TOutput, TInput> {\n  /** @internal */\n  readonly _fields: Record<string, ResolvedField>;\n}\n\n/**\n * Resolves each field, eagerly validates JSON Schema support, and returns\n * a PortableSchema whose JSON Schema conversion is lazy.\n * @internal\n */\nexport function createConfigSchema(\n  fields: Record<string, StandardSchemaV1>,\n): MergeablePortableSchema {\n  const resolved: Record<string, ResolvedField> = {};\n\n  for (const [key, field] of Object.entries(fields)) {\n    resolved[key] = resolveField(key, field);\n  }\n\n  return buildPortableSchema(resolved);\n}\n\n/**\n * Combines schemas from different sources for blueprint + override\n * composition. Each source may use a completely different schema library.\n * Because we track per-field resolvers, merging is just combining the\n * field maps.\n * @internal\n */\nexport function mergePortableSchemas<A, B>(\n  a: MergeablePortableSchema<A> | undefined,\n  b: MergeablePortableSchema<B> | undefined,\n): MergeablePortableSchema<A & B> | undefined {\n  if (!a && !b) {\n    return undefined;\n  }\n  if (!a) {\n    return b as MergeablePortableSchema<A & B>;\n  }\n  if (!b) {\n    return a as MergeablePortableSchema<A & B>;\n  }\n\n  return buildPortableSchema<A & B>({\n    ...a._fields,\n    ...b._fields,\n  });\n}\n\n/**\n * Assembles resolved fields into a PortableSchema with per-field\n * validation (eager) and lazy JSON Schema generation.\n */\nfunction buildPortableSchema<TOutput = unknown>(\n  fields: Record<string, ResolvedField>,\n): MergeablePortableSchema<TOutput> {\n  function parse(input: unknown) {\n    if (\n      input !== undefined &&\n      input !== null &&\n      (typeof input !== 'object' || Array.isArray(input))\n    ) {\n      throw new Error(\n        `Invalid config input, expected object but got ${\n          Array.isArray(input) ? 'array' : typeof input\n        }`,\n      );\n    }\n    const inputObj = (input ?? {}) as Record<string, unknown>;\n    const result: Record<string, unknown> = {};\n    const errors: string[] = [];\n\n    for (const [key, field] of Object.entries(fields)) {\n      const validated = field.validate(inputObj[key]);\n      if ('errors' in validated) {\n        errors.push(...validated.errors);\n      } else if (validated.value !== undefined || key in inputObj) {\n        result[key] = validated.value;\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new Error(errors.join('; '));\n    }\n\n    return result as TOutput;\n  }\n\n  let cached: { schema: JsonObject } | undefined;\n\n  const result: MergeablePortableSchema<TOutput> = {\n    parse,\n    schema() {\n      if (!cached) {\n        cached = { schema: buildObjectJsonSchema(fields) };\n      }\n      return cached;\n    },\n  } as MergeablePortableSchema<TOutput>;\n\n  Object.defineProperty(result, '_fields', {\n    value: fields,\n    enumerable: false,\n  });\n\n  return result;\n}\n\n/**\n * Wraps a single schema into a ResolvedField. Eagerly validates that\n * JSON Schema conversion will be possible, but defers the actual\n * conversion until toJsonSchema() is called.\n */\nfunction resolveField(key: string, schema: unknown): ResolvedField {\n  if (isZodV3Type(schema)) {\n    throw new Error(\n      `Config schema for field '${key}' uses a Zod v3 schema, which is ` +\n        `not supported by the \\`configSchema\\` option. Upgrade to the ` +\n        `\\`zod\\` v4 package (\\`zod@^4.0.0\\`). Note that the \\`zod/v4\\` ` +\n        `subpath export from the zod v3 package is also not supported, ` +\n        `as it does not include JSON Schema conversion.`,\n    );\n  }\n  if (isStandardSchema(schema)) {\n    if (!hasJsonSchemaConverter(schema)) {\n      throw new Error(\n        `Config schema for field '${key}' does not support JSON Schema ` +\n          `conversion. Use a schema library that implements the Standard ` +\n          `JSON Schema interface (like zod v4+).`,\n      );\n    }\n    return resolveStandardField(key, schema);\n  }\n  throw new Error(\n    `Config schema for field '${key}' is not a valid Standard Schema`,\n  );\n}\n\nfunction resolveZodField(key: string, schema: ZodType): ResolvedField {\n  const wrapper = zodV3.object({ [key]: schema });\n\n  return {\n    validate(value) {\n      const result = wrapper.safeParse({ [key]: value });\n      if (result.success) {\n        return { value: result.data[key] };\n      }\n      return { errors: result.error.issues.map(formatZodIssue) };\n    },\n    toJsonSchema() {\n      const wholeJsonSchema = zodToJsonSchema(wrapper) as Record<string, any>;\n      return (wholeJsonSchema.properties?.[key] ?? {}) as JsonObject;\n    },\n    required: !schema.isOptional(),\n  };\n}\n\nfunction resolveStandardField(\n  key: string,\n  schema: StandardSchemaV1 & {\n    '~standard': { jsonSchema: { input: Function } };\n  },\n): ResolvedField {\n  const required = isFieldRequired(schema);\n\n  return {\n    validate(value) {\n      const result = schema['~standard'].validate(value);\n      if (result instanceof Promise) {\n        throw new Error(\n          `Config schema for '${key}' returned a Promise — async schemas are not supported`,\n        );\n      }\n      if (result.issues) {\n        return {\n          errors: Array.from(result.issues).map(issue =>\n            formatStandardIssue(key, issue),\n          ),\n        };\n      }\n      return { value: result.value };\n    },\n    toJsonSchema() {\n      const raw = schema['~standard'].jsonSchema.input({ target: 'draft-07' });\n      const { $schema: _, ...rest } = raw;\n      return rest as JsonObject;\n    },\n    required,\n  };\n}\n\n/** Assembles per-field JSON Schemas into a single object-level JSON Schema. */\nfunction buildObjectJsonSchema(\n  fields: Record<string, ResolvedField>,\n): JsonObject {\n  const properties: Record<string, JsonObject> = {};\n  const required: string[] = [];\n\n  for (const [key, field] of Object.entries(fields)) {\n    properties[key] = field.toJsonSchema();\n    if (field.required) {\n      required.push(key);\n    }\n  }\n\n  const schema: Record<string, unknown> = {\n    type: 'object',\n    properties,\n    additionalProperties: false,\n  };\n\n  if (required.length > 0) {\n    schema.required = required;\n  }\n\n  return schema as JsonObject;\n}\n\nfunction isZodV3Type(value: unknown): value is ZodType {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as any)._parse === 'function' &&\n    '_def' in value\n  );\n}\n\nfunction isStandardSchema(value: unknown): value is StandardSchemaV1 {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '~standard' in value &&\n    typeof (value as any)['~standard']?.validate === 'function'\n  );\n}\n\nfunction hasJsonSchemaConverter(\n  schema: StandardSchemaV1,\n): schema is StandardSchemaV1 & {\n  '~standard': { jsonSchema: { input: Function } };\n} {\n  const std = schema['~standard'] as any;\n  return typeof std?.jsonSchema?.input === 'function';\n}\n\nfunction isFieldRequired(schema: StandardSchemaV1): boolean {\n  const result = schema['~standard'].validate(undefined);\n  if (result instanceof Promise) {\n    return true;\n  }\n  return (result.issues?.length ?? 0) > 0;\n}\n\nfunction formatZodIssue(issue: {\n  code: string;\n  message: string;\n  path: Array<string | number>;\n  unionErrors?: Array<{ issues: Array<any> }>;\n}): string {\n  if (issue.code === 'invalid_union' && issue.unionErrors?.[0]?.issues?.[0]) {\n    return formatZodIssue(issue.unionErrors[0].issues[0]);\n  }\n  let message = issue.message;\n  if (message === 'Required') {\n    message = 'Missing required value';\n  }\n  if (issue.path.length) {\n    message += ` at '${issue.path.join('.')}'`;\n  }\n  return message;\n}\n\nfunction formatStandardIssue(\n  fieldKey: string,\n  issue: StandardSchemaV1.Issue,\n): string {\n  let message = issue.message;\n  if (message === 'Required') {\n    message = 'Missing required value';\n  }\n  const path = issue.path?.length\n    ? `${fieldKey}.${issue.path\n        .map((p: PropertyKey | StandardSchemaV1.PathSegment) =>\n          typeof p === 'object' ? p.key : p,\n        )\n        .join('.')}`\n    : fieldKey;\n  return `${message} at '${path}'`;\n}\n\n/** @internal */\nexport function warnConfigSchemaPropDeprecation(callSite: string) {\n  // eslint-disable-next-line no-console\n  console.warn(\n    `DEPRECATION WARNING: The \\`config.schema\\` option for extension config is deprecated. ` +\n      `Use the \\`configSchema\\` option instead with Standard Schema values, for example ` +\n      `\\`configSchema: { title: z.string() }\\` using the \\`zod\\` v4 package ` +\n      `(\\`zod@^4.0.0\\`). Declared at ${callSite}`,\n  );\n}\n"],"names":["zodV3","result"],"mappings":"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"}
+{"version":3,"file":"createPortableSchema.esm.js","sources":["../../src/schema/createPortableSchema.ts"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonObject } from '@backstage/types';\nimport { PortableSchema } from './types';\n\n/**\n * The Standard Schema interface.\n * @public\n */\nexport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Per-field resolved schema — validation is eager, JSON Schema is lazy.\n * @internal\n */\ninterface ResolvedField {\n  validate(value: unknown): { value: unknown } | { errors: string[] };\n  toJsonSchema(): JsonObject;\n  required: boolean;\n}\n\n/**\n * Resolves each field, eagerly validates JSON Schema support, and returns\n * a PortableSchema whose JSON Schema conversion is lazy.\n * @internal\n */\nexport function createConfigSchema(\n  fields: Record<string, StandardSchemaV1>,\n): PortableSchema {\n  const resolved: Record<string, ResolvedField> = {};\n\n  for (const [key, field] of Object.entries(fields)) {\n    resolved[key] = resolveField(key, field);\n  }\n\n  return buildPortableSchema(resolved);\n}\n\n/**\n * Assembles resolved fields into a PortableSchema with per-field\n * validation (eager) and lazy JSON Schema generation.\n */\nfunction buildPortableSchema<TOutput = unknown>(\n  fields: Record<string, ResolvedField>,\n): PortableSchema<TOutput> {\n  function parse(input: unknown) {\n    if (\n      input !== undefined &&\n      input !== null &&\n      (typeof input !== 'object' || Array.isArray(input))\n    ) {\n      throw new Error(\n        `Invalid config input, expected object but got ${\n          Array.isArray(input) ? 'array' : typeof input\n        }`,\n      );\n    }\n    const inputObj = (input ?? {}) as Record<string, unknown>;\n    const result: Record<string, unknown> = {};\n    const errors: string[] = [];\n\n    for (const [key, field] of Object.entries(fields)) {\n      const validated = field.validate(inputObj[key]);\n      if ('errors' in validated) {\n        errors.push(...validated.errors);\n      } else if (validated.value !== undefined || key in inputObj) {\n        result[key] = validated.value;\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new Error(errors.join('; '));\n    }\n\n    return result as TOutput;\n  }\n\n  let cached: { schema: JsonObject } | undefined;\n\n  return {\n    parse,\n    schema() {\n      if (!cached) {\n        cached = { schema: buildObjectJsonSchema(fields) };\n      }\n      return cached;\n    },\n  };\n}\n\n/**\n * Wraps a single schema into a ResolvedField. Eagerly validates that\n * JSON Schema conversion will be possible, but defers the actual\n * conversion until toJsonSchema() is called.\n */\nfunction resolveField(key: string, schema: unknown): ResolvedField {\n  if (isZodV3Type(schema)) {\n    throw new Error(\n      `Config schema for field '${key}' uses a Zod v3 schema, which is ` +\n        `not supported by the \\`configSchema\\` option. Upgrade to the ` +\n        `\\`zod\\` v4 package (\\`zod@^4.0.0\\`). Note that the \\`zod/v4\\` ` +\n        `subpath export from the zod v3 package is also not supported, ` +\n        `as it does not include JSON Schema conversion.`,\n    );\n  }\n  if (isStandardSchema(schema)) {\n    if (!hasJsonSchemaConverter(schema)) {\n      throw new Error(\n        `Config schema for field '${key}' does not support JSON Schema ` +\n          `conversion. Use a schema library that implements the Standard ` +\n          `JSON Schema interface (like zod v4+).`,\n      );\n    }\n    return resolveStandardField(key, schema);\n  }\n  throw new Error(\n    `Config schema for field '${key}' is not a valid Standard Schema`,\n  );\n}\n\nfunction resolveStandardField(\n  key: string,\n  schema: StandardSchemaV1 & {\n    '~standard': { jsonSchema: { input: Function } };\n  },\n): ResolvedField {\n  const required = isFieldRequired(schema);\n\n  return {\n    validate(value) {\n      const result = schema['~standard'].validate(value);\n      if (result instanceof Promise) {\n        throw new Error(\n          `Config schema for '${key}' returned a Promise — async schemas are not supported`,\n        );\n      }\n      if (result.issues) {\n        return {\n          errors: Array.from(result.issues).map(issue =>\n            formatStandardIssue(key, issue),\n          ),\n        };\n      }\n      return { value: result.value };\n    },\n    toJsonSchema() {\n      const raw = schema['~standard'].jsonSchema.input({ target: 'draft-07' });\n      const { $schema: _, ...rest } = raw;\n      return rest as JsonObject;\n    },\n    required,\n  };\n}\n\n/** Assembles per-field JSON Schemas into a single object-level JSON Schema. */\nfunction buildObjectJsonSchema(\n  fields: Record<string, ResolvedField>,\n): JsonObject {\n  const properties: Record<string, JsonObject> = {};\n  const required: string[] = [];\n\n  for (const [key, field] of Object.entries(fields)) {\n    properties[key] = field.toJsonSchema();\n    if (field.required) {\n      required.push(key);\n    }\n  }\n\n  const schema: Record<string, unknown> = {\n    type: 'object',\n    properties,\n    additionalProperties: false,\n  };\n\n  if (required.length > 0) {\n    schema.required = required;\n  }\n\n  return schema as JsonObject;\n}\n\nfunction isZodV3Type(value: unknown): boolean {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as any)._parse === 'function' &&\n    '_def' in value\n  );\n}\n\nfunction isStandardSchema(value: unknown): value is StandardSchemaV1 {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '~standard' in value &&\n    typeof (value as any)['~standard']?.validate === 'function'\n  );\n}\n\nfunction hasJsonSchemaConverter(\n  schema: StandardSchemaV1,\n): schema is StandardSchemaV1 & {\n  '~standard': { jsonSchema: { input: Function } };\n} {\n  const std = schema['~standard'] as any;\n  return typeof std?.jsonSchema?.input === 'function';\n}\n\nfunction isFieldRequired(schema: StandardSchemaV1): boolean {\n  const result = schema['~standard'].validate(undefined);\n  if (result instanceof Promise) {\n    return true;\n  }\n  return (result.issues?.length ?? 0) > 0;\n}\n\nfunction formatStandardIssue(\n  fieldKey: string,\n  issue: StandardSchemaV1.Issue,\n): string {\n  let message = issue.message;\n  if (message === 'Required') {\n    message = 'Missing required value';\n  }\n  const path = issue.path?.length\n    ? `${fieldKey}.${issue.path\n        .map((p: PropertyKey | StandardSchemaV1.PathSegment) =>\n          typeof p === 'object' ? p.key : p,\n        )\n        .join('.')}`\n    : fieldKey;\n  return `${message} at '${path}'`;\n}\n"],"names":[],"mappings":"AAyCO,SAAS,mBACd,MAAA,EACgB;AAChB,EAAA,MAAM,WAA0C,EAAC;AAEjD,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,QAAA,CAAS,GAAG,CAAA,GAAI,YAAA,CAAa,GAAA,EAAK,KAAK,CAAA;AAAA,EACzC;AAEA,EAAA,OAAO,oBAAoB,QAAQ,CAAA;AACrC;AAMA,SAAS,oBACP,MAAA,EACyB;AACzB,EAAA,SAAS,MAAM,KAAA,EAAgB;AAC7B,IAAA,IACE,KAAA,KAAU,MAAA,IACV,KAAA,KAAU,IAAA,KACT,OAAO,UAAU,QAAA,IAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,CAAA,EACjD;AACA,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,iDACE,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA,GAAU,OAAO,KAC1C,CAAA;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,QAAA,GAAY,SAAS,EAAC;AAC5B,IAAA,MAAM,SAAkC,EAAC;AACzC,IAAA,MAAM,SAAmB,EAAC;AAE1B,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,MAAA,MAAM,SAAA,GAAY,KAAA,CAAM,QAAA,CAAS,QAAA,CAAS,GAAG,CAAC,CAAA;AAC9C,MAAA,IAAI,YAAY,SAAA,EAAW;AACzB,QAAA,MAAA,CAAO,IAAA,CAAK,GAAG,SAAA,CAAU,MAAM,CAAA;AAAA,MACjC,CAAA,MAAA,IAAW,SAAA,CAAU,KAAA,KAAU,MAAA,IAAa,OAAO,QAAA,EAAU;AAC3D,QAAA,MAAA,CAAO,GAAG,IAAI,SAAA,CAAU,KAAA;AAAA,MAC1B;AAAA,IACF;AAEA,IAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,MAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,IACnC;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,IAAI,MAAA;AAEJ,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,MAAA,GAAS;AACP,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,MAAA,GAAS,EAAE,MAAA,EAAQ,qBAAA,CAAsB,MAAM,CAAA,EAAE;AAAA,MACnD;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF;AAOA,SAAS,YAAA,CAAa,KAAa,MAAA,EAAgC;AACjE,EAAA,IAAI,WAAA,CAAY,MAAM,CAAA,EAAG;AACvB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,4BAA4B,GAAG,CAAA,wQAAA;AAAA,KAKjC;AAAA,EACF;AACA,EAAA,IAAI,gBAAA,CAAiB,MAAM,CAAA,EAAG;AAC5B,IAAA,IAAI,CAAC,sBAAA,CAAuB,MAAM,CAAA,EAAG;AACnC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,4BAA4B,GAAG,CAAA,kIAAA;AAAA,OAGjC;AAAA,IACF;AACA,IAAA,OAAO,oBAAA,CAAqB,KAAK,MAAM,CAAA;AAAA,EACzC;AACA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR,4BAA4B,GAAG,CAAA,gCAAA;AAAA,GACjC;AACF;AAEA,SAAS,oBAAA,CACP,KACA,MAAA,EAGe;AACf,EAAA,MAAM,QAAA,GAAW,gBAAgB,MAAM,CAAA;AAEvC,EAAA,OAAO;AAAA,IACL,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAW,CAAA,CAAE,SAAS,KAAK,CAAA;AACjD,MAAA,IAAI,kBAAkB,OAAA,EAAS;AAC7B,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,sBAAsB,GAAG,CAAA,2DAAA;AAAA,SAC3B;AAAA,MACF;AACA,MAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,QAAA,OAAO;AAAA,UACL,MAAA,EAAQ,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA,CAAE,GAAA;AAAA,YAAI,CAAA,KAAA,KACpC,mBAAA,CAAoB,GAAA,EAAK,KAAK;AAAA;AAChC,SACF;AAAA,MACF;AACA,MAAA,OAAO,EAAE,KAAA,EAAO,MAAA,CAAO,KAAA,EAAM;AAAA,IAC/B,CAAA;AAAA,IACA,YAAA,GAAe;AACb,MAAA,MAAM,GAAA,GAAM,OAAO,WAAW,CAAA,CAAE,WAAW,KAAA,CAAM,EAAE,MAAA,EAAQ,UAAA,EAAY,CAAA;AACvE,MAAA,MAAM,EAAE,OAAA,EAAS,CAAA,EAAG,GAAG,MAAK,GAAI,GAAA;AAChC,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA;AAAA,GACF;AACF;AAGA,SAAS,sBACP,MAAA,EACY;AACZ,EAAA,MAAM,aAAyC,EAAC;AAChD,EAAA,MAAM,WAAqB,EAAC;AAE5B,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,UAAA,CAAW,GAAG,CAAA,GAAI,KAAA,CAAM,YAAA,EAAa;AACrC,IAAA,IAAI,MAAM,QAAA,EAAU;AAClB,MAAA,QAAA,CAAS,KAAK,GAAG,CAAA;AAAA,IACnB;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAkC;AAAA,IACtC,IAAA,EAAM,QAAA;AAAA,IACN,UAAA;AAAA,IACA,oBAAA,EAAsB;AAAA,GACxB;AAEA,EAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,IAAA,MAAA,CAAO,QAAA,GAAW,QAAA;AAAA,EACpB;AAEA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,YAAY,KAAA,EAAyB;AAC5C,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,OAAQ,KAAA,CAAc,MAAA,KAAW,UAAA,IACjC,MAAA,IAAU,KAAA;AAEd;AAEA,SAAS,iBAAiB,KAAA,EAA2C;AACnE,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,WAAA,IAAe,KAAA,IACf,OAAQ,KAAA,CAAc,WAAW,CAAA,EAAG,QAAA,KAAa,UAAA;AAErD;AAEA,SAAS,uBACP,MAAA,EAGA;AACA,EAAA,MAAM,GAAA,GAAM,OAAO,WAAW,CAAA;AAC9B,EAAA,OAAO,OAAO,GAAA,EAAK,UAAA,EAAY,KAAA,KAAU,UAAA;AAC3C;AAEA,SAAS,gBAAgB,MAAA,EAAmC;AAC1D,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAW,CAAA,CAAE,SAAS,MAAS,CAAA;AACrD,EAAA,IAAI,kBAAkB,OAAA,EAAS;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAA,CAAQ,MAAA,CAAO,MAAA,EAAQ,MAAA,IAAU,CAAA,IAAK,CAAA;AACxC;AAEA,SAAS,mBAAA,CACP,UACA,KAAA,EACQ;AACR,EAAA,IAAI,UAAU,KAAA,CAAM,OAAA;AACpB,EAAA,IAAI,YAAY,UAAA,EAAY;AAC1B,IAAA,OAAA,GAAU,wBAAA;AAAA,EACZ;AACA,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,EAAM,MAAA,GACrB,GAAG,QAAQ,CAAA,CAAA,EAAI,MAAM,IAAA,CAClB,GAAA;AAAA,IAAI,CAAC,CAAA,KACJ,OAAO,CAAA,KAAM,QAAA,GAAW,EAAE,GAAA,GAAM;AAAA,GAClC,CACC,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,GACZ,QAAA;AACJ,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA,CAAA;AAC/B;;;;"}

package/dist/schema/optionalStringSchema.esm.js

@@ -0,0 +1,33 @@
+const optionalStringSchema = {
+  "~standard": {
+    version: 1,
+    vendor: "backstage",
+    validate(value) {
+      if (typeof value === "string" || value === void 0) {
+        return { value };
+      }
+      let receivedType = typeof value;
+      if (value === null) {
+        receivedType = "null";
+      } else if (Array.isArray(value)) {
+        receivedType = "array";
+      }
+      return {
+        issues: [
+          { message: `Expected a string, but received ${receivedType}` }
+        ]
+      };
+    },
+    jsonSchema: {
+      input() {
+        return { type: "string" };
+      },
+      output() {
+        return { type: "string" };
+      }
+    }
+  }
+};
+
+export { optionalStringSchema };
+//# sourceMappingURL=optionalStringSchema.esm.js.map

package/dist/schema/optionalStringSchema.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalStringSchema.esm.js","sources":["../../src/schema/optionalStringSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  StandardJSONSchemaV1,\n  StandardSchemaV1,\n} from '@standard-schema/spec';\n\nexport const optionalStringSchema: StandardSchemaV1<string | undefined> &\n  StandardJSONSchemaV1<string | undefined> = {\n  '~standard': {\n    version: 1,\n    vendor: 'backstage',\n    validate(value) {\n      if (typeof value === 'string' || value === undefined) {\n        return { value };\n      }\n      let receivedType: string = typeof value;\n      if (value === null) {\n        receivedType = 'null';\n      } else if (Array.isArray(value)) {\n        receivedType = 'array';\n      }\n      return {\n        issues: [\n          { message: `Expected a string, but received ${receivedType}` },\n        ],\n      };\n    },\n    jsonSchema: {\n      input() {\n        return { type: 'string' };\n      },\n      output() {\n        return { type: 'string' };\n      },\n    },\n  },\n};\n"],"names":[],"mappings":"AAqBO,MAAM,oBAAA,GACgC;AAAA,EAC3C,WAAA,EAAa;AAAA,IACX,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,WAAA;AAAA,IACR,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAA,EAAW;AACpD,QAAA,OAAO,EAAE,KAAA,EAAM;AAAA,MACjB;AACA,MAAA,IAAI,eAAuB,OAAO,KAAA;AAClC,MAAA,IAAI,UAAU,IAAA,EAAM;AAClB,QAAA,YAAA,GAAe,MAAA;AAAA,MACjB,CAAA,MAAA,IAAW,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC/B,QAAA,YAAA,GAAe,OAAA;AAAA,MACjB;AACA,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ;AAAA,UACN,EAAE,OAAA,EAAS,CAAA,gCAAA,EAAmC,YAAY,CAAA,CAAA;AAAG;AAC/D,OACF;AAAA,IACF,CAAA;AAAA,IACA,UAAA,EAAY;AAAA,MACV,KAAA,GAAQ;AACN,QAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAAA,MAC1B,CAAA;AAAA,MACA,MAAA,GAAS;AACP,QAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAAA,MAC1B;AAAA;AACF;AAEJ;;;;"}

package/dist/types/{alpha.d-BScvftwR.d.ts → alpha.d-gY8B1WFX.d.ts}

@@ -2,7 +2,6 @@ import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api'
 import { JSX, ComponentType, ReactNode } from 'react';
 import { Expand, JsonObject } from '@backstage/types';
 import { FilterPredicate } from '@backstage/filter-predicates';
-import { z } from 'zod/v3';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
@@ -345,7 +344,7 @@ type ExtensionArrayToMap<T extends ExtensionDefinition[], TId extends string, TO
 type MakeSortedExtensionsMap<UExtensions extends ExtensionDefinition, TId extends string> = ExtensionArrayToMap<SortExtensions<UnionToArray<UExtensions>>, TId>;
 
 /**
- * Descriptor of a route relative to an absolute {@link RouteRef}.
+ * Descriptor of a route relative to a {@link RouteRef} or another sub-route.
  *
  * @remarks
  *
@@ -407,7 +406,7 @@ type MakeSubRouteRef<Params extends {
  */
 declare function createSubRouteRef<Path extends string, ParentParams extends AnyRouteRefParams = never>(config: {
     path: Path;
-    parent: RouteRef<ParentParams>;
+    parent: RouteRef<ParentParams> | SubRouteRef<ParentParams>;
 }): MakeSubRouteRef<PathParams<Path>, ParentParams>;
 
 /**
@@ -733,8 +732,6 @@ declare function createExtensionBlueprintParams<T extends object = object>(param
  */
 type CreateExtensionBlueprintOptions<TKind extends string, TParams extends object | ExtensionBlueprintDefineParams, UOutput extends ExtensionDataRef, TInputs extends {
     [inputName in string]: ExtensionInput;
-}, TConfigSchema extends {
-    [key in string]: (zImpl: typeof z) => z.ZodType;
 }, UFactoryOutput extends ExtensionDataValue<any, any>, TDataRefs extends {
     [name in string]: ExtensionDataRef;
 }, UParentInputs extends ExtensionDataRef, TNewConfigSchema extends {
@@ -747,15 +744,6 @@ type CreateExtensionBlueprintOptions<TKind extends string, TParams extends objec
     inputs?: TInputs;
     output: Array<UOutput>;
     configSchema?: TNewConfigSchema;
-    /**
-     * @deprecated Use {@link CreateExtensionBlueprintOptions.configSchema} instead.
-     */
-    config?: {
-        /**
-         * @deprecated Use {@link CreateExtensionBlueprintOptions.configSchema} instead.
-         */
-        schema: TConfigSchema;
-    };
     /**
      * This option is used to further refine the blueprint params. When this
      * option is used, the blueprint will require params to be passed in callback
@@ -800,8 +788,6 @@ type CreateExtensionBlueprintOptions<TKind extends string, TParams extends objec
         apis: ApiHolder;
         config: {
             [key in keyof TNewConfigSchema]: StandardSchemaV1.InferOutput<TNewConfigSchema[key]>;
-        } & {
-            [key in keyof TConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TConfigSchema[key]>>;
         };
         inputs: Expand<ResolvedExtensionInputs<TInputs>>;
     }): Iterable<UFactoryOutput>;
@@ -901,52 +887,6 @@ interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionB
         name: string | undefined extends TName ? undefined : TName;
         params: T['params'];
     }>;
-    /**
-     * @deprecated Use the `configSchema` option instead of `config.schema`.
-     */
-    makeWithOverrides<TName extends string | undefined, TExtensionConfigSchema extends {
-        [key in string]: (zImpl: typeof z) => z.ZodType;
-    }, UFactoryOutput extends ExtensionDataValue<any, any>, UNewOutput extends ExtensionDataRef, UParentInputs extends ExtensionDataRef, TExtraInputs extends {
-        [inputName in string]: ExtensionInput;
-    } = {}>(args: {
-        name?: TName;
-        attachTo?: ExtensionDefinitionAttachTo<UParentInputs> & VerifyExtensionAttachTo<ExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UParentInputs>;
-        disabled?: boolean;
-        if?: FilterPredicate;
-        inputs?: TExtraInputs & {
-            [KName in keyof T['inputs']]?: `Error: Input '${KName & string}' is already defined in parent definition`;
-        };
-        output?: Array<UNewOutput>;
-        configSchema?: never;
-        config?: {
-            schema: TExtensionConfigSchema & {
-                [KName in keyof T['config']]?: `Error: Config key '${KName & string}' is already defined in parent schema`;
-            };
-        };
-        factory(originalFactory: <TParamsInput extends AnyParamsInput$1<NonNullable<T['params']>>>(params: TParamsInput extends ExtensionBlueprintDefineParams ? TParamsInput : T['params'] extends ExtensionBlueprintDefineParams ? 'Error: This blueprint uses advanced parameter types and requires you to pass parameters as using the following callback syntax: `originalFactory(defineParams => defineParams(<params>))`' : T['params'], context?: {
-            config?: T['config'];
-            inputs?: ResolvedInputValueOverrides<NonNullable<T['inputs']>>;
-        }) => ExtensionDataContainer<NonNullable<T['output']>>, context: {
-            node: AppNode;
-            apis: ApiHolder;
-            config: T['config'] & {
-                [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>>;
-            };
-            inputs: Expand<ResolvedExtensionInputs<T['inputs'] & TExtraInputs>>;
-        }): Iterable<UFactoryOutput> & VerifyExtensionFactoryOutput<ExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UFactoryOutput>;
-    }): OverridableExtensionDefinition<{
-        config: Expand<(string extends keyof TExtensionConfigSchema ? {} : {
-            [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>>;
-        }) & T['config']>;
-        configInput: Expand<(string extends keyof TExtensionConfigSchema ? {} : z.input<z.ZodObject<{
-            [key in keyof TExtensionConfigSchema]: ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>;
-        }>>) & T['configInput']>;
-        output: ExtensionDataRef extends UNewOutput ? T['output'] : UNewOutput;
-        inputs: Expand<T['inputs'] & TExtraInputs>;
-        kind: T['kind'];
-        name: string | undefined extends TName ? undefined : TName;
-        params: T['params'];
-    }>;
 }
 /**
  * Creates a new extension blueprint that encapsulates the creation of
@@ -1010,7 +950,6 @@ declare function createExtensionBlueprint<TParams extends object | ExtensionBlue
     if?: FilterPredicate;
     inputs?: TInputs;
     output: Array<UOutput>;
-    config?: never;
     configSchema?: TNewConfigSchema;
     defineParams?: TParams extends ExtensionBlueprintDefineParams ? TParams : 'The defineParams option must be a function if provided, see the docs for details';
     factory(params: TParams extends ExtensionBlueprintDefineParams ? ReturnType<TParams>['T'] : TParams, context: {
@@ -1035,50 +974,6 @@ declare function createExtensionBlueprint<TParams extends object | ExtensionBlue
     };
     dataRefs: TDataRefs;
 }>;
-/**
- * @deprecated Use the top-level `configSchema` option instead of `config.schema`.
- * @public
- */
-declare function createExtensionBlueprint<TParams extends object | ExtensionBlueprintDefineParams, UOutput extends ExtensionDataRef, TInputs extends {
-    [inputName in string]: ExtensionInput;
-}, TConfigSchema extends {
-    [key in string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, TKind extends string, UParentInputs extends ExtensionDataRef, TDataRefs extends {
-    [name in string]: ExtensionDataRef;
-} = never>(options: {
-    kind: TKind;
-    attachTo: ExtensionDefinitionAttachTo<UParentInputs> & VerifyExtensionAttachTo<UOutput, UParentInputs>;
-    disabled?: boolean;
-    if?: FilterPredicate;
-    inputs?: TInputs;
-    output: Array<UOutput>;
-    configSchema?: never;
-    config?: {
-        schema: TConfigSchema;
-    };
-    defineParams?: TParams extends ExtensionBlueprintDefineParams ? TParams : 'The defineParams option must be a function if provided, see the docs for details';
-    factory(params: TParams extends ExtensionBlueprintDefineParams ? ReturnType<TParams>['T'] : TParams, context: {
-        node: AppNode;
-        apis: ApiHolder;
-        config: {
-            [key in keyof TConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TConfigSchema[key]>>;
-        };
-        inputs: Expand<ResolvedExtensionInputs<TInputs>>;
-    }): Iterable<UFactoryOutput>;
-    dataRefs?: TDataRefs;
-} & VerifyExtensionFactoryOutput<UOutput, UFactoryOutput>): ExtensionBlueprint<{
-    kind: TKind;
-    params: TParams;
-    output: UOutput extends ExtensionDataRef<infer IData, infer IId, infer IConfig> ? ExtensionDataRef<IData, IId, IConfig> : never;
-    inputs: string extends keyof TInputs ? {} : TInputs;
-    config: string extends keyof TConfigSchema ? {} : {
-        [key in keyof TConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TConfigSchema[key]>>;
-    };
-    configInput: string extends keyof TConfigSchema ? {} : z.input<z.ZodObject<{
-        [key in keyof TConfigSchema]: ReturnType<((...args: any[]) => any) & TConfigSchema[key]>;
-    }>>;
-    dataRefs: TDataRefs;
-}>;
 
 /** @ignore */
 type ResolvedExtensionInput<TExtensionInput extends ExtensionInput> = TExtensionInput['extensionData'] extends Array<ExtensionDataRef> ? {
@@ -1146,8 +1041,6 @@ type ExtensionDefinitionAttachTo<UParentInputs extends ExtensionDataRef = Extens
 /** @public */
 type CreateExtensionOptions<TKind extends string | undefined, TName extends string | undefined, UOutput extends ExtensionDataRef, TInputs extends {
     [inputName in string]: ExtensionInput;
-}, TConfigSchema extends {
-    [key: string]: (zImpl: typeof z) => z.ZodType;
 }, UFactoryOutput extends ExtensionDataValue<any, any>, UParentInputs extends ExtensionDataRef, TNewConfigSchema extends {
     [key: string]: StandardSchemaV1;
 } = {}> = {
@@ -1159,22 +1052,11 @@ type CreateExtensionOptions<TKind extends string | undefined, TName extends stri
     inputs?: TInputs;
     output: Array<UOutput>;
     configSchema?: TNewConfigSchema;
-    /**
-     * @deprecated Use {@link CreateExtensionOptions.configSchema} instead.
-     */
-    config?: {
-        /**
-         * @deprecated Use {@link CreateExtensionOptions.configSchema} instead.
-         */
-        schema: TConfigSchema;
-    };
     factory(context: {
         node: AppNode;
         apis: ApiHolder;
         config: {
             [key in keyof TNewConfigSchema]: StandardSchemaV1.InferOutput<TNewConfigSchema[key]>;
-        } & {
-            [key in keyof TConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TConfigSchema[key]>>;
         };
         inputs: Expand<ResolvedExtensionInputs<TInputs>>;
     }): Iterable<UFactoryOutput>;
@@ -1257,54 +1139,6 @@ interface OverridableExtensionDefinition<T extends ExtensionDefinitionParameters
             [key in keyof TNewExtensionConfigSchema]?: StandardSchemaV1.InferInput<TNewExtensionConfigSchema[key]>;
         };
     }>;
-    /**
-     * @deprecated Use the `configSchema` option instead of `config.schema`.
-     */
-    override<TExtensionConfigSchema extends {
-        [key in string]: (zImpl: typeof z) => z.ZodType;
-    }, UFactoryOutput extends ExtensionDataValue<any, any>, UNewOutput extends ExtensionDataRef, TExtraInputs extends {
-        [inputName in string]: ExtensionInput;
-    }, TParamsInput extends AnyParamsInput<NonNullable<T['params']>>, UParentInputs extends ExtensionDataRef>(args: Expand<{
-        attachTo?: ExtensionDefinitionAttachTo<UParentInputs> & VerifyExtensionAttachTo<ExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UParentInputs>;
-        disabled?: boolean;
-        if?: FilterPredicate;
-        inputs?: TExtraInputs & {
-            [KName in keyof T['inputs']]?: `Error: Input '${KName & string}' is already defined in parent definition`;
-        };
-        output?: Array<UNewOutput>;
-        configSchema?: never;
-        config?: {
-            schema: TExtensionConfigSchema & {
-                [KName in keyof T['config']]?: `Error: Config key '${KName & string}' is already defined in parent schema`;
-            };
-        };
-        factory?(originalFactory: <TFactoryParamsReturn extends AnyParamsInput<NonNullable<T['params']>>>(context?: Expand<{
-            config?: T['config'];
-            inputs?: ResolvedInputValueOverrides<NonNullable<T['inputs']>>;
-        } & ([T['params']] extends [never] ? {} : {
-            params?: TFactoryParamsReturn extends ExtensionBlueprintDefineParams ? TFactoryParamsReturn : T['params'] extends ExtensionBlueprintDefineParams ? 'Error: This blueprint uses advanced parameter types and requires you to pass parameters as using the following callback syntax: `originalFactory(defineParams => defineParams(<params>))`' : Partial<T['params']>;
-        })>) => ExtensionDataContainer<NonNullable<T['output']>>, context: {
-            node: AppNode;
-            apis: ApiHolder;
-            config: T['config'] & {
-                [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>>;
-            };
-            inputs: Expand<ResolvedExtensionInputs<T['inputs'] & TExtraInputs>>;
-        }): Iterable<UFactoryOutput>;
-    } & ([T['params']] extends [never] ? {} : {
-        params?: TParamsInput extends ExtensionBlueprintDefineParams ? TParamsInput : T['params'] extends ExtensionBlueprintDefineParams ? 'Error: This blueprint uses advanced parameter types and requires you to pass parameters as using the following callback syntax: `originalFactory(defineParams => defineParams(<params>))`' : Partial<T['params']>;
-    })> & VerifyExtensionFactoryOutput<ExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UFactoryOutput>): OverridableExtensionDefinition<{
-        kind: T['kind'];
-        name: T['name'];
-        output: ExtensionDataRef extends UNewOutput ? T['output'] : UNewOutput;
-        inputs: T['inputs'] & TExtraInputs;
-        config: T['config'] & {
-            [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>>;
-        };
-        configInput: T['configInput'] & z.input<z.ZodObject<{
-            [key in keyof TExtensionConfigSchema]: ReturnType<((...args: any[]) => any) & TExtensionConfigSchema[key]>;
-        }>>;
-    }>;
 }
 /**
  * Creates a new extension definition for installation in a Backstage app.
@@ -1345,9 +1179,7 @@ declare function createExtension<UOutput extends ExtensionDataRef, TInputs exten
     [inputName in string]: ExtensionInput;
 }, UFactoryOutput extends ExtensionDataValue<any, any>, const TKind extends string | undefined = undefined, const TName extends string | undefined = undefined, UParentInputs extends ExtensionDataRef = ExtensionDataRef, TNewConfigSchema extends {
     [key: string]: StandardSchemaV1;
-} = {}>(options: CreateExtensionOptions<TKind, TName, UOutput, TInputs, {}, UFactoryOutput, UParentInputs, TNewConfigSchema> & {
-    config?: never;
-}): OverridableExtensionDefinition<{
+} = {}>(options: CreateExtensionOptions<TKind, TName, UOutput, TInputs, UFactoryOutput, UParentInputs, TNewConfigSchema>): OverridableExtensionDefinition<{
     config: {
         [key in keyof TNewConfigSchema]: StandardSchemaV1.InferOutput<TNewConfigSchema[key]>;
     };
@@ -1360,29 +1192,6 @@ declare function createExtension<UOutput extends ExtensionDataRef, TInputs exten
     kind: string | undefined extends TKind ? undefined : TKind;
     name: string | undefined extends TName ? undefined : TName;
 }>;
-/**
- * @deprecated Use the top-level `configSchema` option instead of `config.schema`.
- * @public
- */
-declare function createExtension<UOutput extends ExtensionDataRef, TInputs extends {
-    [inputName in string]: ExtensionInput;
-}, TConfigSchema extends {
-    [key: string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, const TKind extends string | undefined = undefined, const TName extends string | undefined = undefined, UParentInputs extends ExtensionDataRef = ExtensionDataRef>(options: CreateExtensionOptions<TKind, TName, UOutput, TInputs, TConfigSchema, UFactoryOutput, UParentInputs, {}> & {
-    configSchema?: never;
-}): OverridableExtensionDefinition<{
-    config: string extends keyof TConfigSchema ? {} : {
-        [key in keyof TConfigSchema]: z.infer<ReturnType<((...args: any[]) => any) & TConfigSchema[key]>>;
-    };
-    configInput: string extends keyof TConfigSchema ? {} : z.input<z.ZodObject<{
-        [key in keyof TConfigSchema]: ReturnType<((...args: any[]) => any) & TConfigSchema[key]>;
-    }>>;
-    output: UOutput extends ExtensionDataRef<infer IData, infer IId, infer IConfig> ? ExtensionDataRef<IData, IId, IConfig> : never;
-    inputs: TInputs;
-    params: never;
-    kind: string | undefined extends TKind ? undefined : TKind;
-    name: string | undefined extends TName ? undefined : TName;
-}>;
 
 /**
  * The specification for this {@link AppNode} in the {@link AppTree}.

package/dist/wiring/createExtension.esm.js

@@ -1,6 +1,6 @@
 import { resolveInputOverrides } from './resolveInputOverrides.esm.js';
-import { warnConfigSchemaPropDeprecation, mergePortableSchemas, createConfigSchema, createDeprecatedConfigSchema } from '../schema/createPortableSchema.esm.js';
-import { describeParentCallSite } from '../routing/describeParentCallSite.esm.js';
+import { createConfigSchema } from '../schema/createPortableSchema.esm.js';
+import { assertNoLegacyConfigSchema } from '../schema/assertNoLegacyConfigSchema.esm.js';
 import { OpaqueExtensionDefinition } from '../frontend-internal/src/wiring/InternalExtensionDefinition.esm.js';
 import { createExtensionDataContainer } from '../frontend-internal/src/wiring/createExtensionDataContainer.esm.js';
 import { OpaqueExtensionInput } from '../frontend-internal/src/wiring/InternalExtensionInput.esm.js';
@@ -24,13 +24,8 @@ function bindInputs(inputs, kind, name) {
   );
 }
 function createExtension(options) {
-  if (options.config?.schema) {
-    warnConfigSchemaPropDeprecation(describeParentCallSite());
-  }
-  const resolvedConfigSchema = mergePortableSchemas(
-    options.config?.schema ? createDeprecatedConfigSchema(options.config.schema) : void 0,
-    options.configSchema ? createConfigSchema(options.configSchema) : void 0
-  );
+  assertNoLegacyConfigSchema(options);
+  const resolvedConfigSchema = options.configSchema ? createConfigSchema(options.configSchema) : void 0;
   return OpaqueExtensionDefinition.createInstance("v2", {
     T: void 0,
     kind: options.kind,
@@ -85,14 +80,12 @@ function createExtension(options) {
       return `ExtensionDefinition{${parts.join(",")}}`;
     },
     override(overrideOptions) {
+      assertNoLegacyConfigSchema(overrideOptions);
       if (!Array.isArray(options.output)) {
         throw new Error(
           "Cannot override an extension that is not declared using the new format with outputs as an array"
         );
       }
-      if (overrideOptions.config?.schema) {
-        warnConfigSchemaPropDeprecation(describeParentCallSite());
-      }
       if (overrideOptions.output && !overrideOptions.factory) {
         throw new Error(
           "Refused to override output without also overriding factory"
@@ -122,12 +115,6 @@ function createExtension(options) {
           options.name
         ),
         output: overrideOptions.output ?? options.output,
-        config: options.config?.schema || overrideOptions.config?.schema ? {
-          schema: {
-            ...options.config?.schema,
-            ...overrideOptions.config?.schema
-          }
-        } : void 0,
         configSchema: options.configSchema || overrideOptions.configSchema ? {
           ...options.configSchema,
           ...overrideOptions.configSchema