api: tagging top-level Loop dependencies as @Alpha (#18613)

Includes all types imported by Loop from packages that currently generate *.alpha.d.ts rollups.

---------

Co-authored-by: Tony Murphy <anthonm@microsoft.com>

common/lib/common-definitions/api-report/common-definitions.api.md

@@ -4,7 +4,7 @@
 
 ```ts
 
-// @internal @deprecated
+// @alpha @deprecated
 export type ExtendEventProvider<TBaseEvent extends IEvent, TBase extends IEventProvider<TBaseEvent>, TEvent extends TBaseEvent> = Omit<Omit<Omit<TBase, "on">, "once">, "off"> & IEventProvider<TBaseEvent> & IEventProvider<TEvent>;
 
 // @internal @deprecated
@@ -13,31 +13,31 @@ export interface IDisposable {
     readonly disposed: boolean;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export interface IErrorEvent extends IEvent {
     // @eventProperty
     (event: "error", listener: (message: any) => void): any;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export interface IEvent {
     // @eventProperty
     (event: string, listener: (...args: any[]) => void): any;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export interface IEventProvider<TEvent extends IEvent> {
     readonly off: IEventTransformer<this, TEvent>;
     readonly on: IEventTransformer<this, TEvent>;
     readonly once: IEventTransformer<this, TEvent>;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export type IEventThisPlaceHolder = {
     thisPlaceHolder: "thisPlaceHolder";
 };
 
-// @internal @deprecated
+// @alpha @deprecated
 export type IEventTransformer<TThis, TEvent extends IEvent> = TEvent extends {
     (event: infer E0, listener: (...args: infer A0) => void): any;
     (event: infer E1, listener: (...args: infer A1) => void): any;
@@ -195,7 +195,7 @@ export interface ILoggingError extends Error {
     getTelemetryProperties(): ITelemetryProperties;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export interface ITaggedTelemetryPropertyType {
     // (undocumented)
     tag: string;
@@ -245,24 +245,24 @@ export interface ITelemetryPerformanceEvent extends ITelemetryGenericEvent {
     duration?: number;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export interface ITelemetryProperties {
     // (undocumented)
     [index: string]: TelemetryEventPropertyType | ITaggedTelemetryPropertyType;
 }
 
-// @internal @deprecated
+// @alpha @deprecated
 export type ReplaceIEventThisPlaceHolder<L extends any[], TThis> = L extends any[] ? {
     [K in keyof L]: L[K] extends IEventThisPlaceHolder ? TThis : L[K];
 } : L;
 
 // @internal @deprecated
 export type TelemetryEventCategory = "generic" | "error" | "performance";
 
-// @internal @deprecated
+// @alpha @deprecated
 export type TelemetryEventPropertyType = string | number | boolean | undefined;
 
-// @internal @deprecated
+// @alpha @deprecated
 export type TransformedEvent<TThis, E, A extends any[]> = (event: E, listener: (...args: ReplaceIEventThisPlaceHolder<A, TThis>) => void) => TThis;
 
 ```

common/lib/common-definitions/src/events.ts

@@ -7,7 +7,7 @@
  * Base interface for event emitters.
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#IEvent} instead.
- * @internal
+ * @alpha
  */
 export interface IEvent {
 	/**
@@ -28,7 +28,7 @@ export interface IEvent {
  * Base interface for error event emitters.
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#IErrorEvent} instead.
- * @internal
+ * @alpha
  */
 export interface IErrorEvent extends IEvent {
 	/**
@@ -44,7 +44,7 @@ export interface IErrorEvent extends IEvent {
  * Base interface for event providers.
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#IEventProvider} instead.
- * @internal
+ * @alpha
  */
 export interface IEventProvider<TEvent extends IEvent> {
 	/**
@@ -85,7 +85,7 @@ export interface IEventProvider<TEvent extends IEvent> {
  * interface B will now extend interface A and its events
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#ExtendEventProvider} instead.
- * @internal
+ * @alpha
  */
 export type ExtendEventProvider<
 	TBaseEvent extends IEvent,
@@ -109,7 +109,7 @@ export type ExtendEventProvider<
  * The placeholder type that should be used instead of `this` in events.
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#IEventThisPlaceholder} instead.
- * @internal
+ * @alpha
  */
 // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
 export type IEventThisPlaceHolder = { thisPlaceHolder: "thisPlaceHolder" };
@@ -118,7 +118,7 @@ export type IEventThisPlaceHolder = { thisPlaceHolder: "thisPlaceHolder" };
  * Does the type replacement by changing types of {@link IEventThisPlaceHolder} to `TThis`
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#ReplaceIEventThisPlaceHolder} instead.
- * @internal
+ * @alpha
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type ReplaceIEventThisPlaceHolder<L extends any[], TThis> = L extends any[]
@@ -130,7 +130,7 @@ export type ReplaceIEventThisPlaceHolder<L extends any[], TThis> = L extends any
  * arguments and having the overload return `TTHis` as well
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#TransformedEvent} instead.
- * @internal
+ * @alpha
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type TransformedEvent<TThis, E, A extends any[]> = (
@@ -148,7 +148,7 @@ export type TransformedEvent<TThis, E, A extends any[]> = (
  * If we need to move beyond 15 we should evaluate using a mapped type pattern like `{"event":(listenerArgs)=>void}`
  *
  * @deprecated Use {@link @fluidframework/core-interfaces#IEventTransformer} instead.
- * @internal
+ * @alpha
  */
 export type IEventTransformer<TThis, TEvent extends IEvent> = TEvent extends {
 	(event: infer E0, listener: (...args: infer A0) => void);

common/lib/common-definitions/src/logger.ts

@@ -19,7 +19,7 @@ export type TelemetryEventCategory = "generic" | "error" | "performance";
  * General best practice is to explicitly log the fields you care about from objects.
  *
  * @deprecated Moved to the `@fluidframework/core-interfaces` package.
- * @internal
+ * @alpha
  */
 export type TelemetryEventPropertyType = string | number | boolean | undefined;
 
@@ -29,7 +29,7 @@ export type TelemetryEventPropertyType = string | number | boolean | undefined;
  * party scenarios. For example, tags are used to mark data that should not be stored in logs for privacy reasons.
  *
  * @deprecated Moved to the `@fluidframework/core-interfaces` package.
- * @internal
+ * @alpha
  */
 export interface ITaggedTelemetryPropertyType {
 	value: TelemetryEventPropertyType;
@@ -40,7 +40,7 @@ export interface ITaggedTelemetryPropertyType {
  * JSON-serializable properties, which will be logged with telemetry.
  *
  * @deprecated Moved to the `@fluidframework/core-interfaces` package.
- * @internal
+ * @alpha
  */
 export interface ITelemetryProperties {
 	[index: string]: TelemetryEventPropertyType | ITaggedTelemetryPropertyType;

common/lib/protocol-definitions/api-report/protocol-definitions.api.md

@@ -549,7 +549,7 @@ export enum NackErrorType {
     ThrottlingError = "ThrottlingError"
 }
 
-// @internal
+// @alpha
 export enum ScopeType {
     DocRead = "doc:read",
     DocWrite = "doc:write",

common/lib/protocol-definitions/src/scopes.ts

@@ -5,7 +5,7 @@
 
 /**
  * Defines scope access for a Container/Document.
- * @internal
+ * @alpha
  */
 export enum ScopeType {
 	/**

examples/data-objects/table-document/src/document.ts

@@ -27,6 +27,11 @@ import { debug } from "./debug";
 import { TableSlice } from "./slice";
 import { ITable, TableDocumentItem } from "./table";
 
+/**
+ * @deprecated `TableDocument` is an abandoned prototype.
+ * Please use {@link @fluidframework/matrix#SharedMatrix} with the `IMatrixProducer`/`Consumer` interfaces instead.
+ * @alpha
+ */
 export interface ITableDocumentEvents extends IEvent {
 	(
 		event: "op",
@@ -45,7 +50,7 @@ export interface ITableDocumentEvents extends IEvent {
 /**
  * @deprecated `TableDocument` is an abandoned prototype.
  * Please use {@link @fluidframework/matrix#SharedMatrix} with the `IMatrixProducer`/`Consumer` interfaces instead.
- * @internal
+ * @alpha
  */
 export class TableDocument extends DataObject<{ Events: ITableDocumentEvents }> implements ITable {
 	public static getFactory() {

examples/data-objects/table-document/src/interception/tableWithInterception.ts

@@ -31,7 +31,10 @@ import { TableDocument } from "../document";
  * @param propertyInterceptionCallback - The interception callback to be called.
  *
  * @returns A new {@link ITable} object that intercepts the methods modifying the properties of cells, rows or columns.
- * @internal
+ *
+ * @deprecated `createTableWithInterception` is an abandoned prototype.
+ * Please use {@link @fluidframework/matrix#SharedMatrix} with the `IMatrixProducer`/`Consumer` interfaces instead.
+ * @alpha
  */
 export function createTableWithInterception<T extends ITable>(
 	table: T,

examples/data-objects/table-document/src/table.ts

@@ -5,12 +5,17 @@
 
 import { PropertySet } from "@fluidframework/sequence";
 
+/**
+ * @deprecated `TableDocumentItem` is an abandoned prototype.
+ * Please use {@link @fluidframework/matrix#SharedMatrix} with the `IMatrixProducer`/`Consumer` interfaces instead.
+ * @alpha
+ */
 export type TableDocumentItem = any;
 
 /**
  * @deprecated `ITable` is an abandoned prototype.
  * Please use {@link @fluidframework/matrix#SharedMatrix} with the `IMatrixProducer`/`Consumer` interfaces instead.
- * @internal
+ * @alpha
  */
 export interface ITable {
 	readonly numRows: number;