create-gluon / packages/create-gluon/src / componentKindHelpText

Variable: componentKindHelpText

const componentKindHelpText: "Supported app-local component kinds:\n atom stateless Quark-based primitive; caller owns its document/ShadowRoot sheet\n molecule stateless composition of official Atoms; caller owns its sheet\n organism stateless downward Atom/Molecule composition; caller owns its sheet\n element stateful autonomous Custom Element; defineGluonElement owns its ShadowRoot sheet and cleanup\n headless behavior-only wrapper; caller owns markup, styles, activation, and deactivation\n"

Example

Explain the runtime, stylesheet, markup, and cleanup owner for each supported generated kind before interactive selection:

import { PassThrough } from 'node:stream';
import {
  AddComponentError,
  addComponent,
  addComponentHelpText,
  componentKindHelpText,
  componentKinds,
  parseAddComponentArguments,
  planComponent,
  runAddComponentCli,
  type AddComponentAction,
  type AddComponentErrorCode,
  type AddComponentOperation,
  type AddComponentOptions,
  type AddComponentResult,
  type ComponentKind,
  type ParsedAddComponentArguments,
} from 'create-gluon';

const parsed: ParsedAddComponentArguments = parseAddComponentArguments([
  'PurchaseAction', '--kind', 'molecule', '--root', '/tmp/shop', '--dry-run', '--yes',
]);
const kind: ComponentKind = parsed.kind ?? componentKinds[0];
const options = {
  kind,
  name: parsed.name!,
  root: parsed.root,
  dryRun: true,
} satisfies AddComponentOptions;
const planned: Promise<AddComponentResult> = planComponent(options);
const generated: Promise<AddComponentResult> = addComponent(options);
const operation = { path: 'src/components/index.ts', action: 'update', bytes: 80 } satisfies AddComponentOperation;
const action: AddComponentAction = operation.action;
const output = new PassThrough();
await runAddComponentCli(['--help'], { output, cwd: '/tmp/shop' });
console.log(planned, generated, action, addComponentHelpText, componentKindHelpText);
try { throw new AddComponentError('FILE_COLLISION', 'existing component'); } catch (error) {
  if (error instanceof AddComponentError) {
    const code: AddComponentErrorCode = error.code;
    console.error(code);
  }
}