Merge @comet/blocks-api into @comet/cms-api

[johnnyomair]

Description

The dedicated @comet/blocks-api package was originally introduced to support projects without CMS parts.
It turned out that this is never the case, so the separation doesn't make sense anymore.
Therefore, the @comet/blocks-api is merged into the @comet/cms-api package.

Example

• I have verified if my change requires an example

Changeset

• I have verified if my change requires a changeset

Related tasks and documents

Task: https://vivid-planet.atlassian.net/browse/COM-1120

Further information

The first commit merges the packages, the other commits add some improvements.

[johnnyomair]

I've compiled a list of newly added exports to the public API:

List of newly added exports

• AnnotationBlockMeta
• BaseBlocksBlockItemData
• BaseBlocksBlockItemInput
• BaseListBlockItemData
• BaseListBlockItemInput
• BaseOneOfBlockData
• BaseOneOfBlockInput
• BaseOneOfBlockItemData
• BaseOneOfBlockItemInput
• Block
• BlockContext
• BlockData
• BlockDataFactory
• BlockDataInterface
• BlockDataMigrationVersion
• BlockFactoryNameOrOptions
• BlockField
• BlockIndexData
• BlockInput
• BlockInputFactory
• BlockInputInterface
• BlockMetaField
• BlockMetaFieldKind
• BlockMetaInterface
• BlockMetaLiteralFieldKind
• BlockMigration
• BlockMigrationInterface
• BlocksBlockFixturesGeneratorMap
• BlockTransformerServiceInterface
• ChildBlock
• ChildBlockInput
• ColumnsBlockFactory
• composeBlocks
• createBlock
• createBlocksBlock
• createListBlock
• createOneOfBlock
• CreateOneOfBlockOptions
• createOptionalBlock
• createRichTextBlock
• createSpaceBlock
• createTextLinkBlock
• ExternalLinkBlock
• ExtractBlockData
• ExtractBlockInput
• ExtractBlockInputFactoryProps
• FlatBlocks
• getBlocksMeta
• getFieldKeys
• getMostSignificantPreviewImageUrlTemplate
• getPreviewImageUrlTemplates
• getRegisteredBlocks
• getSearchText
• inputToData
• isBlockDataInterface
• isBlockInputInterface
• OneOfBlock
• OptionalBlockInputInterface
• registerBlock
• RootBlock
• RootBlockEntity
• SearchText
• SimpleBlockInputInterface
• SpaceBlock
• strictBlockDataFactoryDecorator
• strictBlockInputFactoryDecorator
• TransformResponse
• TransformResponseArray
• transformToSave
• transformToSaveIndex
• TraversableTransformResponse
• TraversableTransformResponseArray
• typesafeMigrationPipe
• WeightedSearchText

I've reviewed the list and looked for exports which are too generic. I'd therefore propose the following changes:

• getFieldKeys -> Remove from public API, since it's only used internally
• getMostSignificantPreviewImageUrlTemplate -> Rename to getMostSignificantPreviewImageUrlTemplateFromBlock
• getPreviewImageUrlTemplates -> Rename to getPreviewImageUrlTemplatesFromBlock
• getSearchText -> Rename to getSearchTextFromBlock
• inputToData -> Rename to blockInputToData
• SearchText -> Keep, since SearchText could be used for more than blocks
• typesafeMigrationPipe -> Rename to typesafeBlockMigrationPipe
• WeightedSearchText -> Keep, since WeightedSearchText could be used for more than blocks

What do you think? Any other exports you'd like to change?

[nsams]

aren't those block specific?

• TransformResponse
• TransformResponseArray
• transformToSave
• transformToSaveIndex
• TraversableTransformResponse
• TraversableTransformResponseArray

[johnnyomair]

aren't those block specific?

You're right, I'll rename those as well

[johnnyomair]

@fraxachun do you want to review this?