chore: fixing the re-exporting of the types with the alpha annotation

Signed-off-by: blam <ben@blam.sh>
This commit is contained in:
blam
2022-12-22 17:33:07 +01:00
parent 33f069c805
commit c2f1010f3c
3 changed files with 307 additions and 9 deletions
+248
View File
@@ -0,0 +1,248 @@
## API Report File for "@backstage/plugin-scaffolder-react"
> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
```ts
/// <reference types="react" />
import { ApiHolder } from '@backstage/core-plugin-api';
import { Extension } from '@backstage/core-plugin-api';
import { ExternalRouteRef } from '@backstage/core-plugin-api';
import { FieldProps } from '@rjsf/core';
import { FieldProps as FieldProps_2 } from '@rjsf/utils';
import { FieldValidation } from '@rjsf/core';
import { FieldValidation as FieldValidation_2 } from '@rjsf/utils';
import type { FormProps as FormProps_2 } from '@rjsf/core-v5';
import { JsonObject } from '@backstage/types';
import { JSONSchema7 } from 'json-schema';
import { JsonValue } from '@backstage/types';
import { PathParams } from '@backstage/core-plugin-api';
import { PropsWithChildren } from 'react';
import { default as React_2 } from 'react';
import { RouteRef } from '@backstage/core-plugin-api';
import { SubRouteRef } from '@backstage/core-plugin-api';
import { TemplateEntityV1beta3 } from '@backstage/plugin-scaffolder-common';
import { UIOptionsType } from '@rjsf/utils';
import { UiSchema } from '@rjsf/utils';
// Warning: (ae-missing-release-tag) "actionsRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const actionsRouteRef: SubRouteRef<undefined>;
// @alpha
export const createFieldValidation: () => FieldValidation_2;
// @alpha
export function createNextScaffolderFieldExtension<
TReturnValue = unknown,
TInputProps extends UIOptionsType = {},
>(
options: NextFieldExtensionOptions<TReturnValue, TInputProps>,
): Extension<FieldExtensionComponent<TReturnValue, TInputProps>>;
// @public
export function createScaffolderFieldExtension<
TReturnValue = unknown,
TInputProps = unknown,
>(
options: FieldExtensionOptions<TReturnValue, TInputProps>,
): Extension<FieldExtensionComponent<TReturnValue, TInputProps>>;
// @public
export type CustomFieldExtensionSchema = {
returnValue: JSONSchema7;
uiOptions?: JSONSchema7;
};
// @public
export type CustomFieldValidator<TFieldReturnValue> = (
data: TFieldReturnValue,
field: FieldValidation,
context: {
apiHolder: ApiHolder;
},
) => void | Promise<void>;
// Warning: (ae-missing-release-tag) "editRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const editRouteRef: SubRouteRef<undefined>;
// @alpha
export const extractSchemaFromStep: (inputStep: JsonObject) => {
uiSchema: UiSchema;
schema: JsonObject;
};
// Warning: (ae-missing-release-tag) "FIELD_EXTENSION_KEY" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const FIELD_EXTENSION_KEY = 'scaffolder.extensions.field.v1';
// Warning: (ae-missing-release-tag) "FIELD_EXTENSION_WRAPPER_KEY" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const FIELD_EXTENSION_WRAPPER_KEY = 'scaffolder.extensions.wrapper.v1';
// @public
export type FieldExtensionComponent<_TReturnValue, _TInputProps> = () => null;
// @public
export interface FieldExtensionComponentProps<
TFieldReturnValue,
TUiOptions extends {} = {},
> extends FieldProps<TFieldReturnValue> {
// (undocumented)
uiSchema: FieldProps['uiSchema'] & {
'ui:options'?: TUiOptions;
};
}
// @public
export type FieldExtensionOptions<
TFieldReturnValue = unknown,
TInputProps = unknown,
> = {
name: string;
component: (
props: FieldExtensionComponentProps<TFieldReturnValue, TInputProps>,
) => JSX.Element | null;
validation?: CustomFieldValidator<TFieldReturnValue>;
schema?: CustomFieldExtensionSchema;
};
// @alpha
export type FormProps = Pick<
FormProps_2,
'transformErrors' | 'noHtml5Validate'
>;
// Warning: (ae-missing-release-tag) "legacySelectedTemplateRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public @deprecated (undocumented)
export const legacySelectedTemplateRouteRef: SubRouteRef<
PathParams<'/templates/:templateName'>
>;
// @alpha
export type NextCustomFieldValidator<TFieldReturnValue> = (
data: TFieldReturnValue,
field: FieldValidation_2,
context: {
apiHolder: ApiHolder;
formData: JsonObject;
},
) => void | Promise<void>;
// @alpha
export interface NextFieldExtensionComponentProps<
TFieldReturnValue,
TUiOptions = {},
> extends PropsWithChildren<FieldProps_2<TFieldReturnValue>> {
// (undocumented)
uiSchema?: UiSchema<TFieldReturnValue> & {
'ui:options'?: TUiOptions & UIOptionsType;
};
}
// @alpha
export type NextFieldExtensionOptions<
TFieldReturnValue = unknown,
TInputProps = unknown,
> = {
name: string;
component: (
props: NextFieldExtensionComponentProps<TFieldReturnValue, TInputProps>,
) => JSX.Element | null;
validation?: NextCustomFieldValidator<TFieldReturnValue>;
schema?: CustomFieldExtensionSchema;
};
// @alpha (undocumented)
export const nextRouteRef: RouteRef<undefined>;
// Warning: (ae-missing-release-tag) "nextScaffolderTaskRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const nextScaffolderTaskRouteRef: SubRouteRef<
PathParams<'/tasks/:taskId'>
>;
// @alpha (undocumented)
export const nextSelectedTemplateRouteRef: SubRouteRef<
PathParams<'/templates/:namespace/:templateName'>
>;
// Warning: (ae-missing-release-tag) "registerComponentRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const registerComponentRouteRef: ExternalRouteRef<undefined, true>;
// Warning: (ae-forgotten-export) The symbol "ReviewStateProps" needs to be exported by the entry point index.d.ts
//
// @alpha
export const ReviewState: (props: ReviewStateProps) => JSX.Element;
// @public (undocumented)
export const rootRouteRef: RouteRef<undefined>;
// @public
export const ScaffolderFieldExtensions: React_2.ComponentType;
// Warning: (ae-missing-release-tag) "scaffolderListTaskRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const scaffolderListTaskRouteRef: SubRouteRef<undefined>;
// Warning: (ae-missing-release-tag) "scaffolderTaskRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const scaffolderTaskRouteRef: SubRouteRef<PathParams<'/tasks/:taskId'>>;
// @public (undocumented)
export const selectedTemplateRouteRef: SubRouteRef<
PathParams<'/templates/:namespace/:templateName'>
>;
// Warning: (ae-forgotten-export) The symbol "StepperProps" needs to be exported by the entry point index.d.ts
//
// @alpha (undocumented)
export const Stepper: (props: StepperProps) => JSX.Element;
// @alpha
export const TemplateCard: (props: TemplateCardProps) => JSX.Element;
// @alpha
export interface TemplateCardProps {
// (undocumented)
deprecated?: boolean;
// (undocumented)
template: TemplateEntityV1beta3;
}
// @public
export type TemplateParameterSchema = {
title: string;
description?: string;
steps: Array<{
title: string;
description?: string;
schema: JsonObject;
}>;
};
// Warning: (ae-missing-release-tag) "viewTechDocRouteRef" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
//
// @public (undocumented)
export const viewTechDocRouteRef: ExternalRouteRef<
{
name: string;
kind: string;
namespace: string;
},
true
>;
// (No @packageDocumentation comment for this package)
```
+59 -7
View File
@@ -56,15 +56,8 @@ export {
createScaffolderFieldExtension,
ScaffolderFieldExtensions,
rootRouteRef,
nextRouteRef,
selectedTemplateRouteRef,
nextSelectedTemplateRouteRef,
createNextScaffolderFieldExtension,
type TemplateParameterSchema,
type NextCustomFieldValidator,
type NextFieldExtensionOptions,
type NextFieldExtensionComponentProps,
type FormProps,
type CustomFieldExtensionSchema,
type CustomFieldValidator,
type FieldExtensionOptions,
@@ -78,3 +71,62 @@ export type { TaskPageProps } from './components/TaskPage';
export { NextScaffolderPage } from './plugin';
export type { NextRouterProps } from './next';
export type { TemplateGroupFilter } from './next';
// These types in the future can be removed from being exported out of this package and be imported
// instead from @backstage/plugin-scaffolder-react. They have to be redeclared here to keep the alpha
// annotation in order to not polluted the main export surface.
import {
nextRouteRef as nextRouteRefTemp,
nextSelectedTemplateRouteRef as nextSelectedTemplateRouteRefTemp,
createNextScaffolderFieldExtension as createNextScaffolderFieldExtensionTemp,
type NextCustomFieldValidator as NextCustomFieldValidatorTemp,
type NextFieldExtensionOptions as NextFieldExtensionOptionsTemp,
type NextFieldExtensionComponentProps as NextFieldExtensionComponentPropsTemp,
type FormProps as FormPropsTemp,
} from '@backstage/plugin-scaffolder-react';
/**
* @alpha
*/
const nextRouteRef = nextRouteRefTemp;
/**
* @alpha
*/
const nextSelectedTemplateRouteRef = nextSelectedTemplateRouteRefTemp;
/**
* @alpha
*/
const createNextScaffolderFieldExtension =
createNextScaffolderFieldExtensionTemp;
/**
* @alpha
*/
type NextCustomFieldValidator<T> = NextCustomFieldValidatorTemp<T>;
/**
* @alpha
*/
type NextFieldExtensionOptions<
TFieldReturnValue = unknown,
TInputProps = unknown,
> = NextFieldExtensionOptionsTemp<TFieldReturnValue, TInputProps>;
/**
* @alpha
*/
type NextFieldExtensionComponentProps<
TFieldReturnValue,
TUiOptions = {},
> = NextFieldExtensionComponentPropsTemp<TFieldReturnValue, TUiOptions>;
/**
* @alpha
*/
type FormProps = FormPropsTemp;
export {
nextRouteRef,
nextSelectedTemplateRouteRef,
createNextScaffolderFieldExtension,
type NextCustomFieldValidator,
type NextFieldExtensionOptions,
type NextFieldExtensionComponentProps,
type FormProps,
};
-2
View File
@@ -16,5 +16,3 @@
export * from './Router';
export * from './TemplateListPage';
export * from './TemplateWizardPage';
export type { FormProps } from '@backstage/plugin-scaffolder-react';