hikkaku 0.1.0

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "hikkaku",
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "module": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./client": "./src/client/index.ts",
+    "./vite": "./src/vite/index.ts",
+    "./*": "./src/*",
+    "./blocks": "./src/blocks/index.ts"
+  },
+  "scripts": {},
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "vite": "8.0.0-beta.8",
+    "@pnsk-lab/sb3-types": "npm:@jsr/pnsk-lab__sb3-types@0.1.8"
+  }
+}

package/src/blocks/control.ts

@@ -0,0 +1,169 @@
+import { fromPrimitiveSource } from '../compiler/block-helper'
+import { block, substack, valueBlock } from '../compiler/composer'
+import type { PrimitiveSource, VariableReference } from '../compiler/types'
+
+export type StopOption =
+  | 'all'
+  | 'this script'
+  | 'other scripts in sprite'
+  | 'other scripts in stage'
+
+export const repeat = (times: PrimitiveSource<number>, handler: () => void) => {
+  const substackId = substack(handler)
+  return block('control_repeat', {
+    inputs: {
+      TIMES: fromPrimitiveSource(times),
+      ...(substackId ? { SUBSTACK: [2, substackId] } : {}),
+    },
+  })
+}
+
+export const repeatUntil = (
+  condition: PrimitiveSource<boolean>,
+  handler: () => void,
+) => {
+  const substackId = substack(handler)
+  return block('control_repeat_until', {
+    inputs: {
+      CONDITION: fromPrimitiveSource(condition),
+      ...(substackId ? { SUBSTACK: [2, substackId] } : {}),
+    },
+  })
+}
+
+export const repeatWhile = (
+  condition: PrimitiveSource<boolean>,
+  handler: () => void,
+) => {
+  const substackId = substack(handler)
+  return block('control_while', {
+    inputs: {
+      CONDITION: fromPrimitiveSource(condition),
+      ...(substackId ? { SUBSTACK: [2, substackId] } : {}),
+    },
+  })
+}
+
+export const forEach = (
+  variable: VariableReference,
+  value: PrimitiveSource<number>,
+  handler: () => void,
+) => {
+  const substackId = substack(handler)
+  return block('control_for_each', {
+    inputs: {
+      VALUE: fromPrimitiveSource(value),
+      ...(substackId ? { SUBSTACK: [2, substackId] } : {}),
+    },
+    fields: {
+      VARIABLE: [variable.name, variable.id],
+    },
+  })
+}
+
+export const forever = (handler: () => void) => {
+  const substackId = substack(handler)
+  return block('control_forever', {
+    inputs: substackId
+      ? {
+          SUBSTACK: [2, substackId],
+        }
+      : {},
+  })
+}
+
+export const wait = (seconds: PrimitiveSource<number>) => {
+  return block('control_wait', {
+    inputs: {
+      DURATION: fromPrimitiveSource(seconds),
+    },
+  })
+}
+
+export const waitUntil = (condition: PrimitiveSource<boolean>) => {
+  return block('control_wait_until', {
+    inputs: {
+      CONDITION: fromPrimitiveSource(condition),
+    },
+  })
+}
+
+export const ifThen = (
+  condition: PrimitiveSource<boolean>,
+  handler: () => void,
+) => {
+  const substackId = substack(handler)
+  return block('control_if', {
+    inputs: {
+      CONDITION: fromPrimitiveSource(condition),
+      ...(substackId ? { SUBSTACK: [2, substackId] } : {}),
+    },
+  })
+}
+
+export const ifElse = (
+  condition: PrimitiveSource<boolean>,
+  thenHandler: () => void,
+  elseHandler: () => void,
+) => {
+  const thenSubstackId = substack(thenHandler)
+  const elseSubstackId = substack(elseHandler)
+  return block('control_if_else', {
+    inputs: {
+      CONDITION: fromPrimitiveSource(condition),
+      ...(thenSubstackId ? { SUBSTACK: [2, thenSubstackId] } : {}),
+      ...(elseSubstackId ? { SUBSTACK2: [2, elseSubstackId] } : {}),
+    },
+  })
+}
+
+export const stop = (option: StopOption) => {
+  return block('control_stop', {
+    fields: {
+      STOP_OPTION: [option, null],
+    },
+  })
+}
+
+export const createClone = (target: string) => {
+  return block('control_create_clone_of', {
+    inputs: {
+      CLONE_OPTION: fromPrimitiveSource(target),
+    },
+  })
+}
+
+export const deleteThisClone = () => {
+  return block('control_delete_this_clone', {})
+}
+
+export const getCounter = () => {
+  return valueBlock('control_get_counter', {})
+}
+
+export const incrCounter = () => {
+  return block('control_incr_counter', {})
+}
+
+export const clearCounter = () => {
+  return block('control_clear_counter', {})
+}
+
+export const controlStartAsClone = (stack?: () => void) => {
+  const res = block('control_start_as_clone', {
+    topLevel: true,
+  })
+  stack?.()
+  return res
+}
+
+export const allAtOnce = (handler: () => void) => {
+  const substackId = substack(handler)
+  return block('control_all_at_once', {
+    inputs: substackId
+      ? {
+          SUBSTACK: [2, substackId],
+        }
+      : {},
+  })
+}

package/src/blocks/data.ts

@@ -0,0 +1,203 @@
+import type { Fields } from '@pnsk-lab/sb3-types'
+import { fromPrimitiveSource } from '../compiler/block-helper'
+import { block, valueBlock } from '../compiler/composer'
+import type {
+  ListReference,
+  PrimitiveSource,
+  VariableReference,
+} from '../compiler/types'
+
+export type ListIndex = PrimitiveSource<number | string>
+
+const toField = (field: VariableReference | ListReference): Fields => [
+  field.name,
+  field.id,
+]
+
+export const getVariable = (variable: VariableReference) => {
+  return valueBlock('data_variable', {
+    fields: {
+      VARIABLE: toField(variable),
+    },
+  })
+}
+
+export const setVariableTo = (
+  variable: VariableReference,
+  value: PrimitiveSource<number | string>,
+) => {
+  return block('data_setvariableto', {
+    inputs: {
+      VALUE: fromPrimitiveSource(value),
+    },
+    fields: {
+      VARIABLE: toField(variable),
+    },
+  })
+}
+
+export const changeVariableBy = (
+  variable: VariableReference,
+  value: PrimitiveSource<number>,
+) => {
+  return block('data_changevariableby', {
+    inputs: {
+      VALUE: fromPrimitiveSource(value),
+    },
+    fields: {
+      VARIABLE: toField(variable),
+    },
+  })
+}
+
+export const showVariable = (variable: VariableReference) => {
+  return block('data_showvariable', {
+    fields: {
+      VARIABLE: toField(variable),
+    },
+  })
+}
+
+export const hideVariable = (variable: VariableReference) => {
+  return block('data_hidevariable', {
+    fields: {
+      VARIABLE: toField(variable),
+    },
+  })
+}
+
+export const getListContents = (list: ListReference) => {
+  return valueBlock('data_listcontents', {
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const addToList = (
+  list: ListReference,
+  item: PrimitiveSource<string | number>,
+) => {
+  return block('data_addtolist', {
+    inputs: {
+      ITEM: fromPrimitiveSource(item),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const deleteOfList = (list: ListReference, index: ListIndex) => {
+  return block('data_deleteoflist', {
+    inputs: {
+      INDEX: fromPrimitiveSource(index),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const deleteAllOfList = (list: ListReference) => {
+  return block('data_deletealloflist', {
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const insertAtList = (
+  list: ListReference,
+  index: ListIndex,
+  item: PrimitiveSource<string | number>,
+) => {
+  return block('data_insertatlist', {
+    inputs: {
+      INDEX: fromPrimitiveSource(index),
+      ITEM: fromPrimitiveSource(item),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const replaceItemOfList = (
+  list: ListReference,
+  index: ListIndex,
+  item: PrimitiveSource<string | number>,
+) => {
+  return block('data_replaceitemoflist', {
+    inputs: {
+      INDEX: fromPrimitiveSource(index),
+      ITEM: fromPrimitiveSource(item),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const getItemOfList = (list: ListReference, index: ListIndex) => {
+  return valueBlock('data_itemoflist', {
+    inputs: {
+      INDEX: fromPrimitiveSource(index),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const getItemNumOfList = (
+  list: ListReference,
+  item: PrimitiveSource<string | number>,
+) => {
+  return valueBlock('data_itemnumoflist', {
+    inputs: {
+      ITEM: fromPrimitiveSource(item),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const lengthOfList = (list: ListReference) => {
+  return valueBlock('data_lengthoflist', {
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const listContainsItem = (
+  list: ListReference,
+  item: PrimitiveSource<string | number>,
+) => {
+  return valueBlock('data_listcontainsitem', {
+    inputs: {
+      ITEM: fromPrimitiveSource(item),
+    },
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const showList = (list: ListReference) => {
+  return block('data_showlist', {
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}
+
+export const hideList = (list: ListReference) => {
+  return block('data_hidelist', {
+    fields: {
+      LIST: toField(list),
+    },
+  })
+}

package/src/blocks/events.ts

@@ -0,0 +1,116 @@
+import type { Input } from '@pnsk-lab/sb3-types'
+import { fromPrimitiveSource } from '../compiler/block-helper'
+import { block } from '../compiler/composer'
+import type { PrimitiveSource } from '../compiler/types'
+
+export const whenFlagClicked = (stack?: () => void) => {
+  const res = block('event_whenflagclicked', {
+    topLevel: true,
+  })
+  stack?.()
+  return res
+}
+
+export const whenKeyPressed = (key: string, stack?: () => void) => {
+  const res = block('event_whenkeypressed', {
+    topLevel: true,
+    fields: {
+      KEY_OPTION: [key, null],
+    },
+  })
+  stack?.()
+  return res
+}
+
+export const whenThisSpriteClicked = (stack?: () => void) => {
+  const res = block('event_whenthisspriteclicked', {
+    topLevel: true,
+  })
+  stack?.()
+  return res
+}
+
+export const whenStageClicked = (stack?: () => void) => {
+  const res = block('event_whenstageclicked', {
+    topLevel: true,
+  })
+  stack?.()
+  return res
+}
+
+export const whenBackdropSwitchesTo = (
+  backdrop: string,
+  stack?: () => void,
+) => {
+  const res = block('event_whenbackdropswitchesto', {
+    topLevel: true,
+    fields: {
+      BACKDROP: [backdrop, null],
+    },
+  })
+  stack?.()
+  return res
+}
+
+export const whenBroadcastReceived = (
+  broadcast: string,
+  stack?: () => void,
+) => {
+  const res = block('event_whenbroadcastreceived', {
+    topLevel: true,
+    fields: {
+      BROADCAST_OPTION: [broadcast, null],
+    },
+  })
+  stack?.()
+  return res
+}
+
+export const whenTouchingObject = (target: string, stack?: () => void) => {
+  const res = block('event_whentouchingobject', {
+    topLevel: true,
+    fields: {
+      TOUCHINGOBJECTMENU: [target, null],
+    },
+  })
+  stack?.()
+  return res
+}
+
+export const whenGreaterThan = (
+  menu: string,
+  value: PrimitiveSource<number>,
+  stack?: () => void,
+) => {
+  const res = block('event_whengreaterthan', {
+    topLevel: true,
+    inputs: {
+      VALUE: fromPrimitiveSource(value),
+    },
+    fields: {
+      WHENGREATERTHANMENU: [menu, null],
+    },
+  })
+  stack?.()
+  return res
+}
+
+export const broadcast = (message: PrimitiveSource<string>) => {
+  return block('event_broadcast', {
+    inputs: {
+      BROADCAST_INPUT:
+        typeof message === 'string'
+          ? // @ts-expect-error type issue
+            ([1, [11, message]] as Input)
+          : fromPrimitiveSource(message),
+    },
+  })
+}
+
+export const broadcastAndWait = (message: PrimitiveSource<string>) => {
+  return block('event_broadcastandwait', {
+    inputs: {
+      BROADCAST_INPUT: fromPrimitiveSource(message),
+    },
+  })
+}

package/src/blocks/index.ts

@@ -0,0 +1,9 @@
+export * from './control'
+export * from './data'
+export * from './events'
+export * from './looks'
+export * from './motion'
+export * from './operator'
+export * from './procedures'
+export * from './sensing'
+export * from './sound'

package/src/blocks/looks.ts

@@ -0,0 +1,189 @@
+import {
+  fromCostumeSource,
+  fromPrimitiveSource,
+} from '../compiler/block-helper'
+import { block, valueBlock } from '../compiler/composer'
+import type { CostumeSource, PrimitiveSource } from '../compiler/types'
+
+export type LookEffect =
+  | 'color'
+  | 'fisheye'
+  | 'whirl'
+  | 'pixelate'
+  | 'mosaic'
+  | 'brightness'
+  | 'ghost'
+
+export type FrontBack = 'front' | 'back'
+export type ForwardBackward = 'forward' | 'backward'
+export type NumberName = 'number' | 'name'
+
+export const say = (message: PrimitiveSource<string>) => {
+  return block('looks_say', {
+    inputs: {
+      MESSAGE: fromPrimitiveSource(message),
+    },
+  })
+}
+
+export const sayForSecs = (
+  message: PrimitiveSource<string>,
+  seconds: PrimitiveSource<number>,
+) => {
+  return block('looks_sayforsecs', {
+    inputs: {
+      MESSAGE: fromPrimitiveSource(message),
+      SECS: fromPrimitiveSource(seconds),
+    },
+  })
+}
+
+export const think = (message: PrimitiveSource<string>) => {
+  return block('looks_think', {
+    inputs: {
+      MESSAGE: fromPrimitiveSource(message),
+    },
+  })
+}
+
+export const thinkForSecs = (
+  message: PrimitiveSource<string>,
+  seconds: PrimitiveSource<number>,
+) => {
+  return block('looks_thinkforsecs', {
+    inputs: {
+      MESSAGE: fromPrimitiveSource(message),
+      SECS: fromPrimitiveSource(seconds),
+    },
+  })
+}
+
+export const show = () => {
+  return block('looks_show', {})
+}
+
+export const hide = () => {
+  return block('looks_hide', {})
+}
+
+export const switchCostumeTo = (costume: CostumeSource) => {
+  return block('looks_switchcostumeto', {
+    inputs: {
+      COSTUME: fromCostumeSource(costume),
+    },
+  })
+}
+
+export const nextCostume = () => {
+  return block('looks_nextcostume', {})
+}
+
+export const switchBackdropTo = (backdrop: PrimitiveSource<string>) => {
+  return block('looks_switchbackdropto', {
+    inputs: {
+      BACKDROP: fromPrimitiveSource(backdrop),
+    },
+  })
+}
+
+export const switchBackdropToAndWait = (backdrop: PrimitiveSource<string>) => {
+  return block('looks_switchbackdroptoandwait', {
+    inputs: {
+      BACKDROP: fromPrimitiveSource(backdrop),
+    },
+  })
+}
+
+export const nextBackdrop = () => {
+  return block('looks_nextbackdrop', {})
+}
+
+export const changeLooksEffectBy = (
+  effect: LookEffect,
+  value: PrimitiveSource<number>,
+) => {
+  return block('looks_changeeffectby', {
+    inputs: {
+      CHANGE: fromPrimitiveSource(value),
+    },
+    fields: {
+      EFFECT: [effect, null],
+    },
+  })
+}
+
+export const setLooksEffectTo = (
+  effect: LookEffect,
+  value: PrimitiveSource<number>,
+) => {
+  return block('looks_seteffectto', {
+    inputs: {
+      VALUE: fromPrimitiveSource(value),
+    },
+    fields: {
+      EFFECT: [effect, null],
+    },
+  })
+}
+
+export const clearGraphicEffects = () => {
+  return block('looks_cleargraphiceffects', {})
+}
+
+export const changeSizeBy = (value: PrimitiveSource<number>) => {
+  return block('looks_changesizeby', {
+    inputs: {
+      CHANGE: fromPrimitiveSource(value),
+    },
+  })
+}
+
+export const setSizeTo = (value: PrimitiveSource<number>) => {
+  return block('looks_setsizeto', {
+    inputs: {
+      SIZE: fromPrimitiveSource(value),
+    },
+  })
+}
+
+export const goToFrontBack = (position: FrontBack) => {
+  return block('looks_gotofrontback', {
+    fields: {
+      FRONT_BACK: [position, null],
+    },
+  })
+}
+
+export const goForwardBackwardLayers = (
+  direction: ForwardBackward,
+  layers: PrimitiveSource<number>,
+) => {
+  return block('looks_goforwardbackwardlayers', {
+    inputs: {
+      NUM: fromPrimitiveSource(layers),
+    },
+    fields: {
+      FORWARD_BACKWARD: [direction, null],
+    },
+  })
+}
+
+export const getSize = () => {
+  return valueBlock('looks_size', {})
+}
+
+export const getCostumeNumberName = (value: NumberName) => {
+  return valueBlock('looks_costumenumbername', {
+    fields: {
+      NUMBER_NAME: [value, null],
+    },
+  })
+}
+
+export const getBackdropNumberName = (value: NumberName) => {
+  return valueBlock('looks_backdropnumbername', {
+    fields: {
+      NUMBER_NAME: [value, null],
+    },
+  })
+}