@se-studio/core-data-types 1.0.167 → 1.0.169

package/CHANGELOG.md

@@ -1,9 +1,22 @@
 # @se-studio/core-data-types
 
+## 1.0.169
+
+### Patch Changes
+
+- 16e795f: Fix `indexOfType` to use CMS-facing type keys (`componentType`, `collectionType`, `externalComponentType`) instead of structural `type`. Adds shared `getContentTypeKey()` helper. Fixes #41.
+
+## 1.0.168
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.167
 
 ### Patch Changes
 
+- Version bump: patch for changed packages
 - ccad4d9: Document external component type discriminator (#34): projects must use `externalComponentType` (Contentful field name), not `externalType`. Restore deferred discriminator pattern on `IBaseExternalComponent`. Consumer upgrade guide: `docs/UPGRADE_EXTERNAL_COMPONENT_TYPE.md`.
 
 ## 1.0.166

package/README.md

@@ -92,7 +92,7 @@ type PartialPage = DeepPartial<IPage>;
   - Tag / tag type `show?: boolean` - Visual display on cards and detail pages only (`false` hides; unset = visible). Distinct from `hidden` and `indexed` on `IInternalLink`
   - `date?: string` - Publication date
   - `author?: IPersonLink` - Optional author
-  - `externalLink?: string | null` - Override href with an external URL
+  - `externalLink?: string | null` - Supplementary external URL (e.g. DOI or publisher link). On `IArticleLink`, `href` is the internal detail URL when the article has article-level body content (`topContent`, `content`, or `bottomContent` on the article entry; article-type `articlePageTopContent` does not count); external-only articles use `externalLink` as `href`.
   - `download?: IDownloadAsset` - Optional downloadable asset
   - `subtitle?: string` - Article subtitle (e.g. customer name for case studies)
   - `visuals?: ReadonlyArray<IVisual>` - Additional visuals beyond the featured image; used for article browser / gallery views

package/dist/index.d.ts

@@ -43,5 +43,6 @@ export type { IBaseTag, IBaseTags, IBaseTagType } from './types/tag';
 export { isTag, isTags, } from './types/tag';
 export type { Horizontal, IAnimation, IExternalVideo, IFullVideo, IImage, ILocalVideo, IOptimisedSvg, IPicture, IResponsiveVisual, ISvgData, ISvgImage, IVideo, IVideoDetails, IVideoEmbed, IVisual, IVisualCommon, IVisualSizes, Vertical, } from './types/visual';
 export { getVisualHorizontalPosition, getVisualWidthPercent, isAnimation, isExternalVideo, isFullVideo, isImage, isLocalVideo, isPicture, isResponsiveVisual, isSvgData, isSvgImage, isVideo, isVisual, isVisualAnimation, isVisualImage, isVisualVideo, processSizes, } from './types/visual';
+export { getContentTypeKey } from './utils/getContentTypeKey';
 export { orderContentWithHtmlHeroFirst } from './utils/orderContentWithHtmlHeroFirst';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,MAAM,EACN,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,MAAM,EACN,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/index.js

@@ -36,5 +36,6 @@ export { isCustomType } from './types/customType';
 export { isPage } from './types/page';
 export { isTag, isTags, } from './types/tag';
 export { getVisualHorizontalPosition, getVisualWidthPercent, isAnimation, isExternalVideo, isFullVideo, isImage, isLocalVideo, isPicture, isResponsiveVisual, isSvgData, isSvgImage, isVideo, isVisual, isVisualAnimation, isVisualImage, isVisualVideo, processSizes, } from './types/visual';
+export { getContentTypeKey } from './utils/getContentTypeKey';
 export { orderContentWithHtmlHeroFirst } from './utils/orderContentWithHtmlHeroFirst';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAqC1C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,8BAA8B;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AAqBrB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAqC1C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,8BAA8B;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AAqBrB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/utils/getContentTypeKey.d.ts

@@ -0,0 +1,7 @@
+import type { ITyped } from '../types/common';
+/**
+ * Returns the CMS-facing type key used for renderer lookup and position metadata.
+ * Component → componentType, Collection → collectionType, External component → externalComponentType.
+ */
+export declare function getContentTypeKey(item: ITyped): string;
+//# sourceMappingURL=getContentTypeKey.d.ts.map

package/dist/utils/getContentTypeKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContentTypeKey.d.ts","sourceRoot":"","sources":["../../src/utils/getContentTypeKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,MAAM,EACP,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/utils/getContentTypeKey.js

@@ -0,0 +1,18 @@
+/**
+ * Returns the CMS-facing type key used for renderer lookup and position metadata.
+ * Component → componentType, Collection → collectionType, External component → externalComponentType.
+ */
+export function getContentTypeKey(item) {
+    switch (item.type) {
+        case 'Component':
+            return item.componentType;
+        case 'Collection':
+            return item.collectionType;
+        case 'External component':
+            return item
+                .externalComponentType;
+        default:
+            return item.type;
+    }
+}
+//# sourceMappingURL=getContentTypeKey.js.map

package/dist/utils/getContentTypeKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContentTypeKey.js","sourceRoot":"","sources":["../../src/utils/getContentTypeKey.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW;YACd,OAAQ,IAAmD,CAAC,aAAa,CAAC;QAC5E,KAAK,YAAY;YACf,OAAQ,IAAqD,CAAC,cAAc,CAAC;QAC/E,KAAK,oBAAoB;YACvB,OAAQ,IAAmE;iBACxE,qBAAqB,CAAC;QAC3B;YACE,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;AACH,CAAC"}

package/docs/llms.md

@@ -109,6 +109,12 @@ import {
 } from '@se-studio/core-data-types';
 ```
 
+**`IArticleLink` `href` vs `externalLink`:**
+
+- `href` is internal when the article has article-level body content (`topContent`, `content`, or `bottomContent` on the article entry). Article-type `articlePageTopContent` does not count.
+- External-only articles (no article-level body content, with `externalLink`) use `externalLink` as `href`.
+- `externalLink` is always preserved on the link object when set (e.g. DOI or publisher URL alongside an on-site detail page).
+
 ## Visual / Media Types
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-data-types",
-  "version": "1.0.167",
+  "version": "1.0.169",
   "description": "Core TypeScript type definitions for SE Studio content models",
   "repository": {
     "type": "git",
@@ -39,14 +39,16 @@
     "url": "https://github.com/Something-Else-Studio/se-core-product/issues"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.15",
-    "typescript": "^6.0.3"
+    "@biomejs/biome": "^2.4.16",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
     "dev": "tsc --project tsconfig.build.json --watch",
     "type-check": "tsc --noEmit",
     "lint": "biome lint .",
+    "test": "vitest run",
     "clean": "rm -rf dist .turbo *.tsbuildinfo"
   }
 }