「利用者:黄身」を編集中

=KL=

==ダウンロード==
準備中。

==概要==
新版のライブラリ。Chakraの使用を前提にkiliを作り直したもの。
{| class="wikitable"
!マクロ
!中身とか注意事項とか
|-
|KL.js<br />global.js
|Mery組み込みオブジェクトの拡張など。
|-
|polyfill.js
|Chakraで実装されていないメソッドなどの拡張。
|-
|ArrExt.js<br />StrExt.js<br />MathExt.js
|それぞれのオブジェクトへのメソッドの追加。
|-
|WidePop.js
|旧版に同じ。
|-
|ComText.js
|旧版のInsetText.jsからマッチング部分だけ抜き出したもの。
|-
|InsertOption.js
|旧版のInsetText.jsに相当。ComText.jsを使って実現する為のもの。
|-
|InsetSearch.js
|旧版のFillSearch.jsをComText.jsを使って作り直したもの。
|-
|MouseEmurator.js
|旧版に同じ。
|-
|Commentize.js
|旧版に同じ。
|-
|MoveSelection.js
|旧版に同じ。
|-
|Exes
|旧版に同じ。
|}

==KL.js==
KLを名前空間として独自のオブジェクトとMery組み込みオブジェクトの拡張を含む。

===オブジェクト===
;KL.Range（<= KILI.Range）
:範囲を表す。座標系はKL.Pointで指定する。
KL.Coord（<= KILI.Coordinate/KILI.LineMode）
:座標系posをserialに変更。logicalとviewはmePosViewとmePosLogicalに数値を合わせた
;KL.Dir（<= KILI.Direction）
:選択方向。
KL.Point（<= KILI.Point）
:座標系を指定できる様に変更。

===メソッド===
;KL.GetScroll/KL.SetScroll
:スクロール位置の取得/設定。

===組み込みオブジェクトの拡張===
旧版の機能ごとの分類からSelection/Document/Editorのラッパに変更したので、Mery組み込みの機能と独自の機能を同じ方法で呼び出せる。

e.g. 
<source lang="javascript" style="word-wrap:break-word;">
//旧版
var $d=GSO();
$s.Text=KILI.selex.getLeft();

//新版
let $s=KL.Selection();
$s.Text=$s.GetLeft();
</source>

====KL.Editor====
{| class="wikitable"
|Original
|組み込みのEditor。
|-
|Documents
|KL.Documents。
|-
|ActiveDocument
|アクティブな文書のKL.Document。組み込みのActiveDocumentではない。
|-
|NewFile
|文書を新規作成する。
|-
|GetDocument
|Documentオブジェクトを取得する。
|-
|}

====KL.Document====
{| class="wikitable"
|Original
|組み込みのDocument。
|-
|Close
|文書を閉じる。組み込みのを追加拡張している。
|-
|Selection
|KL.Selectionを取得。
|-
|LineEndingChar
|改行文字を取得する。
|-
|ToSerial
|座標を文頭からの位置に変換する。
|-
|ToLogical
|座標を論理行座標に変換する。
|-
|ToView
|座標を表示行座標に変換する。
|-
|LogicalToView
|論理行座標を表示行座標に変換する。
|-
|LogicalToSerial
|論理行座標を文頭からの位置に変換する。
|-
|SerialToLogical
|文頭からの位置を論理行座標に変換する。
|-
|SerialToView
|文頭からの位置を表示行座標に変換する。
|-
|ViewToLogical
|表示行座標を論理行座標に変換する。
|-
|ViewToSerial
|表示行座標を文書先頭からの位置に変換する。
|-
|Clone
|文書のクローンを作成する。
|-
|Lines
|行を取得する。
|-
|}

====KL.Selection====
{| class="wikitable"
|Original
|組み込みのDocument。
|-
|OriginalParent
|親となる組み込みのDocument。
|-
|Parent
|親となるKL.Documentオブジェクト。
|-
|SelectLines
|複数の行を選択する。
|-
|SelectLineRange
|複数の行を選択する。
|-
|SelectIfEmpty
|選択されていなければ選択する。
|-
|IsLogicalStart
|論理行頭かどうか判定する。
|-
|IsLogicalEnd
|論理行末かどうか判定する。
|-
|IsViewStart
|表示行頭かどうか判定する。
|-
|IsViewEnd
|表示行末かどうか判定する。
|-
|IsEOF
|文末かどうか判定する。
|-
|Inline
|行内選択かどうか判定する。
|-
|Multiline
|複数行に渡る選択かどうか判定する。
|-
|WholeLines
|行の全体を選択しているかどうか判定する。
|-
|GetRange
|選択範囲を取得する。
|-
|SetRange
|範囲選択する。
|-
|GetDirection
|テキスト選択方向を取得する。
|-
|SetDirection
|テキスト選択方向を設定する。
|-
|Reverse
|選択範囲を反転する。
|-
|GetBottomPos
|選択範囲の文末側の位置を取得する。
|-
|GetTopPos
|選択範囲の文頭側の位置を取得する。
|-
|GetAnchorPoint
|カーソル位置を取得する。
|-
|GetActivePoint
|選択範囲の開始位置を取得する。
|-
|GetBottomPoint
|選択範囲の文末側の位置を取得する。
|-
|GetTopPoint
|選択範囲の文頭側の位置を取得する。
|-
|GetLeft
|選択範囲より左の文字列を取得する。
|-
|GetRight
|選択範囲より右の文字列を取得する。
|-
|Exclude
|選択部分から文末側の改行を除外する。
|-
|Duplicate
|テキスト二重化。
|-
|Sort
|選択範囲の行または文字列をソートする。
|-
|DeleteLines
|行を削除する。
|-
|}

==global.js==
KL名前空間下に含まれず、グローバルに確保したメソッドや変数。旧版ではKILI.jsにあったものを独立させただけ。

{| class="wikitable"
|meGetLineLogical
|論理座標で指定するフラグ。
|-
|mePosCaret
|キャレット位置で指定するフラグ。
|-
|GEO
|組み込みのEditorオブジェクトを取得する。
|-
|GDO
|組み込みのDocumentオブジェクトを取得する。
|-
|GSO
|組み込みのSelectionを取得する。
|-
|O
|OutputBar.Writeへのショートカット。
|-
|RelativePath
|実行中のスクリプトから相対的にファイルパスを取得する
|-
|}

==polyfill.js==
ECMAScriptにありChakraでは使用できないものの補完。

* Array.from()
* Array.of()
* Array.prototype.copyWithin()
* Array.prototype.fill()
* Array.prototype.find()
* Array.prototype.findIndex()
* Array.prototype.flat()
* Array.prototype.flatMap()
* Array.prototype.includes()
* Math.trunc()
* Number.isFinite()
* Number.isInteger()
* Number.isNaN()
* Number.parseFloat()
* Number.parseInt()
* Object.is()
* String.fromCodePoint()
* String.prototype.codePointAt()
* String.prototype.endsWith()
* String.prototype.includes()
* String.prototype.padEnd()
* String.prototype.padStart()
* String.prototype.repeat()
* String.prototype.startsWith()
* String.prototype.trimEnd()

==Chakraへの追加==

===ArrExt.js===
{| class="wikitable"
|unique
|配列から重複を削除する。
|-
|last
|配列の最後の要素。
|-
|}

===StrExt.js===
{| class="wikitable"
|bracket
|文字列の前後に文字列を挿入する。
|-
|quote
|「'」で囲む。
|-
|parens
|「()」で囲む。
|-
|braces
|「[]」で囲む。
|-
|curls
|「{}」で囲む。
|-
|crlf
|改行コードを変換する。
|-
|insert
|文字列を挿入する。
|-
|escapeRe
|正規表現で使用される文字をエスケープする。
|-
|unescapeRe
|エスケープされた正規表現で使用される文字を戻す。
|-
|cpcount
|サロゲートペアを考慮して文字列の長さを取得する。
|-
|cpsplit
|サロゲートペアを考慮して文字列を分割する。
|-
|}

===MathExt.js===
{| class="wikitable"
|within
|n以上m以下であるか判定する。
|-
|clamp
|数値を範囲内に収める。
|-
|}

==ComText.js==
キャレット行の情報から条件を満たすテンプレートを取得し、文字列を作成する。

e.g
<source lang="javascript" style="word-wrap:break-word;">
let os=new ComText(path,option).match();
</source>
ComText.jsでは取得したテンプレートや情報を<code>options</code>のインスタンスに格納する。
デフォルトの<code>ComText.Option</code>は文字列の作成までしか行わないので、文字列の利用には別の関数に渡すか、<code>ComText.Option</code>を継承・拡張する必要がある。

==InsertOption.js==
<code>ComText.Option</code>の拡張。旧版のInsetText.jsに相当する機能を追加している。

e.g
<source lang="javascript" style="word-wrap:break-word;">
let os=new ComText(path,InsertOption).match().options;
if(os.length){
  os[0].insert();
}
</source>

==InsetSearch.js==
旧版のFillSearch.jsをComText.jsを使う形に作り直したもの。

e.g
<source lang="javascript" style="word-wrap:break-word;">
let os=new InsetSearch(path,option).execute();
</source>
InsetSearch.jsではoptionはデフォルトのままで、<code>ComText</code>を継承する事で処理を追加している。

=kili=

==ダウンロード==
[https://bitbucket.org/kimigatame/merymacro BitBucket]

==概要==
旧版のライブラリ。
{| class="wikitable"
!マクロ
!中身とか注意事項とか
|-
|KILI.js
|Selection/Documentの拡張がメイン。その他座標などを表す簡易なオブジェクトやグローバルな関数/変数を含む。<br />グローバルなもの以外はKILIオブジェクト下に存在する。
|-
|KILI.code.js
|文字・コードポイントの相互変換とその表現を扱う。Unicodeのみが対象。
|-
|ArrayEx.js<br />StringEx.js<br />NumberEx.js
|それぞれのオブジェクトの拡張。
|-
|WidePop.js
|ポップアップ拡張。
|-
|InsetText.js
|キャレット行の検索結果に基づいてテンプレートから文字列を作成・挿入する。
|-
|MouseEmurator.js
|マウスの操作。
|-
|Commentize.js
|コメント化もしくはコメント解除する。
|-
|LoopyBookmark.js
|最後のブックマークまで来たら最初のブックマークへ移動する。
|-
|FillSearch.js
|選択文字列をテンプレートにはめ込んで検索する。
|-
|MoveSelection.js
|選択文字列を移動する。
|-
|Exes
|マクロの実行用ファイル。
|}

==WidePop.js==
拡張PopupMenu。機能は以下の通り。
*配列のみでのメニュー定義
*チェックボックス
*ラジオボタン
*チェック、有効･無効の切り換え
*サブメニュー
*選択時にコマンド実行
*MouseEmurator.jsを利用してメニューの位置を一定にする

e.g.
<source lang="javascript" style="word-wrap:break-word;">
var menu=[
  ["a",1,function(pop,me){Alert(me.tags[0]);},null,["A","a"]],
  [], //区切り線
  ["b",20], //チェック&グループ開始
  ["c",4],  //"b"がチェック済みなのでチェックされない
  ["d",4],  //次のflagが0なのでここでグループ終了
  ["e",1,function(pop,me){return this.caption},[
    ["-a",2,"e-a"], //チェックボックス
    ["-b",1,function(pop,me){return pop.getItemById(me.parent).command()+me.caption}],
    ["-c",1,"unalbled"]
  ]],
  ["f",0] //無効になっている
];
var p=new WidePop(menu);
p.getItemFromPosition(5,2).enabled=false;
p.check(1,function(pos,me){return me.caption=="-a"});
p.create().track(0,true);
Alert(p.getResult().value)
</source>

==InsetText.js==
キャレット行の検索結果に基づいてテンプレートから文字列を作成・挿入する。
SSnippet.js・Blockize.js・SmartBreak.jsを統合して一から作り直したもの。
検索条件やテンプレートはJSONで指定する。

;機能
*複数条件での検索
**検索範囲をキャレット行・キャレット位置に基づいて指定可能
*編集モードによる絞り込み
*テンプレートへの検索マッチやキャレット前後・選択部分などの埋め込み
**一部分だけも可能
*インデントの考慮
*選択範囲とは違う範囲への挿入
*挿入後の選択範囲指定
*一致するエントリーが無い場合の代替テンプレート

;検索方法
* （先頭・末尾/選択位置の直前・直後）に一致
* （選択位置の前後/選択文字列）に（一致/含まれる/長さが一致）
* 行全体に（含まれる/長さが一致）
* （選択位置の前後/選択文字列/行全体）を正規表現検索
* 上記それぞれの否定検索

e.g.
仮に以下の様なinsettext.jsonを用意する。
<source lang="javascript" style="word-wrap:break-word;">
{
  "entries": [
    {
      "name":"for",
      "template":"for(var {0:8-1,0:8}=0;{0:8-1,0:8}<{s}.length;{0:8-1,0:8}++){\n\t\n}",
      "indent":true,
      "modes":["JavaScript","C#","C++","Java"],
      "conditions":[
        {
          "type":14,
          "text":"for[ijk]$"
        }
      ],
      "range":"0"
    }
  ],
  "sub":{
    "name":"sub",
    "comment":"一致するものが無ければ単純に改行する",
    "template":"\n"
  }
}
</source>
Mery上で
 [Tab]fori
というテキストの末尾にキャレットがある時、次のマクロを実行する。
<source lang="javascript" style="word-wrap:break-word;">
var g=new InsetText("insettext.json").match(false).generated[0];
if(g){
  g.insert();
}
</source>

# この時InsetTextはJSONファイルのentriesをリスト化し、現在の編集モードが"modes"にあればそのエントリーを検索に使用する。
# 検索するメソッドは"InsetText#match"。
# 検索条件は"conditions"で指定する。複数指定できるが、全てにマッチした時のみそのエントリーがマッチしたとみなす。検索範囲は現在の行に限る。
# "type"は検索方法を指定する。14であれば「選択位置より前の文字列を正規表現検索」する。（この番号はInsetText.SearchTypesを参照）
# "text"は検索文字列で、ここでは正規表現パターンになる。「選択位置より前の文字列」が検索範囲で「$」を指定しているので、選択範囲の直前がfori/forj/forkのいずれかであればマッチは成功となる。
# マッチが成功すれば、"template"から挿入する文字列を作成する。「{0:8-1,0:8}」は元のテキストの範囲を表し、その部分のテキストをテンプレートに埋め込んで文字列を作成できる。「,」の前は開始位置、後は終了位置を表す。「:」の前はconditionsのインデックスを表す（0始まり）。「:」の後の数字はテキスト中での位置を表す（InsetText.RangeTypes）。「8」はマッチ終了位置を意味する。「-1」はその位置からの差分を表す。なので「{0:8-1,0:8}」は「conditionsの0番目のマッチ終了位置より1文字遡った位置から、conditionsの0番目のマッチ終了位置」までの文字列を表す事になる。つまりマッチした最後の1文字「i」になる。これがテンプレートに埋め込まれて文字列が完成する。
# こうして作成された文字列は他の情報と共にInsetText#generatedに追加される。複数のエントリーがマッチする事もあるが、マクロで「match(true)」とすれば1つのエントリーがマッチした時点で強制終了する。どちらにせよInsetText#generatedは配列なのでそこから必要なものを選ぶことになる。
# テキストの挿入は"InsetText#generated#insert"で行う。挿入位置は"range"で指定する。指定方法はテンプレートの範囲指定と同じだが、ここでは省略してconditionsのインデックス「0」だけを指定しているので、挿入位置は「conditionsの0番目のマッチ位置全体」になる。
# "indent"を指定していれば、挿入する文字列が複数行の場合に、1行目に合わせてインデントを追加する。これで上のテキストは次の様になる。

 [Tab]for(var i=0;i<.length;i++){
 [Tab][Tab]
 [Tab]}

なお、テンプレート中の「{s}」「{e}」は挿入後の選択範囲を表す。ここでは「{s}」のみ指定しているので、「.length」の前にキャレットが移動する。
どのエントリーもマッチしなかった場合、"sub"に指定したテンプレートから文字列を作成してInsetText#generatedに追加する。"sub"が存在しなければInsetText#generatedは空になり、挿入できる文字列は何もないという事になる。

==MouseEmulator.js==
Mouse.dll（http://ja.syoubook.info/wsh/wsftemplate/<nowiki />）を利用してマウスの操作や座標の取得をする。

==古いもの・非推奨==
;KeyList.js
:簡単なJSON形式のファイル読み書き。あまり汎用には使えない。

===InsetText.jsに統合したもの===
;SSnippet.js
:キャレット直前の文字列をキーとして補完する。
;Blockize.js
:選択部分をテンプレートにはめ込んだブロックを挿入する。
;SmartBreak.js
:ちょっと賢く改行する。

===WidePop.jsに統合したもの===
;SimplePM.js
:テキストと実行コマンドのみからなる単純なPopupMenu。
;WidePM.js
:いろいろできるPopupMenu。

==Events==
イベントマクロを使いやすく（?）したもの。
大体のメリットとしては、
*ポップアップ地獄を回避。
*イベント編集に必要なファイルは1つだけ。
*同じ様な処理にファイルを分けなくていい。

;Event.js
:イベントを実行するクラス。イベント名に応じてEventMain.jsの関数を呼び出す。また例外メッセージをアウトプットに投げている。
;EventMain.js
:イベントで実行される関数のファイル。イベントの編集はこのファイルをいじるだけでいい。
;EventTemplate.js
:1つのファイルで通常とイベントと両方のマクロに利用できるようするテンプレート。
;「On～」で始まるファイル
:Meryでイベントとして登録するファイル。Event.executeを呼び出すだけ。
;EventMethod.js
:イベント用に作った関数。

===ダウンロード===
[https://bitbucket.org/kimigatame/merymarco_event BitBucket]

=覚え書き=
;OnDocumentCloseで閉じたタブをもう一度開こうとすると
以下のNewFileで開いたタブを閉じるとき、定期的?にonDocumentCloseが呼ばれない。またOpenFileは何回かに一回しか成功しない。
<source lang="javascript" style="word-wrap:break-word;">
var file="";
Editor.NewFile();
Editor.OpenFile(file,meEncodingUTF16LE,false);
</source>
OnModifiedなどでは問題ない。
;コマンドラインオプションからマクロ実行
Window.PromptとWindow.Confirmは実行できない。
;Document.GetLine
デフォルトでは表示行を取得。meGetLineLogicalが未定義なので0を指定する。
;最初の数
*行:1 (Document.GetLine)
*文頭からの位置:0 (Selection.GetActivePos)
*桁:1 (Selection.GetActivePointX)
*Editor,Document:0 (Editors.Item.Documents.Item)
;Window.Document
Document.NewFile後も更新されない。
<source lang="javascript" style="word-wrap:break-word;">
Editor.ActiveDocument.NewFile();
Alert(Document.Text);
</source>
;Editor.FindInFiles
*ディレクトリ名は最後を"\\"か"\\*"にする。
*アクティブな文書が結果表示で乗っ取られる。
;PopupMenu.Track
*引数無しだとエラー。0でキャレット位置に表示。mePosMouseは1。
*キャンセルした場合の返り値は0。
*返り値を変数に入れるなりOutputするなりしないとメニューは表示されない。
*領域外をクリックしてキャンセルした場合、続けてTrackしていても実行されない。Escでだとされる。
<source lang="javascript" style="word-wrap:break-word;">
var p=CreatePopupMenu();
p.Add("1");
var x=p.Track(0);	//ここでキャンセル
if(x==0){
  x=p.Track(0);
}
</source>
;Selection.Replace
検索オプションを何も付けたくない場合はflagに0を指定する。
<source lang="javascript" style="word-wrap:break-word;">
//正規表現を使わず、大文字と小文字を区別せず、カーソル位置の次の一つだけ、単語の途中でもマッチする
Selection.Replace("x","y",0);
</source>

検索文字列が0x000aから始まるとき、meFindReplaceRegExpを指定しないと、meReplaceAllがおかしい。
<source lang="javascript" style="word-wrap:break-word;">
Selection.Replace("\n","",meReplaceAll);	//文書全体の最初の1つだけ処理される
Selection.Replace(";\n","",meReplaceAll);	//全て処理される
Selection.Replace("\n;","",meReplaceAll);	//文書全体の最初の1つだけ処理される
</source>
;Document.Text
代入する場合、設定上の改行コードに関わらず、改行記号は文字列中の改行によって変わる。これがSelection.Textだと変わらない。
<source lang="javascript" style="word-wrap:break-word;">
Document.Text=Document.Text;	//改行記号はLFになる
Selection.SelectAll();
Selection.Text=Selection.Text;	//元のまま
</source>
;Selection.CharLeft,CharRight,LineUp,LineDown
Countが0の時は1と同じ。負の場合、逆方向に移動。
;Selection.Find
正規表現の時meFindReplaceOnlyWordは無効。