@i2analyze/notebook-sdk 1.8.0 → 1.9.0-dev.1

package/lib/gen/notebook-sdk-public.d.ts

@@ -364,12 +364,12 @@ export declare namespace app {
      * A common specifier for a note, for use in mutation APIs.
      * @i2since 1.1
      */
-    export type NoteSpecifier = records.NoteId | records.INote;
+    export type NoteSpecifier = data.NoteId | data.INote;
     /**
      * A common specifier for a source reference, for use in mutation APIs.
      * @i2since 1.1
      */
-    export type SourceReferenceSpecifier = records.SourceReferenceId | records.ISourceReference;
+    export type SourceReferenceSpecifier = data.SourceReferenceId | data.ISourceReference;
     /**
      * A common specifier for a node, for use in mutation APIs.
      * @i2since 1.2
@@ -408,44 +408,62 @@ export declare namespace app {
     export type SelectionOption = 'addRecordsToSelection' | 'setSelectionToRecords' | 'setSelectionToNewRecords';
     /**
      * A common specifier for the properties of new records, for use in mutation APIs.
-     * @i2since 1.1
+     * @i2since 1.9
      */
-    export type RecordPropertiesSpecifier = Record<schema.ChartPropertyTypeId, data.PropertyValue> | Iterable<[schema.PropertyTypeSpecifier, data.PropertyValue]>;
+    export type PropertiesSpecifier = Record<schema.PropertyTypeIdentifier, data.PropertyValue> | Iterable<[schema.PropertyTypeSpecifier, data.PropertyValue]>;
     /**
-     * A common specifier for record properties that are to be edited, for use in mutation APIs.
+     * A common specifier for the properties of new records, for use in mutation APIs.
+     * @deprecated Use {@link app.PropertiesSpecifier | PropertiesSpecifier} instead.
      * @i2since 1.1
      */
-    export type EditRecordPropertiesSpecifier = Record<schema.ChartPropertyTypeId, data.PropertyValue | null> | Iterable<[schema.PropertyTypeSpecifier, data.PropertyValue | null]>;
+    export type RecordPropertiesSpecifier = PropertiesSpecifier;
     /**
-     * A set of data that is common to creating records of all types.
+     * A common specifier for properties that are to be edited, for use in mutation APIs.
+     * @i2since 1.9
+     */
+    export type EditPropertiesSpecifier = Record<schema.PropertyTypeIdentifier, data.PropertyValue | null> | Iterable<[schema.PropertyTypeSpecifier, data.PropertyValue | null]>;
+    /**
+     * A common specifier for records properties that are to be edited, for use in mutation APIs.
+     * @deprecated Use {@link app.EditPropertiesSpecifier | EditPropertiesSpecifier} instead.
      * @i2since 1.1
      */
-    export interface IChartRecordBaseData {
-        /**
-         * Gets or sets the item type of the new record.
-         * @i2since 1.1
-         */
-        itemType: schema.ChartItemTypeId | schema.IChartItemType;
+    export type EditRecordPropertiesSpecifier = EditPropertiesSpecifier;
+    /**
+     * A set of common chart data that for creating records.
+     * @i2since 1.9
+     */
+    export interface IChartBaseData {
         /**
          * Gets or sets the properties of the new record.
          * @i2since 1.1
          */
-        properties?: RecordPropertiesSpecifier;
+        properties?: PropertiesSpecifier;
         /**
          * Gets or sets the security settings of the new record.
          * @i2since 1.1
          */
-        security?: readonly records.ISecuritySetting[] | data.IKeyedReadOnlyCollection<schema.SecurityDimensionId, records.ISecuritySetting>;
+        security?: readonly data.ISecuritySetting[] | data.IKeyedReadOnlyCollection<schema.SecurityDimensionId, data.ISecuritySetting>;
         /**
          * Gets or sets the notes for the new record.
          * @i2since 1.1
          */
-        notes?: readonly records.INoteData[];
+        notes?: readonly data.INoteData[];
         /**
          * Gets or sets the source references of the new record.
          * @i2since 1.1
          */
         sourceReferences?: readonly records.ISourceReferenceData[];
+    }
+    /**
+     * A set of data that is common to creating records of all types.
+     * @i2since 1.1
+     */
+    export interface IChartRecordBaseData extends IChartBaseData {
+        /**
+         * Gets or sets the item type of the new record.
+         * @i2since 1.1
+         */
+        itemType: schema.ChartItemTypeId | schema.IChartItemType;
         /**
          * Gets or sets the source identifiers of the new record.
          * @i2since 1.1
@@ -508,8 +526,37 @@ export declare namespace app {
      * @i2since 1.1
      */
     export interface IUntrackedMutations extends IMutationsBase {
+        /**
+         * Gets an object with methods for editing the appearance of a node.
+         *
+         * @remarks
+         * Untracked edits apply only locally and are not persisted to the server.
+         * Any changes are lost on page or chart reload.
+         *
+         * @param node - The node to be edited.
+         * @returns The node-editing object.
+         * @i2since 1.9
+         */
+        editNode(node: NodeSpecifier): INodeEditor;
+        /**
+         * Gets an object with methods for editing the appearance of an edge.
+         *
+         * @remarks
+         * Untracked edits apply only locally and are not persisted to the server.
+         * Any changes are lost on page or chart reload.
+         *
+         * @param edge - The edge to be edited.
+         * @returns The edge-editing object.
+         * @i2since 1.9
+         */
+        editEdge(edge: EdgeSpecifier): IEdgeEditor;
         /**
          * Gets an object with methods for editing the appearance of an edge summary.
+         *
+         * @remarks
+         * Untracked edits apply only locally and are not persisted to the server.
+         * Any changes to edge summaries are persisted to the browser only.
+         *
          * @param edge - The edge summary to edit.
          * @returns The edge-summary-editing object.
          * @i2since 1.6
@@ -531,10 +578,10 @@ export declare namespace app {
         setLabel(label: string | undefined): this;
     }
     /**
-     * A set of methods for modifying the contents of a record.
-     * @i2since 1.1
+     * A set of methods for modifying common record data.
+     *  @i2since 1.9
      */
-    export interface IRecordEditor {
+    export interface IEditorBase {
         /**
          * Sets or clears the values of properties on the record.
          *
@@ -542,7 +589,7 @@ export declare namespace app {
          * @returns This record, with the edited properties in place.
          * @i2since 1.1
          */
-        setProperties(properties: EditRecordPropertiesSpecifier): this;
+        setProperties(properties: EditPropertiesSpecifier): this;
         /**
          * Adds a new note to the record.
          *
@@ -550,7 +597,7 @@ export declare namespace app {
          * @returns This record, with the new note in place.
          * @i2since 1.1
          */
-        addNote(noteData: records.INoteData): this;
+        addNote(noteData: data.INoteData): this;
         /**
          * Replaces an existing note on the record with a new one.
          *
@@ -559,7 +606,7 @@ export declare namespace app {
          * @returns This record, with the new note in place.
          * @i2since 1.1
          */
-        replaceNote(note: NoteSpecifier, noteData: records.INoteData): this;
+        replaceNote(note: NoteSpecifier, noteData: data.INoteData): this;
         /**
          * Removes a note from the record.
          *
@@ -575,7 +622,7 @@ export declare namespace app {
          * @returns This record, with the new source reference in place.
          * @i2since 1.1
          */
-        addSourceReference(refData: records.ISourceReferenceData): this;
+        addSourceReference(refData: data.ISourceReferenceData): this;
         /**
          * Replaces an existing source reference on the record with a new one.
          *
@@ -584,7 +631,7 @@ export declare namespace app {
          * @returns This record, with the new source reference in place.
          * @i2since 1.1
          */
-        replaceSourceReference(ref: SourceReferenceSpecifier, refData: records.ISourceReferenceData): this;
+        replaceSourceReference(ref: SourceReferenceSpecifier, refData: data.ISourceReferenceData): this;
         /**
          * Removes a source reference from the record.
          *
@@ -594,21 +641,27 @@ export declare namespace app {
          */
         removeSourceReference(ref: SourceReferenceSpecifier): this;
         /**
-         * Adds a new source identifier to the record.
+         * Replaces the record's security settings with a new set.
          *
-         * @param identifierData - The data for the new source identifier.
-         * @returns This record, with the new source identifier in place.
+         * @param security - The new security settings.
+         * @returns This record, with the new security settings in place.
          * @i2since 1.1
          */
-        addSourceIdentifier(identifierData: records.ISourceIdentifierData): this;
+        replaceSecurity(security: readonly data.ISecuritySetting[] | data.IKeyedReadOnlyCollection<schema.SecurityDimensionId, records.ISecuritySetting>): this;
+    }
+    /**
+     * A set of methods for modifying the contents of a record.
+     * @i2since 1.1
+     */
+    export interface IRecordEditor extends IEditorBase {
         /**
-         * Replaces the record's security settings with a new set.
+         * Adds a new source identifier to the record.
          *
-         * @param security - The new security settings.
-         * @returns This record, with the new security settings in place.
+         * @param identifierData - The data for the new source identifier.
+         * @returns This record, with the new source identifier in place.
          * @i2since 1.1
          */
-        replaceSecurity(security: readonly records.ISecuritySetting[] | data.IKeyedReadOnlyCollection<schema.SecurityDimensionId, records.ISecuritySetting>): this;
+        addSourceIdentifier(identifierData: records.ISourceIdentifierData): this;
         /**
          * Sets the direction of a link record.
          *
@@ -819,7 +872,7 @@ export declare namespace app {
          * @throws `Error` if the security dimension or dimension values in the data do not exist in the security schema.
          * @i2since 1.1
          */
-        createSecuritySetting(data: records.ISecuritySettingData): records.ISecuritySetting;
+        createSecuritySetting(data: data.ISecuritySettingData): data.ISecuritySetting;
         /**
          * Creates a decimal value from a number or a string.
          *
@@ -1142,7 +1195,7 @@ export declare namespace app {
          * @returns The type-editing object.
          * @i2since 1.6
          */
-        editItemType(itemType: schema.ItemTypeSpecifier): schema.IItemTypeEditor | schema.IPropertyTypesEditor;
+        editItemType(itemType: schema.ChartItemTypeSpecifier | schema.IPendingItemType): schema.IItemTypeEditor | schema.IPropertyTypesEditor;
     }
     /**
      * A collection of elements and records that together represent a selection on the chart surface.
@@ -1574,17 +1627,17 @@ export declare namespace chart {
          * Gets all the entity types in use on the chart.
          * @i2since 1.3
          */
-        readonly entityTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeId, schema.IChartEntityType>;
+        readonly entityTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeIdentifier, schema.IChartEntityType>;
         /**
          * Gets all the link types in use on the chart.
          * @i2since 1.3
          */
-        readonly linkTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeId, schema.IChartLinkType>;
+        readonly linkTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeIdentifier, schema.IChartLinkType>;
         /**
          * Gets all the entity types and link types in use on the chart.
          * @i2since 1.3
          */
-        readonly itemTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeId, schema.IChartItemType>;
+        readonly itemTypes: data.IKeyedReadOnlyCollection<schema.ChartItemTypeIdentifier, schema.IChartItemType>;
         /**
          * Fetches property values from the server of the specified types for the specified records, if they have not previously been fetched.
          *
@@ -2789,6 +2842,11 @@ export declare namespace commands {
          * @i2since 1.3
          */
         readonly toggleLists: CommandId;
+        /**
+         * Gets the identifier of the system command that toggles the list most connected UI.
+         * @i2since 1.8
+         */
+        readonly toggleListMostConnected: CommandId;
         /**
          * Gets the identifier of the system command that toggles the map UI.
          * @i2since 1.1
@@ -2829,6 +2887,11 @@ export declare namespace commands {
          * @i2since 1.8
          */
         readonly ungroupNodes: CommandId;
+        /**
+         * Gets the identifier of the system command that toggles the Time Wheel UI.
+         * @i2since 1.8
+         */
+        readonly toggleTimeWheel: CommandId;
     }
     /**
      * A lookup table for the identifiers of the system action groups in the Home tab.
@@ -3664,6 +3727,210 @@ export declare namespace data {
          */
         readonly hasLabel: boolean;
     }
+    /**
+     * A set of common chart data properties.
+     * @i2since 1.9
+     */
+    export interface IBaseChartData {
+        /**
+         * Gets the property value for the specified property type.
+         *
+         * @param propertyType - The property type or property type identifier of the value to retrieve.
+         * @returns The property value or, if not present, `undefined`.
+         * @i2since 1.0
+         */
+        getProperty(propertyType: schema.PropertyTypeSpecifier): PropertyValue | IValueNotFetched | undefined;
+        /**
+         * Gets the notes of the record.
+         * @i2since 1.0
+         */
+        readonly notes: IKeyedReadOnlyCollection<NoteId, INote>;
+        /**
+         * Gets the source references of the record.
+         * @i2since 1.0
+         */
+        readonly sourceReferences: IKeyedReadOnlyCollection<SourceReferenceId, ISourceReference>;
+        /**
+         * Gets the security settings of the record.
+         * @i2since 1.0
+         */
+        readonly security: IKeyedReadOnlyCollection<schema.SecurityDimensionId, ISecuritySetting>;
+    }
+    /**
+     * The identifier of a note.
+     * @i2since 1.0
+     */
+    export type NoteId = string;
+    /**
+     * A set of data for creating a note.
+     * @i2since 1.1
+     */
+    export interface INoteData {
+        /**
+         * Gets the contents of the new note.
+         * @i2since 1.1
+         */
+        readonly contents: string;
+    }
+    /**
+     * A note for a record.
+     * @i2since 1.0
+     */
+    export interface INote {
+        /**
+         * Gets the identifier of the note.
+         * @i2since 1.0
+         */
+        readonly id: NoteId;
+        /**
+         * Gets the creator of the note.
+         * @i2since 1.0
+         */
+        readonly creator: IUser;
+        /**
+         * Gets information about when and by whom the note was first uploaded.
+         *
+         * @returns The user who first uploaded the note and when it happened, or `undefined` if the note has not been uploaded.
+         * @i2since 1.0
+         */
+        readonly firstUploaded: IUserAndDateAndTime | undefined;
+        /**
+         * Gets information about when and by whom the note was last uploaded.
+         *
+         * @returns The user who last uploaded the note and when it happened, or `undefined` if the note has not been uploaded.
+         * @i2since 1.0
+         */
+        readonly lastUploaded: IUserAndDateAndTime | undefined;
+        /**
+         * Gets the contents of the note.
+         *
+         * @remarks
+         * See {@link schema.INotesSchema} for constraints on the contents of notes.
+         * @i2since 1.0
+         */
+        readonly contents: string;
+    }
+    /**
+     * The identifier of a source reference.
+     * @i2since 1.0
+     */
+    export type SourceReferenceId = string;
+    /**
+     * A source reference for a record.
+     *
+     * @remarks
+     * A source reference contains information about a source from which data in the record was derived.
+     * @i2since 1.0
+     */
+    export interface ISourceReference {
+        /**
+         * Gets the identifier of the source reference.
+         * @i2since 1.0
+         */
+        readonly id: SourceReferenceId;
+        /**
+         * Indicates whether the source reference is read-only.
+         * @i2since 1.8
+         */
+        readonly isReadOnly: boolean;
+        /**
+         * Gets the name of the source that the source reference describes.
+         * @i2since 1.0
+         */
+        readonly name: string;
+        /**
+         * Gets the type of the source that the source reference describes.
+         * @i2since 1.0
+         */
+        readonly type?: string;
+        /**
+         * Gets the location of the source that the source reference describes.
+         * @i2since 1.0
+         */
+        readonly location?: string;
+        /**
+         * Indicates whether it makes sense to show `location` as a hyperlink.
+         *
+         * @remarks
+         * This property is `true` if `location` is a valid URL that a plug-in can make available to users,
+         * in the same way that the i2 Notebook Record Inspector presents source reference locations.
+         * @i2since 1.0
+         */
+        readonly locationIsUrl: boolean;
+        /**
+         * Gets the description of the source that the source reference describes.
+         * @i2since 1.0
+         */
+        readonly description?: string;
+        /**
+         * Gets the URL of an image of the source that the source reference describes.
+         * @i2since 1.0
+         */
+        readonly imageUrl?: string;
+    }
+    /**
+     * A set of data for creating a source reference.
+     * @i2since 1.1
+     */
+    export interface ISourceReferenceData {
+        /**
+         * Gets the name of the source that the new source reference describes.
+         * @i2since 1.1
+         */
+        readonly name: string;
+        /**
+         * Gets the type of the source that the new source reference describes.
+         * @i2since 1.1
+         */
+        readonly type?: string;
+        /**
+         * Gets the location of the source that the new source reference describes.
+         * @i2since 1.1
+         */
+        readonly location?: string;
+        /**
+         * Gets the description of the source that the new source reference describes.
+         * @i2since 1.1
+         */
+        readonly description?: string;
+        /**
+         * Gets the URL of an image of the source that the new source reference describes.
+         * @i2since 1.1
+         */
+        readonly imageUrl?: string;
+    }
+    /**
+     * A set of dimension values for a record, from a particular security dimension.
+     * @i2since 1.0
+     */
+    export interface ISecuritySetting {
+        /**
+         * Gets the security dimension that the dimension values come from.
+         * @i2since 1.0
+         */
+        readonly dimension: schema.ISecurityDimension;
+        /**
+         * Gets the security dimension values.
+         * @i2since 1.0
+         */
+        readonly values: IReadOnlyCollection<schema.ISecurityDimensionValue>;
+    }
+    /**
+     * A set of data for creating a security setting.
+     * @i2since 1.1
+     */
+    export interface ISecuritySettingData {
+        /**
+         * Gets or sets the security dimension for the new security setting.
+         * @i2since 1.1
+         */
+        dimension: schema.SecurityDimensionId | schema.ISecurityDimension;
+        /**
+         * Gets or sets the dimension values for the new security setting.
+         * @i2since 1.1
+         */
+        values: readonly (schema.SecurityDimensionValueId | schema.ISecurityDimensionValue)[];
+    }
 }
 
 /**
@@ -4104,7 +4371,7 @@ export declare namespace records {
      * A set of information and functionality that is common to all records in i2 Notebook.
      * @i2since 1.0
      */
-    export interface IChartRecordBase {
+    export interface IChartRecordBase extends data.IBaseChartData {
         /**
          * Gets the identifier of the record.
          * @i2since 1.0
@@ -4153,14 +4420,6 @@ export declare namespace records {
          * @i2since 1.0
          */
         getUnfetchedPropertyTypes(): data.IReadOnlyCollection<schema.IChartPropertyType>;
-        /**
-         * Gets the property value for the specified property type.
-         *
-         * @param propertyType - The property type or property type identifier of the value to retrieve.
-         * @returns The property value or, if not present, `undefined`.
-         * @i2since 1.0
-         */
-        getProperty(propertyType: schema.PropertyTypeSpecifier): data.PropertyValue | data.IValueNotFetched | undefined;
         /**
          * Tests whether the record is an entity record; functions as a TypeScript typeguard.
          *
@@ -4180,21 +4439,6 @@ export declare namespace records {
          * @i2since 1.0
          */
         readonly itemType: schema.IChartItemType;
-        /**
-         * Gets the notes of the record.
-         * @i2since 1.0
-         */
-        readonly notes: data.IKeyedReadOnlyCollection<NoteId, INote>;
-        /**
-         * Gets the source references of the record.
-         * @i2since 1.0
-         */
-        readonly sourceReferences: data.IKeyedReadOnlyCollection<SourceReferenceId, ISourceReference>;
-        /**
-         * Gets the security settings of the record.
-         * @i2since 1.0
-         */
-        readonly security: data.IKeyedReadOnlyCollection<schema.SecurityDimensionId, ISecuritySetting>;
         /**
          * Gets information about when and by whom the record was first uploaded.
          *
@@ -4288,178 +4532,54 @@ export declare namespace records {
     /**
      * The identifier of a note.
      * @i2since 1.0
+     * @deprecated Use {@link data.NoteId} instead.
      */
-    export type NoteId = string;
+    export type NoteId = data.NoteId;
     /**
      * A set of data for creating a note.
      * @i2since 1.1
+     * @deprecated Use {@link data.INoteData} instead.
      */
-    export interface INoteData {
-        /**
-         * Gets the contents of the new note.
-         * @i2since 1.1
-         */
-        readonly contents: string;
-    }
+    export type INoteData = data.INoteData;
     /**
      * A note for a record.
      * @i2since 1.0
+     * @deprecated Use {@link data.INote} instead.
      */
-    export interface INote {
-        /**
-         * Gets the identifier of the note.
-         * @i2since 1.0
-         */
-        readonly id: NoteId;
-        /**
-         * Gets the creator of the note.
-         * @i2since 1.0
-         */
-        readonly creator: data.IUser;
-        /**
-         * Gets information about when and by whom the note was first uploaded.
-         *
-         * @returns The user who first uploaded the note and when it happened, or `undefined` if the note has not been uploaded.
-         * @i2since 1.0
-         */
-        readonly firstUploaded: data.IUserAndDateAndTime | undefined;
-        /**
-         * Gets information about when and by whom the note was last uploaded.
-         *
-         * @returns The user who last uploaded the note and when it happened, or `undefined` if the note has not been uploaded.
-         * @i2since 1.0
-         */
-        readonly lastUploaded: data.IUserAndDateAndTime | undefined;
-        /**
-         * Gets the contents of the note.
-         *
-         * @remarks
-         * See {@link schema.INotesSchema} for constraints on the contents of notes.
-         * @i2since 1.0
-         */
-        readonly contents: string;
-    }
+    export type INote = data.INote;
     /**
      * The identifier of a source reference.
      * @i2since 1.0
+     * @deprecated Use {@link data.SourceReferenceId} instead.
      */
-    export type SourceReferenceId = string;
+    export type SourceReferenceId = data.SourceReferenceId;
     /**
      * A source reference for a record.
      *
      * @remarks
      * A source reference contains information about a source from which data in the record was derived.
      * @i2since 1.0
+     * @deprecated Use {@link data.ISourceReference} instead.
      */
-    export interface ISourceReference {
-        /**
-         * Gets the identifier of the source reference.
-         * @i2since 1.0
-         */
-        readonly id: SourceReferenceId;
-        /**
-         * Indicates whether the source reference is read-only.
-         * @i2since 1.8
-         */
-        readonly isReadOnly: boolean;
-        /**
-         * Gets the name of the source that the source reference describes.
-         * @i2since 1.0
-         */
-        readonly name: string;
-        /**
-         * Gets the type of the source that the source reference describes.
-         * @i2since 1.0
-         */
-        readonly type?: string;
-        /**
-         * Gets the location of the source that the source reference describes.
-         * @i2since 1.0
-         */
-        readonly location?: string;
-        /**
-         * Indicates whether it makes sense to show `location` as a hyperlink.
-         *
-         * @remarks
-         * This property is `true` if `location` is a valid URL that a plug-in can make available to users,
-         * in the same way that the i2 Notebook Record Inspector presents source reference locations.
-         * @i2since 1.0
-         */
-        readonly locationIsUrl: boolean;
-        /**
-         * Gets the description of the source that the source reference describes.
-         * @i2since 1.0
-         */
-        readonly description?: string;
-        /**
-         * Gets the URL of an image of the source that the source reference describes.
-         * @i2since 1.0
-         */
-        readonly imageUrl?: string;
-    }
+    export type ISourceReference = data.ISourceReference;
     /**
      * A set of data for creating a source reference.
      * @i2since 1.1
+     * @deprecated Use {@link data.ISourceReferenceData} instead.
      */
-    export interface ISourceReferenceData {
-        /**
-         * Gets the name of the source that the new source reference describes.
-         * @i2since 1.1
-         */
-        readonly name: string;
-        /**
-         * Gets the type of the source that the new source reference describes.
-         * @i2since 1.1
-         */
-        readonly type?: string;
-        /**
-         * Gets the location of the source that the new source reference describes.
-         * @i2since 1.1
-         */
-        readonly location?: string;
-        /**
-         * Gets the description of the source that the new source reference describes.
-         * @i2since 1.1
-         */
-        readonly description?: string;
-        /**
-         * Gets the URL of an image of the source that the new source reference describes.
-         * @i2since 1.1
-         */
-        readonly imageUrl?: string;
-    }
+    export type ISourceReferenceData = data.ISourceReferenceData;
     /**
      * A set of dimension values for a record, from a particular security dimension.
      * @i2since 1.0
+     * @deprecated Use {@link data.ISecuritySetting} instead.
      */
-    export interface ISecuritySetting {
-        /**
-         * Gets the security dimension that the dimension values come from.
-         * @i2since 1.0
-         */
-        readonly dimension: schema.ISecurityDimension;
-        /**
-         * Gets the security dimension values.
-         * @i2since 1.0
-         */
-        readonly values: data.IReadOnlyCollection<schema.ISecurityDimensionValue>;
-    }
+    export type ISecuritySetting = data.ISecuritySetting;
     /**
      * A set of data for creating a security setting.
      * @i2since 1.1
+     * @deprecated Use {@link data.ISecuritySettingData} instead.
      */
-    export interface ISecuritySettingData {
-        /**
-         * Gets or sets the security dimension for the new security setting.
-         * @i2since 1.1
-         */
-        dimension: schema.SecurityDimensionId | schema.ISecurityDimension;
-        /**
-         * Gets or sets the dimension values for the new security setting.
-         * @i2since 1.1
-         */
-        values: readonly (schema.SecurityDimensionValueId | schema.ISecurityDimensionValue)[];
-    }
+    export type ISecuritySettingData = data.ISecuritySettingData;
     /**
      * A source identifier for a record.
      *
@@ -4515,17 +4635,17 @@ export declare namespace schema {
          * Gets all the entity types in the chart schema.
          * @i2since 1.0
          */
-        readonly entityTypes: data.IKeyedReadOnlyCollection<ChartItemTypeId, IChartEntityType>;
+        readonly entityTypes: data.IKeyedReadOnlyCollection<ChartItemTypeIdentifier, IChartEntityType>;
         /**
          * Gets all the link types in the chart schema.
          * @i2since 1.0
          */
-        readonly linkTypes: data.IKeyedReadOnlyCollection<ChartItemTypeId, IChartLinkType>;
+        readonly linkTypes: data.IKeyedReadOnlyCollection<ChartItemTypeIdentifier, IChartLinkType>;
         /**
          * Gets all the item types (that is, entity types _and_ link types) in the chart schema.
          * @i2since 1.0
          */
-        readonly itemTypes: data.IKeyedReadOnlyCollection<ChartItemTypeId, IChartItemType>;
+        readonly itemTypes: data.IKeyedReadOnlyCollection<ChartItemTypeIdentifier, IChartItemType>;
         /**
          * Gets the item type in the chart schema that has the specified i2 Analyze type identifier.
          * @param analyzeItemTypeId - An i2 Analyze item type identifier.
@@ -4541,7 +4661,7 @@ export declare namespace schema {
          * @returns The requested source reference schema.
          * @i2since 1.0
          */
-        getSourceReferenceSchema(itemTypeOrId: IChartItemType | ChartItemTypeId): ISourceReferenceSchema;
+        getSourceReferenceSchema(itemTypeOrId: ChartItemTypeSpecifier): ISourceReferenceSchema;
         /**
          * Gets the schema for notes.
          * @i2since 1.0
@@ -4603,7 +4723,7 @@ export declare namespace schema {
          * Gets the security dimension values to apply to new records by default.
          * @i2since 1.1
          */
-        readonly defaultSecurity: data.IKeyedReadOnlyCollection<SecurityDimensionId, records.ISecuritySetting>;
+        readonly defaultSecurity: data.IKeyedReadOnlyCollection<SecurityDimensionId, data.ISecuritySetting>;
     }
     /**
      * An identifier of a security dimension.
@@ -4720,11 +4840,16 @@ export declare namespace schema {
      * @i2since 1.0
      */
     export type AnalyzeItemTypeId = string;
+    /**
+     * A common identifier for a chart item type.
+     * @i2since 1.9
+     */
+    export type ChartItemTypeIdentifier = ChartItemTypeId | AnalyzeItemTypeId;
     /**
      * A common specifier for a chart item type.
      * @i2since 1.3
      */
-    export type ChartItemTypeSpecifier = ChartItemTypeId | IChartItemType;
+    export type ChartItemTypeSpecifier = ChartItemTypeIdentifier | IChartItemType;
     /**
      * A set of information that is common to all item types in i2 Notebook.
      * @i2since 1.0
@@ -4773,7 +4898,7 @@ export declare namespace schema {
          * Gets all the property types of the item type.
          * @i2since 1.0
          */
-        readonly propertyTypes: data.IKeyedReadOnlyCollection<ChartPropertyTypeId, IChartPropertyType>;
+        readonly propertyTypes: data.IKeyedReadOnlyCollection<PropertyTypeIdentifier, IChartPropertyType>;
         /**
          * Gets the property type that has the specified i2 Analyze type identifier.
          * @param analyzePropertyTypeId - An i2 Analyze property type identifier.
@@ -4941,21 +5066,22 @@ export declare namespace schema {
          * @returns The new, pending property type.
          * @i2since 1.6
          */
-        addPropertyType(propertyTypeData: IPropertyTypeData, insertAfter?: IChartPropertyType | IPendingPropertyType | null): IPendingPropertyType;
+        addPropertyType(propertyTypeData: IPropertyTypeData, insertAfter?: PropertyTypeSpecifier | IPendingPropertyType | null): IPendingPropertyType;
         /**
          * Gets an object with methods for editing a custom property type.
          *
-         * @param propertyType - The custom property type to be edited.
+         * @param propertyTypeSpecifier - The custom property type to be edited.
          * @returns The type-editing object.
          * @i2since 1.6
          */
-        editPropertyType(propertyType: IChartPropertyType | IPendingPropertyType): IPropertyTypeEditor;
+        editPropertyType(propertyTypeSpecifier: AnalyzePropertyTypeId | IPendingPropertyType): IPropertyTypeEditor;
         /**
          * Gets an object with methods for editing a custom property type.
          *
          * @param typeId - The identifier of the property type to be edited.
          * @param logicalType - The logical type of the property type to be edited.
          * @returns The type-editing object.
+         * @deprecated Use {@link schema.IPropertyTypesEditor.(editPropertyType:1) | editPropertyType(propertyType)} instead.
          * @i2since 1.6
          */
         editPropertyType(typeId: AnalyzePropertyTypeId, logicalType: CustomLogicalType): IPropertyTypeEditor;
@@ -5004,7 +5130,7 @@ export declare namespace schema {
          * @returns This property type, in its new position.
          * @i2since 1.6
          */
-        moveAfter(propertyType: IChartPropertyType | IPendingPropertyType | null): this;
+        moveAfter(propertyType: PropertyTypeSpecifier | IPendingPropertyType | null): this;
         /**
          * Sets whether the property type forms part of the item type's label definition.
          *
@@ -5031,7 +5157,7 @@ export declare namespace schema {
      * A common specifier for an item type.
      * @i2since 1.6
      */
-    export type ItemTypeSpecifier = AnalyzeItemTypeId | IChartItemType | IPendingItemType;
+    export type ItemTypeSpecifier = ChartItemTypeIdentifier | IChartItemType | IPendingItemType;
     /**
      * An identifier of a property type in a chart schema.
      * @i2since 1.0
@@ -5042,11 +5168,16 @@ export declare namespace schema {
      * @i2since 1.0
      */
     export type AnalyzePropertyTypeId = string;
+    /**
+     * A common identifier for a chart property type.
+     * @i2since 1.9
+     */
+    export type PropertyTypeIdentifier = ChartPropertyTypeId | AnalyzePropertyTypeId;
     /**
      * A common specifier for a chart property type.
      * @i2since 1.1
      */
-    export type PropertyTypeSpecifier = ChartPropertyTypeId | IChartPropertyType;
+    export type PropertyTypeSpecifier = PropertyTypeIdentifier | IChartPropertyType;
     /**
      * A property type.
      * @i2since 1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i2analyze/notebook-sdk",
-  "version": "1.8.0",
+  "version": "1.9.0-dev.1",
   "description": "i2 Notebook SDK",
   "license": "MIT",
   "publishConfig": {