@oicl/openbridge-webcomponents-full-bundle 2.0.0-next.117 → 2.0.0-next.119

package/script/eslint-rules.test.ts

@@ -0,0 +1,230 @@
+import {describe, expect, it} from 'vitest';
+import {RuleTester} from 'eslint';
+import tsParser from '@typescript-eslint/parser';
+
+// @ts-expect-error - eslint.config.mjs is untyped JavaScript.
+import {__testables} from '../eslint.config.mjs';
+
+const {openbridgePlugin, extractComponents, pinComponentIndex} = __testables;
+
+// The story rule resolves meta.component through a cross-file index. Pin it so
+// the tests describe the rule's behaviour rather than the current state of src/.
+pinComponentIndex({
+  'obc-stable-thing': ['stable'],
+  'obc-beta-thing': ['beta'],
+  'obc-experimental-thing': ['experimental'],
+  'obc-deprecated-thing': ['deprecated'],
+  'obc-untagged-thing': [],
+  'obc-ambiguous-thing': ['beta', 'deprecated'],
+});
+
+const ruleTester = new RuleTester({
+  languageOptions: {
+    parser: tsParser,
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+});
+
+function story(body: string) {
+  return `const meta = {\n${body}\n} satisfies Meta;\nexport default meta;\n`;
+}
+
+describe('extractComponents', () => {
+  it('reads the lifecycle tag from a class JSDoc block', () => {
+    expect(
+      extractComponents(
+        `/**\n * Does a thing.\n * @stable\n */\n@customElement('obc-thing')\nexport class Thing {}`
+      )
+    ).toMatchObject([{tag: 'obc-thing', tags: ['stable']}]);
+  });
+
+  it('tolerates a blank line between the JSDoc and the decorator', () => {
+    expect(
+      extractComponents(
+        `/**\n * @beta\n */\n\n@customElement('obc-thing')\nexport class Thing {}`
+      )
+    ).toMatchObject([{tag: 'obc-thing', tags: ['beta']}]);
+  });
+
+  it('ignores a tag in a plain block comment, which is not JSDoc', () => {
+    expect(
+      extractComponents(
+        `/* Thing\n * @deprecated\n */\n@customElement('obc-thing')\nexport class Thing {}`
+      )
+    ).toMatchObject([{tag: 'obc-thing', tags: []}]);
+  });
+
+  it('does not stretch an earlier JSDoc block across intervening code', () => {
+    expect(
+      extractComponents(
+        `/**\n * @stable\n */\nexport enum Size {}\n\n/* Thing */\n@customElement('obc-thing')\nexport class Thing {}`
+      )
+    ).toMatchObject([{tag: 'obc-thing', tags: []}]);
+  });
+
+  it('ignores a decorator written inside a JSDoc code fence', () => {
+    expect(
+      extractComponents(
+        `/**\n * \`\`\`js\n * @customElement('my-element')\n * \`\`\`\n */\nexport const customElement = () => {};`
+      )
+    ).toEqual([]);
+  });
+
+  it('reports every lifecycle tag when a class declares more than one', () => {
+    expect(
+      extractComponents(
+        `/**\n * @beta\n * @deprecated\n */\n@customElement('obc-thing')\nexport class Thing {}`
+      )
+    ).toMatchObject([{tag: 'obc-thing', tags: ['beta', 'deprecated']}]);
+  });
+
+  it('finds several components in one file', () => {
+    expect(
+      extractComponents(
+        `/**\n * @stable\n */\n@customElement('obc-a')\nexport class A {}\n\n/**\n * @beta\n */\n@customElement('obc-b')\nexport class B {}`
+      ).map((component: {tag: string; tags: string[]}) => [
+        component.tag,
+        component.tags,
+      ])
+    ).toEqual([
+      ['obc-a', ['stable']],
+      ['obc-b', ['beta']],
+    ]);
+  });
+});
+
+describe('openbridge/component-lifecycle-tag', () => {
+  it('accepts and rejects the right shapes', () => {
+    ruleTester.run(
+      'component-lifecycle-tag',
+      openbridgePlugin.rules['component-lifecycle-tag'],
+      {
+        valid: [
+          `/**\n * @stable\n */\n@customElement('obc-thing')\nexport class Thing {}`,
+          `/**\n * @deprecated\n */\n@customElement('obc-thing')\nexport class Thing {}`,
+          `export class NotAComponent {}`,
+        ],
+        invalid: [
+          {
+            code: `/**\n * Does a thing.\n */\n@customElement('obc-thing')\nexport class Thing {}`,
+            errors: [{message: /has no lifecycle tag/ as unknown as string}],
+          },
+          {
+            code: `@customElement('obc-thing')\nexport class Thing {}`,
+            errors: [{message: /has no lifecycle tag/ as unknown as string}],
+          },
+          {
+            code: `/**\n * @beta\n * @deprecated\n */\n@customElement('obc-thing')\nexport class Thing {}`,
+            errors: [
+              {
+                message:
+                  /declares more than one lifecycle tag/ as unknown as string,
+              },
+            ],
+          },
+        ],
+      }
+    );
+  });
+});
+
+describe('openbridge/story-lifecycle-tags', () => {
+  it('accepts and fixes the right shapes', () => {
+    ruleTester.run(
+      'story-lifecycle-tags',
+      openbridgePlugin.rules['story-lifecycle-tags'],
+      {
+        valid: [
+          // @stable emits no tag.
+          story(`  title: 'A/B',\n  component: 'obc-stable-thing',`),
+          story(
+            `  title: 'A/B',\n  tags: ['autodocs', '6.0'],\n  component: 'obc-stable-thing',`
+          ),
+          // Already correct.
+          story(
+            `  title: 'A/B',\n  tags: ['autodocs', 'experimental'],\n  component: 'obc-experimental-thing',`
+          ),
+          // No meta.component: the pure-function-module pattern.
+          story(`  title: 'A/B',\n  tags: ['autodocs'],`),
+          // Unresolvable, or ambiguous, components are the source rule's job.
+          story(`  title: 'A/B',\n  component: 'obc-untagged-thing',`),
+          story(`  title: 'A/B',\n  component: 'obc-ambiguous-thing',`),
+          story(`  title: 'A/B',\n  component: 'obc-unknown-thing',`),
+          // A story-level tags array is not meta.tags.
+          `const meta = {title: 'A/B', component: 'obc-stable-thing'} satisfies Meta;\nexport const Story = {tags: ['skip-test']};\n`,
+        ],
+        invalid: [
+          {
+            code: story(
+              `  title: 'A/B',\n  tags: ['autodocs', '6.0'],\n  component: 'obc-experimental-thing',`
+            ),
+            output: story(
+              `  title: 'A/B',\n  tags: ['autodocs', '6.0', 'experimental'],\n  component: 'obc-experimental-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            // The retired `wip` / `alpha` names are replaced, order preserved.
+            code: story(
+              `  title: 'A/B',\n  tags: ['autodocs', 'wip', '6.1'],\n  component: 'obc-experimental-thing',`
+            ),
+            output: story(
+              `  title: 'A/B',\n  tags: ['autodocs', '6.1', 'experimental'],\n  component: 'obc-experimental-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            code: story(
+              `  title: 'A/B',\n  tags: ['alpha'],\n  component: 'obc-beta-thing',`
+            ),
+            output: story(
+              `  title: 'A/B',\n  tags: ['beta'],\n  component: 'obc-beta-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            // A @stable component must shed a stale lifecycle tag; the whole
+            // property goes when nothing else is left in it.
+            code: story(
+              `  title: 'A/B',\n  tags: ['wip'],\n  component: 'obc-stable-thing',`
+            ),
+            output: story(`  title: 'A/B',\n  component: 'obc-stable-thing',`),
+            errors: 1,
+          },
+          {
+            code: story(
+              `  title: 'A/B',\n  tags: ['autodocs', 'wip'],\n  component: 'obc-stable-thing',`
+            ),
+            output: story(
+              `  title: 'A/B',\n  tags: ['autodocs'],\n  component: 'obc-stable-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            // No tags property at all: one is inserted after title.
+            code: story(`  title: 'A/B',\n  component: 'obc-beta-thing',`),
+            output: story(
+              `  title: 'A/B',\n  tags: ['beta'],\n  component: 'obc-beta-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            // No title either: inserted as the first property.
+            code: story(`  component: 'obc-deprecated-thing',`),
+            output: story(
+              `  tags: ['deprecated'],\n  component: 'obc-deprecated-thing',`
+            ),
+            errors: 1,
+          },
+          {
+            // A plain `const meta = {…}` with no `satisfies` clause.
+            code: `const meta = {\n  title: 'A/B',\n  component: 'obc-deprecated-thing',\n};\nexport default meta;\n`,
+            output: `const meta = {\n  title: 'A/B',\n  tags: ['deprecated'],\n  component: 'obc-deprecated-thing',\n};\nexport default meta;\n`,
+            errors: 1,
+          },
+        ],
+      }
+    );
+  });
+});

package/src/ar/building-blocks/poi-graphic-line/poi-graphic-line.stories.ts

@@ -12,7 +12,7 @@ import {
 
 const meta: Meta<ObcPoiGraphicLine> = {
   title: 'AR/Building Blocks/POI Graphic Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-graphic-line',
   argTypes: {
     lineStyle: {

package/src/ar/building-blocks/poi-header/poi-header.stories.ts

@@ -10,7 +10,7 @@ import './poi-header.js';
 
 const meta: Meta<ObcPoiHeader> = {
   title: 'AR/Building Blocks/POI Header',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-header',
   args: {
     content: '1',

package/src/ar/building-blocks/poi-line/poi-line.stories.ts

@@ -12,7 +12,7 @@ import {crossDecorator} from '../../../storybook-util.js';
 import {html} from 'lit';
 const meta: Meta<ObcPoiLine> = {
   title: 'AR/Building Blocks/POI Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   decorators: [crossDecorator],
   component: 'obc-poi-line',
   argTypes: {

package/src/ar/building-blocks/poi-pointer/poi-pointer.stories.ts

@@ -12,7 +12,7 @@ type PoiPointerArgs = {
 
 const meta: Meta<PoiPointerArgs> = {
   title: 'AR/Building Blocks/POI Pointer',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-poi-pointer',
   decorators: [
     (story) => html`

package/src/ar/building-blocks/poi-selection-frame/poi-selection-frame.stories.ts

@@ -9,7 +9,7 @@ import './poi-selection-frame.js';
 
 const meta: Meta<ObcPoiSelectionFrame> = {
   title: 'AR/Building Blocks/POI Selection Frame',
-  tags: ['autodocs', '6.1'],
+  tags: ['autodocs', '6.1', 'experimental'],
   component: 'obc-poi-selection-frame',
   args: {
     type: ObcPoiSelectionFrameType.Indicator,

package/src/ar/building-blocks/ruler-pointer/ruler-pointer.stories.ts

@@ -9,7 +9,7 @@ type RulerPointerArgs = {
 
 const meta: Meta<RulerPointerArgs> = {
   title: 'AR/Building Blocks/Ruler Pointer',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-ruler-pointer',
   decorators: [
     (story) => html`

package/src/ar/chart-object-vessel-button/chart-object-vessel-button.stories.ts

@@ -15,7 +15,7 @@ import {html} from 'lit';
 
 const meta: Meta<ObcChartObjectVesselButton> = {
   title: 'AR/Chart Object Vessel Button',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-chart-object-vessel-button',
   args: {
     number: 2,

package/src/ar/poi/poi-aton.stories.ts

@@ -101,7 +101,7 @@ const renderPoiAton = (args: ObcPoiAton) => html`
 
 const meta: Meta<ObcPoiAton> = {
   title: 'AR/POI/POI AtoN',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-aton',
   args: {
     type: ObcPoiType.Line,

package/src/ar/poi/poi-base.ts

@@ -47,6 +47,12 @@ const VALID_POI_STATES = new Set(Object.values(ObcPoiState));
  * layout-change dispatch, and visual-query logic so that each variant
  * only needs to override `renderContent()` and `getVisualNodes()`.
  *
+ * The `@fires` tag below documents the dispatch site, which lives here rather
+ * than in the variants. It is deliberately duplicated on each concrete
+ * subclass — that is where `custom-elements.json` and the framework wrappers
+ * pick the event up, since this class is not registered. Do not remove it from
+ * the subclasses. `@ignore` keeps this class out of the generated docs.
+ *
  * @fires {CustomEvent<void>} obc-poi-data-layout-change - Fired when layout-driving properties change. Bubbles and is composed.
  * @ignore
  */

package/src/ar/poi/poi-data.stories.ts

@@ -89,7 +89,7 @@ const renderPoiData = (args: ObcPoiData) => html`
 
 const meta: Meta<ObcPoiData> = {
   title: 'AR/POI/POI Data',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-data',
   args: {
     type: ObcPoiType.Line,

package/src/ar/poi/poi-vessel.stories.ts

@@ -103,7 +103,7 @@ const renderPoiVessel = (args: ObcPoiVessel) => html`
 
 const meta: Meta<ObcPoiVessel> = {
   title: 'AR/POI/POI Vessel',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-vessel',
   args: {
     type: ObcPoiType.Line,

package/src/ar/poi/poi.stories.ts

@@ -35,7 +35,7 @@ type PoiStoryArgs = {
 
 const meta: Meta<PoiStoryArgs> = {
   title: 'AR/POI/POI',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi',
   decorators: [crossDecorator],
   args: {

package/src/ar/poi-button/poi-button-aton.stories.ts

@@ -32,7 +32,7 @@ import {
 
 const meta: Meta<ObcPoiButtonAton> = {
   title: 'AR/POI Button/POI Button AtoN',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-button-aton',
   decorators: [crossDecorator],
   args: {

package/src/ar/poi-button/poi-button-data.stories.ts

@@ -15,7 +15,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<ObcPoiButtonData> = {
   title: 'AR/POI Button/POI Button Data',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-button-data',
   decorators: [crossDecorator],
   args: {

package/src/ar/poi-button/poi-button-vessel.stories.ts

@@ -32,7 +32,7 @@ import {
 
 const meta: Meta<ObcPoiButtonVessel> = {
   title: 'AR/POI Button/POI Button Vessel',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-button-vessel',
   decorators: [crossDecorator],
   args: {

package/src/ar/poi-button/poi-button.stories.ts

@@ -136,7 +136,7 @@ function startOverlappedDataButtonLoop(
 
 const meta: Meta<ObcPoiButton> = {
   title: 'AR/POI Button/POI Button',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-button',
   decorators: [crossDecorator],
   args: {

package/src/ar/poi-button/poi-button.ts

@@ -116,8 +116,8 @@ export interface ObcPoiButtonDataItem {
  * - `relation`: Optional relation icon/content rendered when `hasRelation` is true in data mode.
  *
  * ## Events
- * This component does not emit custom events.
- * - Emits a standard `click` event (`onClick` handler in framework wrappers) when activated.
+ * This component emits no custom events. A standard `click` bubbles from the
+ * internal `<button>` (`onClick` in the framework wrappers).
  *
  * ## Best Practices
  * - Keep `value`, `state`, and `selected` synchronized to avoid conflicting visual states.

package/src/ar/poi-card/poi-card.stories.ts

@@ -61,7 +61,7 @@ function renderFixedPlaceholder(text: string = 'Content') {
 
 const meta: Meta<PoiCardArgs> = {
   title: 'AR/POI Card',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-card',
   args: {
     pointerDirection: PointerDirection.None,

package/src/ar/poi-card-header/poi-card-header.stories.ts

@@ -18,7 +18,7 @@ interface PoiCardHeaderArgs {
 
 const meta: Meta<PoiCardHeaderArgs> = {
   title: 'AR/POI Card Header',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-card-header',
   args: {
     variant: ObcPoiCardHeaderVariant.Regular,

package/src/ar/poi-controller/poi-controller.stories.ts

@@ -78,7 +78,7 @@ const waitForStorySettle = async (
 
 const meta: Meta<PoiControllerArgs> = {
   title: 'AR/POI Controller',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-poi-controller',
   args: {
     fit: PoiFitMode.Contain,

package/src/ar/poi-group/poi-group.stories.ts

@@ -36,7 +36,7 @@ type PoiGroupStoryArgs = {
 
 const meta: Meta<PoiGroupStoryArgs> = {
   title: 'AR/POI Group',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-poi-group',
   decorators: [crossDecorator, compactPreviewHeightDecorator],
   args: {

package/src/ar/poi-layer/poi-layer.stories.ts

@@ -20,7 +20,7 @@ type PoiLayerArgs = {
 
 const meta: Meta<PoiLayerArgs> = {
   title: 'AR/POI Layer',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-poi-layer',
   decorators: [
     (story) => html`

package/src/ar/poi-layer-stack/poi-layer-stack.stories.ts

@@ -22,7 +22,7 @@ type PoiLayerStackArgs = {
 
 const meta: Meta<PoiLayerStackArgs> = {
   title: 'AR/POI Layer Stack',
-  tags: ['6.1'],
+  tags: ['6.1', 'experimental'],
   component: 'obc-poi-layer-stack',
   decorators: [
     (story) => html`

package/src/ar/poi-object/poi-object-aton.stories.ts

@@ -11,7 +11,7 @@ import '../../icons/icon-beacon-general-east.js';
 const meta: Meta = {
   title: 'AR/POI Object/POI Object AtoN',
   component: 'obc-poi-object-aton',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   argTypes: {
     type: {
       control: 'select',

package/src/ar/poi-object/poi-object-data.stories.ts

@@ -11,7 +11,7 @@ import '../../icons/icon-vessel-generic-default-filled.js';
 const meta: Meta = {
   title: 'AR/POI Object/POI Object Data',
   component: 'obc-poi-object-data',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   argTypes: {
     type: {
       control: 'select',

package/src/ar/poi-object/poi-object-vessel.stories.ts

@@ -12,7 +12,7 @@ import '../../icons/icon-vessel-type-psv-filled.js';
 const meta: Meta = {
   title: 'AR/POI Object/POI Object Vessel',
   component: 'obc-poi-object-vessel',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   argTypes: {
     type: {
       control: 'select',

package/src/ar/poi-object/poi-object.stories.ts

@@ -12,7 +12,7 @@ import '../../icons/icon-placeholder.js';
 const meta: Meta<ObcPoiObject> = {
   title: 'AR/POI Object/POI Object',
   component: 'obc-poi-object',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   argTypes: {
     type: {
       control: 'select',

package/src/automation/automation-input-modal/automation-input-modal.stories.ts

@@ -24,7 +24,7 @@ import {ObcNumberInputFieldTextAlign} from '../../components/number-input-field/
 
 const meta: Meta<typeof ObcAutomationInputModal> = {
   title: 'Automation/Automation Control',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-automation-input-modal',
   args: {},
 } satisfies Meta<ObcAutomationInputModal>;

package/src/automation/automation-readout/automation-readout.stories.ts

@@ -10,7 +10,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcAutomationReadout> = {
   title: 'Automation/Readouts/Readout',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'experimental'],
   component: 'obc-automation-readout',
   decorators: [crossDecorator],
   args: {

package/src/automation/automation-tank/automation-tank.stories.ts

@@ -130,7 +130,7 @@ const renderTank = (args: StoryArgs) => renderTankEl(args);
 
 const meta: Meta<StoryArgs> = {
   title: 'Automation/Tanks/Tank',
-  tags: ['autodocs', '6.0'],
+  tags: ['autodocs', '6.0', 'beta'],
   component: 'obc-automation-tank',
   args: {
     value: 9_000,

package/src/automation/bus/bus.stories.ts

@@ -5,7 +5,7 @@ import {html} from 'lit';
 
 const meta: Meta<typeof ObcBus> = {
   title: 'Automation/Automation Devices/Bus',
-  tags: ['autodocs', '6.1', 'wip'],
+  tags: ['autodocs', '6.1', 'beta'],
   component: 'obc-bus',
   args: {
     label: 'Title',

package/src/automation/corner-line/corner-line.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcCornerLine> = {
   title: 'Automation/Line/Corner Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   decorators: [crossDecorator],
   component: 'obc-corner-line',
   args: {},

package/src/automation/direction-line/direction-line.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcDirectionLine> = {
   title: 'Automation/Line/Direction',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-direction-line',
   decorators: [crossDecorator],
   args: {},

package/src/automation/end-point-line/end-point-line.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcEndPointLine> = {
   title: 'Automation/Line/End Point Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-end-point-line',
   decorators: [crossDecorator],
   argTypes: {

package/src/automation/horizontal-line/horizontal-line.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcHorizontalLine> = {
   title: 'Automation/Line/Horizontal Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-horizontal-line',
   decorators: [crossDecorator],
   argTypes: {

package/src/automation/line-cross/line-cross.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcLineCross> = {
   title: 'Automation/Line/Cross',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-line-cross',
   decorators: [crossDecorator],
   argTypes: {

package/src/automation/line-overlap/line-overlap.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcLineOverlap> = {
   title: 'Automation/Line/Overlap',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-line-overlap',
   args: {},
   decorators: [crossDecorator],

package/src/automation/three-way-line/three-way-line.stories.ts

@@ -5,7 +5,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcThreeWayLine> = {
   title: 'Automation/Line/Three Way Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-three-way-line',
   decorators: [crossDecorator],
   argTypes: {

package/src/automation/vertical-line/vertical-line.stories.ts

@@ -6,7 +6,7 @@ import {crossDecorator} from '../../storybook-util.js';
 
 const meta: Meta<typeof ObcVerticalLine> = {
   title: 'Automation/Line/Vertical Line',
-  tags: ['autodocs'],
+  tags: ['autodocs', 'deprecated'],
   component: 'obc-vertical-line',
   argTypes: {
     medium: {

package/src/automation/vertical-line/vertical-line.ts

@@ -3,7 +3,8 @@ import {property} from 'lit/decorators.js';
 import {LineMedium, lineColor, LineType, lineWidth} from '../index.js';
 import {customElement} from '../../decorator.js';
 
-/* Vertical line component
+/**
+ * Vertical line component
  *
  * The vertical line is 24px * length + 1px. +1 px to make sure that connecting lines are overlapping, to hide the gap between them.
  * @deprecated